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