SuperAPI AI 工具集

author-ui-modules

通用与其它

查看项目

更新于 10-16 07:58

技能介绍

用途:在 Remix 的 packages/ui 中编写惯用的 UI 模块,适用于构建跨多个角色、或把较小模块组合成一个控件的 API。

主要能力与推荐形态:优先采用两种形态。一是小型无头模块,包含一个 provider/context 组件、一个带共享方法/refs/getters 的普通 context 值、若干聚焦的角色 mixin,以及类似 popover 或 listbox 的命名空间导出。二是组合式控件,包含拥有渲染状态的包装组件、对较小模块的组合,以及实现 mixin 的薄组件。除非高层控件本身就是产品,否则调用方仍应拥有大部分标记。

使用方式:优先使用普通 context 而非控制器,默认用 handle.context.set(...) 配合普通对象,不要引入控制器类或 context 上的事件发射器模式,除非任务确实需要。状态按归属拆分:包装组件状态用于渲染阶段与显示值,provider 状态用于共享协调与注册,mixin 本地状态用于单个宿主节点,回调作用域用于瞬时 DOM 事件解析。角色 mixin 是宿主元素与共享模块行为之间的适配器,每个 mixin 拥有一个角色和一个宿主元素,从 context getters 派生 attrs 与 ARIA,规范化 DOM 输入后再调用 context 方法。DOM 工作应与拥有相关 ref 的代码放在一起,使用 handle.queueTask() 处理渲染后的 showPopover()、hidePopover()、锚定、滚动或暴露 refs。

适用场景:编写或修订第一方 UI 原语、无头控件或基于 mixin 的模块时使用。

限制与反模式:避免把控制器类作为默认抽象;避免仅为触发更新而给 context 添加 TypedEventTarget 或变更发射器;避免在包装组件、provider 和 mixin 之间重复 open、selected 或 active 状态;避免在高层控件中重新实现本可组合的 popover 或 listbox 行为;避免把专用控件逻辑复制到无关控件中。资料未提供安装命令、收费或平台信息。