دنیا بھر میں کام کرنے والا فارم

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 ہے؛ کسی کو ایک لفظی نام اور بغیر پوسٹ کوڈ کا پتہ دیں، اور یقینی بنائیں کہ فارم دونوں قبول کرتا ہے۔

اگلے اقدامات

  • تربیت — آٹھ ماڈیول، ہر ایک میں ایک مشق اور خود جانچ۔
  • قومی شناخت کنندگان‏: 50 سے زیادہ ملکوں کی 82 اقسام کے شناخت کنندگان کے لیے 164 اجزاء، ہر ایک کا ایک -input اور ایک -view۔
  • ترجیحی معاونین‏: زبان، متن کا سائز، حرکت اور ٹائم زون۔
  • لوکیلز‏: وہ زبانیں جن کا احاطہ سائٹ اور لیبل پیک کرتے ہیں۔