组件
组件
组件按真实界面任务组织:操作、输入、反馈、布局、主题与状态展示。每个组件都暴露属性、事件、slots、parts 与 token 边界。
公开组件
具备稳定 metadata 与 package exports 的 custom elements。
任务分组
按界面任务组织,而不是按内部实现归属组织。
Token 钩子
组件 metadata 暴露可换肤边界。
基础操作
按钮、图标按钮、标签和可选择 chip,用于命令、过滤和轻量状态。
nami-button
触发主要操作、次要操作和加载状态。
nami-icon-button
承载工具栏、收藏、关闭等图标命令。
nami-badge
显示状态、版本、分类和元信息。
nami-chip
用于筛选、标签选择和轻量布尔状态。
nami-tab-bar
在同级内容区域之间切换,支持 roving tabindex。
表单输入
支持表单参与、键盘交互和错误状态的输入组件。
nami-input
表单文本输入,支持 helper、error、required 和表单参与。
nami-switch
表示设置项开关,并参与表单提交。
nami-radio-card
用卡片呈现单选项和配置选择。
反馈与浮层
加载、弹层、抽屉和通知,用于完成异步反馈与焦点管理。
nami-spinner
显示局部加载状态。
nami-dialog
承载需要焦点管理的模态任务。
nami-drawer
在移动端或辅助流程中打开侧向面板。
nami-toast
显示短时反馈和操作结果。
布局与主题
应用壳、卡片、主题边界和全局配置,支撑跨页面的设计系统。
nami-config
设置全局语言、方向和本地化运行时。
nami-theme
建立主题边界,控制 accent、明暗模式、密度和风格预设。
RailApp shellResponsive layout slots
nami-app-shell
构建桌面侧栏与移动底部导航的响应式应用壳。
Grouped content surface.
nami-card
组织内容区块、示例和产品信息。
状态展示
空状态、结果页和插画组件,用于产品内的状态表达。
nami-illustration
渲染可随主题变化的状态插画。
nami-empty
表达空列表、无结果和初始状态。
nami-result
表达成功、错误、警告和 HTTP 状态页。