# SnowUI 组件目录

已知组件名时查此表；按场景选型优先使用 [检索](https://snowui.dev/llms/find?q=button)。返回 [AI 主入口](https://snowui.dev/llms.txt)。

- [Accordion](https://snowui.dev/llms/components/accordion.md) [component]：将相关内容组织为可展开、收起的分组，适合常见问题、设置和分段说明，支持单项或多项同时展开。
- [AccordionItem](https://snowui.dev/llms/components/accordion-item.md) [component]：定义 Accordion 中的一项折叠内容，将标题与正文组合起来，并随父级统一管理展开状态。
- [Avatar](https://snowui.dev/llms/components/avatar.md) [component]：展示用户或团队头像，支持图片、文字和渐变占位，让列表、评论与成员信息更易辨认。
- [AvatarGroup](https://snowui.dev/llms/components/avatar-group.md) [component]：将多个头像排列或叠放展示，并以数量提示收起的成员，适合团队、协作者与参与者列表。
- [Badge](https://snowui.dev/llms/components/badge.md) [component]：用紧凑的数字、文字或圆点提示未读数量与状态，可搭配按钮、头像和导航项使用。
- [BarChart](https://snowui.dev/llms/components/bar-chart.md) [component]：用柱状图比较不同类别的数据，支持横向、纵向、分组与堆叠展示，以及坐标轴和交互提示。
- [BlurText](https://snowui.dev/llms/components/blur-text.md) [component]：通过逐字变清晰、淡入与轻微上移呈现标题和短段落，保持自然换行、字号、行高与文字基线，适合欢迎语、介绍文案和内容揭示。
- [Breadcrumb](https://snowui.dev/llms/components/breadcrumb.md) [component]：展示当前页面的层级路径，帮助用户理解所在位置并返回上级页面。
- [Button](https://snowui.dev/llms/components/button.md) [component]：触发即时操作；bare 且需要透明度 hover 时使用 emphasis=muted。
- [ButtonGroup](https://snowui.dev/llms/components/button-group.md) [component]：将相关按钮组合为统一的操作组，支持分割线，适合拆分按钮和紧凑工具栏。
- [Card](https://snowui.dev/llms/components/card.md) [component]：为相关内容提供统一的卡片表面，可自由组合文字、媒体和操作，支持固定子项与内容滚动。
- [ChartGroup](https://snowui.dev/llms/components/chart-group.md) [component]：将多个图表组合在同一区域，协调分类悬停、叠加绘制与共享坐标轴，便于比较关联数据。
- [Checkbox](https://snowui.dev/llms/components/checkbox.md) [component]：选择一个或多个独立选项，支持选中、未选中和部分选中状态，适合表单与批量选择。
- [Chip](https://snowui.dev/llms/components/chip.md) [component]：以紧凑的行内标签展示分类、状态或简短信息，可与文字、图标和列表内容自然组合。
- [CircularChart](https://snowui.dev/llms/components/circular-chart.md) [component]：用圆环或饼图展示数据占比，支持分段、圆角、环厚与悬停强调，适合构成分析和比例概览。
- [CodeBlock](https://snowui.dev/llms/components/code-block.md) [component]：清晰展示可复制的代码，支持语法着色、行号、全屏查看和尺寸调整，适合文档与开发工具。
- [ColorSchemeButton](https://snowui.dev/llms/components/color-scheme-button.md) [component]：在亮色与暗色主题之间切换，并以图标反馈当前方案，适合网站和应用的主题入口。
- [CopyButton](https://snowui.dev/llms/components/copy-button.md) [component]：将文字或代码复制到剪贴板，并提供短暂的成功反馈，适合链接、标识符和安装命令。
- [CopyLink](https://snowui.dev/llms/components/copy-link.md) [component]：展示可打开、可复制的链接地址，文字打开链接，其余区域复制地址。
- [DataTable](https://snowui.dev/llms/components/data-table.md) [component]：数据列表需要搜索、排序、筛选、勾选、操作列或分页；组合 TableToolbar、Table 与 Pagination。
- [Dialog](https://snowui.dev/llms/components/dialog.md) [component]：在模态对话框中呈现需要关注的内容或操作，提供遮罩、焦点管理与背景滚动锁定，适合确认和表单任务。
- [ExpandButton](https://snowui.dev/llms/components/expand-button.md) [component]：在展开与收起之间切换，用一致的按钮反馈表达状态，适合折叠内容和详情入口。
- [Field](https://snowui.dev/llms/components/field.md) [component]：将输入控件、标签、图标和校验反馈组织为完整的表单字段，统一外观与内容布局。
- [FlowText](https://snowui.dev/llms/components/flow-text.md) [component]：以流动过渡展示文字和数字变化，适合动态文案、计数、计时与倒计时。
- [Frame](https://snowui.dev/llms/components/frame.md) [component]：统一布局、状态、加载与动效，并通过显式配置支持多个组件的联动和样式编排。
- [GaugeChart](https://snowui.dev/llms/components/gauge-chart.md) [component]：以半环或半饼展示多项正数占比，分母为实际显示项之和。
- [Gradient](https://snowui.dev/llms/components/gradient.md) [component]：以柔和的多层渐变丰富背景与占位画面，提供六种配色与可缩放的形变效果。
- [GradientMotion](https://snowui.dev/llms/components/gradient-motion.md) [component]：以流动扫光呈现动态渐变，可用于背景、头像占位或可裁切的媒体区域。
- [Icon](https://snowui.dev/llms/components/icon.md) [component]：展示 SVG 图标，并统一尺寸与颜色，适合按钮、导航和内容中的视觉标识。
- [IconProvider](https://snowui.dev/llms/components/icon-provider.md) [component]：为应用或局部区域统一替换 SnowUI 内置功能图标，未配置的图标继续使用组件默认样式。
- [Image](https://snowui.dev/llms/components/image.md) [component]：展示图片及其占位状态，支持组合角标、操作与预览入口，适合内容图片和媒体缩略图。
- [ImageGroup](https://snowui.dev/llms/components/image-group.md) [component]：统一组织多张图片的尺寸与排列，并提供成组预览，适合图库、附件和图片集合。
- [ImageViewer](https://snowui.dev/llms/components/image-viewer.md) [component]：在页面级预览中查看图片或视频，提供前后切换与关闭操作，适合媒体详情浏览。
- [Indicator](https://snowui.dev/llms/components/indicator.md) [component]：提供可拖动的尺寸调整手柄，支持鼠标与键盘操作，可用于面板和内容区域的大小调整。
- [Input](https://snowui.dev/llms/components/input.md) [component]：提供单行输入，支持文本、搜索、密码、数字、日期时间与颜色，可组合标签、图标和校验反馈。
- [Kbd](https://snowui.dev/llms/components/kbd.md) [component]：以紧凑的按键标签展示快捷键或键盘操作提示，帮助用户快速识别可用操作。
- [LineChart](https://snowui.dev/llms/components/line-chart.md) [component]：用折线展示数据变化趋势，支持多序列、面积填充、实线与虚线，以及坐标轴、网格和节点样式。
- [Link](https://snowui.dev/llms/components/link.md) [component]：在正文、说明和导航中提供清晰的文字链接，支持箭头等视觉形式，表达可继续访问的内容。
- [Listbox](https://snowui.dev/llms/components/listbox.md) [component]：在浮层中展示可选择的选项，支持搜索过滤与键盘操作，可作为 Select 的选择面板。
- [LocaleProvider](https://snowui.dev/llms/components/locale-provider.md) [component]：为应用或局部区域统一设置 SnowUI 内置界面文案的语言，支持按需覆盖消息内容。
- [MenuItem](https://snowui.dev/llms/components/menu-item.md) [component]：在选项列表或快捷操作面板中呈现一项内容，支持图标、选中状态与禁用反馈。
- [NumberFlow](https://snowui.dev/llms/components/number-flow.md) [component]：以逐位滚动和宽度过渡展示数字变化，保留金额、分组符与小数格式，适合计数器和实时指标。
- [NumericText](https://snowui.dev/llms/components/numeric-text.md) [component]：对文字或数字中发生变化的部分进行过渡，保留未变内容，适合简短状态、数值与计时信息。
- [OTPInput](https://snowui.dev/llms/components/otp-input.md) [component]：提供 4–8 位数字一次性验证码输入，支持整码粘贴、短信自动填充、原生表单提交与重置。
- [OverflowAction](https://snowui.dev/llms/components/overflow-action.md) [component]：定义 OverflowActions 中的一项按钮操作，让它可随可用空间在工具栏与更多菜单之间切换。
- [OverflowActions](https://snowui.dev/llms/components/overflow-actions.md) [component]：一组操作需要从完整态退化为 icon-only，并把剩余操作逐项或全部转入 More。
- [Pagination](https://snowui.dev/llms/components/pagination.md) [component]：提供页码导航，帮助用户在多页数据之间切换，适合表格、列表和搜索结果。
- [Popover](https://snowui.dev/llms/components/popover.md) [component]：在触发器附近展示补充内容或操作，支持不同尺寸与触发方式，适合快捷操作和轻量交互面板。
- [Progress](https://snowui.dev/llms/components/progress.md) [component]：以条形或圆形反馈任务进度，支持明确进度与不确定状态，适合上传、处理和加载过程。
- [Radio](https://snowui.dev/llms/components/radio.md) [component]：在一组互斥选项中选择一项，适合需要直接展示所有选项的表单设置。
- [ScrambleText](https://snowui.dev/llms/components/scramble-text.md) [component]：通过字符扰动逐步呈现目标文字，适合标题、短句与状态文案的动态揭示。
- [ScrollArea](https://snowui.dev/llms/components/scroll-area.md) [component]：为内容提供可滚动区域与统一的滚动条，适合长列表、面板和受限空间中的正文。
- [SearchBox](https://snowui.dev/llms/components/search-box.md) [component]：提供打开搜索浮层的入口，整块区域均可点击，可组合快捷键提示，适合全局搜索。
- [SearchInput](https://snowui.dev/llms/components/search-input.md) [component]：提供带搜索图标的单行输入框，适合列表过滤、页面搜索和工具栏中的查询输入。
- [SearchPopup](https://snowui.dev/llms/components/search-popup.md) [block]：需要统一搜索输入、分组标题和结果间距的产品区块。
- [Segmented](https://snowui.dev/llms/components/segmented.md) [component]：多个互斥参数或过滤器之间单选，使用 radiogroup 语义。
- [Select](https://snowui.dev/llms/components/select.md) [component]：在下拉列表中选择选项，可由数据直接生成面板，也可自定义选项组合，支持搜索与键盘操作。
- [SelectButton](https://snowui.dev/llms/components/select-button.md) [component]：以按钮形式提供单项下拉选择，适合工具栏、筛选入口和需要紧凑展示的选项切换。
- [Separator](https://snowui.dev/llms/components/separator.md) [component]：用水平或垂直分割线划分内容与操作区域，帮助建立清晰的信息层次。
- [Sidebar](https://snowui.dev/llms/components/sidebar.md) [block]：组织应用的品牌入口、分组导航与底部操作，支持折叠和独立滚动，适合多页面应用。
- [SidebarItem](https://snowui.dev/llms/components/sidebar-item.md) [block]：在 Sidebar 中呈现导航入口，支持激活状态、图标、层级与状态提示，帮助识别当前位置。
- [SidebarSection](https://snowui.dev/llms/components/sidebar-section.md) [block]：将 Sidebar 导航组织为带标题的分组，支持展开、收起与附加操作，便于浏览较长的导航列表。
- [SidePanel](https://snowui.dev/llms/components/side-panel.md) [component]：从页面右侧展示详情或辅助内容，支持浮层与内嵌两种形态，让用户保留主页面上下文。
- [Skeleton](https://snowui.dev/llms/components/skeleton.md) [component]：在内容加载时展示占位轮廓，帮助用户预先理解页面结构，并保持加载过程中的布局连续。
- [Slider](https://snowui.dev/llms/components/slider.md) [component]：通过拖动选择单个数值或数值区间，支持水平、垂直、步进与填充式展示，适合范围和参数调整。
- [SlotText](https://snowui.dev/llms/components/slot-text.md) [component]：以逐字符的纵向滚动展示文字变化，适合短标题、状态、计数与计时信息。
- [SnowUILogo](https://snowui.dev/llms/components/snow-ui-logo.md) [component]：展示 SnowUI 图标、字标或组合标识，支持横向与纵向排列，适合品牌入口和页面署名。
- [Spinner](https://snowui.dev/llms/components/spinner.md) [component]：以持续旋转的视觉提示表示加载中，提供圆环、辐条和胶囊三种形式，适合按钮与内容区域。
- [StyleButton](https://snowui.dev/llms/components/style-button.md) [component]：在 SnowUI 与 Apple 两种视觉风格之间切换，适合提供界面风格选择的入口。
- [Switch](https://snowui.dev/llms/components/switch.md) [component]：在开启与关闭之间切换，适合需要即时生效的设置和功能开关。
- [Tab](https://snowui.dev/llms/components/tab.md) [component]：选项对应不同内容区域或视图。
- [Table](https://snowui.dev/llms/components/table.md) [component]：以语义化表格展示结构化数据，支持自适应列宽、局部横向滚动与加载状态，可自由组合表头和单元格。
- [TableBody](https://snowui.dev/llms/components/table-body.md) [component]：组织 Table 的数据行，保留表格正文语义，适合组合列表记录和自定义行内容。
- [TableCell](https://snowui.dev/llms/components/table-cell.md) [component]：在 Table 的数据行中展示一个单元格，支持文字、组件与自定义内容，默认以单行截断控制长内容。
- [TableHead](https://snowui.dev/llms/components/table-head.md) [component]：定义 Table 的列标题，可承载排序操作与列宽调整，帮助用户理解和组织表格数据。
- [TableHeader](https://snowui.dev/llms/components/table-header.md) [component]：组织 Table 的表头行，明确各列含义，并保留原生表格的表头语义。
- [TableRow](https://snowui.dev/llms/components/table-row.md) [component]：组织一行表头或数据单元格，统一行内的悬停与交互反馈，适合可浏览和可操作的数据记录。
- [TableToolbar](https://snowui.dev/llms/components/table-toolbar.md) [component]：为 DataTable 提供搜索、排序、筛选和批量操作入口，并展示选择状态，适合数据管理界面。
- [Tag](https://snowui.dev/llms/components/tag.md) [component]：以可交互标签表达标记、筛选条件或路径片段，适合组织内容与收敛选择范围。
- [Text](https://snowui.dev/llms/components/text.md) [component]：统一展示文本，支持排版与截断，适合正文、标签和受限空间中的信息表达。
- [Textarea](https://snowui.dev/llms/components/textarea.md) [component]：提供多行文本输入，可承接原生表单属性并组合字段反馈，适合描述、备注和较长内容的编辑。
- [ThemeButton](https://snowui.dev/llms/components/color-scheme-button.md) [component]：在亮色与暗色主题之间切换，并以图标反馈当前方案，适合网站和应用的主题入口。
- [Toast](https://snowui.dev/llms/components/toast.md) [component]：用短暂通知反馈操作结果或状态变化，支持图标、操作和富内容，适合保存成功、错误与提醒。
- [Toaster](https://snowui.dev/llms/components/toaster.md) [component]：集中展示通过 toast() 触发的全局通知，支持六个屏幕位置、堆叠动效与可见数量控制，让连续反馈保持有序。
- [Tooltip](https://snowui.dev/llms/components/tooltip.md) [component]：在悬停时展示简短说明，支持位置避让与连续切换动效，适合图标按钮和需要补充解释的内容。