选择器是一个点击后打开选项列表的按钮。为它传入 options(一个 NuiOption 数组),并绑定 [(value)];启用 multiple 时则绑定 [(values)]。它也支持 Signal Forms、响应式表单和 ngModel。
选项可以带有 group、description 和 keywords,children 则会让列表变成树。超过 200 行时只渲染可见的行,因此十万个选项也能像十个一样快速打开。
如果想输入文本来筛选,请使用组合框。
分组
带有 group 的选项会列在对应的分组标题下。输入一个字母会跳到下一个以该字母开头的选项。
Chosen: it. Type “s” to jump to Spain, again for Switzerland.
一次多选
multiple 会让列表保持打开,并绑定 [(values)]。selectAll 会添加一个全选或全部清除的按钮。禁用的选项无法选择。
2 toppings. The list stays open while you pick.
树形结构
带有 children 的选项构成一棵树。打开列表时,已选选项所在的文件夹会自动展开。
Chosen: website/pages. → opens a folder and ← closes it.
长列表
按地区列出所有时区。超过 200 行时只渲染可见的行,而高亮的选项始终保持渲染,供屏幕阅读器使用。
About 400 options, but only the rows in view are rendered.