Форма, которая работает по всему миру

Lily рассчитан на все страны, а не на одну. В нём нет английского текста и нет страны по умолчанию, поэтому выбор, делающий форму местной, остаётся за вами и делается осознанно. Это руководство проходит по каждому такому выбору.

Что вы создадите

Форму регистрации для клиники, которая принимает людей из многих стран: имя, дата рождения, адрес, телефон, оплата и страница, которая при необходимости читается справа налево. Примеры на Svelte; все каталоги принимают те же свойства. Около 20 минут, после руководства по доступным формам.

Шаг 1 — Имена: одно поле, а не два

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

«Имя» и «фамилия» не подходят многим: единственное имя, фамилия первой, две фамилии, отчество. Спрашивайте полное имя в одном поле, а если нужно знать, как обращаться к человеку, спросите об этом отдельно.

Шаг 2 — Даты: части в привычном читателю порядке

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

order может быть "dmy", "mdy" или "ymd": выберите тот, которого ждут ваши читатели, ведь 03/04 — это март в одной стране и апрель в соседней. Значение всегда в ISO (YYYY-MM-DD), при любом порядке. Для даты, которую человек знает лишь частично, например когда началась болезнь, precision="month" сохраняет 2019-03 и никогда не выдумывает день.

Чтобы показать дату, форматируйте её через Intl.DateTimeFormat на языке читателя; Lily никогда не делает этого за вас.

Шаг 3 — Адреса: без формы какой-либо страны по умолчанию

<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 — это именованная группа; поля внутри задаёте вы. Адрес свободным текстом плюс страна работает везде. Если делите адрес на части, делайте это по странам (во многих индекс необязателен или отсутствует) и никогда не делайте обязательным поле «штат».

Шаг 4 — Телефоны и деньги

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

Принимайте телефон так, как его ввели, с пробелами и знаком +; не навязывайте формат одной страны. CurrencyInput не имеет валюты по умолчанию: currencyCode (ISO 4217) обязателен, ведь валюта по умолчанию была бы деньгами одной страны.

Шаг 5 — Направление письма и язык

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

Выбор языка задаёт lang и dir на странице, поэтому арабский или иврит читаются справа налево. Каждый компонент Lily наследует dir; темы используют логические свойства (margin-inline-start, а не margin-left), и ваш CSS должен тоже. Выбор языка ничего не переводит: текст берётся из ваших собственных переводов.

Шаг 6 — Подписи помощников на языке читателя

<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)} … />

У таблицы данных, канбан-доски, календаря, диаграммы Ганта и фильтра много подписей для программ экранного доступа. Lily поставляет их на 64 языках в виде пакетов подписей. Проверен только английский; остальные 63 — машинные черновики, поэтому попросите носителя языка проверить формулировки, прежде чем полагаться на пакет. Пакет никогда не подставляет другой язык.

Проверьте работу: переключите страницу на арабский и убедитесь, что вёрстка отражается без обрезанного текста; введите дату в своём порядке и проверьте, что отправлено значение в ISO; дайте человеку имя из одного слова и адрес без индекса и убедитесь, что форма принимает и то и другое.

Что дальше