दुनिया भर में काम करने वाला फ़ॉर्म

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 है; किसी को एक शब्द का नाम और बिना पिन कोड का पता दें, और सुनिश्चित करें कि फ़ॉर्म दोनों स्वीकार करता है।

अगले कदम