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]