Ejemplos

Campo con ayuda

La etiqueta va siempre visible y antes del control. La ayuda se enlaza con aria-describedby.

Vista previa · colores por defecto de angela

Como aparece en tu documento.

<div class="field">
  <label for="c-nombre">Nombre completo</label>
  <p class="hint" id="c-nombre-hint">Como aparece en tu documento.</p>
  <input class="input" id="c-nombre" name="nombre" autocomplete="name" aria-describedby="c-nombre-hint">
</div>

Validación accesible

El error aparece al salir del campo (no mientras escribes) gracias a :user-invalid. @angela-ui/angela/js sincroniza aria-invalid, enlaza el mensaje y lo anuncia. Prueba a escribir un correo incompleto y salir del campo, o envía el formulario vacío.

Vista previa · colores por defecto de angela

Crear cuenta

Escribe un correo válido, por ejemplo ana@correo.com.

Mínimo 8 caracteres.

La contraseña necesita al menos 8 caracteres.

<form class="stack" action="#" method="post" aria-labelledby="c-form-titulo">
  <h4 id="c-form-titulo">Crear cuenta</h4>
  <div class="field">
    <label for="c-email">Correo <span aria-hidden="true">*</span></label>
    <input class="input" id="c-email" name="email" type="email" required autocomplete="email"
      autocapitalize="none" spellcheck="false" data-error="c-email-error">
    <p class="error" id="c-email-error">Escribe un correo válido, por ejemplo ana@correo.com.</p>
  </div>
  <div class="field">
    <label for="c-pass">Contraseña <span aria-hidden="true">*</span></label>
    <p class="hint" id="c-pass-hint">Mínimo 8 caracteres.</p>
    <input class="input" id="c-pass" name="password" type="password" required minlength="8"
      autocomplete="new-password" aria-describedby="c-pass-hint" data-error="c-pass-error">
    <p class="error" id="c-pass-error">La contraseña necesita al menos 8 caracteres.</p>
  </div>
  <div class="cluster">
    <button class="button" type="submit">Crear cuenta</button>
  </div>
</form>

Error del servidor

Si el error viene del servidor, renderiza aria-invalid="true" y enlaza el mensaje en aria-describedby. El script lo respeta.

Vista previa · colores por defecto de angela

Ese usuario ya existe. Prueba con otro.

<div class="field">
  <label for="c-usuario">Usuario</label>
  <input class="input" id="c-usuario" name="usuario" value="ana" aria-invalid="true"
    aria-describedby="c-usuario-error" autocapitalize="none" spellcheck="false">
  <p class="error" id="c-usuario-error">Ese usuario ya existe. Prueba con otro.</p>
</div>

Select y textarea

El select es nativo: en móvil abre el selector del sistema. El textarea crece con el contenido donde se soporta field-sizing.

Vista previa · colores por defecto de angela

<div class="stack">
  <div class="field">
    <label for="c-pais">País</label>
    <select class="input" id="c-pais" name="pais" autocomplete="country">
      <option value="">Elige un país</option>
      <option>Argentina</option>
      <option>Colombia</option>
      <option>España</option>
      <option>México</option>
      <option>Perú</option>
      <option>Chile</option>
    </select>
  </div>
  <div class="field">
    <label for="c-mensaje">Mensaje</label>
    <textarea class="input" id="c-mensaje" name="mensaje"></textarea>
  </div>
</div>

Deshabilitado y solo lectura

Vista previa · colores por defecto de angela

<div class="stack">
  <div class="field">
    <label for="c-dis">Código de cliente</label>
    <input class="input" id="c-dis" value="CL-2048" disabled>
  </div>
  <div class="field">
    <label for="c-ro">Fecha de alta</label>
    <input class="input" id="c-ro" value="18/11/2026" readonly>
  </div>
</div>

API

Clases y atributos de Campos de texto
Clase o atributoUso
.fieldContenedor: etiqueta, ayuda, control y error en una columna.
.inputPara <input>, <select> y <textarea>. data-size="sm|lg".
.hintTexto de ayuda. Enlázalo con aria-describedby.
.errorMensaje de error. Se muestra con :user-invalid o aria-invalid="true".
data-errorEn el control: id de su mensaje de error (lo usa @angela-ui/angela/js).
.fieldsetPara <fieldset> con <legend> como primer hijo.

Accesibilidad

  • Cada control tiene un <label for> visible. El placeholder nunca sustituye a la etiqueta.
  • Usa los atributos nativos: required, minlength, pattern, type="email"… y autocomplete para datos personales.
  • El error no se muestra antes de interactuar y no se anuncia en cada tecla.
  • El estado de error se comunica con texto e ícono, no solo con color.
  • Fuente de 16 px mínimo en los controles para evitar el zoom de iOS.
  • Inputs numéricos: usa inputmode="numeric" con type="text" para códigos, tarjetas o documentos (sin ceros perdidos).