Bootstrap Typeahead
Введение
В этом руководстве вы увидите, как использовать Bootstrap для создания Typeahead.
Typeahead предоставляет подсказки или данные пользователям при заполнении форм.
Bootstrap позволяет создавать прекрасно выглядящий Typeahead, и его легко расширять; можно улучшать его функциональность без существенных изменений.
Что требуется
Typeahead — это функция Bootstrap 2.x, поэтому в этом руководстве для тестирования используется Bootstrap 2.0.
Необходимо подключить два файла JavaScript, jquery.js и bootstrap-typeahead.js, оба находящиеся в docs/assets/js/.
В следующем примере показано, как создать Typeahead, используя только разметку, без написания JavaScript.
Пример
Пример
<input type="text" class="span3" style="margin: 0 auto;" data-provide="typeahead" data-items="4" data-source="["Ahmedabad","Akola","Asansol","Aurangabad","Bangaluru","Baroda","Belgaon","Berhumpur","Calicut","Chennai","Chapra","Cherapunji"]">
</div>
<script src="../bootstrap/twitter-bootstrap-v2/docs/assets/js/jquery.js.html"></script>
<script src="../bootstrap/twitter-bootstrap-v2/docs/assets/js/bootstrap-typeahead.js.html"></script>
Вы можете вызывать Typeahead через JavaScript и расширять его функциональность, используя различные параметры. Использование вызова Typeahead через JavaScript выглядит следующим образом:
$('#example').typeahead()Здесь 'example' — это идентификатор поля ввода, к которому вы хотите применить typeahead.
Пример
Пример
<input type="text" class="span3" id="search" data-provide="typeahead" data-items="4" />
</div>
<script src="../bootstrap/twitter-bootstrap-v2/docs/assets/js/jquery.js.html"></script>
<script src="../bootstrap/twitter-bootstrap-v2/docs/assets/js/bootstrap-typeahead.js.html"></script>
<script>
var subjects = ['PHP', 'MySQL', 'SQL', 'PostgreSQL', 'HTML', 'CSS', 'HTML5', 'CSS3', 'JSON'];
$('#search').typeahead({source: subjects})
</script>
Параметры
Вы можете использовать различные параметры Typeahead. Ниже приведено подробное объяснение каждого параметра:
source: Указывает источник данных, содержащий значения для отображения при запросе. Тип данных — массив, а значение по умолчанию — [ ].
items: Задает максимальное количество записей для отображения при запросе. Тип данных — number, значение по умолчанию — 8.
matcher: Определяет, соответствует ли запрос записи. Принимает один параметр — запись для проверки на соответствие запросу. Доступ к текущему запросу осуществляется через this.query. Возвращает логическое значение true, указывающее, что запрос соответствует. Тип данных — function. По умолчанию регистр не учитывается.
sorter: Используется для автоматической классификации результатов. Принимает один параметр — запись, привязанную к экземпляру typeahead. Доступ к текущему запросу осуществляется через this.query. Тип данных — function. По умолчанию используется точное совпадение, а другие значения могут быть с учетом регистра или без учета регистра.
highlighter: Используется для автоматического выделения результатов. Принимает один параметр — запись, привязанную к экземпляру typeahead. Тип данных — function. По умолчанию выделяет все совпадения по умолчанию.
Методы
.typeahead(options)
Инициализирует поле ввода с помощью Typeahead.
Нажмите здесь, чтобы скачать все HTML, CSS, JS и файлы изображений, используемые в этом руководстве.
Другие расширения