Source

Форми

Примери и насоки за използване на стилове за управление на формуляри, опции за оформление и потребителски компоненти за създаване на голямо разнообразие от формуляри.

Преглед

Контролите за формуляри на Bootstrap разширяват нашите рестартирани стилове на формуляри с класове. Използвайте тези класове, за да изберете техните персонализирани дисплеи за по-последователно изобразяване в браузъри и устройства.

Уверете се, че използвате подходящ typeатрибут за всички входове (напр. emailза имейл адрес или numberза цифрова информация), за да се възползвате от по-новите контроли за въвеждане като потвърждение на имейл, избор на номер и др.

Ето бърз пример за демонстриране на стиловете на формуляри на Bootstrap. Продължавайте да четете за документация относно необходимите класове, оформление на формуляр и др.

Никога няма да споделяме вашия имейл с никой друг.
<form>
  <div class="form-group">
    <label for="exampleInputEmail1">Email address</label>
    <input type="email" class="form-control" id="exampleInputEmail1" aria-describedby="emailHelp" placeholder="Enter email">
    <small id="emailHelp" class="form-text text-muted">We'll never share your email with anyone else.</small>
  </div>
  <div class="form-group">
    <label for="exampleInputPassword1">Password</label>
    <input type="password" class="form-control" id="exampleInputPassword1" placeholder="Password">
  </div>
  <div class="form-check">
    <input type="checkbox" class="form-check-input" id="exampleCheck1">
    <label class="form-check-label" for="exampleCheck1">Check me out</label>
  </div>
  <button type="submit" class="btn btn-primary">Submit</button>
</form>

Контроли на формуляра

Текстовите контроли на формата - като <input>s, <select>s и <textarea>s - са стилизирани с .form-controlкласа. Включени са стилове за общ външен вид, състояние на фокус, оразмеряване и др.

Не пропускайте да проучите нашите персонализирани форми за допълнително стилизиране <select>.

<form>
  <div class="form-group">
    <label for="exampleFormControlInput1">Email address</label>
    <input type="email" class="form-control" id="exampleFormControlInput1" placeholder="[email protected]">
  </div>
  <div class="form-group">
    <label for="exampleFormControlSelect1">Example select</label>
    <select class="form-control" id="exampleFormControlSelect1">
      <option>1</option>
      <option>2</option>
      <option>3</option>
      <option>4</option>
      <option>5</option>
    </select>
  </div>
  <div class="form-group">
    <label for="exampleFormControlSelect2">Example multiple select</label>
    <select multiple class="form-control" id="exampleFormControlSelect2">
      <option>1</option>
      <option>2</option>
      <option>3</option>
      <option>4</option>
      <option>5</option>
    </select>
  </div>
  <div class="form-group">
    <label for="exampleFormControlTextarea1">Example textarea</label>
    <textarea class="form-control" id="exampleFormControlTextarea1" rows="3"></textarea>
  </div>
</form>

За въвеждане на файлове разменете .form-controlза .form-control-file.

<form>
  <div class="form-group">
    <label for="exampleFormControlFile1">Example file input</label>
    <input type="file" class="form-control-file" id="exampleFormControlFile1">
  </div>
</form>

Оразмеряване

Задайте височини, като използвате класове като .form-control-lgи .form-control-sm.

<input class="form-control form-control-lg" type="text" placeholder=".form-control-lg">
<input class="form-control" type="text" placeholder="Default input">
<input class="form-control form-control-sm" type="text" placeholder=".form-control-sm">
<select class="form-control form-control-lg">
  <option>Large select</option>
</select>
<select class="form-control">
  <option>Default select</option>
</select>
<select class="form-control form-control-sm">
  <option>Small select</option>
</select>

Само за четене

Добавете readonlyбулевия атрибут към вход, за да предотвратите промяна на стойността на входа. Входовете само за четене изглеждат по-леки (точно като деактивираните входове), но запазват стандартния курсор.

<input class="form-control" type="text" placeholder="Readonly input here…" readonly>

Обикновен текст само за четене

Ако искате да имате <input readonly>елементи във вашия формуляр, оформени като обикновен текст, използвайте .form-control-plaintextкласа, за да премахнете стила на полето на формуляра по подразбиране и да запазите правилното поле и подложка.

<form>
  <div class="form-group row">
    <label for="staticEmail" class="col-sm-2 col-form-label">Email</label>
    <div class="col-sm-10">
      <input type="text" readonly class="form-control-plaintext" id="staticEmail" value="[email protected]">
    </div>
  </div>
  <div class="form-group row">
    <label for="inputPassword" class="col-sm-2 col-form-label">Password</label>
    <div class="col-sm-10">
      <input type="password" class="form-control" id="inputPassword" placeholder="Password">
    </div>
  </div>
</form>
<form class="form-inline">
  <div class="form-group mb-2">
    <label for="staticEmail2" class="sr-only">Email</label>
    <input type="text" readonly class="form-control-plaintext" id="staticEmail2" value="[email protected]">
  </div>
  <div class="form-group mx-sm-3 mb-2">
    <label for="inputPassword2" class="sr-only">Password</label>
    <input type="password" class="form-control" id="inputPassword2" placeholder="Password">
  </div>
  <button type="submit" class="btn btn-primary mb-2">Confirm identity</button>
</form>

Отметки и радиостанции

Квадратчетата по подразбиране и радиостанциите са подобрени с помощта на .form-checkедин клас за двата типа вход, който подобрява оформлението и поведението на техните HTML елементи . Квадратчетата за отметка са за избиране на една или няколко опции в списък, докато радиостанциите са за избиране на една опция от много.

Поддържат се деактивирани квадратчета за отметка и радиостанции, но за да осигурите not-allowedкурсор при задържане на родителския елемент <label>, ще трябва да добавите disabledатрибута към .form-check-input. Атрибутът disabled ще приложи по-светъл цвят, за да покаже състоянието на входа.

Квадратчетата за отметка и използването на радиостанции са създадени, за да поддържат HTML базирано валидиране на формуляри и да предоставят кратки, достъпни етикети. Като такива, нашите <input>s и <label>s са братски елементи, за разлика от <input>вътре в <label>. Това е малко по-подробно, тъй като трябва да посочите idи forатрибути, за да свържете <input>и <label>.

По подразбиране (подредени)

По подразбиране произволен брой квадратчета за отметка и радиостанции, които са непосредствени роднини, ще бъдат вертикално подредени и разположени на подходящо разстояние с .form-check.

<div class="form-check">
  <input class="form-check-input" type="checkbox" value="" id="defaultCheck1">
  <label class="form-check-label" for="defaultCheck1">
    Default checkbox
  </label>
</div>
<div class="form-check">
  <input class="form-check-input" type="checkbox" value="" id="defaultCheck2" disabled>
  <label class="form-check-label" for="defaultCheck2">
    Disabled checkbox
  </label>
</div>
<div class="form-check">
  <input class="form-check-input" type="radio" name="exampleRadios" id="exampleRadios1" value="option1" checked>
  <label class="form-check-label" for="exampleRadios1">
    Default radio
  </label>
</div>
<div class="form-check">
  <input class="form-check-input" type="radio" name="exampleRadios" id="exampleRadios2" value="option2">
  <label class="form-check-label" for="exampleRadios2">
    Second default radio
  </label>
</div>
<div class="form-check disabled">
  <input class="form-check-input" type="radio" name="exampleRadios" id="exampleRadios3" value="option3" disabled>
  <label class="form-check-label" for="exampleRadios3">
    Disabled radio
  </label>
</div>

В редица

Групирайте квадратчета за отметка или радиостанции на един и същи хоризонтален ред, като добавите .form-check-inlineкъм всеки .form-check.

<div class="form-check form-check-inline">
  <input class="form-check-input" type="checkbox" id="inlineCheckbox1" value="option1">
  <label class="form-check-label" for="inlineCheckbox1">1</label>
</div>
<div class="form-check form-check-inline">
  <input class="form-check-input" type="checkbox" id="inlineCheckbox2" value="option2">
  <label class="form-check-label" for="inlineCheckbox2">2</label>
</div>
<div class="form-check form-check-inline">
  <input class="form-check-input" type="checkbox" id="inlineCheckbox3" value="option3" disabled>
  <label class="form-check-label" for="inlineCheckbox3">3 (disabled)</label>
</div>
<div class="form-check form-check-inline">
  <input class="form-check-input" type="radio" name="inlineRadioOptions" id="inlineRadio1" value="option1">
  <label class="form-check-label" for="inlineRadio1">1</label>
</div>
<div class="form-check form-check-inline">
  <input class="form-check-input" type="radio" name="inlineRadioOptions" id="inlineRadio2" value="option2">
  <label class="form-check-label" for="inlineRadio2">2</label>
</div>
<div class="form-check form-check-inline">
  <input class="form-check-input" type="radio" name="inlineRadioOptions" id="inlineRadio3" value="option3" disabled>
  <label class="form-check-label" for="inlineRadio3">3 (disabled)</label>
</div>

Без етикети

Добавете .position-staticкъм входове в рамките .form-check, които нямат текст на етикета. Не забравяйте да предоставите някаква форма на етикет за помощни технологии (например използване на aria-label).

<div class="form-check">
  <input class="form-check-input position-static" type="checkbox" id="blankCheckbox" value="option1" aria-label="...">
</div>
<div class="form-check">
  <input class="form-check-input position-static" type="radio" name="blankRadio" id="blankRadio1" value="option1" aria-label="...">
</div>

Оформление

Тъй като Bootstrap се прилага display: blockкъм width: 100%почти всички наши контроли за формуляри, формулярите по подразбиране ще се подреждат вертикално. Допълнителни класове могат да се използват за промяна на това оформление на базата на всеки формуляр.

Формирайте групи

Класът .form-groupе най-лесният начин да добавите някаква структура към формулярите. Той предоставя гъвкав клас, който насърчава правилното групиране на етикети, контроли, незадължителен помощен текст и съобщения за валидиране на формуляр. По подразбиране се прилага само margin-bottom, но избира допълнителни стилове, .form-inlineако е необходимо. Използвайте го с <fieldset>s, <div>s или почти всеки друг елемент.

<form>
  <div class="form-group">
    <label for="formGroupExampleInput">Example label</label>
    <input type="text" class="form-control" id="formGroupExampleInput" placeholder="Example input">
  </div>
  <div class="form-group">
    <label for="formGroupExampleInput2">Another label</label>
    <input type="text" class="form-control" id="formGroupExampleInput2" placeholder="Another input">
  </div>
</form>

Решетка на формата

По-сложни форми могат да бъдат изградени с помощта на нашите класове от мрежи. Използвайте ги за оформления на формуляри, които изискват множество колони, различни ширини и допълнителни опции за подравняване.

<form>
  <div class="row">
    <div class="col">
      <input type="text" class="form-control" placeholder="First name">
    </div>
    <div class="col">
      <input type="text" class="form-control" placeholder="Last name">
    </div>
  </div>
</form>

Формуляр ред

Можете също така да замените .rowс .form-row, вариант на нашия стандартен мрежов ред, който замества улуците на колоните по подразбиране за по-стегнати и по-компактни оформления.

<form>
  <div class="form-row">
    <div class="col">
      <input type="text" class="form-control" placeholder="First name">
    </div>
    <div class="col">
      <input type="text" class="form-control" placeholder="Last name">
    </div>
  </div>
</form>

С мрежовата система могат да се създават и по-сложни оформления.

<form>
  <div class="form-row">
    <div class="form-group col-md-6">
      <label for="inputEmail4">Email</label>
      <input type="email" class="form-control" id="inputEmail4" placeholder="Email">
    </div>
    <div class="form-group col-md-6">
      <label for="inputPassword4">Password</label>
      <input type="password" class="form-control" id="inputPassword4" placeholder="Password">
    </div>
  </div>
  <div class="form-group">
    <label for="inputAddress">Address</label>
    <input type="text" class="form-control" id="inputAddress" placeholder="1234 Main St">
  </div>
  <div class="form-group">
    <label for="inputAddress2">Address 2</label>
    <input type="text" class="form-control" id="inputAddress2" placeholder="Apartment, studio, or floor">
  </div>
  <div class="form-row">
    <div class="form-group col-md-6">
      <label for="inputCity">City</label>
      <input type="text" class="form-control" id="inputCity">
    </div>
    <div class="form-group col-md-4">
      <label for="inputState">State</label>
      <select id="inputState" class="form-control">
        <option selected>Choose...</option>
        <option>...</option>
      </select>
    </div>
    <div class="form-group col-md-2">
      <label for="inputZip">Zip</label>
      <input type="text" class="form-control" id="inputZip">
    </div>
  </div>
  <div class="form-group">
    <div class="form-check">
      <input class="form-check-input" type="checkbox" id="gridCheck">
      <label class="form-check-label" for="gridCheck">
        Check me out
      </label>
    </div>
  </div>
  <button type="submit" class="btn btn-primary">Sign in</button>
</form>

Хоризонтална форма

Създавайте хоризонтални форми с решетката, като добавяте .rowкласа към формиращи групи и използвате .col-*-*класовете, за да укажете ширината на вашите етикети и контроли. Не забравяйте да добавите .col-form-labelи към вашите <label>s, така че да са вертикално центрирани със свързаните с тях контроли на формуляра.

Понякога може да се наложи да използвате помощни програми за маржове или подложки, за да създадете това перфектно подравняване, от което се нуждаете. Например премахнахме padding-topетикета на нашите подредени радио входове, за да подравним по-добре базовата линия на текста.

Радиостанции
Квадратче за отметка
<form>
  <div class="form-group row">
    <label for="inputEmail3" class="col-sm-2 col-form-label">Email</label>
    <div class="col-sm-10">
      <input type="email" class="form-control" id="inputEmail3" placeholder="Email">
    </div>
  </div>
  <div class="form-group row">
    <label for="inputPassword3" class="col-sm-2 col-form-label">Password</label>
    <div class="col-sm-10">
      <input type="password" class="form-control" id="inputPassword3" placeholder="Password">
    </div>
  </div>
  <fieldset class="form-group">
    <div class="row">
      <legend class="col-form-label col-sm-2 pt-0">Radios</legend>
      <div class="col-sm-10">
        <div class="form-check">
          <input class="form-check-input" type="radio" name="gridRadios" id="gridRadios1" value="option1" checked>
          <label class="form-check-label" for="gridRadios1">
            First radio
          </label>
        </div>
        <div class="form-check">
          <input class="form-check-input" type="radio" name="gridRadios" id="gridRadios2" value="option2">
          <label class="form-check-label" for="gridRadios2">
            Second radio
          </label>
        </div>
        <div class="form-check disabled">
          <input class="form-check-input" type="radio" name="gridRadios" id="gridRadios3" value="option3" disabled>
          <label class="form-check-label" for="gridRadios3">
            Third disabled radio
          </label>
        </div>
      </div>
    </div>
  </fieldset>
  <div class="form-group row">
    <div class="col-sm-2">Checkbox</div>
    <div class="col-sm-10">
      <div class="form-check">
        <input class="form-check-input" type="checkbox" id="gridCheck1">
        <label class="form-check-label" for="gridCheck1">
          Example checkbox
        </label>
      </div>
    </div>
  </div>
  <div class="form-group row">
    <div class="col-sm-10">
      <button type="submit" class="btn btn-primary">Sign in</button>
    </div>
  </div>
</form>
Оразмеряване на етикета с хоризонтална форма

Не забравяйте да използвате .col-form-label-smили .col-form-label-lgкъм вашите <label>s или <legend>s, за да следвате правилно размера на .form-control-lgи .form-control-sm.

<form>
  <div class="form-group row">
    <label for="colFormLabelSm" class="col-sm-2 col-form-label col-form-label-sm">Email</label>
    <div class="col-sm-10">
      <input type="email" class="form-control form-control-sm" id="colFormLabelSm" placeholder="col-form-label-sm">
    </div>
  </div>
  <div class="form-group row">
    <label for="colFormLabel" class="col-sm-2 col-form-label">Email</label>
    <div class="col-sm-10">
      <input type="email" class="form-control" id="colFormLabel" placeholder="col-form-label">
    </div>
  </div>
  <div class="form-group row">
    <label for="colFormLabelLg" class="col-sm-2 col-form-label col-form-label-lg">Email</label>
    <div class="col-sm-10">
      <input type="email" class="form-control form-control-lg" id="colFormLabelLg" placeholder="col-form-label-lg">
    </div>
  </div>
</form>

Оразмеряване на колони

Както е показано в предишните примери, нашата мрежова система ви позволява да поставите произволен брой .cols в рамките на .rowили .form-row. Те ще разделят наличната ширина поравно между тях. Можете също така да изберете подмножество от вашите колони, които да заемат повече или по-малко място, докато останалите .cols поравно разделят останалите, със специфични класове колони като .col-7.

<form>
  <div class="form-row">
    <div class="col-7">
      <input type="text" class="form-control" placeholder="City">
    </div>
    <div class="col">
      <input type="text" class="form-control" placeholder="State">
    </div>
    <div class="col">
      <input type="text" class="form-control" placeholder="Zip">
    </div>
  </div>
</form>

Автоматично оразмеряване

Примерът по-долу използва помощна програма flexbox за вертикално центриране на съдържанието и промени .col, .col-autoтака че вашите колони да заемат толкова място, колкото е необходимо. Казано по друг начин, колоната се оразмерява сама според съдържанието.

@
<form>
  <div class="form-row align-items-center">
    <div class="col-auto">
      <label class="sr-only" for="inlineFormInput">Name</label>
      <input type="text" class="form-control mb-2" id="inlineFormInput" placeholder="Jane Doe">
    </div>
    <div class="col-auto">
      <label class="sr-only" for="inlineFormInputGroup">Username</label>
      <div class="input-group mb-2">
        <div class="input-group-prepend">
          <div class="input-group-text">@</div>
        </div>
        <input type="text" class="form-control" id="inlineFormInputGroup" placeholder="Username">
      </div>
    </div>
    <div class="col-auto">
      <div class="form-check mb-2">
        <input class="form-check-input" type="checkbox" id="autoSizingCheck">
        <label class="form-check-label" for="autoSizingCheck">
          Remember me
        </label>
      </div>
    </div>
    <div class="col-auto">
      <button type="submit" class="btn btn-primary mb-2">Submit</button>
    </div>
  </div>
</form>

След това можете да го смесите отново със специфични за размера класове колони.

@
<form>
  <div class="form-row align-items-center">
    <div class="col-sm-3 my-1">
      <label class="sr-only" for="inlineFormInputName">Name</label>
      <input type="text" class="form-control" id="inlineFormInputName" placeholder="Jane Doe">
    </div>
    <div class="col-sm-3 my-1">
      <label class="sr-only" for="inlineFormInputGroupUsername">Username</label>
      <div class="input-group">
        <div class="input-group-prepend">
          <div class="input-group-text">@</div>
        </div>
        <input type="text" class="form-control" id="inlineFormInputGroupUsername" placeholder="Username">
      </div>
    </div>
    <div class="col-auto my-1">
      <div class="form-check">
        <input class="form-check-input" type="checkbox" id="autoSizingCheck2">
        <label class="form-check-label" for="autoSizingCheck2">
          Remember me
        </label>
      </div>
    </div>
    <div class="col-auto my-1">
      <button type="submit" class="btn btn-primary">Submit</button>
    </div>
  </div>
</form>

И разбира се поддържат персонализирани контроли на формуляри .

<form>
  <div class="form-row align-items-center">
    <div class="col-auto my-1">
      <label class="mr-sm-2" for="inlineFormCustomSelect">Preference</label>
      <select class="custom-select mr-sm-2" id="inlineFormCustomSelect">
        <option selected>Choose...</option>
        <option value="1">One</option>
        <option value="2">Two</option>
        <option value="3">Three</option>
      </select>
    </div>
    <div class="col-auto my-1">
      <div class="custom-control custom-checkbox mr-sm-2">
        <input type="checkbox" class="custom-control-input" id="customControlAutosizing">
        <label class="custom-control-label" for="customControlAutosizing">Remember my preference</label>
      </div>
    </div>
    <div class="col-auto my-1">
      <button type="submit" class="btn btn-primary">Submit</button>
    </div>
  </div>
</form>

Вградени форми

Използвайте .form-inlineкласа, за да покажете поредица от етикети, контроли на формуляри и бутони на един хоризонтален ред. Контролите на формуляри във вградените формуляри се различават леко от техните състояния по подразбиране.

  • Контролите са display: flex, свивайки всяко празно пространство в HTML и ви позволявайки да осигурите контрол на подравняването с помощни програми за интервали и flexbox .
  • Контролите и групите за въвеждане получават width: auto, за да заменят настройките по подразбиране на Bootstrap width: 100%.
  • Контролите се появяват вградени само в екранни прозорци, които са широки най-малко 576 пиксела, за да се вземат предвид тесните екранни прозорци на мобилни устройства.

Може да се наложи ръчно да се обърнете към ширината и подравняването на отделните контроли на формуляра с помощта на помощни програми за интервали (както е показано по-долу). И накрая, не забравяйте винаги да включвате <label>с всяка контрола на формуляра, дори ако трябва да го скриете от посетители, които не използват екранни четци с .sr-only.

@
<form class="form-inline">
  <label class="sr-only" for="inlineFormInputName2">Name</label>
  <input type="text" class="form-control mb-2 mr-sm-2" id="inlineFormInputName2" placeholder="Jane Doe">

  <label class="sr-only" for="inlineFormInputGroupUsername2">Username</label>
  <div class="input-group mb-2 mr-sm-2">
    <div class="input-group-prepend">
      <div class="input-group-text">@</div>
    </div>
    <input type="text" class="form-control" id="inlineFormInputGroupUsername2" placeholder="Username">
  </div>

  <div class="form-check mb-2 mr-sm-2">
    <input class="form-check-input" type="checkbox" id="inlineFormCheck">
    <label class="form-check-label" for="inlineFormCheck">
      Remember me
    </label>
  </div>

  <button type="submit" class="btn btn-primary mb-2">Submit</button>
</form>

Поддържат се и персонализирани контроли на формуляри и избори.

<form class="form-inline">
  <label class="my-1 mr-2" for="inlineFormCustomSelectPref">Preference</label>
  <select class="custom-select my-1 mr-sm-2" id="inlineFormCustomSelectPref">
    <option selected>Choose...</option>
    <option value="1">One</option>
    <option value="2">Two</option>
    <option value="3">Three</option>
  </select>

  <div class="custom-control custom-checkbox my-1 mr-sm-2">
    <input type="checkbox" class="custom-control-input" id="customControlInline">
    <label class="custom-control-label" for="customControlInline">Remember my preference</label>
  </div>

  <button type="submit" class="btn btn-primary my-1">Submit</button>
</form>
Алтернативи на скритите етикети

Помощните технологии като екранни четци ще имат проблеми с вашите формуляри, ако не включите етикет за всеки вход. За тези вградени формуляри можете да скриете етикетите с помощта на .sr-onlyкласа. Има допълнителни алтернативни методи за предоставяне на етикет за помощни технологии, като aria-labelатрибута или aria-labelledby. titleАко нито един от тях не присъства, помощните технологии могат да прибягнат до използването на placeholderатрибута, ако има такъв, но имайте предвид, че placeholderне се препоръчва използването на като заместител на други методи за етикетиране.

Помощен текст

Помощен текст на ниво блок във формуляри може да бъде създаден с помощта на .form-text(преди известно като .help-blockv3). Вграденият помощен текст може да бъде гъвкаво внедрен с помощта на всеки вграден HTML елемент и помощни класове като .text-muted.

Свързване на помощен текст с контроли на формуляр

Помощният текст трябва да бъде изрично свързан с контролата на формуляра, към която се отнася с помощта на aria-describedbyатрибута. Това ще гарантира, че помощните технологии - като екранни четци - ще обявят този помощен текст, когато потребителят фокусира или влезе в контрола.

Помощният текст под входовете може да бъде стилизиран с .form-text. Този клас включва display: blockи добавя малко горно поле за лесно разделяне от входовете по-горе.

Вашата парола трябва да е с дължина 8-20 знака, да съдържа букви и цифри и не трябва да съдържа интервали, специални знаци или емотикони.
<label for="inputPassword5">Password</label>
<input type="password" id="inputPassword5" class="form-control" aria-describedby="passwordHelpBlock">
<small id="passwordHelpBlock" class="form-text text-muted">
  Your password must be 8-20 characters long, contain letters and numbers, and must not contain spaces, special characters, or emoji.
</small>

Вграденият текст може да използва всеки типичен вграден HTML елемент (било то <small>, <span>, или нещо друго) с нищо повече от полезен клас.

Трябва да съдържа 8-20 знака.
<form class="form-inline">
  <div class="form-group">
    <label for="inputPassword6">Password</label>
    <input type="password" id="inputPassword6" class="form-control mx-sm-3" aria-describedby="passwordHelpInline">
    <small id="passwordHelpInline" class="text-muted">
      Must be 8-20 characters long.
    </small>
  </div>
</form>

Форми с увреждания

Добавете disabledбулевия атрибут към вход, за да предотвратите потребителски взаимодействия и да го направите да изглежда по-лек.

<input class="form-control" id="disabledInput" type="text" placeholder="Disabled input here..." disabled>

Добавете disabledатрибута към a, <fieldset>за да деактивирате всички контроли в него.

<form>
  <fieldset disabled>
    <div class="form-group">
      <label for="disabledTextInput">Disabled input</label>
      <input type="text" id="disabledTextInput" class="form-control" placeholder="Disabled input">
    </div>
    <div class="form-group">
      <label for="disabledSelect">Disabled select menu</label>
      <select id="disabledSelect" class="form-control">
        <option>Disabled select</option>
      </select>
    </div>
    <div class="form-check">
      <input class="form-check-input" type="checkbox" id="disabledFieldsetCheck" disabled>
      <label class="form-check-label" for="disabledFieldsetCheck">
        Can't check this
      </label>
    </div>
    <button type="submit" class="btn btn-primary">Submit</button>
  </fieldset>
</form>
Предупреждение с котви

По подразбиране браузърите ще третират всички собствени контроли на формуляри ( <input>, <select>и <button>елементи) вътре <fieldset disabled>като дезактивирани, предотвратявайки взаимодействието както с клавиатура, така и с мишка върху тях. Ако обаче вашият формуляр включва и <a ... class="btn btn-*">елементи, на тях ще бъде даден само стил на pointer-events: none. Както е отбелязано в раздела за забранено състояние за бутони (и по-специално в подраздела за анкерни елементи), това свойство на CSS все още не е стандартизирано и не се поддържа напълно в Opera 18 и по-долу или в Internet Explorer 10 и спечели не пречи на потребителите на клавиатурата да могат да фокусират или активират тези връзки. Така че, за да сте в безопасност, използвайте персонализиран JavaScript, за да деактивирате такива връзки.

Съвместимост между различни браузъри

Въпреки че Bootstrap ще приложи тези стилове във всички браузъри, Internet Explorer 11 и по-стари не поддържат напълно disabledатрибута на <fieldset>. Използвайте персонализиран JavaScript, за да деактивирате набора от полета в тези браузъри.

Валидиране

Осигурете ценна, полезна обратна връзка на вашите потребители с валидиране на HTML5 формуляр – достъпно във всички наши поддържани браузъри . Изберете от обратната връзка за проверка по подразбиране на браузъра или внедрете персонализирани съобщения с нашите вградени класове и начален JavaScript.

Силно препоръчваме персонализирани стилове за проверка, тъй като стандартните настройки на браузъра не се съобщават на екранните четци.

Как работи

Ето как работи проверката на формуляр с Bootstrap:

  • Валидирането на HTML форма се прилага чрез двата псевдо-класа на CSS :invalidи :valid. Прилага се за <input>, <select>и <textarea>елементи.
  • Bootstrap обхваща :invalidи :validстилове към родителския .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, приложени към вашите контроли на формуляра.

Looks good!
Looks good!
@
Please choose a username.
Please provide a valid city.
Please provide a valid state.
Please provide a valid zip.
You must agree before submitting.
<form class="needs-validation" novalidate>
  <div class="form-row">
    <div class="col-md-4 mb-3">
      <label for="validationCustom01">First name</label>
      <input type="text" class="form-control" id="validationCustom01" placeholder="First name" value="Mark" required>
      <div class="valid-feedback">
        Looks good!
      </div>
    </div>
    <div class="col-md-4 mb-3">
      <label for="validationCustom02">Last name</label>
      <input type="text" class="form-control" id="validationCustom02" placeholder="Last name" value="Otto" required>
      <div class="valid-feedback">
        Looks good!
      </div>
    </div>
    <div class="col-md-4 mb-3">
      <label for="validationCustomUsername">Username</label>
      <div class="input-group">
        <div class="input-group-prepend">
          <span class="input-group-text" id="inputGroupPrepend">@</span>
        </div>
        <input type="text" class="form-control" id="validationCustomUsername" placeholder="Username" aria-describedby="inputGroupPrepend" required>
        <div class="invalid-feedback">
          Please choose a username.
        </div>
      </div>
    </div>
  </div>
  <div class="form-row">
    <div class="col-md-6 mb-3">
      <label for="validationCustom03">City</label>
      <input type="text" class="form-control" id="validationCustom03" placeholder="City" required>
      <div class="invalid-feedback">
        Please provide a valid city.
      </div>
    </div>
    <div class="col-md-3 mb-3">
      <label for="validationCustom04">State</label>
      <input type="text" class="form-control" id="validationCustom04" placeholder="State" required>
      <div class="invalid-feedback">
        Please provide a valid state.
      </div>
    </div>
    <div class="col-md-3 mb-3">
      <label for="validationCustom05">Zip</label>
      <input type="text" class="form-control" id="validationCustom05" placeholder="Zip" required>
      <div class="invalid-feedback">
        Please provide a valid zip.
      </div>
    </div>
  </div>
  <div class="form-group">
    <div class="form-check">
      <input class="form-check-input" type="checkbox" value="" id="invalidCheck" required>
      <label class="form-check-label" for="invalidCheck">
        Agree to terms and conditions
      </label>
      <div class="invalid-feedback">
        You must agree before submitting.
      </div>
    </div>
  </div>
  <button class="btn btn-primary" type="submit">Submit form</button>
</form>

<script>
// Example starter JavaScript for disabling form submissions if there are invalid fields
(function() {
  'use strict';
  window.addEventListener('load', function() {
    // Fetch all the forms we want to apply custom Bootstrap validation styles to
    var forms = document.getElementsByClassName('needs-validation');
    // Loop over them and prevent submission
    var validation = Array.prototype.filter.call(forms, function(form) {
      form.addEventListener('submit', function(event) {
        if (form.checkValidity() === false) {
          event.preventDefault();
          event.stopPropagation();
        }
        form.classList.add('was-validated');
      }, false);
    });
  }, false);
})();
</script>

Браузър по подразбиране

Не се интересувате от персонализирани съобщения за обратна връзка за валидиране или писане на JavaScript за промяна на поведението на формуляра? Всичко е наред, можете да използвате настройките на браузъра по подразбиране. Опитайте да изпратите формуляра по-долу. В зависимост от вашия браузър и операционна система ще видите малко по-различен стил на обратна връзка.

Въпреки че тези стилове за обратна връзка не могат да бъдат стилизирани с CSS, все пак можете да персонализирате текста за обратна връзка чрез JavaScript.

@
<form>
  <div class="form-row">
    <div class="col-md-4 mb-3">
      <label for="validationDefault01">First name</label>
      <input type="text" class="form-control" id="validationDefault01" placeholder="First name" value="Mark" required>
    </div>
    <div class="col-md-4 mb-3">
      <label for="validationDefault02">Last name</label>
      <input type="text" class="form-control" id="validationDefault02" placeholder="Last name" value="Otto" required>
    </div>
    <div class="col-md-4 mb-3">
      <label for="validationDefaultUsername">Username</label>
      <div class="input-group">
        <div class="input-group-prepend">
          <span class="input-group-text" id="inputGroupPrepend2">@</span>
        </div>
        <input type="text" class="form-control" id="validationDefaultUsername" placeholder="Username" aria-describedby="inputGroupPrepend2" required>
      </div>
    </div>
  </div>
  <div class="form-row">
    <div class="col-md-6 mb-3">
      <label for="validationDefault03">City</label>
      <input type="text" class="form-control" id="validationDefault03" placeholder="City" required>
    </div>
    <div class="col-md-3 mb-3">
      <label for="validationDefault04">State</label>
      <input type="text" class="form-control" id="validationDefault04" placeholder="State" required>
    </div>
    <div class="col-md-3 mb-3">
      <label for="validationDefault05">Zip</label>
      <input type="text" class="form-control" id="validationDefault05" placeholder="Zip" required>
    </div>
  </div>
  <div class="form-group">
    <div class="form-check">
      <input class="form-check-input" type="checkbox" value="" id="invalidCheck2" required>
      <label class="form-check-label" for="invalidCheck2">
        Agree to terms and conditions
      </label>
    </div>
  </div>
  <button class="btn btn-primary" type="submit">Submit form</button>
</form>

Страната на сървъра

Препоръчваме да използвате проверка от страна на клиента, но в случай че се нуждаете от страна на сървъра, можете да посочите невалидни и валидни полета на формуляра с .is-invalidи .is-valid. Имайте предвид, че .invalid-feedbackсе поддържа и с тези класове.

Изглежда добре!
Изглежда добре!
@
Моля, изберете потребителско име.
Моля, посочете валиден град.
Моля, предоставете валидно състояние.
Моля, предоставете валиден пощенски код.
Трябва да се съгласите, преди да изпратите.
<form>
  <div class="form-row">
    <div class="col-md-4 mb-3">
      <label for="validationServer01">First name</label>
      <input type="text" class="form-control is-valid" id="validationServer01" placeholder="First name" value="Mark" required>
      <div class="valid-feedback">
        Looks good!
      </div>
    </div>
    <div class="col-md-4 mb-3">
      <label for="validationServer02">Last name</label>
      <input type="text" class="form-control is-valid" id="validationServer02" placeholder="Last name" value="Otto" required>
      <div class="valid-feedback">
        Looks good!
      </div>
    </div>
    <div class="col-md-4 mb-3">
      <label for="validationServerUsername">Username</label>
      <div class="input-group">
        <div class="input-group-prepend">
          <span class="input-group-text" id="inputGroupPrepend3">@</span>
        </div>
        <input type="text" class="form-control is-invalid" id="validationServerUsername" placeholder="Username" aria-describedby="inputGroupPrepend3" required>
        <div class="invalid-feedback">
          Please choose a username.
        </div>
      </div>
    </div>
  </div>
  <div class="form-row">
    <div class="col-md-6 mb-3">
      <label for="validationServer03">City</label>
      <input type="text" class="form-control is-invalid" id="validationServer03" placeholder="City" required>
      <div class="invalid-feedback">
        Please provide a valid city.
      </div>
    </div>
    <div class="col-md-3 mb-3">
      <label for="validationServer04">State</label>
      <input type="text" class="form-control is-invalid" id="validationServer04" placeholder="State" required>
      <div class="invalid-feedback">
        Please provide a valid state.
      </div>
    </div>
    <div class="col-md-3 mb-3">
      <label for="validationServer05">Zip</label>
      <input type="text" class="form-control is-invalid" id="validationServer05" placeholder="Zip" required>
      <div class="invalid-feedback">
        Please provide a valid zip.
      </div>
    </div>
  </div>
  <div class="form-group">
    <div class="form-check">
      <input class="form-check-input is-invalid" type="checkbox" value="" id="invalidCheck3" required>
      <label class="form-check-label" for="invalidCheck3">
        Agree to terms and conditions
      </label>
      <div class="invalid-feedback">
        You must agree before submitting.
      </div>
    </div>
  </div>
  <button class="btn btn-primary" type="submit">Submit form</button>
</form>

Поддържани елементи

Нашите примерни формуляри показват оригинални текстови <input>s по-горе, но стиловете за валидиране на формуляри са налични и за нашите персонализирани контроли на формуляри.

Примерен невалиден текст за обратна връзка
Още примерен невалиден текст за обратна връзка
Пример за невалидна обратна връзка за персонализиран избор
Пример за невалидна обратна връзка за персонализиран файл
<form class="was-validated">
  <div class="custom-control custom-checkbox mb-3">
    <input type="checkbox" class="custom-control-input" id="customControlValidation1" required>
    <label class="custom-control-label" for="customControlValidation1">Check this custom checkbox</label>
    <div class="invalid-feedback">Example invalid feedback text</div>
  </div>

  <div class="custom-control custom-radio">
    <input type="radio" class="custom-control-input" id="customControlValidation2" name="radio-stacked" required>
    <label class="custom-control-label" for="customControlValidation2">Toggle this custom radio</label>
  </div>
  <div class="custom-control custom-radio mb-3">
    <input type="radio" class="custom-control-input" id="customControlValidation3" name="radio-stacked" required>
    <label class="custom-control-label" for="customControlValidation3">Or toggle this other custom radio</label>
    <div class="invalid-feedback">More example invalid feedback text</div>
  </div>

  <div class="form-group">
    <select class="custom-select" required>
      <option value="">Open this select menu</option>
      <option value="1">One</option>
      <option value="2">Two</option>
      <option value="3">Three</option>
    </select>
    <div class="invalid-feedback">Example invalid custom select feedback</div>
  </div>

  <div class="custom-file">
    <input type="file" class="custom-file-input" id="validatedCustomFile" required>
    <label class="custom-file-label" for="validatedCustomFile">Choose file...</label>
    <div class="invalid-feedback">Example invalid custom file feedback</div>
  </div>
</form>

Подсказки

Ако оформлението на вашия формуляр го позволява, можете да размените .{valid|invalid}-feedbackкласовете с .{valid|invalid}-tooltipкласове, за да покажете обратна връзка за валидиране в стилизирана подсказка. Уверете се, че имате родител с position: relativeнего за позициониране на подсказка. В примера по-долу нашите класове колони вече имат това, но вашият проект може да изисква алтернативна настройка.

Looks good!
Looks good!
@
Please choose a unique and valid username.
Please provide a valid city.
Please provide a valid state.
Please provide a valid zip.
<form class="needs-validation" novalidate>
  <div class="form-row">
    <div class="col-md-4 mb-3">
      <label for="validationTooltip01">First name</label>
      <input type="text" class="form-control" id="validationTooltip01" placeholder="First name" value="Mark" required>
      <div class="valid-tooltip">
        Looks good!
      </div>
    </div>
    <div class="col-md-4 mb-3">
      <label for="validationTooltip02">Last name</label>
      <input type="text" class="form-control" id="validationTooltip02" placeholder="Last name" value="Otto" required>
      <div class="valid-tooltip">
        Looks good!
      </div>
    </div>
    <div class="col-md-4 mb-3">
      <label for="validationTooltipUsername">Username</label>
      <div class="input-group">
        <div class="input-group-prepend">
          <span class="input-group-text" id="validationTooltipUsernamePrepend">@</span>
        </div>
        <input type="text" class="form-control" id="validationTooltipUsername" placeholder="Username" aria-describedby="validationTooltipUsernamePrepend" required>
        <div class="invalid-tooltip">
          Please choose a unique and valid username.
        </div>
      </div>
    </div>
  </div>
  <div class="form-row">
    <div class="col-md-6 mb-3">
      <label for="validationTooltip03">City</label>
      <input type="text" class="form-control" id="validationTooltip03" placeholder="City" required>
      <div class="invalid-tooltip">
        Please provide a valid city.
      </div>
    </div>
    <div class="col-md-3 mb-3">
      <label for="validationTooltip04">State</label>
      <input type="text" class="form-control" id="validationTooltip04" placeholder="State" required>
      <div class="invalid-tooltip">
        Please provide a valid state.
      </div>
    </div>
    <div class="col-md-3 mb-3">
      <label for="validationTooltip05">Zip</label>
      <input type="text" class="form-control" id="validationTooltip05" placeholder="Zip" required>
      <div class="invalid-tooltip">
        Please provide a valid zip.
      </div>
    </div>
  </div>
  <button class="btn btn-primary" type="submit">Submit form</button>
</form>

Персонализирани формуляри

За още повече персонализиране и последователност между браузърите, използвайте нашите напълно персонализирани елементи на формуляр, за да замените настройките по подразбиране на браузъра. Те са изградени върху семантично и достъпно маркиране, така че са стабилни заместители на всяка контрола на формуляр по подразбиране.

Отметки и радиостанции

Всяко квадратче за отметка и радио е обвито в a <div>с брат или сестра <span>, за да създадем нашия персонализиран контрол и a <label>за придружаващия текст. Структурно, това е същият подход като нашия по подразбиране .form-check.

Ние използваме селектора за брат или сестра ( ~) за всички наши <input>състояния, например, :checkedза да стилизираме правилно нашия потребителски индикатор за форма. Когато се комбинира с .custom-control-labelкласа, можем също да стилизираме текста за всеки елемент въз основа на <input>състоянието на 's.

Скриваме по подразбиране <input>с opacityи използваме, за .custom-control-labelда изградим нов персонализиран индикатор за формуляр на негово място с ::beforeи ::after. За съжаление не можем да създадем персонализиран такъв само от, <input>защото CSS contentне работи върху този елемент.

В отметнатите състояния използваме base64 вградени SVG икони от Open Iconic . Това ни осигурява най-добрия контрол за стилизиране и позициониране в браузъри и устройства.

Квадратчета за отметка

<div class="custom-control custom-checkbox">
  <input type="checkbox" class="custom-control-input" id="customCheck1">
  <label class="custom-control-label" for="customCheck1">Check this custom checkbox</label>
</div>

Персонализираните квадратчета за отметка също могат да използват :indeterminateпсевдокласа, когато са зададени ръчно чрез JavaScript (няма наличен HTML атрибут за указването му).

Ако използвате jQuery, нещо като това трябва да е достатъчно:

$('.your-checkbox').prop('indeterminate', true)

Радиостанции

<div class="custom-control custom-radio">
  <input type="radio" id="customRadio1" name="customRadio" class="custom-control-input">
  <label class="custom-control-label" for="customRadio1">Toggle this custom radio</label>
</div>
<div class="custom-control custom-radio">
  <input type="radio" id="customRadio2" name="customRadio" class="custom-control-input">
  <label class="custom-control-label" for="customRadio2">Or toggle this other custom radio</label>
</div>

В редица

<div class="custom-control custom-radio custom-control-inline">
  <input type="radio" id="customRadioInline1" name="customRadioInline1" class="custom-control-input">
  <label class="custom-control-label" for="customRadioInline1">Toggle this custom radio</label>
</div>
<div class="custom-control custom-radio custom-control-inline">
  <input type="radio" id="customRadioInline2" name="customRadioInline1" class="custom-control-input">
  <label class="custom-control-label" for="customRadioInline2">Or toggle this other custom radio</label>
</div>

хора с увреждания

Персонализирани квадратчета за отметка и радиостанции също могат да бъдат деактивирани. Добавете disabledбулевия атрибут към <input>и потребителският индикатор и описанието на етикета ще бъдат автоматично стилизирани.

<div class="custom-control custom-checkbox">
  <input type="checkbox" class="custom-control-input" id="customCheckDisabled" disabled>
  <label class="custom-control-label" for="customCheckDisabled">Check this custom checkbox</label>
</div>

<div class="custom-control custom-radio">
  <input type="radio" id="radio3" name="radioDisabled" id="customRadioDisabled" class="custom-control-input" disabled>
  <label class="custom-control-label" for="customRadioDisabled">Toggle this custom radio</label>
</div>

Изберете меню

Персонализираните <select>менюта се нуждаят само от персонализиран клас, .custom-selectза да задействат персонализираните стилове.

<select class="custom-select">
  <option selected>Open this select menu</option>
  <option value="1">One</option>
  <option value="2">Two</option>
  <option value="3">Three</option>
</select>

Можете също така да избирате от малки и големи персонализирани селекции, за да съответствате на нашите текстови входове с подобен размер.

<select class="custom-select custom-select-lg mb-3">
  <option selected>Open this select menu</option>
  <option value="1">One</option>
  <option value="2">Two</option>
  <option value="3">Three</option>
</select>

<select class="custom-select custom-select-sm">
  <option selected>Open this select menu</option>
  <option value="1">One</option>
  <option value="2">Two</option>
  <option value="3">Three</option>
</select>

Атрибутът multipleсъщо се поддържа:

<select class="custom-select" multiple>
  <option selected>Open this select menu</option>
  <option value="1">One</option>
  <option value="2">Two</option>
  <option value="3">Three</option>
</select>

Както и sizeатрибутът:

<select class="custom-select" size="3">
  <option selected>Open this select menu</option>
  <option value="1">One</option>
  <option value="2">Two</option>
  <option value="3">Three</option>
</select>

Файлов браузър

Въведеният файл е най-неудобният от групата и изисква допълнителен JavaScript, ако искате да ги свържете с функционален Избор на файл… и избран текст на име на файл.

<div class="custom-file">
  <input type="file" class="custom-file-input" id="customFile">
  <label class="custom-file-label" for="customFile">Choose file</label>
</div>

Скриваме файла по подразбиране <input>чрез opacityи вместо това стилизираме <label>. Бутонът се генерира и позиционира с ::after. И накрая, ние декларираме widthи heightна <input>за правилното разстояние за околното съдържание.

Превод или персонализиране на низовете

Псевдокласът :lang()се използва, за да позволи превод на текста „Преглед“ на други езици. Заменете или добавете записи към $custom-file-textпроменливата Sass със съответния езиков таг и локализирани низове. Английските низове могат да бъдат персонализирани по същия начин. Например, ето как може да се добави испански превод (кодът на испанския език е es):

$custom-file-text: (
  en: "Browse",
  es: "Elegir"
);

Ето lang(es)в действие относно въвеждането на персонализиран файл за превод на испански:

<div class="custom-file">
  <input type="file" class="custom-file-input" id="customFileLang" lang="es">
  <label class="custom-file-label" for="customFileLang">Seleccionar Archivo</label>
</div>

Ще трябва да зададете правилно езика на вашия документ (или негово поддърво), за да се показва правилният текст. Това може да се направи с помощта на langатрибута на <html>елемента или Content-LanguageHTTP заглавката , наред с други методи.