نموذج يعمل في كل أنحاء العالم
يستهدف 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. - أدوات التفضيلات: اللغة وحجم النص والحركة والمنطقة الزمنية.
- اللغات المحلية: اللغات التي يغطيها الموقع وحزم التسميات.