CSS: form-field-group ​

.instui-form-field-group — Un grupo <fieldset> con una leyenda, un diseño en columna o en línea, y espaciado configurable.

Establece su propio gap entre campos, ajustable con los modificadores -col-spacing-*/-row-spacing-* abajo — prefiera esos sobre encadenar un modificador genérico de utilidad de espaciado -gap-*, que anula el valor integrado por completo.

Source: form-field-group.css

Accesibilidad ​

Representa un <fieldset> nativo con una <legend>, de modo que el texto de la leyenda nombre todo el grupo para las tecnologías de asistencia.

Uso ​

css
@import "@pantoken/components/components.css";
@import "@pantoken/components/form-field-group.css";

Ejemplos ​

html
<fieldset class="instui-form-field-group -layout-columns -col-spacing-medium">
  <legend>Dirección de envío</legend>
  <label class="instui-form-field">
    <span class="label">Nombre</span>
    <span class="controls"><input class="instui-text-input"></span>
  </label>
  <label class="instui-form-field">
    <span class="label">Apellido</span>
    <span class="controls"><input class="instui-text-input"></span>
  </label>
  <label class="instui-form-field">
    <span class="label">Ciudad</span>
    <span class="controls"><input class="instui-text-input"></span>
  </label>
  <label class="instui-form-field">
    <span class="label">Estado</span>
    <span class="controls">
      <select class="instui-simple-select">
        <option>CA</option>
        <option>NY</option>
        <option>TX</option>
      </select>
    </span>
  </label>
  <div class="instui-form-field-messages">
    <span class="instui-form-field-message -type-hint">Todos los campos se usan únicamente para la entrega.</span>
  </div>
</fieldset>

Estructura ​

text
.instui-form-field-group.-layout-columns.-col-spacing-medium
  legend
  form-field (component)
  form-field-messages (component)
flowchart TD n0[".instui-form-field-group.-layout-columns.-col-spacing-medium"]:::cssdoc-root n1("legend"):::cssdoc-part n2(["form-field"]):::cssdoc-component n3(["form-field-messages"]):::cssdoc-component n0 --> n1 n0 --> n2 n0 --> n3 click n2 "/api/css/form-field.md" click n3 "/api/css/form-field-messages.md" classDef cssdoc-root stroke-width:1px; classDef cssdoc-part stroke-width:1px; classDef cssdoc-slot stroke-width:1px; classDef cssdoc-component stroke-width:1px;

Modificadores ​

ModificadorDescripción
.-col-spacing-largeGran espacio entre columnas.
.-col-spacing-mediumEspacio medio entre columnas.
.-col-spacing-noneSin espacio entre columnas.
.-col-spacing-smallPequeño espacio entre columnas.
.-layout-alignedAlinear los campos hijos a una cuadrícula compartida.
.-layout-columnsDistribuir los campos hijos en columnas.
.-layout-inlineDistribuir los campos hijos en línea, en una fila.
.-requiredMarcar el grupo como obligatorio.
.-row-spacing-largeGran espacio entre filas.
.-row-spacing-mediumEspacio medio entre filas.
.-row-spacing-noneSin espacio entre filas.
.-row-spacing-smallPequeño espacio entre filas.
.-v-align-bottomAlinear los campos abajo.
.-v-align-middleAlinear los campos al centro (vertical).
.-v-align-topAlinear los campos arriba.

Pseudoelementos ​

PseudoelementoDescripción
::afterMuestra el asterisco decorativo de campo obligatorio después del texto de la leyenda cuando el grupo es obligatorio.

Condiciones ​

TipoConsultaDescripción
supports(grid-template-columns: subgrid)—

Tokens consumidos ​

TokenTipoValor
--instui-component-form-field-layout-asterisk-color<color>LightDarklight-dark(#C51F22, #FA917F)
--instui-component-form-field-layout-font-family[ <font-family-name> | <generic-font-family> ]#Atkinson Hyperlegible Next, "Helvetica Neue", Helvetica, Arial, sans-serif
--instui-component-form-field-layout-font-size<length>1rem
--instui-component-form-field-layout-font-weight<integer>400
--instui-component-form-field-layout-gap-inputs<length>0.75rem
--instui-component-form-field-layout-gap-primitives<length>0.5rem
--instui-component-form-field-layout-line-height<length>1.125rem
--instui-component-form-field-layout-text-color<color>LightDarklight-dark(#273540, #ffffff)
--instui-spacing-space-lg<length>1rem
--instui-spacing-space-md<length>0.75rem
--instui-spacing-space-sm<length>0.5rem

Compatibilidad con navegadores ​

  • El modo -layout-aligned usa subgrid de CSS detrás de una protección @supports; cuando subgrid no es compatible, los campos vuelven a su propio diseño apilado.

Subcomponentes ​

Relacionado ​