Примеры и рекомендации по использованию стилей управления формами, параметров макета и пользовательских компонентов для создания самых разнообразных форм.
Обзор
Элементы управления формы Bootstrap расширяют наши стили формы Rebooted с классами. Используйте эти классы, чтобы использовать их настраиваемые дисплеи для более согласованного рендеринга в браузерах и на устройствах.
Обязательно используйте соответствующий typeатрибут для всех входных данных (например, emailдля адреса электронной почты или numberчисловой информации), чтобы воспользоваться преимуществами новых элементов управления вводом, таких как проверка электронной почты, выбор номера и т. д.
Вот краткий пример для демонстрации стилей форм Bootstrap. Продолжайте читать документацию по необходимым классам, макету формы и т. д.
Элементы управления формой
Элементы управления текстовыми формами, такие как <input>s, <select>s и <textarea>s, стилизованы вместе с .form-controlклассом. Включены стили для общего вида, состояния фокуса, размеров и т. д.
Для файловых входов замените .form-controlдля .form-control-file.
Размеры
Установите высоту, используя такие классы, как .form-control-lgи .form-control-sm.
Только для чтения
Добавьте readonlyлогический атрибут на вход, чтобы предотвратить изменение значения входа. Вводы только для чтения выглядят светлее (точно так же, как отключенные вводы), но сохраняют стандартный курсор.
Простой текст только для чтения
Если вы хотите, чтобы <input readonly>элементы в вашей форме были оформлены как обычный текст, используйте .form-control-plaintextкласс, чтобы удалить стиль поля формы по умолчанию и сохранить правильные поля и отступы.
Входы диапазона
Установите горизонтально прокручиваемые входы диапазона, используя .form-control-range.
Флажки и радио
Флажки и переключатели по умолчанию улучшены с помощью .form-checkединого класса для обоих типов ввода, который улучшает макет и поведение их HTML-элементов . Флажки предназначены для выбора одного или нескольких параметров в списке, а переключатели предназначены для выбора одного параметра из многих.
Отключенные флажки и радио поддерживаются. Атрибут disabledприменит более светлый цвет, чтобы указать состояние ввода.
Флажки и переключатели поддерживают проверку формы на основе HTML и предоставляют краткие и доступные метки. Таким образом, наши <input>s и <label>s являются родственными элементами, в отличие от an <input>внутри a <label>. Это немного более подробно, так как вы должны указать idи forатрибуты, чтобы связать <input>и <label>.
По умолчанию (с накоплением)
По умолчанию любое количество флажков и радиостанций, которые являются непосредственными родственными элементами, будут располагаться вертикально друг над другом и располагаться на соответствующем расстоянии друг от друга с помощью .form-check.
В соответствии
Сгруппируйте флажки или переключатели в одной горизонтальной строке, добавив .form-check-inlineв любой файл .form-check.
Без этикеток
Добавить .position-staticк входам внутри .form-check, которые не имеют текста метки. Не забудьте по-прежнему предоставлять какую-либо метку для вспомогательных технологий (например, с помощью aria-label).
Макет
Поскольку Bootstrap применяется display: blockпочти width: 100%ко всем нашим элементам управления формами, формы по умолчанию располагаются вертикально. Дополнительные классы могут использоваться для изменения этого макета в зависимости от формы.
Группы форм
Класс .form-group— это самый простой способ добавить некоторую структуру формам. Он предоставляет гибкий класс, который способствует правильной группировке меток, элементов управления, дополнительного текста справки и сообщений проверки формы. По умолчанию применяется только margin-bottom, но при необходимости он подбирает дополнительные стили .form-inline. Используйте его с <fieldset>s, <div>s или почти с любым другим элементом.
Сетка формы
С помощью наших классов сетки можно создавать более сложные формы. Используйте их для макетов форм, которые требуют нескольких столбцов, различной ширины и дополнительных параметров выравнивания.
Строка формы
Вы также можете заменить .rowна .form-row, вариант нашей стандартной строки сетки, которая переопределяет поля столбцов по умолчанию для более узких и компактных макетов.
Более сложные макеты также могут быть созданы с помощью системы сетки.
Горизонтальная форма
Создавайте горизонтальные формы с сеткой, добавляя .rowкласс в группы форм и используя .col-*-*классы для указания ширины ваших меток и элементов управления. Не забудьте также добавить .col-form-labelк своим <label>s, чтобы они были вертикально центрированы с соответствующими элементами управления формой.
Иногда вам, возможно, придется использовать утилиты полей или отступов, чтобы создать идеальное выравнивание, которое вам нужно. Например, мы удалили padding-topметку на нашей многоуровневой радиовходной метке, чтобы лучше выровнять базовую линию текста.
Размер этикетки горизонтальной формы
Обязательно используйте .col-form-label-smили .col-form-label-lgдля ваших <label>s или <legend>s, чтобы правильно следовать размеру .form-control-lgи .form-control-sm.
Размер столбца
Как показано в предыдущих примерах, наша система сетки позволяет размещать любое количество .cols в пределах a .rowили .form-row. Они разделят доступную ширину поровну между собой. Вы также можете выбрать подмножество ваших столбцов, чтобы они занимали больше или меньше места, в то время как оставшиеся .cols поровну делят остальные с определенными классами столбцов, такими как .col-7.
Автоматический размер
В приведенном ниже примере используется утилита flexbox для вертикального центрирования содержимого и изменений .col, чтобы .col-autoваши столбцы занимали ровно столько места, сколько необходимо. Другими словами, размер столбца зависит от содержимого.
Затем вы можете снова смешать это с классами столбцов, зависящими от размера.
Используйте .form-inlineкласс для отображения набора меток, элементов управления формы и кнопок в одной горизонтальной строке. Элементы управления формы во встроенных формах немного отличаются от их состояний по умолчанию.
К элементам управления относятся display: flex, сворачивающие любые пробелы HTML и позволяющие вам обеспечить контроль выравнивания с помощью утилит spacing и flexbox .
Элементы управления и группы ввода получают width: autoпереопределение значения Bootstrap по умолчанию width: 100%.
Элементы управления отображаются встроенными только в окнах просмотра шириной не менее 576 пикселей, чтобы учесть узкие окна просмотра на мобильных устройствах.
Возможно, вам придется вручную настроить ширину и выравнивание отдельных элементов управления формы с помощью утилит для установки интервалов (как показано ниже). Наконец, обязательно всегда добавляйте a <label>к каждому элементу управления формой, даже если вам нужно скрыть его от посетителей, не использующих программы чтения с экрана, с помощью .sr-only.
Также поддерживаются настраиваемые элементы управления и выборки форм.
Альтернативы скрытым ярлыкам
Вспомогательные технологии, такие как программы чтения с экрана, будут иметь проблемы с вашими формами, если вы не включите метку для каждого ввода. Для этих встроенных форм вы можете скрыть метки с помощью .sr-onlyкласса. Существуют дополнительные альтернативные методы предоставления метки для вспомогательных технологий, такие как атрибут aria-label, aria-labelledbyили . titleЕсли ни один из них не присутствует, вспомогательные технологии могут прибегнуть к использованию placeholderатрибута, если он присутствует, но обратите внимание, что использование placeholderвместо других методов маркировки не рекомендуется.
Текст справки
Текст справки на уровне блоков в формах может быть создан с помощью .form-text(ранее известного как .help-blockв версии 3). Встроенный текст справки может быть гибко реализован с использованием любого встроенного HTML-элемента и служебных классов, таких как .text-muted.
Связывание текста справки с элементами управления формы
Текст справки должен быть явно связан с элементом управления формы, к которому он относится с помощью aria-describedbyатрибута. Это гарантирует, что вспомогательные технологии, такие как программы чтения с экрана, будут объявлять этот текст справки, когда пользователь фокусируется или вводит элемент управления.
Текст справки под входными данными может быть оформлен с помощью .form-text. Этот класс включает display: blockи добавляет некоторое верхнее поле для легкого отступа от входных данных выше.
Ваш пароль должен состоять из 8-20 символов, содержать буквы и цифры и не должен содержать пробелов, специальных символов или эмодзи.
Встроенный текст может использовать любой типичный встроенный элемент HTML (будь то <small>, <span>или что-то еще) с не чем иным, как служебным классом.
Отключенные формы
Добавьте disabledлогический атрибут для ввода, чтобы предотвратить взаимодействие с пользователем и сделать его более легким.
Добавьте disabledатрибут в a, <fieldset>чтобы отключить все элементы управления внутри.
Предостережение с якорями
По умолчанию браузеры будут рассматривать все собственные элементы управления формы ( <input>и <select>элементы <button>) внутри a <fieldset disabled>как отключенные, предотвращая взаимодействие с ними как с клавиатуры, так и с мышью. Однако, если ваша форма также включает <a ... class="btn btn-*">элементы, им будет присвоен только стиль pointer-events: none. Как отмечалось в разделе об отключенном состоянии кнопок (и, в частности, в подразделе об элементах привязки), это свойство CSS еще не стандартизировано и не полностью поддерживается в Internet Explorer 10, и не будет препятствовать тому, чтобы пользователи клавиатуры в состоянии сфокусировать или активировать эти связи. Поэтому, чтобы быть в безопасности, используйте собственный JavaScript для отключения таких ссылок.
Кроссбраузерная совместимость
Хотя Bootstrap будет применять эти стили во всех браузерах, Internet Explorer 11 и более ранние версии не полностью поддерживают disabledатрибут в файле <fieldset>. Используйте собственный JavaScript, чтобы отключить набор полей в этих браузерах.
Проверка
Предоставляйте своим пользователям ценные и действенные отзывы с помощью проверки формы HTML5, доступной во всех поддерживаемых нами браузерах . Выберите обратную связь по проверке браузера по умолчанию или реализуйте настраиваемые сообщения с помощью наших встроенных классов и начального JavaScript.
В настоящее время мы рекомендуем использовать настраиваемые стили проверки, поскольку собственные сообщения проверки браузера по умолчанию не всегда доступны вспомогательным технологиям во всех браузерах (в первую очередь, в Chrome для настольных компьютеров и мобильных устройств).
Как это работает
Вот как работает проверка формы с Bootstrap:
Проверка формы HTML осуществляется с помощью двух псевдоклассов CSS :invalidи :valid. Это относится к элементам <input>, <select>, и .<textarea>
Bootstrap привязывает стили :invalidи :validк родительскому .was-validatedклассу, обычно применяемому к <form>. В противном случае любое обязательное поле без значения отображается как недействительное при загрузке страницы. Таким образом, вы можете выбрать, когда их активировать (обычно после попытки отправки формы).
Чтобы сбросить внешний вид формы (например, в случае отправки динамических форм с использованием AJAX), удалите .was-validatedкласс <form>снова после отправки.
В качестве запасного варианта можно .is-invalidиспользовать .is-validклассы вместо псевдоклассов для проверки на стороне сервера . Они не требуют .was-validatedродительского класса.
Из-за ограничений в том, как работает CSS, мы не можем (в настоящее время) применять стили к элементу, <label>который находится перед элементом управления формы в DOM, без помощи пользовательского JavaScript.
Все современные браузеры поддерживают API проверки ограничений , набор методов JavaScript для проверки элементов управления формы.
Сообщения обратной связи могут использовать настройки браузера по умолчанию (разные для каждого браузера и не настраиваемые с помощью CSS) или наши пользовательские стили обратной связи с дополнительными HTML и CSS.
Вы можете предоставить настраиваемые сообщения о достоверности setCustomValidityв JavaScript.
Имея это в виду, рассмотрите следующие демонстрации для наших пользовательских стилей проверки формы, дополнительных классов на стороне сервера и значений по умолчанию для браузера.
Пользовательские стили
Для настраиваемых сообщений проверки формы Bootstrap вам необходимо добавить novalidateлогический атрибут в файл <form>. Это отключает всплывающие подсказки браузера по умолчанию, но по-прежнему предоставляет доступ к API проверки формы в JavaScript. Попробуйте отправить форму ниже; наш JavaScript перехватит кнопку отправки и передаст вам отзыв. При попытке отправки вы увидите стили :invalidи , примененные к элементам управления формы.:valid
Пользовательские стили отзывов применяют настраиваемые цвета, границы, стили фокуса и фоновые значки, чтобы лучше передавать отзывы. Фоновые значки для <select>s доступны только с .custom-select, но не с .form-control.
Браузер по умолчанию
Не заинтересованы в настраиваемых сообщениях обратной связи проверки или написании JavaScript для изменения поведения формы? Все хорошо, вы можете использовать настройки браузера по умолчанию. Попробуйте отправить форму ниже. В зависимости от вашего браузера и ОС вы увидите немного другой стиль обратной связи.
Хотя эти стили обратной связи нельзя настроить с помощью CSS, вы все равно можете настроить текст обратной связи с помощью JavaScript.
Сторона сервера
Мы рекомендуем использовать проверку на стороне клиента, но если вам требуется проверка на стороне сервера, вы можете указать недопустимые и действительные поля формы с помощью .is-invalidи .is-valid. Обратите внимание, что .invalid-feedbackэто также поддерживается этими классами.
Поддерживаемые элементы
Стили проверки доступны для следующих элементов управления и компонентов формы:
<input>s и <textarea>s with .form-control(в том числе до одного .form-controlв входных группах)
<select>с .form-controlили.custom-select
.form-checkс
.custom-checkboxс и .custom-radioс
.custom-file
Подсказки
Если ваш макет формы позволяет это, вы можете поменять местами .{valid|invalid}-feedbackклассы для .{valid|invalid}-tooltipклассов, чтобы отобразить обратную связь проверки в стилизованной всплывающей подсказке. Убедитесь, что на нем есть родитель position: relativeдля позиционирования всплывающей подсказки. В приведенном ниже примере это уже есть в наших классах столбцов, но для вашего проекта может потребоваться альтернативная настройка.
Настройка
Состояния проверки можно настроить с помощью Sass с $form-validation-statesкартой. _variables.scssЭта карта Sass, расположенная в нашем файле, зациклена для генерации состояний по умолчанию valid/ invalidпроверки. Включена вложенная карта для настройки цвета и значка каждого состояния. Хотя никакие другие состояния не поддерживаются браузерами, те, кто использует пользовательские стили, могут легко добавлять более сложные формы обратной связи.
Обратите внимание, что мы не рекомендуем настраивать эти значения без изменения form-validation-stateмиксина.
Пользовательские формы
Для еще большей настройки и согласованности в разных браузерах используйте наши полностью настраиваемые элементы формы для замены элементов браузера по умолчанию. Они построены на основе семантической и доступной разметки, поэтому они являются надежной заменой любому элементу управления формой по умолчанию.
Флажки и радио
Каждый флажок, радио <input>и <label>сопряжение завернуты в <div>для создания нашего пользовательского элемента управления. Структурно это тот же подход, что и у нас по умолчанию .form-check.
Мы используем родственный селектор ( ~) для всех наших <input>состояний, например, для :checkedправильного оформления нашего пользовательского индикатора формы. В сочетании с .custom-control-labelклассом мы также можем стилизовать текст для каждого элемента в зависимости от <input>состояния.
Мы скрываем значение по умолчанию <input>с помощью opacityи используем .custom-control-labelдля создания нового пользовательского индикатора формы на его месте с помощью ::beforeи ::after. К сожалению, мы не можем создать пользовательский элемент только из элемента, <input>потому что CSS contentне работает с этим элементом.
В проверенных состояниях мы используем встроенные SVG-иконки base64 из Open Iconic . Это дает нам лучший контроль над стилем и позиционированием в браузерах и на разных устройствах.
Флажки
Пользовательские флажки также могут использовать :indeterminateпсевдокласс, если он установлен вручную с помощью JavaScript (нет доступного HTML-атрибута для его указания).
Если вы используете jQuery, должно хватить чего-то вроде этого:
Радио
В соответствии
Неполноценный
Пользовательские флажки и радио также можно отключить. Добавьте disabledлогический атрибут к , <input>и пользовательский индикатор и описание метки будут автоматически оформлены.
Переключатели
Переключатель имеет разметку пользовательского флажка, но использует .custom-switchкласс для отображения переключателя. Коммутаторы также поддерживают этот disabledатрибут.
Выберите меню
Пользовательским <select>меню нужен только пользовательский класс, .custom-selectчтобы активировать пользовательские стили. Пользовательские стили ограничены <select>первоначальным внешним видом и не могут изменять <option>s из-за ограничений браузера.
Вы также можете выбирать из маленьких и больших пользовательских вариантов, чтобы они соответствовали нашим текстовым вводам аналогичного размера.
Атрибут multipleтакже поддерживается:
Как и sizeатрибут:
Диапазон
Создавайте собственные <input type="range">элементы управления с помощью .custom-range. Трек (фон) и миниатюра (значение) имеют одинаковый стиль в разных браузерах. Поскольку только IE и Firefox поддерживают «заполнение» своей дорожки слева или справа от бегунка в качестве средства визуального обозначения прогресса, мы в настоящее время не поддерживаем его.
Входные параметры диапазона имеют неявные значения для minи max— 0и 100соответственно. Вы можете указать новые значения для тех, кто использует атрибуты minи .max
По умолчанию входные данные диапазона «привязываются» к целочисленным значениям. Чтобы изменить это, вы можете указать stepзначение. В приведенном ниже примере мы удваиваем количество шагов, используя step="0.5".
Файловый браузер
Рекомендуемый плагин для анимации ввода пользовательского файла: bs-custom-file-input , это то, что мы используем в настоящее время здесь, в наших документах.
Ввод файла является самым грубым из всех и требует дополнительного JavaScript, если вы хотите связать их с функциональностью « Выбрать файл… » и выбранным текстом имени файла.
Мы скрываем файл по умолчанию <input>через opacityи вместо этого стилизуем файл <label>. Кнопка генерируется и позиционируется с помощью ::after. Наконец, мы объявляем widthи heightдля <input>правильного интервала для окружающего контента.
Перевод или настройка строк с помощью SCSS
:lang()Псевдокласс используется для перевода текста «Обзор» на другие языки . Переопределите или добавьте записи в $custom-file-textпеременную Sass с соответствующим языковым тегом и локализованными строками. Английские строки можно настроить таким же образом. Например, вот как можно добавить испанский перевод (код испанского языка: es):
Вот lang(es)в действии пользовательский ввод файла для испанского перевода:
Вам нужно будет правильно установить язык вашего документа (или его поддерева), чтобы отображался правильный текст. Это можно сделать с помощью атрибута элемента langили<html> HTTP- Content-Languageзаголовка среди других методов.
Перевод или настройка строк с помощью HTML
Bootstrap также предоставляет способ перевода текста «Обзор» в HTML с помощью data-browseатрибута, который можно добавить к пользовательской метке ввода (пример на голландском языке):