Форма, которая работает по всему миру
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; дайте человеку имя из одного слова и адрес без индекса и убедитесь, что форма принимает и то и другое.
Что дальше
- Обучение — восемь модулей, в каждом упражнение и самопроверка.
-
Национальные идентификаторы: 164 компонента для 82 типов идентификаторов более чем в 50 странах, у каждого есть
-inputи-view. - Помощники настроек: язык, размер текста, анимация и часовой пояс.
- Языки: языки, которые охватывают сайт и пакеты подписей.