انتقل إلى المحتوى

المكونات

التركيب

صُممت مكونات UI المضمّنة لتُركّب معًا، لا لتُستخدم منفردة. تُفتح قائمة الاختيار داخل مربع حوار، ويتحقق النموذج من صحته داخل لوحة جانبية، وتظهر القائمة في صف جدول. تشرح هذه الصفحة الآليات التي تجعل هذه الأجزاء تعمل معًا: بنية العائلات المركبة، وكيف تمرر المشغلات خصائص الأزرار، وما تفعله API التفاعلية في الخلفية، ونموذج الطبقات الذي يحافظ على اتساق الأسطح المتراكبة.

العائلات المركبة

المكوّن المركب هو كتلة جذرية مع كتل فرعية. يتولى الجذر الحالة، وتحدد كل كتلة فرعية موضعها في العائلة عبر parent وusesContext في block.json:

JSON
{
  "name": "bsui/select-option",
  "parent": ["bsui/select-popup"],
  "usesContext": ["bsui/select"]
}

توفّر الجذور منطقة InnerBlocks فيها قائمة allowedBlocks وtemplate ابتدائيًا، لذا يؤدي إدراج مربع حوار في المحرر إلى إنشاء هيكل المشغّل والخلفية المنبثقة والنافذة المنبثقة، وتتصرف العائلة بالطريقة نفسها سواء رُكّبت في المحرر أو في صفحة قائمة على الملفات أو ضمن الوسوم:

HTML
<bs:bsui-select name="role" placeholder="Pick a role">
  <bs:bsui-select-trigger />
  <bs:bsui-select-popup>
    <bs:bsui-select-option value="viewer" label="Viewer" />
    <bs:bsui-select-option value="editor" label="Editor" />
  </bs:bsui-select-popup>
</bs:bsui-select>

النوافذ المنبثقة واللوحات مناطق InnerBlocks حقيقية، وليست خانات ذات صياغة خاصة. يقبل bsui/dialog-popup كتلًا متداخلة بالطريقة نفسها التي تقبلها كتلة المجموعة، ما يجعل وضع نموذج أو قائمة اختيار أو مربع حوار آخر بداخله عملية تركيب عادية.

بيانات مسطحة أم أبناء مركّبون

تقبل بعض العائلات محتواها كبيانات بدلًا من الأبناء. تعرض قائمة الاختيار المشغّل ومربع القائمة الخاصين بها عندما تمرر إليها مصفوفة options JSON، وهو ما يناسب الخيارات القادمة من PHP:

PHP
bs_render_block([
  'name' => 'bsui/select',
  'data' => [
    'name' => 'role',
    'placeholder' => 'Pick a role',
    'options' => wp_json_encode([
      ['value' => 'viewer', 'label' => 'Viewer'],
      ['value' => 'editor', 'label' => 'Editor'],
    ]),
  ],
]);

ينتج كلا الشكلين عقد HTML نفسها وسلوك وقت التشغيل نفسه. استخدم الأبناء عندما تكون البنية مكتوبة يدويًا، واستخدم options عندما تُحسب ديناميكيًا.

تمرير خصائص المشغّل

تُفتح مكونات الطبقات المتراكبة من زر، وينبغي أن يكون هذا الزر زر النظام. بدلًا من إعادة تنفيذ الزر في كل مشغّل، تدرج كتل المشغّل في bsui/dialog وbsui/alert-dialog وbsui/drawer وbsui/menu وbsui/popover وbsui/collapsible وbsui/tooltip المكوّن bsui/button عبر حقل كتلة:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "trigger",
        "type": "block",
        "block": "bsui/button",
        "idStructure": "trigger_{id}"
      }
    ]
  }
}

يوسّع idStructure حقول الزر إلى المشغّل باستخدام بادئة trigger_. تتوفر جميع خصائص الزر: trigger_label وtrigger_variant وtrigger_size وtrigger_icon وtrigger_iconPosition وtrigger_href وtrigger_disabled.

HTML
<bs:bsui-dialog-trigger trigger_label="Invite teammate" trigger_variant="outline" />

في قالب المشغّل، يكون $a['trigger'] هو الزر المعروض بالكامل، لذا ترافق ورقة أنماط الزر والتحسينات المستقبلية معه. وفي وقت التشغيل، يمرر مساعد مشترك ربط ARIA الخاص بالحاوية (aria-haspopup وaria-expanded وaria-controls وaria-describedby وaria-labelledby وid) إلى الزر الداخلي ويحافظ على تزامنه عبر MutationObserver، فتراه التقنيات المساعدة عنصر تحكم واحدًا متماسكًا.

ما يحدث في الخلفية ضمن API التفاعلية

كل عائلة تفاعلية هي مخزن WordPress Interactivity API باسم كتلتها الجذرية: bsui/dialog وbsui/select وbsui/form وbsui/tabs وغيرها. وينتج عن ذلك ثلاث نتائج.

تُهيّأ الحالة على الخادم. يطبع القالب الجذري حالته الأولية بصيغة data-wp-context مباشرةً من سمات الكتلة:

HTML
<div
  data-wp-interactive="bsui/select"
  data-wp-context='{"open":false,"value":"","placeholder":"Pick a role", ...}'
  data-bsui-select-root
>

يكون العرض الأول صحيحًا HTML من دون وميض تهيئة من جهة العميل، وتبدأ النوافذ المنبثقة hidden، وتعمل العلامات نفسها في لوحة المحرر لأن السياق لا يعتمد على تمرير حالة خاص بالواجهة الأمامية.

يُربط السلوك بالتوجيهات، لا بـJavaScript الخاص بك. تصل القوالب العلامات بالمخازن على نحو تصريحي. لا يحتوي مشغّل قائمة الاختيار، بعد إزالة PHP منه، إلا على توجيهات:

HTML
<button
  data-wp-interactive="bsui/select"
  data-wp-on--click="actions.toggle"
  data-wp-on--keydown="actions.handleTriggerKeyDown"
  data-wp-bind--aria-expanded="state.ariaExpanded"
  data-wp-text="state.displayValue"
  data-bsui-select-trigger
  aria-haspopup="listbox"
>

يوجّه data-wp-on الأحداث إلى الإجراءات، ويحافظ data-wp-bind على تزامن السمات مع الحالة المشتقة، ويعرض data-wp-text الحالة كنص، ويمنح data-wp-on-document--click الجذور إمكانية الإغلاق عند النقر خارجها. لا يتطلب تركيب المكونات كتابة معالج أحداث؛ إذ يأتي المخزن مع الكتلة كوحدة مضمنة.

يمكن توصيل مخازنك بهذه الأجزاء. تقبل عناصر التحكم في النماذج تعبيرات التوجيه كسمات، وتتيح الصياغة ذات مساحة الأسماء في API التفاعلية توجيهها إلى أي مخزن. يوجّه onChange معالجة التغييرات إلى أحد إجراءاتك، ويربط checked حالة عنصر التحكم بحالتك، ويعرض bindText تسمية داخل عنصر span من النوع data-wp-text مرتبطة بأي مسار حالة:

HTML
<bs:bsui-switch label="Notifications" checked="myPlugin::state.notifications" onChange="myPlugin::actions.toggleNotifications" />
<bs:bsui-checkbox label="0 selected" bindText="myPlugin::state.selectionSummary" />

يتوفر bindText على عناصر bsui/label وbsui/checkbox وbsui/switch وbsui/toggle وbsui/radio-group. وفي عناصر مربع الاختيار ومفتاح التبديل وخيار الراديو، يمر عبر مكوّن التسمية المشترك، فيحتفظ النص المدفوع بالحالة بنفس أسلوب تسمية النظام تمامًا. وترسل قوائم الاختيار وحقول الإدخال الأخرى أيضًا حدث change متصاعدًا من الجذر، يحمل القيمة الجديدة في detail، للتكاملات الأوسع نطاقًا.

القيم التي تتحكم بها

اترك value أو checked دون تعيين لعُنصر تحكم يدير قيمته بنفسه. استخدم defaultValue أو defaultChecked أو defaultPressed الخاص بـ Toggle لاختياره الأولي. يتعامل Toggle المستقل مع إدخال المؤشر ولوحة المفاتيح دون مخزن مستهلك.

للتحكم في حقل من مخزنك الخاص، وفّر كلًا من الربط وإجراء onChange يحدّث القيمة المرتبطة. value مسار توجيهي، وليس قيمة افتراضية حرفية. تدعم عناصر Input وTextarea وPassword Input وNumber Field وSlider وRadio Group وColor Picker وRating وTime Picker الخاصية value. أما Checkbox وSwitch وToggle فتستخدم checked بدلًا منها.

أضف مساحة الأسماء المالكة إلى المسارات، مثل my/settings::context.quantity أو my/settings::state.quantity. لعناصر التحكم المركبة مساحة الأسماء الخاصة بها؛ ويشير المسار غير المؤهل إلى عنصر التحكم نفسه، ولا يشير تلقائيًا إلى مخزنك الأب. تدعم روابط القيم للعناصر المركبة المسارات النقطية إلى السياق أو الحالة، بما في ذلك مفاتيح المصفوفات الرقمية، لكنها لا تدعم تعبيرات JavaScript أو استدعاءات الدوال.

إليك ربطًا كاملًا لـ Number Field في كتلة مخصصة مع تفعيل دعم Interactivity API:

PHP
<div
  data-wp-interactive="my/settings"
  data-wp-context='<?php echo esc_attr(wp_json_encode(['quantity' => 2])); ?>'
>
  <bs:bsui-number-field
    nameAlt="quantity"
    defaultValue="2"
    value="my/settings::context.quantity"
    onChange="my/settings::actions.setQuantity"
  />
  <output data-wp-text="context.quantity"></output>
</div>
JavaScript
import { getContext, store } from '@wordpress/interactivity';

store('my/settings', {
  actions: {
    setQuantity(event) {
      // Compound controls publish their normalized value in a custom change event.
      if (event.detail?.value !== undefined) {
        getContext().quantity = event.detail.value;
      }
    },
  },
});

عيّن القيمة الافتراضية المطابقة للقيمة الأولية المعروضة على الخادم. بعد التهيئة، تحدّث تغييرات العنصر الأب كل نسخة مرتبطة، بما في ذلك القيم صفر وfalse والفارغة. تتبع أيضًا حقول النموذج المخفية في Checkbox وSwitch الربط checked الخاص بها. تستخدم قيم Time Picker HH:MM بتنسيق 24 ساعة أو سلسلة فارغة. بالنسبة إلى معالجات Input وTextarea وPassword Input الأصلية، اقرأ event.target.value؛ أما عناصر التحكم المركبة للقيم فتنشر event.detail.value. حدود Number Field اختيارية: يؤدي حذف min وmax إلى تركه بلا حدود، بينما يظل الصفر المصرّح به حدًا صالحًا.

تنشر Select وDate Input وPhone Input وOTP Input التغييرات عبر onChange، لكنها لا تعرض ربط value الذي تتحكم به. استخدم الخصائص الافتراضية الموثقة لتعيين القيم الأولية.

التركيب من كتل مخصصة

لا يقتصر التركيب على الصفحات. تُعرض وسوم الكتل تلقائيًا داخل قوالب الكتل، لذا يمكن لكتلة المشروع إخراج مكونات bsui مباشرةً ووضعها ضمن بنيتها الخاصة:

PHP
<div useBlockProps class="settings-panel">
  <bs:bsui-switch label="Public profile" name="public" />
  <bs:bsui-space size="4" />
  <bs:bsui-button label="Save" variant="default" />
</div>

وينطبق الأمر نفسه من PHP مع bs_block()، بما في ذلك التداخل عبر المفتاح content، كما هو موضح في العرض البرمجي. في الحالتين، تُحمّل ورقة أنماط المكوّن ومخزنه معه، وتظل كتلتك طبقة بسيطة لترتيب أجزاء النظام.

لترتيب المكونات جنبًا إلى جنب، يُستخدم bsui/stack كصف أو عمود flex عام: direction وgap على مقياس التباعد وalign وjustify ومفتاح wrap. تحتفظ العناصر الفرعية بحجمها الطبيعي افتراضيًا؛ ويمدها مفتاح grow بالتساوي لمشاركة طول الحاوية، كما يجعل زرين في تذييل يقسمان عرضه بدلًا من تجمعهما عند طرف واحد.

مجموعات الحقول والبطاقات

يعرض bsui/field-group مجموعة حقول. يجمع التنويع الافتراضي الحقول المرتبطة دون إضافة سطح. استخدم variant="card" لإطار خارجي خافت، ثم ضع الحقول داخل bsui/field-group-content للحصول على سطح محتوى داخلي. أبقِ العنوان والوصف خارج كتلة المحتوى هذه:

HTML
<bs:bsui-field-group variant="card">
  <bs:bsui-field-group-title text="Account settings" />
  <bs:bsui-field-group-description text="Manage your account preferences." />
  <bs:bsui-field-group-content>
    <bs:bsui-field>
      <bs:bsui-field-label text="Display name" />
      <bs:bsui-input nameAlt="display_name" placeholder="Enter display name" />
    </bs:bsui-field>
    <bs:bsui-field>
      <bs:bsui-field-label text="Email" />
      <bs:bsui-input nameAlt="email" type="email" placeholder="Enter email" />
    </bs:bsui-field>
  </bs:bsui-field-group-content>
</bs:bsui-field-group>

يستخدم disabled="true" في المجموعة سلوك fieldset الأصلي لتعطيل عناصر التحكم في النموذج. لا يغيّر تنسيق البطاقة النمط الافتراضي.

فواصل شريط الأدوات

ضع bsui/toolbar-separator بين عناصر شريط الأدوات. ويتبع orientation للعنصر الأب: يحصل شريط الأدوات الأفقي على فاصل عمودي بارتفاع كامل، ويحصل شريط الأدوات العمودي على فاصل أفقي بعرض كامل. تمتد الفواصل حتى الحواف الداخلية لحدود شريط الأدوات دون تغيير ارتفاع عناصر التحكم. ويُمرّر شريط الأدوات الأفقي محتواه عند تجاوز العرض المتاح.

نموذج الطبقات

غالبًا ما تنهار مكتبات المكونات عند تراكب الأسطح. تتبع المكونات المضمّنة مجموعة صغيرة من القواعد المصممة لمن يبنون واجهات حقيقية.

تُنقل النوافذ المنبثقة إلى body

عند فتح مربع حوار أو مربع حوار تنبيه أو لوحة جانبية، تُنقل النافذة المنبثقة وخلفيتها إلى document.body، مع تعليق نائب يحدد موضع إعادتهما عند الإغلاق. يحرر النقل النافذة من overflow أي عنصر سلف أو تحويله أو سياق التكديس الخاص به. كما يقفل فتحها تمرير الصفحة: ويُحتسب القفل لجميع مكونات الطبقات المتراكبة، ويُعوّض عرض شريط التمرير كي لا تتحرك الصفحة. تظهر الخلفية عند z-index: 50 والنافذة عند 51، وينتقل التركيز إلى النافذة، ويظل Tab محصورًا فيها، وعند الإغلاق يعود التركيز إلى المشغّل.

يمكن تكديس النوافذ المنبثقة. يؤدي فتح مربع حوار من داخل مربع آخر إلى إضافتهما إلى مكدس مشترك: لا تعرض الخلفية إلا النافذة الخارجية، وتصغر مربعات الحوار خلف النافذة العلوية وتظهر أطرافها من خلفها. يضبط المكدس خاصية --bs-ui-nested-dialogs مخصصة لكل نافذة خلفية، فيزداد الإزاحة والتصغير مع كل مستوى، كما يطابق العنصر الأب ارتفاع العنصر الفرعي لتظهر الطبقات بالتساوي. وعند الإغلاق، يُعاد كل شيء بترتيب عكسي، طبقة واحدة في كل مرة.

عند إغلاق نافذة منبثقة، يعود التركيز إلى مشغّلها، أي إلى العنصر الصحيح. يحل مساعد getAnchor مشترك غلاف المشغّل إلى زر النظام الموجود داخله، فيستعيد عنصر التحكم الظاهر التركيز بدلًا من غلاف غير مرئي.

لا تُحوّل النافذة المنبثقة العلوية مطلقًا

يحوّل تأثير الظهور من الخلف مربعات الحوار الخلفية فقط. وتظل النافذة العلوية عمدًا بلا تحويل، لأن العنصر المحوّل يصبح كتلة الاحتواء لعناصر position: fixed التابعة، ما يعطّل كل نافذة منبثقة عائمة تُفتح بداخله.

هذه القاعدة هي ما يجعل نموذج الطبقات بأكمله قابلًا للتركيب. تحدد الطبقات العائمة مواضعها بإحداثيات ثابتة، لا تشير إلى إطار العرض إلا ما دام لا يوجد عنصر سلف محوّل:

  • تحسب القائمة ومربع التحرير والسرد موضعيهما نسبةً إلى المشغّل باستخدام استراتيجية fixed الخاصة بـ Floating UI، فتظهران أسفله وتقلبان الموضع أو تنزاحان عند ضيق إطار العرض.
  • تفعل قائمة الاختيار الأمر نفسه عند عدم تحديد أي خيار. أما عند وجود خيار محدد، فتصطف نافذتها المنبثقة بحيث يقع الخيار المحدد مباشرة فوق المشغّل، مع إبقائها داخل إطار العرض، كما تفعل قوائم الاختيار الأصلية على macOS.
  • تفتح قائمة السياق عند موضع المؤشر clientX/clientY.

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

يغلق Escape الطبقة الأعمق أولًا

تغلق ضغطة واحدة على Escape طبقة واحدة بالضبط، من الداخل إلى الخارج:

  1. تُغلق أولًا الطبقة العائمة المفتوحة (مثل مربع قائمة الاختيار أو القائمة أو النافذة المنبثقة أو نافذة التاريخ أو الهاتف)، ويعود التركيز إلى مشغّلها. يوقف مربع الاختيار انتشار الحدث، كما تتوقف معالجات النوافذ المنبثقة عن الاستجابة عند فتح أي طبقة عائمة، فلا تستقبل النافذة الموجودة أسفلها تلك الضغطة مطلقًا.
  2. تُغلق النافذة المنبثقة العلوية بعد ذلك.
  3. عند تكديس النوافذ المنبثقة، تغلق كل ضغطة إضافية على Escape نافذة أخرى من المكدس.

الإغلاق سياسة وليس أمرًا عارضًا. يتجاهل مربع الحوار المعروض باستخدام dismissable="false" كلاً من مفتاح Escape والنقرات على الخلفية. أما bsui/alert-dialog فيستجيب لمفتاح Escape مثل أي نافذة حوار، لكنه يتجاهل عمدًا النقرات على الخلفية: فالغرض من هذا النمط هو أن يُتخذ القرار بدلًا من إغلاق النافذة عن طريق الخطأ. تُغلق مربعات الحوار العادية عند النقر على الخلفية، لأن dismissable تكون قيمته الافتراضية true.

نموذج في مربع حوار

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

HTML
<bs:bsui-dialog>
  <bs:bsui-dialog-trigger trigger_label="Invite teammate" trigger_variant="outline" />
  <bs:bsui-dialog-backdrop />
  <bs:bsui-dialog-popup>
    <bs:bsui-dialog-header>
      <bs:bsui-dialog-title content="Invite a teammate" />
      <bs:bsui-dialog-description content="They receive an email with a join link." />
    </bs:bsui-dialog-header>
    <bs:bsui-dialog-content>
      <bs:bsui-form block="team/invite" successMessage="Invitation sent.">
        <bs:bsui-field name="email">
          <bs:bsui-field-label text="Email" />
          <bs:bsui-input name="email" type="email" placeholder="colleague@example.com" required="true" />
          <bs:bsui-field-error />
        </bs:bsui-field>
        <bs:bsui-field name="role">
          <bs:bsui-field-label text="Role" />
          <bs:bsui-select name="role" defaultValue="editor" placeholder="Pick a role">
            <bs:bsui-select-trigger />
            <bs:bsui-select-popup>
              <bs:bsui-select-option value="viewer" label="Viewer" />
              <bs:bsui-select-option value="editor" label="Editor" />
              <bs:bsui-select-option value="admin" label="Admin" />
            </bs:bsui-select-popup>
          </bs:bsui-select>
        </bs:bsui-field>
        <bs:bsui-space size="2" />
        <bs:bsui-button label="Send invite" />
      </bs:bsui-form>
    </bs:bsui-dialog-content>
    <bs:bsui-dialog-footer>
      <bs:bsui-dialog-close label="Cancel" />
    </bs:bsui-dialog-footer>
  </bs:bsui-dialog-popup>
</bs:bsui-dialog>

كل وسم وسمة أعلاه أساسي: يمرر زر التشغيل إلى زر النظام، ويأخذ العنوان والوصف content، وتحمل الحقول الأسماء التي يَسلسل النموذج بياناتها، كما يحول required="true" إلى قيمة منطقية فعلية في محلل الوسوم.

ما الذي يفعله كل مخزن أثناء التشغيل

bsui/dialog يهيئ {"open":false,"dismissable":true} في السياق على الخادم. ويشغّل النقر على زر التشغيل actions.open: تُنقل النافذة المنبثقة والخلفية إلى عنصر body، ويُقفل التمرير مع تعويض عرض شريط التمرير، وتظهر النافذة بحركة انتقالية خلال 150ms، وينتقل التركيز إلى أول عنصر قابل للتركيز، وتتنقل المفتاح Tab داخلها. وتضبط مناطق الترويسة والمحتوى والتذييل المسافات بينها وفق رموز تباعد النافذة المنبثقة.

bsui/select ينتظر داخل النموذج مع قائمة الخيارات hidden. يؤدي النقر على زر التشغيل إلى تبديل context.open، وتحديد موضع قائمة الخيارات بإحداثيات ثابتة بالنسبة إلى إطار العرض، وبما أن defaultValue="editor" محدد بالفعل، تتم محاذاة القائمة بحيث يظهر Editor فوق زر التشغيل مباشرة. تنقل مفاتيح الأسهم وHome وEnd والكتابة السريعة الخيار النشط؛ ويؤدي Enter أو النقر إلى الاختيار؛ أما Tab والنقر خارج القائمة فيغلقانها دون اختيار. يُحدّث النص الظاهر على الزر عبر data-wp-text="state.displayValue"، ويتتبع الحقل المخفي <input name="role"> القيمة عبر data-wp-bind--value="state.selectedValue"، وهي القيمة التي يَسلسلها النموذج لاحقًا. ويعمل كل هذا على النحو الصحيح داخل مربع الحوار لأن النافذة المنبثقة العليا غير محوّلة.

يعترض bsui/form عملية الإرسال. يعرض bsui/button في نهاية النموذج عنصر button عاديًا بلا سمة type، لذا يُعد عنصر إرسال النموذج افتراضيًا HTML؛ ويقع زر الإلغاء في التذييل خارج عنصر form، فلا يمكنه إرسال أي شيء. عند الإرسال، يخزّن المتجر قيم FormData للنموذج ويرسلها عبر API البيانات للكتلة المحددة في block، وينشئ هنا صفًا وفق مخطط قاعدة بيانات team/invite مخطط قاعدة البيانات. تعود أخطاء التحقق لكل حقل: يتضمن كل bsui/field قيمة name الخاصة به، ويُعلّم بأنه غير صالح، ويُحوّل إطار التركيز إلى اللون التحذيري، وتُعرض الرسالة في تنبيه bsui/field-error. عند النجاح، يُخفى متن النموذج ويظهر successMessage، وكلاهما عبر data-wp-bind--hidden.

تُغلق الطبقات بالترتيب العكسي. عند فتح قائمة الخيارات، يغلقها مفتاح Escape ويعيد التركيز إلى زر تشغيل قائمة الاختيار؛ ويغلق الضغط التالي على Escape مربع الحوار ويعيد التركيز إلى زر دعوة زميل الفريق. يؤدي النقر على الخلفية إلى إغلاق مربع الحوار لأن dismissable تُركت على قيمتها الافتراضية. عند الإغلاق، يُفتح قفل التمرير وتعود النافذة المنبثقة إلى موضعها في المستند.

تتزامن العلامات نفسها، عند لصقها في صفحة قائمة على ملف، ككتل أصلية، كما تُعرض التركيبة نفسها عند بنائها في المحرر تفاعليًا على اللوحة؛ لأن كل السلوكيات المذكورة أعلاه موجودة في التوجيهات والمخازن التي تُحمّل في كلا السياقين.

ما الذي يضمن عمل هذه الوصلات

الوصلات المذكورة أعلاه ثوابت تضمنها المكتبة أينما عرضت محتواها، وليست مجرد أعراف: فكل تسمية تستخدم تنسيقًا طباعيًا واحدًا متطابقًا، وكل نافذة منبثقة تشترك في سطح موحد وتُعتّم الصفحة خلفها، وتحافظ النوافذ المنبثقة العائمة على ارتباطها بزر التشغيل أثناء تمرير الصفحة، ويغلق مفتاح Escape طبقة واحدة فقط في كل مرة، بدءًا من الطبقة الداخلية. وتسري هذه الضمانات في الواجهة الأمامية وعلى لوحة المحرر، سواء استُخدمت الرموز الافتراضية أو رموز سمتك؛ لذلك تعمل التركيبة بالطريقة نفسها في السياقات المختلفة.

أمثلة مباشرة

التركيبات في هذه الصفحة هي قواعد التركيب؛ أما /ui/examples فهو دليل العبارات. يجمع تركيبات معروضة مباشرة في ثلاث فئات: أزواج تثبت وجود وصلة بين مكونين أو ثلاثة، وأنماط منتجات مألوفة مبنية من مجموعة صغيرة منها، وتطبيقات مصغرة كاملة مركبة بالطريقة التي تُضمّن بها المكونات في المنتجات الفعلية. وتضيف صفحة كل مكون في /ui أمثلة تطبيقية خاصة به، من حقل ذي تسمية إلى تقويم خلف نافذة منبثقة.

التفاعلية

يشرح هذا التوجيه والمخزن نموذج المكونات UI وكيفية استخدامه في الكتل الخاصة بك.