@use-pattern/collections

O pacote UseCollections gerencia interações em uma matriz (array) como uma coleção que pode ser acessada e manipulada usando os métodos e propriedades.

Usage no npm install needed!

<script type="module">
  import usePatternCollections from 'https://cdn.skypack.dev/@use-pattern/collections';
</script>

README

Array Collections

use-pattern npm github

@use-pattern/collections

O pacote UseCollections gerencia interações em uma matriz (array) como uma coleção que pode ser acessada e manipulada usando os métodos e propriedades. Operações em uma instância List modificam a fonte de dados; por exemplo, se você usar o método removeItemAt () em um List, removerá o item do Array subjacente.

Inspirado orinalmente em Adobe ArrayList.

Conteúdo

  1. Instalar
  2. Utilizar
  3. Aprender
  4. Contribuir

Instalar

Instale a partir do npm:

npm install @use-pattern/collections --save

Utilizar

Aprender

src/app/app.component.ts

import {Component} from '@angular/core';
import {List} from '@use-pattern/collections';

@Component({
  selector: 'app-root',
  templateUrl: './app.component.html',
  styleUrls: ['./app.component.css']
})
export class AppComponent {

  //Gerenciador de lista de items
  public list: List;

  constructor() {
    //Cria uma instância da lista
    this.list = new List();

    //Registra um evento na lista
    this.list.addEvent(List.ADD_ITEM, (event) => {
      //Evento disparado quando um item é adicionado na lista
    });
  }

  /**
   * Adiciona um item na lista
   * @param item
   */
  public addItem(item: any): void {
    this.list.addItem(item);
  }

  /**
   * Remove um item da lista
   * @param item
   */
  public removeItem(item: any): void {
    this.list.removeItem(item);
  }
}

Propriedades públicas

Propriedade Descrição Tipo
addItem Adiciona um item na lista boolean
addItemAt Adiciona um item na lista em posição definida boolean
addItems Adiciona lista de items na lista boolean
addItemsAt Adiciona lista de items na lista em posição definida boolean
clone Cria uma lista similar a lista atual ListInterface
contains Verifica se um item especifico está contido na lista boolean
containsAll Verifica se uma lista de itens está contido na lista boolean
equals Comprara uma lista com outra boolean
getItemAt Recupera um item de uma posição especifica na lista any
indexOf Recupera a posição de um item especificado na lista number
isEmpty Estatus indica se a lista está vazia boolean
items Recupera a lista de ietms da lista em uma matriz (array) Array
lastIndexOf Recupera a posição do ultimo item do tipo especificado na lista number
length Recupera a quantidade de items na lista number
removeAll Remove todos os itens da lista void
removeAllSimilarItems Remove duplicidade de um mesmo item na lista boolean
removeItem Remove um item especifico da lista boolean
removeItemAt Remove um item em uma posição especifica na lista any
removeItems Remove uma lista de items especificados da lista boolean
retainItems Remove items da lista mantendo somente os items listado na lista boolean
setItemAt Atualiza um item especificado na lista any
sortNumber Ordena números na matriz. Default ASCENDENTE, opção "desc" para DESCENDENTE void
sortObject Ordena objetos na matriz por uma propriedade especificada. Default ASCENDENTE, opção "desc" para DESCENDENTE void
sortString Ordena strings na matriz. Default ASCENDENTE, opção "desc" para DESCENDENTE void
subList Cria uma sublista a partir de partes especificas de uma lista ListInterface
toArray Converte a lista em array Array
toString Converte a lista para string string

Eventos

Identificador Descrição
ADD_ITEM Evento disparado quando um item é adicionado na lista
ADD_ITEM_AT Evento disparado quando um item é adicionado na lista em posição especifica
ADD_ITEMS Evento disparado quando lista de items são adicionados na lista
ADD_ITEMS_AT Evento disparado quando um item é adcionado em uma posição especifica na lista
REMOVE_ALL_SIMILAR_ITEMS Evento disparado quando quando items similares são removidos da lista
REMOVE_ITEM Evento disparado quando um item é removido da lista
REMOVE_ITEM_AT Evento disparado quando um item é removido de uma posição especifica
REMOVE_ITEMS Evento disparado quando quando uma lista de items espcificados são removidos da lista

Contribuir

Contibuições são sempre muito bem vindas! As contribuições não precisam serem somente através de desenvolvimentos de códigos, qualquer ajuda com ideias, sugestões, melhorias na documentação ou doações para os desenvolvedores são sempre muito apreciadas!

Participe da comunidade Projeto que Vale e colabore da forma que achar melhor.

Licença

MIT License

Copyright (c) 2018 PROJETO QUE VALE

É concedida permissão, gratuitamente, a qualquer pessoa que obtenha uma cópia deste software e dos arquivos de documentação associados (o "Software"), para negociar o Software sem restrições, incluindo, sem limitação, os direitos de uso, cópia, modificação e fusão , publicar, distribuir, sublicenciar e / ou vender cópias do Software, e permitir que as pessoas a quem o Software é fornecido o façam, sujeitas às seguintes condições:

O aviso de copyright acima e este aviso de permissão devem ser incluídos em todas as cópias ou partes substanciais do Software.

O SOFTWARE É FORNECIDO "NO ESTADO EM QUE SE ENCONTRA", SEM NENHUM TIPO DE GARANTIA, EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS NÃO SE LIMITANDO ÀS GARANTIAS DE COMERCIALIZAÇÃO, ADEQUAÇÃO A UM FIM ESPECÍFICO E NÃO VIOLAÇÃO. EM NENHUMA CIRCUNSTÂNCIA, OS AUTORES OU PROPRIETÁRIOS DE DIREITOS DE AUTOR PODERÃO SER RESPONSABILIZADOS POR QUAISQUER REIVINDICAÇÕES, DANOS OU OUTRAS RESPONSABILIDADES, QUER EM ACÇÃO DE CONTRATO, DELITO OU DE OUTRA FORMA, DECORRENTES DE, OU EM CONEXÃO COM O SOFTWARE OU O USO OU OUTRAS NEGOCIAÇÕES NO PROGRAMAS.