Formulir yang bekerja di seluruh dunia
Lily menyasar setiap negara, bukan satu. Lily tidak membawa teks bahasa Inggris dan tidak mengandaikan negara apa pun, jadi pilihan yang membuat formulir terasa lokal adalah milik Anda, dibuat dengan sengaja. Tutorial ini membahasnya satu per satu.
Yang akan Anda buat
Formulir pendaftaran untuk klinik yang melayani orang dari banyak negara: nama, tanggal lahir, alamat, nomor telepon, biaya, dan halaman yang terbaca dari kanan ke kiri bila perlu. Contohnya memakai Svelte; setiap katalog menerima props yang sama. Sekitar 20 menit, setelah tutorial formulir aksesibel.
Langkah 1 — Nama: satu isian, bukan dua
<label class="label" for="name">Full name</label>
<TextInput id="name" name="name" autocomplete="name" label="Full name" />
"Nama depan" dan "nama belakang" tidak cocok bagi banyak orang: nama tunggal, nama keluarga di depan, dua nama keluarga, patronimik. Minta nama lengkap dalam satu isian, dan bila Anda perlu tahu cara memanggil seseorang, tanyakan terpisah.
Langkah 2 — Tanggal: bagian-bagiannya dalam urutan pembaca
<DateField
label="Date of birth"
dayLabel="Day"
monthLabel="Month"
yearLabel="Year"
order="dmy"
autocomplete="bday"
name="dob"
bind:value={dob}
/>
order bernilai "dmy", "mdy" atau
"ymd": pilih yang diharapkan pembaca Anda, karena 03/04 adalah Maret di satu negara dan April di negara berikutnya. Nilainya selalu ISO (YYYY-MM-DD), apa pun urutannya. Untuk tanggal yang hanya diketahui sebagian, seperti kapan suatu penyakit dimulai, precision="month"
menyimpan 2019-03 dan tidak pernah mengarang hari.
Untuk menampilkan tanggal, format dengan Intl.DateTimeFormat dalam lokal pembaca; Lily tidak pernah memformatnya untuk Anda.
Langkah 3 — Alamat: tanpa bentuk negara mana pun sebagai bawaan
<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 adalah grup bernama; isian di dalamnya milik Anda. Satu alamat teks bebas ditambah negara berfungsi di mana saja. Bila Anda memecahnya, lakukan per negara (kode pos opsional atau tidak ada di banyak negara) dan jangan pernah mewajibkan isian "provinsi/negara bagian".
Langkah 4 — Nomor telepon dan uang
<TelInput label="Phone number" name="phone" autocomplete="tel" />
<CurrencyInput label="Fee" currencyCode="KES" bind:value={fee} />
Terima nomor telepon sebagaimana diketik, dengan spasi dan tanda +; jangan paksakan format satu negara. CurrencyInput tidak punya mata uang bawaan: currencyCode (ISO 4217) wajib, karena bawaan apa pun akan menjadi uang satu negara.
Langkah 5 — Arah tulisan dan bahasa
<LocalePicker label="Language" locales={["en", "fr", "ar", "sw"]} bind:value={locale} />
Pemilih bahasa menetapkan lang dan dir pada halaman, sehingga bahasa Arab atau Ibrani terbaca dari kanan ke kiri. Setiap komponen Lily mewarisi
dir; tema memakai properti logis (margin-inline-start, bukan margin-left), dan CSS Anda pun sebaiknya begitu. Pemilih tidak menerjemahkan apa pun: teks Anda berasal dari terjemahan Anda sendiri.
Langkah 6 — Label pembantu, dalam bahasa pembaca
<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)} … />
Kisi data, papan kanban, kalender, bagan Gantt, dan filter membawa banyak label pembaca layar. Lily menyediakannya dalam 64 bahasa sebagai paket label. Hanya bahasa Inggris yang ditinjau; 63 lainnya draf mesin, jadi mintalah penutur asli memeriksa kata-katanya sebelum Anda mengandalkannya. Paket tidak pernah beralih ke bahasa lain.
Periksa hasil kerja Anda: ubah halaman ke bahasa Arab dan periksa bahwa tata letaknya tercermin tanpa teks terpotong; masukkan tanggal dalam urutan Anda dan pastikan nilai yang dikirim berformat ISO; beri seseorang nama satu kata dan alamat tanpa kode pos, dan pastikan formulir menerima keduanya.
Langkah berikutnya
- Pelatihan — delapan modul, masing-masing dengan latihan dan uji mandiri.
-
Identitas nasional: 164 komponen untuk 82 jenis identitas di lebih dari 50 negara, masing-masing berupa
-inputdan-view. - Pembantu preferensi: bahasa, ukuran teks, gerak, dan zona waktu.
- Lokal: bahasa yang dicakup situs dan paket label.