selectize.js

sélectionner.js

Selettize est une personnalité basée sur jQuery extensible <select> ; Contrôle de l'interface utilisateur. Il est utile pour le taggage, les listes de contacts, les sélecteurs de pays, etc. L'objectif est de fournir une expérience solide et utilisable avec une API propre et puissante.

• Démos
• Changelog
• Documentation

Caractéristiques

• Les options de recherche / classement d'options intelligentes sont notées efficacement et triées à la volée (à l'aide de Sifter). Vous souhaitez rechercher le titre et la description d'un article? Aucun problème.
• CARTET Entre les articles, l'ordre compte parfois. Utilisez les touches ← et → flèches pour se déplacer entre les éléments sélectionnés.
• Sélectionnez et supprimez plusieurs éléments à la fois maintenir l'option Hold Down sur Mac ou Ctrl sur Windows pour sélectionner plus d'un élément à supprimer.
• Díåcritîçs soutenait très bien pour les environnements internationaux.
• La création d'articles permet aux utilisateurs de créer des éléments à la volée (la sauvegarde asynchrone est prise en charge; la commande se verrouille jusqu'à ce que le rappel soit renvoyé).
• Chargement de données à distance lorsque vous avez des milliers d'options et que vous souhaitez qu'ils soient fournis par le serveur en tant qu'utilisateur.
• Nettoyez l'interface de l'API et du code avec elle et apportez des modifications facilement. Les demandes de traction sont toujours les bienvenues!
• API du plugin extensible pour développer des fonctionnalités personnalisées (utilise la microplugine).
• Le support Touch joue bien avec les appareils iOS 5+.

Dépendances

• jQuery (1,7 et plus), comme dépendance des pairs
  • Remarque: il est installé automatiquement dans le développement ou dans des projets utilisant NPM 1 ou 2. Lorsque vous utilisez NPM à partir de la version 3, un avertissement est lancé et l'utilisateur doit installer manuellement une version explicite dans son propre projet (par exemple npm install --save [email protected] ).

Facultatif:

• jQuery-UI (requis par le plugin drag_drop )

Installation

Sélection peut être installé via NPM npm install @selectize/selectize

Installation manuellement

Tous les fichiers pré-construits nécessaires pour utiliser la sélection peuvent être trouvés dans le dossier "DIST".

Si vous cherchez à démarrer avec un minimum d'agitation, incluez selectize.min.js (Bundles Sifter et Microplugin De dépendances - également disponible non mini pour déboguer, supprimez simplement la partie .min ) et css/selectize.default.css .

Sélection est disponible chez CDNJS.

• JS /
  • selecttize.js - avec dépendances, moins jQuery
  • selecttize.min.js - avec dépendances, moins jQuery
• SCSS / - Fichiers source SASS pour la personnalisation (bootstrap 3+ compatible)
• moins / - moins de fichiers source pour la personnalisation (bootstrap 2/3 compatible)
• CSS /
  • sélectionner.css - Styles de base
  • sélectionnez.default.css - Thème par défaut (avec les styles de base)
  • selecttize.bootstrap2.css - thème bootstrap 2
  • selecttize.bootstrap3.css - thème bootstrap 3
  • selecttize.bootstrap4.css - thème bootstrap 4
  • selecttize.bootstrap5.css - thème bootstrap 5

Usage

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

Les options disponibles sont documentées ici.

Contributif

Lors de la publication d'une demande de traction:

• Veuillez ne pas inclure / commettre des modifications dans les dist/ ou lib/ Dossiers pour éviter de fusionner les conflits. Un bon moyen d'inclure les bons fichiers consiste à utiliser git gui ou git add lors de l'engagement à sélectionner les fichiers que vous souhaitez ajouter à votre engagement.

• Veuillez inclure des tests avec votre fonctionnalité afin que nous ne soyons pas tentés de le casser à l'avenir!

Ajoutez une entrée en haut du modificateur et mettez à jour la documentation dans docs/ Selon nécessaire. (Les refacteurs et les modifications de la documentation n'ont pas besoin d'une entrée de modification.)

Écraser vos engagements ensemble dans un ou quelques validations logiques complètes, avec un message concis et descriptif. Un engagement signifie une fonctionnalité / bugfix / chose qui a changé, ou un Diff, ce qui a fait avancer le code à un meilleur état de travail.

Une fois que votre engagement est agréable et propre, et que vous souhaitez jeter les autres modifications , vous pouvez utiliser git checkout . (qui effacera les modifications des fichiers suivis) et git clean [-i/--interactive] (pour effacer les fichiers non tracés). Cependant, soyez prudent avec ces commandes, car leur fonction est d'effacer les choses / changements.

Cependant, veillez à ne pas ajouter les fichiers dist/ dans votre validation, car Grunt régénère automatiquement les fichiers dans dist/ AS LA SOURCE est modifié.

Tests

Veuillez vous assurer que tous les tests passent:

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

Environnement local

Pour s'exécuter, sélectionnez localement:

npm start

Vous pouvez ensuite exécuter les exemples sur https://loopback.website:4000/ .

Licence

Copyright © 2013-2016 Brian Reavis et contributeurs
Copyright © 2020-2022 Sélectionnez l'équipe et les contributeurs

Licencié sous la licence Apache, version 2.0 (la "licence"); Vous ne pouvez pas utiliser ce fichier sauf conforme à la licence. Vous pouvez obtenir une copie de la licence à: http://www.apache.org/licenses/license-2.0

Sauf exiger la loi applicable ou convenu par écrit, les logiciels distribués en vertu de la licence sont distribués sur une base «tel quel», sans garantie ou conditions d'aucune sorte, expresse ou implicite. Voir la licence pour la langue spécifique régissant les autorisations et les limitations sous la licence.