README
Array Collections
@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
Instalar
Instale a partir do npm:
npm install @use-pattern/collections --save
Utilizar
npm
— para instalar @use-pattern/collectionsgithub
— para fazer download do código fonte
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.