selectize.js

selectize.js

Selectize ist ein erweiterbares jQuery-basiertes benutzerdefiniertes <select> ; UI -Kontrolle. Es ist nützlich für Tagging, Kontaktlisten, Länderauswahl usw. Ziel ist es, eine solide und verwendbare Erfahrung mit einer sauberen und leistungsstarken API zu bieten.

• Demos
• Changelog
• Dokumentation

Merkmale

• Smart Option Such- / Ranking -Optionen werden effizient bewertet und im Fliege sortiert (mit Sifter). Möchten Sie nach dem Titel und einer Beschreibung eines Elements suchen? Kein Problem.
• Die Pflege zwischen Gegenständen bestellen manchmal wichtig. Verwenden Sie die ← und → Pfeiltasten, um sich zwischen ausgewählten Elementen zu bewegen.
• Wählen Sie mehrere Elemente gleichzeitig auf Mac oder Strg unter Windows aus und löschen Sie sie gleichzeitig , um mehr als ein Element zum Löschen auszuwählen.
• Díåcritîçs unterstützte hervorragend für internationale Umgebungen.
• Mit der Erstellung von Elementen können Benutzer Elemente im laufenden Fliegen erstellen (Async -Speichern wird unterstützt; die Kontrollschlösser, bis der Rückruf abgefeuert wird).
• Laden Sie das Laden von Remotedaten, wenn Sie Tausende von Optionen haben und diese vom Server als Benutzer angeben möchten.
• Reinigen Sie die API & Code -Schnittstelle damit und nehmen Sie leicht Änderungen vor. Pull -Anfragen sind immer willkommen!
• Erweiterbare Plugin -API für die Entwicklung benutzerdefinierter Funktionen (verwendet Microplugin).
• Touch Support spielt gut mit iOS 5+ Geräten.

Abhängigkeiten

• JQuery (1,7 und größer) als Peer -Abhängigkeit
  • Hinweis: Es wird automatisch in der Entwicklung oder in Projekten mit NPM 1 oder 2. installiert. Wenn NPM von Version 3 eins verwendet wird, wird nur eine Warnung geworfen, und der Benutzer muss manuell eine explizite Version in ihrem eigenen Projekt installieren (z. B. npm install --save [email protected] ).

Optional:

• JQuery-UI (erforderlich von drag_drop Plugin)

Installation

Auswählen kann über NPM npm install @selectize/selectize

Manuell installieren

Alle vorgefertigten Dateien, die für die Verwendung von Selectize benötigt werden, finden Sie im Ordner "dist".

Wenn Sie mit minimalem Aufwand beginnen, integrieren Sie selectize.min.js (Bündel Sifter- und Mikroplugin-Abhängigkeiten-auch nicht zum Debuggen verfügbar, entfernen Sie einfach den Teil .min ) und css/selectize.default.css .

Selectize ist bei CDNJS erhältlich.

• JS/
  • Selectize.js - mit Abhängigkeiten, minus jQuery
  • Selectize.min.js - mit Abhängigkeiten, minus jQuery
• SCSS/ - SASS -Quelldateien zur Anpassung (Bootstrap 3+ kompatibel)
• Less/ - weniger Quelldateien für die Anpassung (Bootstrap 2/3 kompatibel)
• CSS/
  • Selectize.css - Kernstile
  • Selectize.default.css - Standardthema (mit Kernstilen)
  • Selectize.bootstrap2.css - Bootstrap 2 -Thema
  • Selectize.bootstrap3.css - Bootstrap 3 -Thema
  • Selectize.bootstrap4.css - Bootstrap 4 -Thema
  • Selectize.bootstrap5.css - Bootstrap 5 Thema

Verwendung

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

Die verfügbaren Optionen sind hier dokumentiert.

Beitragen

Bei der Ausgabe einer Pull -Anfrage:

• Bitte fügen Sie keine Änderungen in den dist/ oder lib/ Ordnern hinzu/ begehen Sie nicht, um zusammengeführte Konflikte zu vermeiden. Eine gute Möglichkeit, die richtigen Dateien einzuschließen, besteht darin, git gui oder git add zu verwenden, wenn Sie sich verpflichten, die Dateien auszuwählen, die Sie Ihrem Commit hinzufügen möchten.

• Bitte geben Sie Tests mit Ihrer Funktion bei, damit wir nicht versucht sind, sie in Zukunft zu brechen!

Fügen Sie einen Eintrag an die Spitze des Changelogs hinzu und aktualisieren Sie die Dokumentation in docs/ nach Bedarf. (Refactors und Dokumentationsänderungen benötigen keinen ChangeLog -Eintrag.)

Kürzen Sie Ihre Commits in einem oder wenigen vollständigen, logischen Commits mit einer prägnanten und beschreibenden Nachricht. Ein Commit bedeutet ein Feature/Bugfix/Ding, das sich geändert hat, oder ein Diff, der den Code einen Schritt in einen besseren Arbeitszustand bringt.

Sobald Ihr Commit schön und sauber ist und Sie die anderen Änderungen verwerfen möchten, können Sie git checkout . (Dadurch werden Änderungen an verfolgten Dateien ausgelöscht) und git clean [-i/--interactive] (um unbeschwerte Dateien zu löschen). Seien Sie jedoch vorsichtig mit diesen Befehlen, da es ihre Funktion darin besteht, Dinge/Änderungen zu löschen.

Achten Sie jedoch darauf, dass Sie die dist/ Dateien in Ihrem Commit nicht hinzufügen, da das Grunzen die Dateien in dist/ mit der Quelle automatisch regeneriert.

Tests

Bitte stellen Sie sicher, dass alle Tests bestehen:

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

Lokale Umgebung

So ausführen ausführen auszuwählen: lokal:

npm start

Sie können dann die Beispiele unter https://loopback.website:4000/ ausführen.

Lizenz

Copyright © 2013–2016 Brian Revis & Mitwirkende
Copyright © 2020-2022 Selectize Team & Mitwirkende

Lizenziert unter der Apache -Lizenz, Version 2.0 (der "Lizenz"); Sie dürfen diese Datei nur in Übereinstimmung mit der Lizenz verwenden. Sie können eine Kopie der Lizenz unter: http://www.apache.org/licenses/license-2.0 erhalten

Sofern nicht nach geltendem Recht oder schriftlich zu vereinbart wird, wird die im Rahmen der Lizenz verteilte Software auf "As is" -Basis ohne Gewährleistung oder Bedingungen jeglicher Art ausdrücklich oder impliziert verteilt. Siehe die Lizenz für die spezifischen Sprachberechtigungen und Einschränkungen im Rahmen der Lizenz.