Примери и насоки за използване на стилове за управление на формуляри, опции за оформление и потребителски компоненти за създаване на голямо разнообразие от формуляри.
Преглед
Контролите за формуляри на Bootstrap разширяват нашите рестартирани стилове на формуляри с класове. Използвайте тези класове, за да изберете техните персонализирани дисплеи за по-последователно изобразяване в браузъри и устройства.
Уверете се, че използвате подходящ typeатрибут за всички входове (напр. emailза имейл адрес или numberза цифрова информация), за да се възползвате от по-новите контроли за въвеждане като потвърждение на имейл, избор на номер и др.
Ето бърз пример за демонстриране на стиловете на формуляри на Bootstrap. Продължавайте да четете за документация относно необходимите класове, оформление на формуляр и др.
Контроли на формуляра
Текстовите контроли на формата - като <input>s, <select>s и <textarea>s - са стилизирани с .form-controlкласа. Включени са стилове за общ външен вид, състояние на фокус, оразмеряване и др.
Не пропускайте да проучите нашите персонализирани форми за допълнително стилизиране <select>.
За въвеждане на файлове разменете .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 са братски елементи, за разлика от <input>вътре в <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 в рамките на .rowили .form-row. Те ще разделят наличната ширина поравно между тях. Можете също така да изберете подмножество от вашите колони, които да заемат повече или по-малко място, докато останалите .cols поравно разделят останалите, със специфични класове колони като .col-7.
Автоматично оразмеряване
Примерът по-долу използва помощна програма flexbox за вертикално центриране на съдържанието и промени .col, .col-autoтака че вашите колони да заемат толкова място, колкото е необходимо. Казано по друг начин, колоната се оразмерява сама според съдържанието.
След това можете да го смесите отново със специфични за размера класове колони.
Използвайте .form-inlineкласа, за да покажете поредица от етикети, контроли на формуляри и бутони на един хоризонтален ред. Контролите на формуляри във вградените формуляри се различават леко от техните състояния по подразбиране.
Контролите са display: flex, свивайки всяко празно пространство в HTML и ви позволявайки да осигурите контрол на подравняването с помощни програми за интервали и flexbox .
Контролите и групите за въвеждане получават width: auto, за да заменят настройките по подразбиране на Bootstrap width: 100%.
Контролите се появяват вградени само в екранни прозорци, които са широки най-малко 576 пиксела, за да се вземат предвид тесните екранни прозорци на мобилни устройства.
Може да се наложи ръчно да се обърнете към ширината и подравняването на отделните контроли на формуляра с помощта на помощни програми за интервали (както е показано по-долу). И накрая, не забравяйте винаги да включвате <label>с всяка контрола на формуляра, дори ако трябва да го скриете от посетители, които не използват екранни четци с .sr-only.
Поддържат се и персонализирани контроли на формуляри и избори.
Алтернативи на скритите етикети
Помощните технологии като екранни четци ще имат проблеми с вашите формуляри, ако не включите етикет за всеки вход. За тези вградени формуляри можете да скриете етикетите с помощта на .sr-onlyкласа. Има допълнителни алтернативни методи за предоставяне на етикет за помощни технологии, като aria-labelатрибута или aria-labelledby. titleАко нито един от тях не е налице, помощните технологии могат да прибегнат до използването на placeholderатрибута, ако има такъв, но имайте предвид, че placeholderне се препоръчва използването на като заместител на други методи за етикетиране.
Помощен текст
Помощен текст на ниво блок във формуляри може да бъде създаден с помощта на .form-text(преди известно като .help-blockv3). Вграденият помощен текст може да бъде гъвкаво внедрен с помощта на всеки вграден HTML елемент и помощни класове като .text-muted.
Свързване на помощен текст с контроли на формуляр
Помощният текст трябва да бъде изрично свързан с контролата на формуляра, към която се отнася с помощта на aria-describedbyатрибута. Това ще гарантира, че помощните технологии - като екранни четци - ще обявят този помощен текст, когато потребителят фокусира или влезе в контрола.
Помощният текст под входовете може да бъде стилизиран с .form-text. Този клас включва display: blockи добавя малко горно поле за лесно разделяне от входовете по-горе.
Вашата парола трябва да е с дължина 8-20 знака, да съдържа букви и цифри и не трябва да съдържа интервали, специални знаци или емотикони.
Вграденият текст може да използва всеки типичен вграден HTML елемент (било то <small>, <span>, или нещо друго) с нищо повече от полезен клас.
Форми с увреждания
Добавете disabledбулевия атрибут към вход, за да предотвратите потребителски взаимодействия и да го направите да изглежда по-лек.
Добавете disabledатрибута към a, <fieldset>за да деактивирате всички контроли в него.
Предупреждение с котви
По подразбиране браузърите ще третират всички собствени контроли на формуляри ( <input>, <select>и <button>елементи) вътре <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, не можем (понастоящем) да прилагаме стилове към a <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 с .form-control(включително до един .form-controlвъв входни групи)
<select>s с .form-controlили.custom-select
.form-checkс
.custom-checkboxs и .custom-radios
.custom-file
Подсказки
Ако оформлението на вашия формуляр го позволява, можете да размените .{valid|invalid}-feedbackкласовете с .{valid|invalid}-tooltipкласове, за да покажете обратна връзка за валидиране в стилизирана подсказка. Уверете се, че имате родител с position: relativeнего за позициониране на подсказка. В примера по-долу нашите класове колони вече имат това, но вашият проект може да изисква алтернативна настройка.
Персонализиране
Състоянията на валидиране могат да бъдат персонализирани чрез Sass с $form-validation-statesкартата. Разположена в нашия _variables.scssфайл, тази карта на Sass се преобръща, за да генерира състоянията по подразбиране valid/ invalidвалидиране. Включена е вложена карта за персонализиране на цвета и иконата на всяко състояние. Докато никакви други състояния не се поддържат от браузърите, тези, които използват персонализирани стилове, могат лесно да добавят по-сложна обратна връзка за формуляри.
Моля, обърнете внимание, че не препоръчваме да персонализирате тези стойности, без също да модифицирате form-validation-statemixin.
Персонализирани формуляри
За още повече персонализиране и последователност между браузърите, използвайте нашите напълно персонализирани елементи на формуляр, за да замените настройките по подразбиране на браузъра. Те са изградени върху семантично и достъпно маркиране, така че са стабилни заместители на всяка контрола на формуляр по подразбиране.
Отметки и радиостанции
Всяко квадратче за отметка, радио <input>и <label>сдвояване е обвито в, за <div>да създадем нашия персонализиран контрол. Структурно, това е същият подход като нашия по подразбиране .form-check.
Ние използваме селектора за брат или сестра ( ~) за всички наши <input>състояния, например, :checkedза да стилизираме правилно нашия потребителски индикатор за форма. Когато се комбинира с .custom-control-labelкласа, можем също да стилизираме текста за всеки елемент въз основа на <input>състоянието на 's.
Скриваме по подразбиране <input>с opacityи използваме, за .custom-control-labelда изградим нов персонализиран индикатор за формуляр на негово място с ::beforeи ::after. За съжаление не можем да създадем персонализиран такъв само от, <input>защото CSS contentне работи върху този елемент.
В отметнатите състояния използваме base64 вградени SVG икони от Open Iconic . Това ни осигурява най-добрия контрол за стилизиране и позициониране в браузъри и устройства.
Квадратчета за отметка
Персонализираните квадратчета за отметка също могат да използват :indeterminateпсевдокласа, когато са зададени ръчно чрез JavaScript (няма наличен HTML атрибут за указването му).
Ако използвате jQuery, нещо като това трябва да е достатъчно:
Радиостанции
В редица
хора с увреждания
Персонализирани квадратчета за отметка и радиостанции също могат да бъдат деактивирани. Добавете disabledбулевия атрибут към <input>и потребителският индикатор и описанието на етикета ще бъдат автоматично стилизирани.
Превключватели
Превключвателят има маркирането на персонализирано квадратче за отметка, но използва .custom-switchкласа, за да рендира превключвател. Превключвателите също поддържат disabledатрибута.
Изберете меню
Персонализираните <select>менюта се нуждаят само от персонализиран клас, .custom-selectза да задействат персонализираните стилове. Персонализираните стилове са ограничени до <select>първоначалния външен вид на s и не могат да променят <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>елемента или Content-LanguageHTTP заглавката , наред с други методи.
Превод или персонализиране на низовете с HTML
Bootstrap също така предоставя начин за превод на текста „Преглед“ в HTML с data-browseатрибута, който може да бъде добавен към персонализирания входен етикет (пример на холандски):