Un formulario que funciona en todo el mundo

Lily apunta a todos los países, no a uno. No incluye texto en inglés ni presupone ningún país, así que las decisiones que hacen local un formulario son tuyas, tomadas a propósito. Este tutorial las recorre.

Lo que vas a construir

Un formulario de registro para una clínica que atiende a personas de muchos países: un nombre, una fecha de nacimiento, una dirección, un teléfono, una tarifa y una página que se lee de derecha a izquierda cuando corresponde. Los ejemplos usan Svelte; todos los catálogos aceptan las mismas props. Unos 20 minutos, después del tutorial de formularios accesibles.

Paso 1 — Nombres: un campo, no dos

<label class="label" for="name">Full name</label>
<TextInput id="name" name="name" autocomplete="name" label="Full name" />

«Nombre» y «apellido» fallan con mucha gente: un nombre único, el apellido primero, dos apellidos, un patronímico. Pide el nombre completo en un solo campo y, si necesitas saber cómo llamar a alguien, pregúntalo aparte.

Paso 2 — Fechas: las partes en el orden del lector

<DateField
  label="Date of birth"
  dayLabel="Day"
  monthLabel="Month"
  yearLabel="Year"
  order="dmy"
  autocomplete="bday"
  name="dob"
  bind:value={dob}
/>

order es "dmy", "mdy" o "ymd": elige el que esperan tus lectores, porque 03/04 es marzo en un país y abril en el siguiente. El valor es siempre ISO (YYYY-MM-DD), sea cual sea el orden. Para una fecha que alguien solo conoce a medias, como cuándo empezó una enfermedad, precision="month" guarda 2019-03 y nunca inventa un día.

Para mostrar una fecha, formatéala con Intl.DateTimeFormat en el idioma del lector; Lily nunca lo hace por ti.

Paso 3 — Direcciones: la forma de ningún país por defecto

<AddressInput label="Home address">
  <label class="label" for="address">Address</label>
  <textarea class="text-area-input" id="address" name="address" autocomplete="street-address" rows="4"></textarea>
  <label class="label" for="country">Country or territory</label>
  <select class="select" id="country" name="country" autocomplete="country"> … </select>
</AddressInput>

AddressInput es un grupo con nombre; los campos de dentro son tuyos. Una dirección en texto libre más un país funciona en todas partes. Si la divides, hazlo por país (el código postal es opcional o no existe en muchos) y nunca hagas obligatorio un campo de «estado».

Paso 4 — Teléfonos y dinero

<TelInput label="Phone number" name="phone" autocomplete="tel" />
<CurrencyInput label="Fee" currencyCode="KES" bind:value={fee} />

Acepta el teléfono tal como se escribe, con espacios y un +; no impongas el formato de un país. CurrencyInput no tiene moneda por defecto: currencyCode (ISO 4217) es obligatorio, porque una moneda por defecto sería el dinero de un solo país.

Paso 5 — Sentido de escritura e idioma

<LocalePicker label="Language" locales={["en", "fr", "ar", "sw"]} bind:value={locale} />

El selector de idioma establece lang y dir en la página, para que el árabe o el hebreo se lean de derecha a izquierda. Todos los componentes de Lily heredan dir; los temas usan propiedades lógicas (margin-inline-start, no margin-left), y tu CSS también debería. El selector no traduce nada: tu texto viene de tus propias traducciones.

Paso 6 — Las etiquetas de los ayudantes, en el idioma del lector

<script lang="ts">
  import { labelsFor } from "@lilydesignsystem/svelte-locale-translations";
  import sw from "@lilydesignsystem/svelte-locale-translations/sw-001";
  import DataGrid from "@lilydesignsystem/svelte-data-grid";
</script>

<DataGrid label="Wagonjwa" labels={labelsFor("data-grid", sw)} … />

La cuadrícula de datos, el tablero kanban, el calendario, el diagrama de Gantt y el filtro tienen muchas etiquetas para lectores de pantalla. Lily las ofrece en 64 idiomas como paquetes de etiquetas. Solo el inglés está revisado; los otros 63 son borradores automáticos, así que pide a un hablante nativo que revise la redacción antes de confiar en uno. Un paquete nunca recurre a otro idioma.

Comprueba tu trabajo: cambia la página al árabe y comprueba que el diseño se refleja sin texto cortado; introduce una fecha en tu orden y confirma que el valor enviado es ISO; da a alguien un nombre de una sola palabra y una dirección sin código postal, y asegúrate de que el formulario acepta ambos.

Próximos pasos

  • Formación — ocho módulos, cada uno con un ejercicio y una autoevaluación.
  • Identificadores nacionales: 164 componentes para 82 tipos de identificador en más de 50 países, cada uno con un -input y un -view.
  • Ayudantes de preferencias: idioma, tamaño de texto, movimiento y zona horaria.
  • Idiomas: los idiomas que cubren el sitio y los paquetes de etiquetas.