Skip to main content Skip to docs navigation
Ver en GitHub

Controles de formulario (Form controls)

Mejora los controles de formulario textuales como <input> y <textarea> con estilos personalizados, tamaños, estados de enfoque y más.

En esta página

Ejemplo

Los controles de formulario están diseñados con una combinación de variables Sass y CSS, lo que les permite adaptarse a los modos de color y admitir cualquier método de personalización.

html 
<div class="mb-3">
  <label for="exampleFormControlInput1" class="form-label">Dirección de correo electrónico</label>
  <input type="email" class="form-control" id="exampleFormControlInput1" placeholder="[email protected]">
</div>
<div class="mb-3">
  <label for="exampleFormControlTextarea1" class="form-label">Área de texto de ejemplo</label>
  <textarea class="form-control" id="exampleFormControlTextarea1" rows="3"></textarea>
</div>

Tamaño

Establece alturas usando clases como .form-control-lg y .form-control-sm.

html 
<input class="form-control form-control-lg" type="text" placeholder=".form-control-lg" aria-label=".form-control-lg example">
<input class="form-control" type="text" placeholder="Entrada predeterminada" aria-label="default input example">
<input class="form-control form-control-sm" type="text" placeholder=".form-control-sm" aria-label=".form-control-sm example">

Texto del formulario (Form text)

Se puede crear texto de formulario a nivel de bloque o en línea utilizando .form-text.

El texto del formulario debe asociarse explícitamente con el control de formulario al que se refiere utilizando el atributo aria-describedby. Esto garantizará que las tecnologías de asistencia (como los lectores de pantalla) anuncien este texto del formulario cuando el usuario enfoque o ingrese al control.

El texto del formulario debajo de las entradas se puede diseñar con .form-text. Si se utiliza un elemento a nivel de bloque, se agrega un margen superior para facilitar el espaciado de las entradas anteriores.

Tu contraseña debe tener entre 8 y 20 caracteres, contener letras y números, y no debe contener espacios, caracteres especiales ni emojis.
html 
<label for="inputPassword5" class="form-label">Contraseña</label>
<input type="password" id="inputPassword5" class="form-control" aria-describedby="passwordHelpBlock">
<div id="passwordHelpBlock" class="form-text">
  Tu contraseña debe tener entre 8 y 20 caracteres, contener letras y números, y no debe contener espacios, caracteres especiales ni emojis.
</div>

El texto en línea puede utilizar cualquier elemento HTML en línea típico (ya sea un <span>, <small> u otro) con nada más que la clase .form-text.

Debe tener entre 8 y 20 caracteres.
html 
<div class="row g-3 align-items-center">
  <div class="col-auto">
    <label for="inputPassword6" class="col-form-label">Contraseña</label>
  </div>
  <div class="col-auto">
    <input type="password" id="inputPassword6" class="form-control" aria-describedby="passwordHelpInline">
  </div>
  <div class="col-auto">
    <span id="passwordHelpInline" class="form-text">
      Debe tener entre 8 y 20 caracteres.
    </span>
  </div>
</div>

Deshabilitado

Agrega el atributo booleano disabled en una entrada para darle una apariencia atenuada, eliminar eventos del puntero y evitar el enfoque.

html 
<input class="form-control" type="text" placeholder="Entrada deshabilitada" aria-label="Disabled input example" disabled>
<input class="form-control" type="text" value="Entrada deshabilitada de solo lectura" aria-label="Disabled input example" disabled readonly>

Solo lectura (Readonly)

Agrega el atributo booleano readonly en una entrada para evitar la modificación del valor de la entrada. Las entradas de readonly aún se pueden enfocar y seleccionar, mientras que las entradas de disabled no.

html 
<input class="form-control" type="text" value="Entrada de solo lectura aquí..." aria-label="readonly input example" readonly>

Texto sin formato de solo lectura (Readonly plain text)

Si deseas que los elementos <input readonly> de tu formulario tengan el estilo de texto sin formato, reemplaza .form-control con .form-control-plaintext para eliminar el estilo de campo de formulario predeterminado y conservar el margin y padding correctos.

html 
<div class="mb-3 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="mb-3 row">
  <label for="inputPassword" class="col-sm-2 col-form-label">Contraseña</label>
  <div class="col-sm-10">
    <input type="password" class="form-control" id="inputPassword">
  </div>
</div>
html 
<form class="row g-3">
  <div class="col-auto">
    <label for="staticEmail2" class="visually-hidden">Email</label>
    <input type="text" readonly class="form-control-plaintext" id="staticEmail2" value="[email protected]">
  </div>
  <div class="col-auto">
    <label for="inputPassword2" class="visually-hidden">Contraseña</label>
    <input type="password" class="form-control" id="inputPassword2" placeholder="Contraseña">
  </div>
  <div class="col-auto">
    <button type="submit" class="btn btn-primary mb-3">Confirmar identidad</button>
  </div>
</form>

Entrada de archivos (File input)

html 
<div class="mb-3">
  <label for="formFile" class="form-label">Ejemplo de entrada de archivos predeterminado</label>
  <input class="form-control" type="file" id="formFile">
</div>
<div class="mb-3">
  <label for="formFileMultiple" class="form-label">Ejemplo de entrada de archivos múltiples</label>
  <input class="form-control" type="file" id="formFileMultiple" multiple>
</div>
<div class="mb-3">
  <label for="formFileDisabled" class="form-label">Ejemplo de entrada de archivos deshabilitada</label>
  <input class="form-control" type="file" id="formFileDisabled" disabled>
</div>
<div class="mb-3">
  <label for="formFileSm" class="form-label">Ejemplo de entrada de archivos pequeña</label>
  <input class="form-control form-control-sm" id="formFileSm" type="file">
</div>
<div>
  <label for="formFileLg" class="form-label">Ejemplo de entrada de archivos grande</label>
  <input class="form-control form-control-lg" id="formFileLg" type="file">
</div>

Color

Establece el type="color" y agrega .form-control-color al <input>. Usamos la clase modificadora para establecer alturas fijas y anular algunas inconsistencias entre navegadores.

html 
<label for="exampleColorInput" class="form-label">Selector de color</label>
<input type="color" class="form-control form-control-color" id="exampleColorInput" value="#563d7c" title="Elige tu color">

Listas de datos (Datalists)

Las listas de datos te permiten crear un grupo de opciones <option> a las que se puede acceder (y autocompletar) desde un <input>. Son similares a los elementos <select>, pero vienen con más limitaciones y diferencias de estilo en sus menús. Si bien la mayoría de los navegadores y sistemas operativos incluyen cierto soporte para los elementos <datalist>, su estilo es, en el mejor de los casos, inconsistente.

Obtén más información sobre el soporte para elementos datalist.

html 
<label for="exampleDataList" class="form-label">Ejemplo de datalist</label>
<input class="form-control" list="datalistOptions" id="exampleDataList" placeholder="Escribe para buscar...">
<datalist id="datalistOptions">
  <option value="San Francisco">
  <option value="New York">
  <option value="Seattle">
  <option value="Los Angeles">
  <option value="Chicago">
</datalist>

CSS

Variables Sass

$input-* se comparten en la mayoría de nuestros controles de formulario (y no en los botones).

scss/_variables.scss 
$input-padding-y:                       $input-btn-padding-y;
$input-padding-x:                       $input-btn-padding-x;
$input-font-family:                     $input-btn-font-family;
$input-font-size:                       $input-btn-font-size;
$input-font-weight:                     $font-weight-base;
$input-line-height:                     $input-btn-line-height;

$input-padding-y-sm:                    $input-btn-padding-y-sm;
$input-padding-x-sm:                    $input-btn-padding-x-sm;
$input-font-size-sm:                    $input-btn-font-size-sm;

$input-padding-y-lg:                    $input-btn-padding-y-lg;
$input-padding-x-lg:                    $input-btn-padding-x-lg;
$input-font-size-lg:                    $input-btn-font-size-lg;

$input-bg:                              var(--#{$prefix}body-bg);
$input-disabled-color:                  null;
$input-disabled-bg:                     var(--#{$prefix}secondary-bg);
$input-disabled-border-color:           null;

$input-color:                           var(--#{$prefix}body-color);
$input-border-color:                    var(--#{$prefix}border-color);
$input-border-width:                    $input-btn-border-width;
$input-box-shadow:                      var(--#{$prefix}box-shadow-inset);

$input-border-radius:                   var(--#{$prefix}border-radius);
$input-border-radius-sm:                var(--#{$prefix}border-radius-sm);
$input-border-radius-lg:                var(--#{$prefix}border-radius-lg);

$input-focus-bg:                        $input-bg;
$input-focus-border-color:              tint-color($component-active-bg, 50%);
$input-focus-color:                     $input-color;
$input-focus-width:                     $input-btn-focus-width;
$input-focus-box-shadow:                $input-btn-focus-box-shadow;

$input-placeholder-color:               var(--#{$prefix}secondary-color);
$input-plaintext-color:                 var(--#{$prefix}body-color);

$input-height-border:                   calc(#{$input-border-width} * 2); // stylelint-disable-line function-disallowed-list

$input-height-inner:                    add($input-line-height * 1em, $input-padding-y * 2);
$input-height-inner-half:               add($input-line-height * .5em, $input-padding-y);
$input-height-inner-quarter:            add($input-line-height * .25em, $input-padding-y * .5);

$input-height:                          add($input-line-height * 1em, add($input-padding-y * 2, $input-height-border, false));
$input-height-sm:                       add($input-line-height * 1em, add($input-padding-y-sm * 2, $input-height-border, false));
$input-height-lg:                       add($input-line-height * 1em, add($input-padding-y-lg * 2, $input-height-border, false));

$input-transition:                      border-color .15s ease-in-out, box-shadow .15s ease-in-out;

$form-color-width:                      3rem;

$form-label-* y $form-text-* son para nuestras etiquetas <label> y el componente .form-text.

scss/_variables.scss 
$form-label-margin-bottom:              .5rem;
$form-label-font-size:                  null;
$form-label-font-style:                 null;
$form-label-font-weight:                null;
$form-label-color:                      null;
scss/_variables.scss 
$form-text-margin-top:                  .25rem;
$form-text-font-size:                   $small-font-size;
$form-text-font-style:                  null;
$form-text-font-weight:                 null;
$form-text-color:                       var(--#{$prefix}secondary-color);

$form-file-* son para la entrada de archivos.

scss/_variables.scss 
$form-file-button-color:          $input-color;
$form-file-button-bg:             var(--#{$prefix}tertiary-bg);
$form-file-button-hover-bg:       var(--#{$prefix}secondary-bg);