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

أمثلة

قائمة الأوامر

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

معاينة

or press Cmd K
HTML
<bs:bsui-stack direction="row" gap="2" align="center">
  <bs:bsui-dialog>
    <bs:bsui-dialog-trigger trigger_label="Search documentation" trigger_variant="outline" />
    <bs:bsui-dialog-backdrop />
    <bs:bsui-dialog-popup>
      <bs:bsui-dialog-content>
        <bs:bsui-combobox name="command" placeholder="Type a command or search...">
          <bs:bsui-combobox-input />
          <bs:bsui-combobox-popup>
            <bs:bsui-combobox-option value="dashboard" label="Go to dashboard" />
            <bs:bsui-combobox-option value="deployments" label="Go to deployments" />
            <bs:bsui-combobox-option value="billing" label="Go to billing" />
            <bs:bsui-combobox-option value="new-project" label="Create new project" />
            <bs:bsui-combobox-option value="invite" label="Invite a teammate" />
            <bs:bsui-combobox-option value="rotate-key" label="Rotate API key" />
            <bs:bsui-combobox-option value="theme" label="Toggle dark mode" />
            <bs:bsui-combobox-option value="docs" label="Open documentation" />
            <bs:bsui-combobox-option value="support" label="Contact support" />
          </bs:bsui-combobox-popup>
        </bs:bsui-combobox>
      </bs:bsui-dialog-content>
    </bs:bsui-dialog-popup>
  </bs:bsui-dialog>
  <bs:bsui-text content="or press" variant="caption" tag="span" />
  <bs:bsui-kbd label="Cmd" />
  <bs:bsui-kbd label="K" />
</bs:bsui-stack>

طريقة العمل

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

كل سلوك في هذه الصفحة هو WordPress للتفاعلية API: يسجّل كل مكون مخزنه الخاص، ويهيئ حالته ضمن سياق معروض على الخادم، ويربط الأحداث بتوجيهات في الترميز أعلاه. لا يوجد JavaScript خاص بالصفحة.