selectize.js

SELECTIZE.JS

Selectize-это расширяемый пользовательский на основе jQuery <select> ; Контроль пользовательского интерфейса. Это полезно для тегов, списков контактов, селекторов страны и так далее. Цель состоит в том, чтобы обеспечить твердый и полезный опыт с чистым и мощным API.

• Демо
• Изменение
• Документация

Функции

• Умные параметры поиска / рейтинга эффективно оцениваются и сортируются на лету (с помощью SIFTER). Хотите найти название и описание элемента? Без проблем.
• Взаимодействие между предметами иногда имеет значение. Используйте клавиши → → стрелки, чтобы перемещаться между выбранными элементами.
• Выберите и удалите несколько элементов одновременно удерживайте опцию на Mac или CTRL в Windows, чтобы выбрать более одного элемента для удаления.
• Díåcritîs отлично поддержали для международных сред.
• Создание элементов позволяет пользователям создавать элементы на лету (поддерживается асинхронизация;
• Удаленная загрузка данных , когда у вас есть тысячи опций, и они хотите, чтобы они были предоставлены сервером в качестве типов пользователей.
• Очистите интерфейс API и кода с ним и легко внесите изменения. Запросы на вытягивание всегда приветствуются!
• Расширимый API плагина для разработки пользовательских функций (использует микроплагин).
• Поддержка прикосновения хорошо играет с устройствами iOS 5+.

Зависимости

• jQuery (1,7 и больше), как зависимость от сверстников
  • ПРИМЕЧАНИЕ. Он установлен автоматически в разработке или в проектах с использованием NPM 1 или 2. При использовании NPM из версии 3 включено только предупреждение, и пользователю необходимо вручную установить явную версию в своем собственном проекте (например, npm install --save [email protected] ).

Необязательный:

• jquery-ui (требуется плагин drag_drop )

Установка

SELECTIZE может быть установлен через NPM npm install @selectize/selectize

Установка вручную

Все предварительно построенные файлы, необходимые для использования Selectize, можно найти в папке "Dist".

Если вы хотите начать с минимальной суеты, включите selectize.min.js (Bundles Sifter и зависимости от микроплагина-также доступны для отладки, просто удалите часть .min ) и css/selectize.default.css .

Selectize доступен в CDNJS.

• JS/
  • selectize.js - с зависимостями, минус jquery
  • selectize.min.js - с зависимостями, минус jquery
• SCSS/ - исходные файлы SASS для настройки (Bootstrap 3+ совместим)
• Меньше/ - меньше исходных файлов для настройки (Bootstrap 2/3 совместимо)
• CSS/
  • Selectize.css - основные стили
  • selectize.default.css - тема по умолчанию (с основными стилями)
  • Selectize.bootstrap2.css - Bootstrap 2 Тема
  • Selectize.bootstrap3.css - Bootstrap 3 Тема
  • Selectize.bootstrap4.css - Bootstrap 4 Тема
  • Selectize.bootstrap5.css - Bootstrap 5 Тема

Использование

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

Доступные варианты задокументированы здесь.

Внося

При выдаче запроса на привлечение:

• Пожалуйста , не включайте/ совершайте изменения в папках dist/ или lib/ чтобы избежать конфликтов слияния. Хороший способ включить правильные файлы - использовать git gui или git add при выборе файлов, которые вы хотите добавить в свой коммит.

• Пожалуйста, включите тесты с вашей функцией, чтобы мы не испытывали желания сломать их в будущем!

Добавьте запись в верхнюю часть изменятеля и обновите документацию в docs/ по мере необходимости. (Рефактории и изменения документации не нуждаются в записи изменений.)

Совместно раздавите свои коммиты в одном или нескольких полных, логичных коммитах, с кратким и описательным сообщением. Один коммит означает одну функцию/ошибку/вещь, которая изменилась, или Diff, представляющий код на один шаг вперед к лучшему рабочее состояние.

Как только ваш коммит будет хорошим и чистым, и вы хотите отказаться от других изменений , вы можете использовать git checkout . (Это будет стереть изменения в отслеживаемых файлах) и git clean [-i/--interactive] (для стирания не отказавшихся файлов). Тем не менее, будьте осторожны с этими командами, так как их функция состоит в том, чтобы стирать вещи/изменения.

Тем не менее, будьте осторожны, чтобы не добавлять файлы dist/ в вашем коммите, поскольку Grunt автоматически восстанавливает файлы в dist/ по мере изменения источника.

Тесты

Пожалуйста, убедитесь, что все тесты проходят:

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

Местная среда

Чтобы запустить выбранные локально:

npm start

Затем вы можете запустить примеры по адресу https://loopback.website:4000/ .

Лицензия

Copyright © 2013–2016 Брайан Reavis & Apportors
Copyright © 2020-2022 Selectize Team & Apportors

Лицензировано по лицензии Apache, версия 2.0 («Лицензия»); Вы не можете использовать этот файл, кроме как в соответствии с лицензией. Вы можете получить копию лицензии по адресу: http://www.apache.org/licenses/license-2.0

Если не требуется применимый закон или не согласен в письменной форме, программное обеспечение, распространяемое по лицензии, распределяется по основам «как есть», без каких -либо гарантий или условий, явных или подразумеваемых. См. Лицензию для конкретного языка, регулирующих разрешения и ограничения по лицензии.