SuperAPI AI 工具集

mantine-combobox

通用与其它

查看项目

更新于 10-16 00:05

技能介绍

用途:该技能面向 Mantine 9.x,讲解如何用 Combobox 底层原语构建各类选择型 UI。内置的 Select、MultiSelect、Autocomplete、TagsInput 均基于它实现,因此应先检查现成组件是否满足需求,仅在都不适用时才自行搭建。

主要能力:Combobox 提供 store(useCombobox)、Target、Dropdown、Options、Option、Search、Chevron 等结构,支持按钮触发、输入框触发、Pills 加独立输入的多选形态。目标元素内置键盘处理:上下方向键移动高亮并跳过禁用项(关闭时也会打开下拉),Enter 提交高亮项,Escape 关闭;targetType="button" 时空格和 Enter 也可打开,Tab 不处理。点击选项不会使输入失焦,禁用项不会触发 onOptionSubmit。下拉默认与目标同宽、渲染在 portal 中、关闭时保持挂载、无动画,悬停不改变键盘高亮。

使用方式:先创建 store,再渲染 Combobox 结构,最后在 onOptionSubmit 中处理提交并关闭下拉。需要区分“selected option”(键盘高亮,data-combobox-selected)与“active option”(持有当前值,active 属性,data-combobox-active,默认无样式)。

适用场景:标准选择、多选、自动补全、标签输入可直接用现成组件;无输入框的按钮下拉可用 ComboboxPopover;层级选项用 TreeSelect;选项超过数百条时配合 useVirtualizedCombobox 虚拟化。

限制:ComboboxPopover 无法渲染自定义下拉内容(标签页、页眉页脚、创建操作),此时需用原语。下拉中的其他交互内容需自行加 onMouseDown 阻止默认行为以保持焦点。若参考资料未覆盖需求,不要猜测,可借助 Mantine MCP 服务器或查阅官方文档与示例。