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.

Пример

Пример

<div class="well">
    <input type="text" class="span3" style="margin: 0 auto;" data-provide="typeahead" data-items="4" data-source="[&quot;Ahmedabad&quot;,&quot;Akola&quot;,&quot;Asansol&quot;,&quot;Aurangabad&quot;,&quot;Bangaluru&quot;,&quot;Baroda&quot;,&quot;Belgaon&quot;,&quot;Berhumpur&quot;,&quot;Calicut&quot;,&quot;Chennai&quot;,&quot;Chapra&quot;,&quot;Cherapunji&quot;]">
</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.

Пример

Пример

<div class="well">
    <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 и файлы изображений, используемые в этом руководстве.

Другие расширения