Кнопки
Используйте настраиваемые стили кнопок Bootstrap для действий в формах, диалоговых окнах и т. д. с поддержкой нескольких размеров, состояний и т. д.
Bootstrap включает в себя несколько предопределенных стилей кнопок, каждый из которых служит своей семантической цели, а также несколько дополнений для большего контроля.
<button type="button" class="btn btn-primary">Primary</button>
<button type="button" class="btn btn-secondary">Secondary</button>
<button type="button" class="btn btn-success">Success</button>
<button type="button" class="btn btn-danger">Danger</button>
<button type="button" class="btn btn-warning">Warning</button>
<button type="button" class="btn btn-info">Info</button>
<button type="button" class="btn btn-light">Light</button>
<button type="button" class="btn btn-dark">Dark</button>
<button type="button" class="btn btn-link">Link</button>
Передача смысла вспомогательным технологиям
Использование цвета для добавления значения обеспечивает только визуальную индикацию, которая не будет передана пользователям вспомогательных технологий, таких как программы чтения с экрана. Убедитесь, что информация, обозначенная цветом, либо очевидна из самого содержимого (например, видимый текст), либо включена с помощью альтернативных средств, таких как дополнительный текст, скрытый вместе с .sr-only
классом.
Классы .btn
предназначены для использования с <button>
элементом. Однако вы также можете использовать эти классы в элементах <a>
или <input>
(хотя некоторые браузеры могут применять несколько иное отображение).
При использовании классов кнопок для <a>
элементов, которые используются для запуска функций на странице (например, для свертывания содержимого), а не для ссылок на новые страницы или разделы на текущей странице, этим ссылкам следует присвоить a, role="button"
чтобы надлежащим образом передать их назначение вспомогательным технологиям, таким как скринридеры.
<a class="btn btn-primary" href="#" role="button">Link</a>
<button class="btn btn-primary" type="submit">Button</button>
<input class="btn btn-primary" type="button" value="Input">
<input class="btn btn-primary" type="submit" value="Submit">
<input class="btn btn-primary" type="reset" value="Reset">
Нужна кнопка, но не здоровенные цвета фона, которые они приносят? Замените классы модификаторов по умолчанию теми .btn-outline-*
, чтобы удалить все фоновые изображения и цвета на любой кнопке.
<button type="button" class="btn btn-outline-primary">Primary</button>
<button type="button" class="btn btn-outline-secondary">Secondary</button>
<button type="button" class="btn btn-outline-success">Success</button>
<button type="button" class="btn btn-outline-danger">Danger</button>
<button type="button" class="btn btn-outline-warning">Warning</button>
<button type="button" class="btn btn-outline-info">Info</button>
<button type="button" class="btn btn-outline-light">Light</button>
<button type="button" class="btn btn-outline-dark">Dark</button>
Хотите большие или маленькие пуговицы? Добавьте .btn-lg
или .btn-sm
для дополнительных размеров.
<button type="button" class="btn btn-primary btn-lg">Large button</button>
<button type="button" class="btn btn-secondary btn-lg">Large button</button>
<button type="button" class="btn btn-primary btn-sm">Small button</button>
<button type="button" class="btn btn-secondary btn-sm">Small button</button>
Создайте кнопки уровня блока — те, которые охватывают всю ширину родителя — путем добавления .btn-block
.
<button type="button" class="btn btn-primary btn-lg btn-block">Block level button</button>
<button type="button" class="btn btn-secondary btn-lg btn-block">Block level button</button>
Кнопки будут казаться нажатыми (с более темным фоном, более темной рамкой и вложенной тенью), когда они активны. Нет необходимости добавлять класс к <button>
s, поскольку они используют псевдокласс . Однако вы по-прежнему можете принудительно использовать такой же активный внешний вид .active
(и включить aria-pressed="true"
атрибут), если вам нужно программно реплицировать состояние.
<a href="#" class="btn btn-primary btn-lg active" role="button" aria-pressed="true">Primary link</a>
<a href="#" class="btn btn-secondary btn-lg active" role="button" aria-pressed="true">Link</a>
Чтобы кнопки выглядели неактивными, добавьте disabled
логический атрибут к любому <button>
элементу.
<button type="button" class="btn btn-lg btn-primary" disabled>Primary button</button>
<button type="button" class="btn btn-secondary btn-lg" disabled>Button</button>
Отключенные кнопки, использующие <a>
элемент, ведут себя немного иначе:
<a>
s не поддерживают этотdisabled
атрибут, поэтому вы должны добавить.disabled
класс, чтобы он визуально казался отключенным.- Некоторые удобные для будущего стили включены, чтобы отключить все
pointer-events
кнопки привязки. В браузерах, поддерживающих это свойство, вы вообще не увидите отключенный курсор. - Отключенные кнопки должны включать в себя
aria-disabled="true"
атрибут, указывающий на состояние элемента вспомогательных технологий.
<a href="#" class="btn btn-primary btn-lg disabled" role="button" aria-disabled="true">Primary link</a>
<a href="#" class="btn btn-secondary btn-lg disabled" role="button" aria-disabled="true">Link</a>
Предупреждение о функциональности ссылки
Класс .disabled
использует pointer-events: none
, чтобы попытаться отключить функцию ссылки <a>
s, но это свойство CSS еще не стандартизировано. Кроме того, даже в браузерах, поддерживающих pointer-events: none
, навигация с помощью клавиатуры остается неизменной, а это означает, что зрячие пользователи клавиатуры и пользователи вспомогательных технологий по-прежнему смогут активировать эти ссылки. Поэтому, чтобы быть в безопасности, добавьте tabindex="-1"
атрибут к этим ссылкам (чтобы они не получали фокус клавиатуры) и используйте собственный JavaScript, чтобы отключить их функциональность.
Делайте больше с кнопками. Управляйте состояниями кнопок или создавайте группы кнопок для дополнительных компонентов, таких как панели инструментов.
Добавить data-toggle="button"
для переключения состояния кнопки active
. Если вы предварительно переключаете кнопку, вы должны вручную добавить .active
класс и aria-pressed="true"
в файл <button>
.
<button type="button" class="btn btn-primary" data-toggle="button" aria-pressed="false" autocomplete="off">
Single toggle
</button>
Стили Bootstrap .button
можно применять к другим элементам, таким как <label>
s, чтобы обеспечить переключение флажков или радиокнопок. Добавьте data-toggle="buttons"
в , .btn-group
содержащий эти измененные кнопки, чтобы включить их поведение переключения с помощью JavaScript, и добавьте .btn-group-toggle
, чтобы стилизовать <input>
s внутри ваших кнопок. Обратите внимание, что вы можете создавать отдельные кнопки с питанием от ввода или их группы.
Отмеченное состояние для этих кнопок обновляется только через click
событие на кнопке. Если вы используете другой метод для обновления ввода — например, с <input type="reset">
помощью или вручную применяя checked
свойство ввода — вам нужно будет включить .active
его <label>
вручную.
Обратите внимание, что предварительно проверенные кнопки требуют, чтобы вы вручную добавили .active
класс во входной файл <label>
.
<div class="btn-group-toggle" data-toggle="buttons">
<label class="btn btn-secondary active">
<input type="checkbox" checked autocomplete="off"> Checked
</label>
</div>
<div class="btn-group btn-group-toggle" data-toggle="buttons">
<label class="btn btn-secondary active">
<input type="radio" name="options" id="option1" autocomplete="off" checked> Active
</label>
<label class="btn btn-secondary">
<input type="radio" name="options" id="option2" autocomplete="off"> Radio
</label>
<label class="btn btn-secondary">
<input type="radio" name="options" id="option3" autocomplete="off"> Radio
</label>
</div>
Метод | Описание |
---|---|
$().button('toggle') |
Переключает состояние нажатия. Создает впечатление, что кнопка активирована. |
$().button('dispose') |
Уничтожает кнопку элемента. |