匯入

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

NuiMenuTrigger

開啟選單。通常套用在 nuiButton 上。

選擇器
[nuiMenuTrigger]
匯出為
nuiMenuTrigger
NuiMenuTrigger: 屬性
名稱型別預設值說明
nuiMenuTrigger輸入Menu要開啟的選單:某個 nuiMenungMenu 參照。

NuiMenu

由項目組成的選單,以 popover 形式顯示在觸發元素旁。它匯出的 ngMenu 就是觸發元素和子選單所接收的 Angular Aria 選單。

選擇器
[nuiMenu]
匯出為
ngMenu
NuiMenu: 屬性
名稱型別預設值說明
wrap輸入booleantrue方向鍵是否從最後一個項目循環回第一個項目。
typeaheadDelay輸入number500鍵入搜尋重設前等待的毫秒數。
disabled輸入booleanfalse停用整個選單。
enter輸入NuiEnter進場方式:zoomfadedropriseunfoldflipswingslidenone
motion輸入NuiMotion運動時使用的彈簧:snappybouncyjellyelasticlazymechanicalnone
spring輸入NuiSpring任意彈簧,以 { stiffness, damping, mass } 的形式指定,在執行階段編譯成 CSS。它會覆寫 motion
corners輸入NuiCorners邊角的形狀:roundsquirclebevelscoopnotchsquare
radius輸入NuiRadius邊角的大小:nonesmallmediumlargefull
density輸入NuiDensity佔用的空間:compactregularroomy
itemSelected輸出V發出所選項目的值。在根選單上,選取子選單中的項目時也會觸發。

用於客製化的輸入屬性如果未設定,會沿用最近的 data-nui-* 屬性。詳見客製化指南

NuiMenuItem

nuiMenu 中的一個項目。

選擇器
[nuiMenuItem]
NuiMenuItem: 屬性
名稱型別預設值說明
value輸入V項目的識別值。在整個選單(包括子選單)中必須唯一。
disabled輸入booleanfalse停用該項目。它仍可透過方向鍵移到,但無法被選取。
submenu輸入Menu該項目開啟的巢狀 nuiMenu
role輸入'menuitem' | 'menuitemcheckbox' | 'menuitemradio''menuitem'menuitemmenuitemcheckboxmenuitemradio
checked輸入boolean | undefined複選或單選項目的勾選狀態。
tone輸入'neutral' | 'danger''neutral'破壞性操作請使用 danger
searchTerm輸入string鍵入搜尋時用於比對的文字,預設為項目的標籤。
selected輸出V透過滑鼠或鍵盤選取該項目時,發出它的值。

NuiMenuSeparator

項目群組之間的分隔線。

選擇器
[nuiMenuSeparator]

NuiMenuShortcut

快速鍵提示,與項目的結尾端對齊。

選擇器
[nuiMenuShortcut]