الصفحات

المكونات

كل ما يقدمه void-fbtee لصفحات التطبيق، من void-fbtee/react: مكوناته وخطافاته، والغرض من كل منها، وكل منها وهو يعمل، والسطر الذي يستخدمه.

المكونات

I18nProvider

يوضع مرة واحدة حول التطبيق، في التخطيط الجذري، لتكون نصوص كل صفحة بلغتها منذ العرض الأول.

pages/layout.tsx
<I18nProvider>

Formatted

نص يُنسَّق أثناء العرض، مثل التاريخ، يبقى كما كتبه الخادم، لأن كل متصفح ينسّق بشكل مختلف قليلًا.

السبت، ٤ يوليو ٢٠٢٦
pages/[lang]/index.tsx
<Formatted>{languageName(locale)}</Formatted>

InLanguage

جزء من الصفحة بلغة أخرى، بسمة lang واتجاه خاصين به، وبصيغة تناسب جنس القارئ حيث تحتاج اللغة ذلك.

  • You're booked.
  • คุณจองแล้ว
src/docs/StringPieces.tsx
<InLanguage locale={locale} gender={gender}>

LanguagePicker

عنصر تحكم واحد لاختيار لغة أخرى، مهما كان عدد لغات التطبيق: لغة القارئ أولًا، ثم كل اللغات، مع مربع بحث. ليس له شكل خاص به: التطبيق يمنحه شكله.

src/shell/SiteHeader.tsx
<LanguagePicker

منتقي اللغة، بشكلين

المكون نفسه مرتين، بأسماء أصناف مختلفة: شكل الترويسة، وصف من الأزرار المستديرة. الترتيب والأسماء والروابط والبحث من الحزمة؛ أما الشكل فمن التطبيق.

الخطافات (Hooks)

useLocale

لغة الصفحة واتجاهها والعنوان الذي يلي اللغة.

{"locale":"ar-EG","dir":"rtl","path":"/docs/components"}
src/shell/SiteHeader.tsx
const { path } = useLocale();

useLocales

كل لغة لدى التطبيق، من إعداداته: لا قائمة خاصة بها أبدًا.

en-US, ar-EG, th-TH
pages/[lang]/docs/right-to-left.tsx
const locales = useLocales();

useHydrated

خطأ على الخادم وأثناء بدء الصفحة، ثم صحيح: لما يعرفه المتصفح وحده، ليطابق العرض الأول عرض الخادم.

false
pages/[lang]/events/[id].tsx
const hydrated = useHydrated();

useNow

الآن: لحظة الخادم أولًا، ليعرض الاثنان الشيء نفسه، ثم ساعة المتصفح.

١٦‏/١١‏/٢٠٢٦، ٣:٣٤ ص
src/docs/Fmt.tsx
const now = useNow({ updateInterval: 60_000 });

useTimeZone

المنطقة الزمنية للقارئ نفسه، حين يعرفها المتصفح؛ لا شيء على الخادم.

—
src/events/EventTime.tsx
const reader = useTimeZone();

useForm

نموذج Void، يرسل إلى العنوان بلغة الصفحة، فتكون إجابته وأخطاؤه بها أيضًا.

pages/[lang]/events/new.tsx
const form = useForm("/[lang]/events/new", {

langAttrs

lang وdir لنص بلغة غير لغة الصفحة، مثل ما ينشره الناس.

pages/[lang]/events/[id].tsx
<bdi {...langAttrs(event.locale)}>{event.venue}</bdi>