مرجع API لمكوّن Menu

الاستيراد

import-menu.ts

import {
  NuiMenu,
  NuiMenuItem,
  NuiMenuSeparator,
  NuiMenuShortcut,
  NuiMenuTrigger,
} from '@needless-ui/angular/menu';

NuiMenuTrigger

يفتح قائمة. ويُطبَّق عادةً على nuiButton.

المُحدِّد: [nuiMenuTrigger]
يُصدَّر باسم: nuiMenuTrigger

NuiMenuTrigger: الخصائص
الاسم	النوع	القيمة الافتراضية	الوصف
`nuiMenuTrigger`مُدخَل	`Menu`		القائمة المراد فتحها: مرجع `ngMenu` الخاص بـ `nuiMenu`.

NuiMenu

قائمة من العناصر تُعرض على هيئة popover بجوار الزر الذي يفتحها. والمرجع المُصدَّر ngMenu هو قائمة Angular Aria التي تستقبلها أزرار الفتح والقوائم الفرعية.

المُحدِّد: [nuiMenu]
يُصدَّر باسم: ngMenu

NuiMenu: الخصائص
الاسم	النوع	القيمة الافتراضية	الوصف
`wrap`مُدخَل	`boolean`	`true`	يحدد ما إذا كانت مفاتيح الأسهم تلتف من العنصر الأخير إلى الأول.
`typeaheadDelay`مُدخَل	`number`	`500`	المدة بالمللي ثانية قبل إعادة ضبط البحث بالكتابة.
`disabled`مُدخَل	`boolean`	`false`	يُعطّل القائمة بأكملها.
`enter`مُدخَل	`NuiEnter`		طريقة ظهوره: `zoom` أو `fade` أو `drop` أو `rise` أو `unfold` أو `flip` أو `swing` أو `slide` أو `none`.
`motion`مُدخَل	`NuiMotion`		النابض الذي يتحرك به: `snappy` أو `bouncy` أو `jelly` أو `elastic` أو `lazy` أو `mechanical` أو `none`.
`spring`مُدخَل	`NuiSpring`		أي نابض تريده بصيغة `{ stiffness, damping, mass }`، ويُحوَّل إلى CSS أثناء التشغيل. وله الأولوية على `motion`.
`corners`مُدخَل	`NuiCorners`		شكل زواياه: `round` أو `squircle` أو `bevel` أو `scoop` أو `notch` أو `square`.
`radius`مُدخَل	`NuiRadius`		حجم زواياه: `none` أو `small` أو `medium` أو `large` أو `full`.
`density`مُدخَل	`NuiDensity`		المساحة التي يشغلها: `compact` أو `regular` أو `roomy`.
`itemSelected`مُخرَج	`V`		يُطلق قيمة العنصر المختار. وفي القائمة الجذرية يُطلَق أيضًا لعناصر القوائم الفرعية.

مُدخلات التخصيص التي تتركها دون ضبط تتبع أقرب سمة data-nui-*. راجع دليل التخصيص.

NuiMenuItem

عنصر داخل nuiMenu.

المُحدِّد: [nuiMenuItem]

NuiMenuItem: الخصائص
الاسم	النوع	القيمة الافتراضية	الوصف
`value`مُدخَل	`V`		يُعرّف العنصر، ويجب أن يكون فريدًا في القائمة كلها، بما فيها القوائم الفرعية.
`disabled`مُدخَل	`boolean`	`false`	يُعطّل العنصر. ويبقى من الممكن الوصول إليه بمفاتيح الأسهم، لكن لا يمكن اختياره.
`submenu`مُدخَل	`Menu`		قائمة `nuiMenu` متداخلة يفتحها هذا العنصر.
`role`مُدخَل	`'menuitem' \| 'menuitemcheckbox' \| 'menuitemradio'`	`'menuitem'`	`menuitem` أو `menuitemcheckbox` أو `menuitemradio`.
`checked`مُدخَل	`boolean \| undefined`		حالة التحديد لعنصر من نوع checkbox أو radio.
`tone`مُدخَل	`'neutral' \| 'danger'`	`'neutral'`	`danger` للإجراءات المدمِّرة.
`searchTerm`مُدخَل	`string`		النص الذي يطابقه البحث بالكتابة. وقيمته الافتراضية تسمية العنصر.
`selected`مُخرَج	`V`		يُطلق قيمة العنصر عند اختياره بالفأرة أو بلوحة المفاتيح.

NuiMenuSeparator

خط فاصل بين مجموعات العناصر.

المُحدِّد: [nuiMenuSeparator]

NuiMenuShortcut

تلميح لاختصار لوحة المفاتيح، بمحاذاة نهاية العنصر.

المُحدِّد: [nuiMenuShortcut]