selectize.js

selectize.js

O Selectize é um Extensible JQuery Custom <select> ; Controle da interface do usuário. É útil para marcação, listas de contatos, seletores de países e assim por diante. O objetivo é fornecer uma experiência sólida e utilizável com uma API limpa e poderosa.

• Demos
• Changelog
• Documentação

Características

• As opções de pesquisa / classificação de opções inteligentes são pontuadas e classificadas com eficiência e classificadas na fly (usando o SiFter). Quer procurar o título e a descrição de um item? Sem problemas.
• O cuidador entre os itens às vezes é importante. Use as teclas ← e → Arrow para mover -se entre os itens selecionados.
• Selecione e exclua vários itens ao mesmo tempo, mantenha pressionado a opção Mac ou Ctrl no Windows para selecionar mais de um item a ser excluído.
• Díåcritîçs apoiados ótimos para ambientes internacionais.
• A criação de itens permite que os usuários criem itens em tempo real (a economia de async é suportada; os bloqueios de controle até que o retorno de chamada seja disparado).
• Carregamento de dados remotos para quando você tem milhares de opções e deseja que eles forneçam pelo servidor como os tipos de usuário.
• Limpe a interface da API & Code com ele e faça modificações facilmente. Os pedidos de puxão são sempre bem -vindos!
• API de plug -in extensível para o desenvolvimento de recursos personalizados (usa microplugina).
• O suporte ao toque é bom com os dispositivos iOS 5+.

Dependências

• jQuery (1,7 e maior), como dependência de colegas
  • NOTA: Ele é instalado automaticamente no desenvolvimento ou em projetos usando o NPM 1 ou 2. Ao usar o NPM da versão 3, apenas um aviso é lançado e o usuário precisa instalar manualmente uma versão explícita em seu próprio projeto (por exemplo, npm install --save [email protected] ).

Opcional:

• jQuery-ui (exigido pelo plugin drag_drop )

Instalação

Selecionar pode ser instalado via NPM npm install @selectize/selectize

Instalando manualmente

Todos os arquivos pré-construídos necessários para usar o Selectize podem ser encontrados na pasta "Dist".

Se você deseja começar com o mínimo de confusão, inclua selectize.min.js (Bundles SiFter e dependências de microplugina-também disponível não-minificado para depuração, basta remover a parte .min ) e css/selectize.default.css .

Selectize está disponível no CDNJS.

• js/
  • selectize.js - com dependências, menos jQuery
  • selectize.min.js - Com dependências, menos jQuery
• SCSS/ - Arquivos de origem SASS para personalização (Bootstrap 3+ Compatível)
• menos/ - menos arquivos de origem para personalização (Bootstrap 2/3 compatível)
• CSS/
  • selectize.css - estilos principais
  • selectize.default.css - Tema padrão (com estilos principais)
  • Selectize.bootstrap2.css - Bootstrap 2 tema
  • selectize.bootstrap3.css - Bootstrap 3 tema
  • selectize.bootstrap4.css - Bootstrap 4 tema
  • Selectize.BootStrap5.css - Bootstrap 5 tema

Uso

 $ ( "select" ) . selectize ( options ) ;

As opções disponíveis estão documentadas aqui.

Contribuindo

Ao emitir uma solicitação de tração:

• Por favor , não inclua/ confirme as alterações nas pastas dist/ ou lib/ e evitam conflitos de mesclagem. Uma boa maneira de incluir os arquivos certos é usar git gui ou git add ao se comprometer para selecionar os arquivos que você deseja adicionar ao seu compromisso.

• Inclua testes com seu recurso para que não sejamos tentados a quebrá -lo no futuro!

Adicione uma entrada na parte superior do Changelog e atualize a documentação nos docs/ conforme necessário. (Os refatores e as alterações de documentação não precisam de uma entrada de Changelog.)

Squash seus compromissos juntos em um ou alguns compromissos lógicos completos, com uma mensagem concisa e descritiva. Um comprometimento significa que um recurso/bugfix/coisa que mudou ou um diferencial trazendo o código um passo adiante para um estado melhor e melhor.

Depois que seu compromisso é bom e limpo, e você deseja descartar as outras alterações , você pode usar git checkout . (Isso apagará as alterações nos arquivos rastreados) e git clean [-i/--interactive] (para apagar arquivos não rastreados). No entanto, tenha cuidado com esses comandos, pois sua função é apagar as coisas/mudanças.

No entanto, tenha cuidado para não adicionar os arquivos dist/ em seu compromisso, pois o Grunt regenera automaticamente os arquivos no dist/ como a fonte é alterada.

Testes

Certifique -se de que todos os testes passem:

npm test # defaults to ChromHeadless
BROWSERS=Firefox npm test
BROWSERS=Firefox,Chrome npm test
BROWSERS=Firefox,Chrome,Safari npm test 

Ambiente local

Para executar, selecione Localmente:

npm start

Você pode executar os exemplos em https://loopback.website:4000/ .

Licença

Copyright © 2013–2016 Brian Reavis & Contribuidores
Copyright © 2020-2022 Selecione a equipe e colaboradores

Licenciado sob a licença Apache, versão 2.0 (a "licença"); Você não pode usar esse arquivo, exceto em conformidade com a licença. Você pode obter uma cópia da licença em: http://www.apache.org/license/license-2.0

A menos que exigido pela lei aplicável ou acordada por escrito, o software distribuído pela licença é distribuído "como está", sem garantias ou condições de qualquer tipo, expressa ou implícita. Consulte a licença para o idioma específico que rege as permissões e limitações sob a licença.