in English

Formes

Exemples et directives d'utilisation pour les styles de contrôle de formulaire, les options de mise en page et les composants personnalisés pour créer une grande variété de formulaires.

Aperçu

Les contrôles de formulaire de Bootstrap étendent nos styles de formulaire redémarrés avec des classes. Utilisez ces classes pour activer leurs affichages personnalisés pour un rendu plus cohérent sur tous les navigateurs et appareils.

Assurez-vous d'utiliser un typeattribut approprié sur toutes les entrées (par exemple, emailpour l'adresse e-mail ou numberpour les informations numériques) pour tirer parti des nouveaux contrôles d'entrée comme la vérification de l'e-mail, la sélection du numéro, etc.

Voici un exemple rapide pour démontrer les styles de formulaire de Bootstrap. Continuez à lire pour obtenir de la documentation sur les classes requises, la disposition des formulaires, etc.

Nous ne partagerons jamais votre e-mail avec quelqu'un d'autre. 
<form>
  <div class="form-group">
    <label for="exampleInputEmail1">Email address</label>
    <input type="email" class="form-control" id="exampleInputEmail1" aria-describedby="emailHelp">
    <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">
  </div>
  <div class="form-group 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>

Champs de formulaire

Les contrôles de forme textuelle, tels que <input>s, <select>s et <textarea>s, sont stylisés avec la .form-controlclasse. Sont inclus les styles pour l'apparence générale, l'état de mise au point, le dimensionnement, etc.

Assurez-vous d'explorer nos formulaires personnalisés pour styliser davantage <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>

Pour les entrées de fichier, remplacez le .form-controlpar .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>

Dimensionnement

Définissez les hauteurs à l'aide de classes telles que .form-control-lget .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>

Lecture seulement

Ajoutez l' readonlyattribut booléen sur une entrée pour empêcher la modification de la valeur de l'entrée. Les entrées en lecture seule apparaissent plus claires (tout comme les entrées désactivées), mais conservent le curseur standard.

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

Texte brut en lecture seule

Si vous souhaitez que les <input readonly>éléments de votre formulaire soient en texte brut, utilisez la .form-control-plaintextclasse pour supprimer le style de champ de formulaire par défaut et conserver la marge et le remplissage corrects.

<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">
    </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>

Entrées de plage

Définissez les entrées de plage à défilement horizontal à l'aide de .form-control-range.

<form>
  <div class="form-group">
    <label for="formControlRange">Example Range input</label>
    <input type="range" class="form-control-range" id="formControlRange">
  </div>
</form>

Cases à cocher et radios

Les cases à cocher et les radios par défaut sont améliorées à l'aide de .form-check, une classe unique pour les deux types d'entrée qui améliore la mise en page et le comportement de leurs éléments HTML . Les cases à cocher permettent de sélectionner une ou plusieurs options dans une liste, tandis que les radios permettent de sélectionner une option parmi plusieurs.

Les cases à cocher et les radios désactivées sont prises en charge. L' disabledattribut appliquera une couleur plus claire pour aider à indiquer l'état de l'entrée.

Les cases à cocher et les boutons radio prennent en charge la validation de formulaire HTML et fournissent des étiquettes concises et accessibles. En tant que tels, nos <input>s et <label>s sont des éléments frères par opposition à un <input>dans un <label>. C'est un peu plus verbeux car vous devez spécifier idet fordes attributs pour relier les <input>et <label>.

Par défaut (empilé)

Par défaut, n'importe quel nombre de cases à cocher et de radios qui sont des frères immédiats seront empilés verticalement et espacés de manière appropriée avec .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">
  <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>

En ligne

Regroupez les cases à cocher ou les radios sur la même ligne horizontale en ajoutant .form-check-inlineà n'importe quel fichier .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>

Sans étiquettes

Ajouter .position-staticaux entrées à l'intérieur .form-checkqui n'ont pas de texte d'étiquette. N'oubliez pas de toujours fournir une forme de nom accessible pour les technologies d'assistance (par exemple, en utilisant 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>

Disposition

Étant donné que Bootstrap s'applique display: blockà width: 100%presque tous nos contrôles de formulaire, les formulaires s'empileront verticalement par défaut. Des classes supplémentaires peuvent être utilisées pour faire varier cette mise en page sur une base par formulaire.

Former des groupes

La .form-groupclasse est le moyen le plus simple d'ajouter une structure aux formulaires. Il fournit une classe flexible qui encourage le regroupement approprié des étiquettes, des contrôles, du texte d'aide facultatif et de la messagerie de validation de formulaire. Par défaut, il s'applique uniquement à margin-bottom, mais il récupère des styles supplémentaires .form-inlinesi nécessaire. Utilisez-le avec <fieldset>s, <div>s ou presque n'importe quel autre élément.

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

Grille de formulaire

Des formulaires plus complexes peuvent être construits à l'aide de nos classes de grille. Utilisez-les pour les mises en page de formulaire qui nécessitent plusieurs colonnes, des largeurs variées et des options d'alignement supplémentaires.

<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>

Ligne de formulaire

Vous pouvez également échanger .rowpour .form-row, une variante de notre ligne de grille standard qui remplace les gouttières de colonne par défaut pour des dispositions plus serrées et plus compactes.

<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>

Des mises en page plus complexes peuvent également être créées avec le système de grille.

<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">
    </div>
    <div class="form-group col-md-6">
      <label for="inputPassword4">Password</label>
      <input type="password" class="form-control" id="inputPassword4">
    </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>

Forme horizontale

Créez des formulaires horizontaux avec la grille en ajoutant la .rowclasse pour former des groupes et en utilisant les .col-*-*classes pour spécifier la largeur de vos étiquettes et contrôles. Assurez-vous d'ajouter également .col-form-labelà vos <label>s afin qu'ils soient centrés verticalement avec leurs contrôles de formulaire associés.

Parfois, vous devrez peut-être utiliser des utilitaires de marge ou de remplissage pour créer l'alignement parfait dont vous avez besoin. Par exemple, nous avons supprimé l' padding-topétiquette sur nos entrées radio empilées pour mieux aligner la ligne de base du texte.

Radios 
<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">
    </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">
    </div>
  </div>
  <fieldset class="form-group row">
    <legend class="col-form-label col-sm-2 float-sm-left 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>
  </fieldset>
  <div class="form-group row">
    <div class="col-sm-10 offset-sm-2">
      <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>
Dimensionnement horizontal des étiquettes de formulaire

Assurez-vous d'utiliser .col-form-label-smou .col-form-label-lgà votre <label>s ou <legend>s pour suivre correctement la taille de .form-control-lget .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>

Dimensionnement des colonnes

Comme indiqué dans les exemples précédents, notre système de grille vous permet de placer n'importe quel nombre de .cols dans a .rowou .form-row. Ils partageront également la largeur disponible entre eux. Vous pouvez également choisir un sous-ensemble de vos colonnes pour occuper plus ou moins d'espace, tandis que les .cols restants divisent également le reste, avec des classes de colonnes spécifiques telles que .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>

Dimensionnement automatique

L'exemple ci-dessous utilise un utilitaire flexbox pour centrer verticalement le contenu et se transforme .colen .col-autoafin que vos colonnes n'occupent que l'espace nécessaire. Autrement dit, la colonne se dimensionne elle-même en fonction du contenu.

@ 
<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>

Vous pouvez ensuite remixer cela avec des classes de colonnes spécifiques à la taille.

@ 
<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>

Et bien sûr , les contrôles de formulaire personnalisés sont pris en charge.

<form>
  <div class="form-row align-items-center">
    <div class="col-auto my-1">
      <label class="mr-sm-2 sr-only" 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>

Formulaires en ligne

Utilisez la .form-inlineclasse pour afficher une série d'étiquettes, de contrôles de formulaire et de boutons sur une seule ligne horizontale. Les contrôles de formulaire dans les formulaires en ligne diffèrent légèrement de leurs états par défaut.

  • Les contrôles sont display: flex, réduisant tout espace blanc HTML et vous permettant de fournir un contrôle d'alignement avec les utilitaires d' espacement et de flexbox .
  • Les contrôles et les groupes d'entrée reçoivent width: autopour remplacer la valeur par défaut de Bootstrap width: 100%.
  • Les commandes n'apparaissent en ligne que dans les fenêtres d'au moins 576 pixels de large pour tenir compte des fenêtres étroites sur les appareils mobiles.

Vous devrez peut-être régler manuellement la largeur et l'alignement des contrôles de formulaire individuels avec des utilitaires d'espacement (comme indiqué ci-dessous). Enfin, assurez-vous de toujours inclure un <label>avec chaque contrôle de formulaire, même si vous devez le masquer aux visiteurs non lecteurs d'écran avec .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>

Les contrôles de formulaire personnalisés et les sélections sont également pris en charge.

<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>
Alternatives aux étiquettes masquées

Les technologies d'assistance telles que les lecteurs d'écran auront des problèmes avec vos formulaires si vous n'incluez pas une étiquette pour chaque entrée. Pour ces formulaires en ligne, vous pouvez masquer les étiquettes à l'aide de la .sr-onlyclasse. Il existe d'autres méthodes alternatives pour fournir une étiquette pour les technologies d'assistance, telles que l' attribut aria-label, aria-labelledbyou . titleSi aucune de ces méthodes n'est présente, les technologies d'assistance peuvent recourir à l'utilisation de l' placeholderattribut, s'il est présent, mais notez que l'utilisation de placeholderen remplacement d'autres méthodes d'étiquetage n'est pas conseillée.

Texte d'aide

Le texte d'aide au niveau du bloc dans les formulaires peut être créé à l'aide de .form-text(anciennement connu sous le nom .help-blockde v3). Le texte d'aide en ligne peut être implémenté de manière flexible à l'aide de n'importe quel élément HTML en ligne et de classes utilitaires telles que .text-muted.

Associer le texte d'aide aux champs de formulaire

Le texte d'aide doit être explicitement associé au contrôle de formulaire auquel il se rapporte à l'aide de l' aria-describedbyattribut. Cela garantira que les technologies d'assistance, telles que les lecteurs d'écran, annonceront ce texte d'aide lorsque l'utilisateur se concentre ou entre dans le contrôle.

Le texte d'aide sous les entrées peut être stylisé avec .form-text. Cette classe inclut display: blocket ajoute une marge supérieure pour un espacement facile des entrées ci-dessus.

Votre mot de passe doit comporter entre 8 et 20 caractères, contenir des lettres et des chiffres et ne doit pas contenir d'espaces, de caractères spéciaux ou d'emoji. 
<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>

Le texte en ligne peut utiliser n'importe quel élément HTML en ligne typique (que ce soit un <small>, <span>ou autre chose) avec rien de plus qu'une classe utilitaire.

Doit contenir entre 8 et 20 caractères. 
<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>

Formulaires désactivés

Ajoutez l' disabledattribut booléen sur une entrée pour empêcher les interactions de l'utilisateur et la rendre plus claire.

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

Ajoutez l' disabledattribut à a <fieldset>pour désactiver tous les contrôles qu'il contient.

Exemple d'ensemble de champs désactivé 
<form>
  <fieldset disabled>
    <legend>Disabled fieldset example</legend>
    <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-group">
      <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>
    </div>
    <button type="submit" class="btn btn-primary">Submit</button>
  </fieldset>
</form>
Mise en garde avec les ancres

Les navigateurs traitent tous les contrôles de formulaire natifs ( éléments <input>, <select>et <button>) à l'intérieur d'un <fieldset disabled>comme désactivés, empêchant les interactions clavier et souris sur eux.

Cependant, si votre formulaire comprend également des éléments de type bouton personnalisés tels que <a ... class="btn btn-*">, ceux-ci ne recevront que le style pointer-events: none. Comme indiqué dans la section sur l'état désactivé pour les boutons (et plus particulièrement dans la sous-section pour les éléments d'ancrage), cette propriété CSS n'est pas encore normalisée et n'est pas entièrement prise en charge dans Internet Explorer 10. Les contrôles basés sur l'ancre seront également toujours focalisable et utilisable à l'aide du clavier. Vous devez modifier manuellement ces contrôles en les ajoutant tabindex="-1"pour les empêcher de recevoir le focus et aria-disabled="disabled"pour signaler leur état aux technologies d'assistance.

Compatibilité entre navigateurs

Alors que Bootstrap appliquera ces styles dans tous les navigateurs, Internet Explorer 11 et les versions antérieures ne prennent pas entièrement en charge l' disabledattribut sur un fichier <fieldset>. Utilisez JavaScript personnalisé pour désactiver l'ensemble de champs dans ces navigateurs.

Validation

Fournissez des commentaires utiles et exploitables à vos utilisateurs grâce à la validation de formulaire HTML5, disponible dans tous nos navigateurs pris en charge . Choisissez parmi les commentaires de validation par défaut du navigateur ou implémentez des messages personnalisés avec nos classes intégrées et JavaScript de démarrage.

Nous sommes conscients qu'actuellement, les styles de validation personnalisés côté client et les info-bulles ne sont pas accessibles, car ils ne sont pas exposés aux technologies d'assistance. Pendant que nous travaillons sur une solution, nous vous recommandons d'utiliser l'option côté serveur ou la méthode de validation du navigateur par défaut.

Comment ça fonctionne

Voici comment fonctionne la validation de formulaire avec Bootstrap :

  • La validation de formulaire HTML est appliquée via les deux pseudo-classes de CSS, :invalidet :valid. Elle s'applique aux éléments <input>, <select>et <textarea>.
  • Bootstrap étend les styles :invalidet :validà la classe parent .was-validated, généralement appliqués au <form>. Sinon, tout champ obligatoire sans valeur s'affiche comme non valide au chargement de la page. De cette façon, vous pouvez choisir quand les activer (généralement après la tentative de soumission du formulaire).
  • Pour réinitialiser l'apparence du formulaire (par exemple, dans le cas de soumissions de formulaires dynamiques à l'aide d'AJAX), supprimez la .was-validatedclasse de <form>nouveau après la soumission.
  • En solution de repli, .is-invalidet .is-validles classes peuvent être utilisées à la place des pseudo-classes pour la validation côté serveur . Ils ne nécessitent pas de .was-validatedclasse parent.
  • En raison de contraintes sur le fonctionnement de CSS, nous ne pouvons pas (pour l'instant) appliquer des styles à un <label>qui précède un contrôle de formulaire dans le DOM sans l'aide de JavaScript personnalisé.
  • Tous les navigateurs modernes prennent en charge l' API de validation de contraintes , une série de méthodes JavaScript pour valider les contrôles de formulaire.
  • Les messages de commentaires peuvent utiliser les paramètres par défaut du navigateur (différents pour chaque navigateur et non stylisables via CSS) ou nos styles de commentaires personnalisés avec HTML et CSS supplémentaires.
  • Vous pouvez fournir des messages de validité personnalisés setCustomValidityen JavaScript.

Dans cet esprit, considérez les démos suivantes pour nos styles de validation de formulaire personnalisés, les classes côté serveur facultatives et les valeurs par défaut du navigateur.

Styles personnalisés

Pour les messages de validation de formulaire Bootstrap personnalisés, vous devrez ajouter l' novalidateattribut booléen à votre fichier <form>. Cela désactive les info-bulles de commentaires par défaut du navigateur, mais permet toujours d'accéder aux API de validation de formulaire en JavaScript. Essayez de soumettre le formulaire ci-dessous; notre JavaScript interceptera le bouton d'envoi et vous transmettra les commentaires. Lorsque vous tentez de soumettre, vous verrez les styles :invalidet :validappliqués à vos contrôles de formulaire.

Les styles de commentaires personnalisés appliquent des couleurs, des bordures, des styles de mise au point et des icônes d'arrière-plan personnalisés pour mieux communiquer les commentaires. Les icônes d'arrière-plan pour <select>s ne sont disponibles qu'avec .custom-select, et non .form-control.

Cela semble bon!
Cela semble bon!
Veuillez fournir une ville valide.
Veuillez sélectionner un état valide.
Veuillez fournir un code postal valide.
Vous devez accepter avant de soumettre. 
<form class="needs-validation" novalidate>
  <div class="form-row">
    <div class="col-md-6 mb-3">
      <label for="validationCustom01">First name</label>
      <input type="text" class="form-control" id="validationCustom01" value="Mark" required>
      <div class="valid-feedback">
        Looks good!
      </div>
    </div>
    <div class="col-md-6 mb-3">
      <label for="validationCustom02">Last name</label>
      <input type="text" class="form-control" id="validationCustom02" value="Otto" required>
      <div class="valid-feedback">
        Looks good!
      </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" required>
      <div class="invalid-feedback">
        Please provide a valid city.
      </div>
    </div>
    <div class="col-md-3 mb-3">
      <label for="validationCustom04">State</label>
      <select class="custom-select" id="validationCustom04" required>
        <option selected disabled value="">Choose...</option>
        <option>...</option>
      </select>
      <div class="invalid-feedback">
        Please select 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" 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>

Valeurs par défaut du navigateur

Vous n'êtes pas intéressé par les messages de retour de validation personnalisés ou par l'écriture de JavaScript pour modifier les comportements des formulaires ? Tout va bien, vous pouvez utiliser les paramètres par défaut du navigateur. Essayez de soumettre le formulaire ci-dessous. Selon votre navigateur et votre système d'exploitation, vous verrez un style de commentaires légèrement différent.

Bien que ces styles de commentaires ne puissent pas être stylisés avec CSS, vous pouvez toujours personnaliser le texte des commentaires via JavaScript.

<form>
  <div class="form-row">
    <div class="col-md-6 mb-3">
      <label for="validationDefault01">First name</label>
      <input type="text" class="form-control" id="validationDefault01" value="Mark" required>
    </div>
    <div class="col-md-6 mb-3">
      <label for="validationDefault02">Last name</label>
      <input type="text" class="form-control" id="validationDefault02" value="Otto" required>
    </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" required>
    </div>
    <div class="col-md-3 mb-3">
      <label for="validationDefault04">State</label>
      <select class="custom-select" id="validationDefault04" required>
        <option selected disabled value="">Choose...</option>
        <option>...</option>
      </select>
    </div>
    <div class="col-md-3 mb-3">
      <label for="validationDefault05">Zip</label>
      <input type="text" class="form-control" id="validationDefault05" 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>

Du côté serveur

Nous vous recommandons d'utiliser la validation côté client, mais si vous avez besoin d'une validation côté serveur, vous pouvez indiquer les champs de formulaire non valides et valides avec .is-invalidet .is-valid. Notez que cela .invalid-feedbackest également pris en charge avec ces classes.

Pour les champs non valides, assurez-vous que le message de commentaire/d'erreur non valide est associé au champ de formulaire approprié à l'aide de aria-describedby. Cet attribut permet d' iden référencer plusieurs, au cas où le champ pointe déjà vers un texte de formulaire supplémentaire.

Cela semble bon!
Cela semble bon!
Veuillez fournir une ville valide.
Veuillez sélectionner un état valide.
Veuillez fournir un code postal valide.
Vous devez accepter avant de soumettre. 
<form>
  <div class="form-row">
    <div class="col-md-6 mb-3">
      <label for="validationServer01">First name</label>
      <input type="text" class="form-control is-valid" id="validationServer01" value="Mark" required>
      <div class="valid-feedback">
        Looks good!
      </div>
    </div>
    <div class="col-md-6 mb-3">
      <label for="validationServer02">Last name</label>
      <input type="text" class="form-control is-valid" id="validationServer02" value="Otto" required>
      <div class="valid-feedback">
        Looks good!
      </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" aria-describedby="validationServer03Feedback" required>
      <div id="validationServer03Feedback" class="invalid-feedback">
        Please provide a valid city.
      </div>
    </div>
    <div class="col-md-3 mb-3">
      <label for="validationServer04">State</label>
      <select class="custom-select is-invalid" id="validationServer04" aria-describedby="validationServer04Feedback" required>
        <option selected disabled value="">Choose...</option>
        <option>...</option>
      </select>
      <div id="validationServer04Feedback" class="invalid-feedback">
        Please select 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" aria-describedby="validationServer05Feedback" required>
      <div id="validationServer05Feedback" 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" aria-describedby="invalidCheck3Feedback" required>
      <label class="form-check-label" for="invalidCheck3">
        Agree to terms and conditions
      </label>
      <div  id="invalidCheck3Feedback" class="invalid-feedback">
        You must agree before submitting.
      </div>
    </div>
  </div>
  <button class="btn btn-primary" type="submit">Submit form</button>
</form>

Éléments pris en charge

Les styles de validation sont disponibles pour les contrôles et composants de formulaire suivants :

  • <input>s et <textarea>s avec.form-control
  • <select>avec .form-controlou.custom-select
  • .form-checks
  • .custom-checkboxs et .custom-radios
  • .custom-file
Veuillez saisir un message dans la zone de texte.
Exemple de texte de commentaire non valide
Plus d'exemples de texte de commentaire non valide
Exemple de commentaire de sélection personnalisée non valide
Exemple de commentaire de fichier personnalisé non valide
@
Exemple de commentaires de groupe d'entrée non valides
Exemple de commentaires de groupe d'entrée non valides
Exemple de commentaires de groupe d'entrée non valides 
<form class="was-validated">
  <div class="mb-3">
    <label for="validationTextarea">Textarea</label>
    <textarea class="form-control is-invalid" id="validationTextarea" placeholder="Required example textarea" required></textarea>
    <div class="invalid-feedback">
      Please enter a message in the textarea.
    </div>
  </div>

  <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="mb-3">
    <select class="custom-select" required>
      <option value="">Choose...</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 mb-3">
    <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>

  <div class="mb-3">
    <div class="input-group is-invalid">
      <div class="input-group-prepend">
        <span class="input-group-text" id="validatedInputGroupPrepend">@</span>
      </div>
      <input type="text" class="form-control is-invalid" aria-describedby="validatedInputGroupPrepend" required>
    </div>
    <div class="invalid-feedback">
      Example invalid input group feedback
    </div>
  </div>

  <div class="mb-3">
    <div class="input-group is-invalid">
      <div class="input-group-prepend">
        <label class="input-group-text" for="validatedInputGroupSelect">Options</label>
      </div>
      <select class="custom-select" id="validatedInputGroupSelect" required>
        <option value="">Choose...</option>
        <option value="1">One</option>
        <option value="2">Two</option>
        <option value="3">Three</option>
      </select>
    </div>
    <div class="invalid-feedback">
      Example invalid input group feedback
    </div>
  </div>

  <div class="input-group is-invalid">
    <div class="custom-file">
      <input type="file" class="custom-file-input" id="validatedInputGroupCustomFile" required>
      <label class="custom-file-label" for="validatedInputGroupCustomFile">Choose file...</label>
    </div>
    <div class="input-group-append">
       <button class="btn btn-outline-secondary" type="button">Button</button>
    </div>
  </div>
  <div class="invalid-feedback">
    Example invalid input group feedback
  </div>
</form>

Info-bulles

Si la mise en page de votre formulaire le permet, vous pouvez échanger les .{valid|invalid}-feedbackclasses contre des .{valid|invalid}-tooltipclasses pour afficher les commentaires de validation dans une info-bulle stylisée. Assurez-vous d'avoir un parent position: relativedessus pour le positionnement de l'info-bulle. Dans l'exemple ci-dessous, nos classes de colonnes l'ont déjà, mais votre projet peut nécessiter une configuration alternative.

Cela semble bon!
Cela semble bon!
Veuillez fournir une ville valide.
Veuillez sélectionner un état valide.
Veuillez fournir un code postal valide. 
<form class="needs-validation" novalidate>
  <div class="form-row">
    <div class="col-md-6 mb-3">
      <label for="validationTooltip01">First name</label>
      <input type="text" class="form-control" id="validationTooltip01" value="Mark" required>
      <div class="valid-tooltip">
        Looks good!
      </div>
    </div>
    <div class="col-md-6 mb-3">
      <label for="validationTooltip02">Last name</label>
      <input type="text" class="form-control" id="validationTooltip02" value="Otto" required>
      <div class="valid-tooltip">
        Looks good!
      </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" required>
      <div class="invalid-tooltip">
        Please provide a valid city.
      </div>
    </div>
    <div class="col-md-3 mb-3">
      <label for="validationTooltip04">State</label>
      <select class="custom-select" id="validationTooltip04" required>
        <option selected disabled value="">Choose...</option>
        <option>...</option>
      </select>
      <div class="invalid-tooltip">
        Please select 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" required>
      <div class="invalid-tooltip">
        Please provide a valid zip.
      </div>
    </div>
  </div>
  <button class="btn btn-primary" type="submit">Submit form</button>
</form>

Personnalisation

Les états de validation peuvent être personnalisés via Sass avec la $form-validation-statescarte. Située dans notre _variables.scssfichier, cette carte Sass est bouclée pour générer les états par défaut valid/ invalidvalidation. Une carte imbriquée est incluse pour personnaliser la couleur et l'icône de chaque état. Bien qu'aucun autre état ne soit pris en charge par les navigateurs, ceux qui utilisent des styles personnalisés peuvent facilement ajouter des commentaires de formulaire plus complexes.

Veuillez noter que nous ne recommandons pas de personnaliser ces valeurs sans également modifier le form-validation-statemixin.

// Sass map from `_variables.scss`
// Override this and recompile your Sass to generate different states
$form-validation-states: map-merge(
  (
    "valid": (
      "color": $form-feedback-valid-color,
      "icon": $form-feedback-icon-valid
    ),
    "invalid": (
      "color": $form-feedback-invalid-color,
      "icon": $form-feedback-icon-invalid
    )
  ),
  $form-validation-states
);

// Loop from `_forms.scss`
// Any modifications to the above Sass map will be reflected in your compiled
// CSS via this loop.
@each $state, $data in $form-validation-states {
  @include form-validation-state($state, map-get($data, color), map-get($data, icon));
}

Validation du groupe d'entrée

Pour détecter quels éléments ont besoin de coins arrondis à l'intérieur d'un groupe d'entrée avec validation, un groupe d'entrée nécessite une .has-validationclasse supplémentaire.

<div class="input-group has-validation">
  <div class="input-group-prepend">
    <span class="input-group-text">@</span>
  </div>
  <input type="text" class="form-control" required>
  <div class="invalid-feedback">
    Please choose a username.
  </div>
</div>
@
Veuillez choisir un nom d'utilisateur.

Formulaires personnalisés

Pour encore plus de personnalisation et de cohérence entre les navigateurs, utilisez nos éléments de formulaire entièrement personnalisés pour remplacer les paramètres par défaut du navigateur. Ils sont construits sur un balisage sémantique et accessible, ce qui en fait des substituts solides pour tout contrôle de formulaire par défaut.

Cases à cocher et radios

Chaque case à cocher, radio <input>et <label>couplage est enveloppé dans un <div>pour créer notre contrôle personnalisé. Structurellement, c'est la même approche que notre default .form-check.

Nous utilisons le sélecteur frère ( ~) pour tous nos <input>états — comme :checked— pour styliser correctement notre indicateur de formulaire personnalisé. Lorsqu'il est combiné avec la .custom-control-labelclasse, nous pouvons également styliser le texte de chaque élément en fonction de l' <input>état de .

Nous masquons la valeur par défaut <input>avec opacityet utilisons le .custom-control-labelpour créer un nouvel indicateur de formulaire personnalisé à sa place avec ::beforeet ::after. Malheureusement, nous ne pouvons pas en créer un personnalisé à partir du <input>car CSS contentne fonctionne pas sur cet élément.

Dans les états cochés, nous utilisons des icônes SVG intégrées en base64 de Open Iconic . Cela nous offre le meilleur contrôle pour le style et le positionnement sur les navigateurs et les appareils.

Cases à cocher

<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>

Les cases à cocher personnalisées peuvent également utiliser la :indeterminatepseudo-classe lorsqu'elles sont définies manuellement via JavaScript (il n'y a pas d'attribut HTML disponible pour le spécifier).

Si vous utilisez jQuery, quelque chose comme ceci devrait suffire :

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

Radios

<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>

En ligne

<div class="custom-control custom-radio custom-control-inline">
  <input type="radio" id="customRadioInline1" name="customRadioInline" 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="customRadioInline" class="custom-control-input">
  <label class="custom-control-label" for="customRadioInline2">Or toggle this other custom radio</label>
</div>

Handicapé

Les cases à cocher et les radios personnalisées peuvent également être désactivées. Ajoutez l' disabledattribut booléen au <input>et l'indicateur personnalisé et la description de l'étiquette seront automatiquement stylés.

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

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

Commutateurs

Un commutateur a le balisage d'une case à cocher personnalisée mais utilise la .custom-switchclasse pour rendre un commutateur à bascule. Les commutateurs prennent également en charge l' disabledattribut.

<div class="custom-control custom-switch">
  <input type="checkbox" class="custom-control-input" id="customSwitch1">
  <label class="custom-control-label" for="customSwitch1">Toggle this switch element</label>
</div>
<div class="custom-control custom-switch">
  <input type="checkbox" class="custom-control-input" disabled id="customSwitch2">
  <label class="custom-control-label" for="customSwitch2">Disabled switch element</label>
</div>

Sélectionnez le menu

Les <select>menus personnalisés n'ont besoin que d'une classe personnalisée .custom-selectpour déclencher les styles personnalisés. Les styles personnalisés sont limités à l' <select>apparence initiale de et ne peuvent pas modifier le <option>s en raison des limitations du navigateur.

<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>

Vous pouvez également choisir parmi des sélections personnalisées petites et grandes pour correspondre à nos entrées de texte de taille similaire.

<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>

L' multipleattribut est également pris en charge :

<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>

Comme l' sizeattribut :

<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>

Intervalle

Créez des <input type="range">contrôles personnalisés avec.custom-range . La piste (l'arrière-plan) et le pouce (la valeur) sont tous deux stylisés pour apparaître de la même manière dans tous les navigateurs. Comme seuls IE et Firefox prennent en charge le "remplissage" de leur piste à partir de la gauche ou de la droite du pouce comme moyen d'indiquer visuellement la progression, nous ne le prenons pas actuellement en charge.

<label for="customRange1">Example range</label>
<input type="range" class="custom-range" id="customRange1">

Les entrées de plage ont des valeurs implicites pour minet max— 0et 100, respectivement. Vous pouvez spécifier de nouvelles valeurs pour ceux qui utilisent minlesmax attributs

<label for="customRange2">Example range</label>
<input type="range" class="custom-range" min="0" max="5" id="customRange2">

Par défaut, les entrées de plage « s'alignent » sur des valeurs entières. Pour changer cela, vous pouvez spécifier une stepvaleur. Dans l'exemple ci-dessous, nous doublons le nombre d'étapes en utilisantstep="0.5" .

<label for="customRange3">Example range</label>
<input type="range" class="custom-range" min="0" max="5" step="0.5" id="customRange3">

Navigateur de fichiers

Le plugin recommandé pour animer l'entrée de fichier personnalisé : bs-custom-file-input , c'est ce que nous utilisons actuellement ici dans nos docs.

L'entrée de fichier est la plus noueuse du groupe et nécessite du JavaScript supplémentaire si vous souhaitez les connecter avec le fichier fonctionnel Choisir… et le texte du nom de fichier sélectionné.

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

Nous masquons le fichier par défaut <input>via opacityet stylisons à la place le fichier <label>. Le bouton est généré et positionné avec ::after. Enfin, nous déclarons un widthet heightsur le <input>pour un espacement approprié pour le contenu environnant.

Traduire ou personnaliser les chaînes avec SCSS

La :lang()pseudo-classe est utilisée pour permettre la traduction du texte "Browse" dans d'autres langues. Remplacez ou ajoutez des entrées à la $custom-file-textvariable Sass avec la balise de langue appropriée et les chaînes localisées. Les chaînes anglaises peuvent être personnalisées de la même manière. Par exemple, voici comment ajouter une traduction en espagnol (le code de la langue espagnole est es) :

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

Voici lang(es)en action l'entrée de fichier personnalisée pour une traduction en espagnol :

<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>

Vous devrez définir correctement la langue de votre document (ou de sa sous-arborescence) pour que le texte correct s'affiche. Cela peut être fait en utilisant l' langattribut sur l' <html>élément ou l' Content-Languageen-tête HTTP , entre autres méthodes.

Traduire ou personnaliser les chaînes avec HTML

Bootstrap fournit également un moyen de traduire le texte "Browse" en HTML avec l' data-browseattribut qui peut être ajouté à l'étiquette d'entrée personnalisée (exemple en néerlandais) :

<div class="custom-file">
  <input type="file" class="custom-file-input" id="customFileLangHTML">
  <label class="custom-file-label" for="customFileLangHTML" data-browse="Bestand kiezen">Voeg je document toe</label>
</div>