# 瑚琏 Hulian (`@hulianui/ui`) > 颜值 + 好用的 React 设计系统(Base UI + Tailwind v4 + Motion) · 399 个组件 · v0.60.0 AI agent 索引。完整逐组件用法见 [llms-full.txt](./llms-full.txt)(自包含)或各组件源码旁 `.md`。 安装 `npm i @hulianui/ui`,默认从根 barrel 导入:`import { X } from "@hulianui/ui"`;只用少数几个组件时可改子路径 `@hulianui/ui/`(见 docs/consuming.md §3)。 铁律:业务里 100% 用库组件,禁止 style=/局部 CSS 覆盖;缺组件回库加。 要做受约束生成(只许输出白名单组件与合法 props)请直接读 [llms-props.json](./llms-props.json),不要去解析下面这些 markdown 表格:那份 JSON 逐 prop 给出 kind / 枚举取值 / 默认值,并带一张 `exportIndex`(导出名 → 组件)。 ## 布局 layout(15) - [AdminLayout](https://github.com/hulianui/hulian/blob/master/packages/ui/src/admin-layout/admin-layout.md): 中后台骨架 · 侧栏(品牌+NavMenu可折叠) + 顶栏(折叠/面包屑/扩展区) + 多页签导航(开/切/关·关闭其他/全部·受控接路由或菜单点击自动维护) + 内容区(复用 NavMenu/ScrollArea/… - [AspectRatio](https://github.com/hulianui/hulian/blob/master/packages/ui/src/aspect-ratio/aspect-ratio.md): 把图片、视频或任意内容锁在固定的宽高比里 - [Container](https://github.com/hulianui/hulian/blob/master/packages/ui/src/container/container.md): 给页面内容限定最大宽度并居中,留出左右安全边距 - [Divider](https://github.com/hulianui/hulian/blob/master/packages/ui/src/divider/divider.md): 用一条分隔线把内容切开,线上可以带文字 - [FitScreen](https://github.com/hulianui/hulian/blob/master/packages/ui/src/fit-screen/fit-screen.md): 把固定尺寸的设计稿等比缩放,铺满任意大小的屏幕 - [Grid](https://github.com/hulianui/hulian/blob/master/packages/ui/src/grid/grid.md): 按栅格排列内容,子项可跨列跨行 - [Layout](https://github.com/hulianui/hulian/blob/master/packages/ui/src/layout/layout.md): 把页面拆成页头、侧栏、内容和页脚四块,侧栏可折叠 - [Masonry](https://github.com/hulianui/hulian/blob/master/packages/ui/src/masonry/masonry.md): 把长短不一的卡片分列排成瀑布流,列数随屏幕宽度变化 - [PreviewSandbox](https://github.com/hulianui/hulian/blob/master/packages/ui/src/preview-sandbox/preview-sandbox.md): 预览沙箱 · 把「隔离渲染容器 + 设备视口 + 缩放适配 + 错误捕获 + 就绪/重载生命周期」一次做对的外壳 · iframe 模式(`code` 传完整 HTML 文档串 → `srcDoc`,默认不透明源隔离,… - [Resizable](https://github.com/hulianui/hulian/blob/master/packages/ui/src/resizable/resizable.md): 把区域切成可拖动的分栏,能限制大小也能用键盘微调 - [ScrollArea](https://github.com/hulianui/hulian/blob/master/packages/ui/src/scroll-area/scroll-area.md): 给溢出内容换上更细的自定义滚动条,可竖可横 - [Separator](https://github.com/hulianui/hulian/blob/master/packages/ui/src/separator/separator.md): 画一条横向或竖向的分隔线,带正确的无障碍语义 - [Spacer](https://github.com/hulianui/hulian/blob/master/packages/ui/src/spacer/spacer.md): 在布局中插入一段纯粹的空白间距 - [Stack](https://github.com/hulianui/hulian/blob/master/packages/ui/src/stack/stack.md): 按一个方向排列子元素,统一控制间距、对齐和换行 - [Viewport](https://github.com/hulianui/hulian/blob/master/packages/ui/src/viewport/viewport.md): 按网页、平板、手机三档宽度预览,内部布局随容器宽度重排 ## 排版 typography(37) - [AnimatedGradientText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/animated-gradient-text/animated-gradient-text.md): 渐变文字 · 行内 chart 渐变流动 + RSC · typography/text · #animated - [AnimatedShinyText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/animated-shiny-text/animated-shiny-text.md): 高光文字 · 横扫高光 + 徽标气质 + RSC · typography/text · #animated - [ASCIIText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/ascii-text/ascii-text.md): ASCII 字符画 · 把文字渲染成 ASCII 字符画 · canvas2d 逐像素亮度采样映射字符 + 正弦波动位移 + 鼠标驱动 hue-rotate 色相(零依赖去 three.js·token·reduced… - [AuroraText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/aurora-text/aurora-text.md): 极光文字 · bg-clip 流动渐变 + chart token + RSC · typography/text · #animated - [BlurText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/blur-text/blur-text.md): 模糊解析 · 各词从模糊+位移解析到清晰 + 滚入视口触发(motion · top/bottom 方向 · aria-label 整段 · reduced-motion 直呈清晰) · typography/text… - [CircularText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/circular-text/circular-text.md): 环形文字 · 每字按等分角排到圆周 + 整体匀速自转 + 悬停调速(加速/减速/暂停/抓狂 · 颜色继承 currentColor · reduced-motion 静态) · typography/text · #a… - [Code](https://github.com/hulianui/hulian/blob/master/packages/ui/src/code/code.md): 给行内代码片段套上等宽皮肤,可选语义色调 - [CodeBlock](https://github.com/hulianui/hulian/blob/master/packages/ui/src/code-block/code-block.md): 展示多行代码,带语言标签和一键复制 - [CodeDiff](https://github.com/hulianui/hulian/blob/master/packages/ui/src/code-diff/code-diff.md): 按行展示代码增删,可单栏也可左右双栏对照 - [CurvedLoop](https://github.com/hulianui/hulian/blob/master/packages/ui/src/curved-loop/curved-loop.md): 弧形跑马灯 · 沿二次贝塞尔曲线无缝循环滚动的弧形跑马灯文字 · SVG textPath + rAF 续滚 + 可拖拽拨动(零依赖·token/currentColor·reduced-motion) · typog… - [DecryptedText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/decrypted-text/decrypted-text.md): 乱码解码 · 字符翻滚后逐位解码到明文 + view/hover 触发(随机仅客户端 effect 避 hydration mismatch · 等宽 tabular-nums 防抖 · aria-label 明文) … - [FallingText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/falling-text/falling-text.md): 文字散落 · 文字按词散落物理特效 · 触发后逐词受重力下落/撞墙反弹堆叠 + 指针拖拽抛掷(零依赖 RAF 自写二维刚体·token·reduced-motion) · typography/text · #anim… - [FlipText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/flip-text/flip-text.md): 翻面标题 · 鼠标移入时逐字 3D 翻面(收 children 不收 text · as 参与类型推导让它自己就是 h1/h2 · 一次性播完不跟随 hover 回退 · 纯 CSS 关键帧不引 motion · 背面… - [Formula](https://github.com/hulianui/hulian/blob/master/packages/ui/src/math/math.md): KaTeX 驱动的数学排版,本库唯一的数学渲染路径 · 走 `@hulianui/ui/math` 独立 subpath 不压主包体积 · 分段函数/矩阵/大型定界符真二维排版 · 认 `$…$` 分隔符,上游没包 `… - [FuzzyText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/fuzzy-text/fuzzy-text.md): 噪点模糊标题 · 信号噪点模糊标题 · canvas2d 逐行/逐列随机错位扫描 + 悬停增强抖动(零依赖·token·reduced-motion 退静态帧) · typography/text · #animated - [GlitchText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/glitch-text/glitch-text.md): 故障撕裂 · 双伪元素 RGB 错位 + clip-path 切片抖动(纯 CSS 零依赖 RSC · 撕裂色吃 chart token · enableOnHover 门控 · motion-reduce 退普通文本… - [Heading](https://github.com/hulianui/hulian/blob/master/packages/ui/src/heading/heading.md): 输出各级标题,视觉大小与标题层级可以分开设定 - [Kbd](https://github.com/hulianui/hulian/blob/master/packages/ui/src/kbd/kbd.md): 按键 · 等宽皮肤 + KbdGroup 组合键容器 + RSC - [LineShadowText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/line-shadow-text/line-shadow-text.md): 在标题文字背后错开一层硬边条纹投影 - [Markdown](https://github.com/hulianui/hulian/blob/master/packages/ui/src/markdown/markdown.md): 把 Markdown 字符串渲染成只读的富文本内容 - [Prose](https://github.com/hulianui/hulian/blob/master/packages/ui/src/prose/prose.md): 给富文本或 Markdown 内容套上统一的排版样式 - [ScrambledText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/scrambled-text/scrambled-text.md): 乱码悬停文字 · 指针靠近文字逐字翻滚乱码再收敛的悬停文字特效 · 半径内越近翻滚越久 + 可自定字符集/速度(零依赖 RAF·reduced-motion) · typography/text · #animated - [ScrollFloat](https://github.com/hulianui/hulian/blob/master/packages/ui/src/scroll-float/scroll-float.md): 滚动浮现标题 · :随容器滚过视口逐字符从「下沉 + 纵向拉伸横向压扁 + 透明」拔起到正常 · useScroll 绑进度 + 每字符 useTransform 派生 opacity/y/scaleX/scaleY(… - [ScrollReveal](https://github.com/hulianui/hulian/blob/master/packages/ui/src/scroll-reveal/scroll-reveal.md): 滚动显影 · 整段随容器滚过视口逐词 opacity+blur 解析(motion useScroll/useTransform · 每词独立进度区间 · reduced-motion 直呈可读) · typograp… - [ScrollVelocity](https://github.com/hulianui/hulian/blob/master/packages/ui/src/scroll-velocity/scroll-velocity.md): 滚动跑马灯 · 滚动速度跑马灯文字 · 多行交替方向视差 + 随页面滚动加速/变向、静止匀速漂移(motion 速度值驱动·零额外依赖·reduced-motion 冻结自走帧保留 DOM) · typography/… - [Shuffle](https://github.com/hulianui/hulian/blob/master/packages/ui/src/shuffle/shuffle.md): 洗牌解密文字 · 逐字「洗牌解密」文本动画 · 字位先滚乱码再按方向顺序锁定真字 + 视口/悬停/循环触发(零依赖 rAF·reduced-motion 直落终态·token 着色) · typography/text… - [Snippet](https://github.com/hulianui/hulian/blob/master/packages/ui/src/snippet/snippet.md): 展示一行命令,带提示符和一键复制 - [SparklesText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/sparkles-text/sparkles-text.md): 星闪文字 · 随机小星脉冲(客户端生成) + token · typography/text · #animated - [SplitText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/split-text/split-text.md): 切字进场 · 文本切字/词 + 滚入视口逐段错峰位移淡入(motion · useInView 触发一次 · aria-label 整段读屏友好 · reduced-motion 直呈终态) · typography/… - [Text](https://github.com/hulianui/hulian/blob/master/packages/ui/src/text/text.md): 统一正文的字号、字重、语义色和截断方式 - [TextCursor](https://github.com/hulianui/hulian/blob/master/packages/ui/src/text-cursor/text-cursor.md): 光标拖尾文字 · 特效组件 · 在容器内移动光标时沿轨迹按间距落下一串字形并随机微浮动淡出回收(沿方向旋转 / emoji / 自定义间距上限)(零依赖·motion 运行时·reduced-motion 去浮动) ·… - [TextPressure](https://github.com/hulianui/hulian/blob/master/packages/ui/src/text-pressure/text-pressure.md): 逐字符"压感"标题 · 字形随鼠标距离实时插值字重/宽度/倾斜 + 透明度(零依赖 RAF·token 配色·reduced-motion·系统字体兜底) · typography/text · #animated - [TextReveal](https://github.com/hulianui/hulian/blob/master/packages/ui/src/text-reveal/text-reveal.md): 揭示扫光 · 一条多色带横扫,带过之处把文字从透明揭示成实色(repeat 循环表示「进行中」· 多串轮换按最宽串预留宽度不跳 · 减弱动效落静态终态而不是整串消失 · 纯 CSS 关键帧不引 motion) · ty… - [TrueFocus](https://github.com/hulianui/hulian/blob/master/packages/ui/src/true-focus/true-focus.md): 真实焦点 · 句中一词清晰余词模糊 + 焦点循环移动 + 四角框跟随(测量 rect 定位 · 角框吃 chart token · manualMode 悬停聚焦 · reduced-motion 全清晰) · typ… - [TypingAnimation](https://github.com/hulianui/hulian/blob/master/packages/ui/src/typing-animation/typing-animation.md): 打字机 · 逐字 + 闪烁光标 + 进入视口触发 · typography/text · #animated - [VariableProximity](https://github.com/hulianui/hulian/blob/master/packages/ui/src/variable-proximity/variable-proximity.md): 邻近可变字体 · 鼠标邻近驱动的逐字可变字体文本 · 按距离插值 font-variation-settings(wght/opsz 等轴)+ linear/exponential/gaussian 三档衰减(零依赖 … - [WordRotate](https://github.com/hulianui/hulian/blob/master/packages/ui/src/word-rotate/word-rotate.md): 轮换词 · motion 进出场 + reduced-motion · typography/text · #animated ## 表单 forms(70) - [AuthPanel](https://github.com/hulianui/hulian/blob/master/packages/ui/src/auth-panel/auth-panel.md): 搭出分屏登录页的品牌一侧,含渐变底、标语和卖点 - [Button](https://github.com/hulianui/hulian/blob/master/packages/ui/src/button/button.md): 触发操作的按钮,提供实心、浅色、描边、幽灵和危险等变体 - [ButtonGroup](https://github.com/hulianui/hulian/blob/master/packages/ui/src/button-group/button-group.md): 把相关按钮连成一体或分组排列,做成分段控件 - [Calendar](https://github.com/hulianui/hulian/blob/master/packages/ui/src/calendar/calendar.md): 常驻的日历面板,可在日、月、年三层之间下钻 - [Cascader](https://github.com/hulianui/hulian/blob/master/packages/ui/src/cascader/cascader.md): 沿逐级展开的选项列选出一条路径 - [CellEditor](https://github.com/hulianui/hulian/blob/master/packages/ui/src/cell-editor/cell-editor.md): 在表格单元格里就地编辑,静止时看起来和纯文本一样 - [Checkbox](https://github.com/hulianui/hulian/blob/master/packages/ui/src/checkbox/checkbox.md): 切换一个独立的布尔值,支持半选态 - [CheckboxGroup](https://github.com/hulianui/hulian/blob/master/packages/ui/src/checkbox-group/checkbox-group.md): 让一组复选框共同维护一个值数组 - [Choicebox](https://github.com/hulianui/hulian/blob/master/packages/ui/src/choicebox/choicebox.md): 用带标题和描述的卡片做单选或多选 - [ClickCaptcha](https://github.com/hulianui/hulian/blob/master/packages/ui/src/click-captcha/click-captcha.md): 点选式人机验证 UI · 采集点击序列回传相对坐标(0~1) + 序号标记/撤销/换一张 + 键盘准星可达 + 失败抖动清空(零协议·不碰网络) - [CodeEditor](https://github.com/hulianui/hulian/blob/master/packages/ui/src/code-editor/code-editor.md): 代码编辑器 · 零依赖 textarea + 高亮层叠加(不引 CodeMirror/Monaco) · 受控 value/onChange + 行号槽 + 当前行高亮 + 语法着色(JS 家族/JSON/Shell … - [ColorField](https://github.com/hulianui/hulian/blob/master/packages/ui/src/color-field/color-field.md): 颜色输入框 · 紧凑单行:色块(调起系统取色器) + 十六进制文本输入 + 短写自动展开(#abc→#aabbcc) + 草稿态支持手输 - [ColorPicker](https://github.com/hulianui/hulian/blob/master/packages/ui/src/colorpicker/colorpicker.md): 拖取饱和度与色相选颜色,可输出 HEX、RGB 或 HSL - [ColorSwatchPicker](https://github.com/hulianui/hulian/blob/master/packages/ui/src/color-swatch-picker/color-swatch-picker.md): 从一组预设色块里挑一个颜色,方向键可达 - [Combobox](https://github.com/hulianui/hulian/blob/master/packages/ui/src/combobox/combobox.md): 边输入边过滤候选项,可用触发按钮也可内联输入 - [CountrySelect](https://github.com/hulianui/hulian/blob/master/packages/ui/src/country-select/country-select.md): 搜索并选择国家和地区,带旗帜与区号 - [DatePicker](https://github.com/hulianui/hulian/blob/master/packages/ui/src/date-picker/date-picker.md): 单日期选择 · 自研零依赖(触发器 + Popover 罩 Calendar 面板·日/月/年三粒度) + min-max/disabledDate/清除 - [DateRangePicker](https://github.com/hulianui/hulian/blob/master/packages/ui/src/date-range-picker/date-range-picker.md): 日期区间 · 自研零依赖双面板范围日历(日 / 月 / 年三档粒度)+ Popover 引擎 + 快捷预设/min-max/disabledDate · 定宽字符串数组受控 - [DateTimePicker](https://github.com/hulianui/hulian/blob/master/packages/ui/src/date-time-picker/date-time-picker.md): 在一个浮层里同时选好日期和时间 - [ElasticSlider](https://github.com/hulianui/hulian/blob/master/packages/ui/src/elastic-slider/elastic-slider.md): 橡皮筋音量滑块 · 拖到两端轨道横拉纵压 + 图标回弹位移 + hover 整体放大、松手 spring 弹回(motion·零新依赖·reduced-motion) · forms/basic · #animated - [EmojiPicker](https://github.com/hulianui/hulian/blob/master/packages/ui/src/emoji-picker/emoji-picker.md): 按分类浏览或关键词搜索表情,带最近使用 - [Field](https://github.com/hulianui/hulian/blob/master/packages/ui/src/field/field.md): 字段包装 · label/help/error a11y 串联 - [Form](https://github.com/hulianui/hulian/blob/master/packages/ui/src/form/form.md): 组织具名字段,统一收集提交和字段级错误 - [IconPicker](https://github.com/hulianui/hulian/blob/master/packages/ui/src/icon-picker/icon-picker.md): 图标选择 · 分类页签 + 跨类搜索(名字/别名) + 网格 + 最近使用 · 图标集由消费方经 renderIcon 注入 - [ImageCropper](https://github.com/hulianui/hulian/blob/master/packages/ui/src/image-cropper/image-cropper.md): 让用户拖动缩放图片,按固定比例裁出成品 - [Input](https://github.com/hulianui/hulian/blob/master/packages/ui/src/input/input.md): 收单行文本输入,可加前后缀和错误态 - [InputOTP](https://github.com/hulianui/hulian/blob/master/packages/ui/src/input-otp/input-otp.md): 分格输入验证码,自动跳格并支持整段粘贴 - [InspectorPanel](https://github.com/hulianui/hulian/blob/master/packages/ui/src/inspector-panel/inspector-panel.md): 设计工具属性检查器 · **字段 schema 驱动**(给一份 `{ key, label, kind }` 就派生控件,不是写死五个分类)· 七种控件 kind 全部换皮自既有表单件 · spacing 四联 + … - [InteractiveHoverButton](https://github.com/hulianui/hulian/blob/master/packages/ui/src/interactive-hover-button/interactive-hover-button.md): 悬停展开按钮 · 圆点扩成整块底色 + 尾随箭头 CTA · forms/button · #animated - [IssueReporter](https://github.com/hulianui/hulian/blob/master/packages/ui/src/issue-reporter/issue-reporter.md): GitHub issue 草稿器 · 表单收集(类型 Select / 相关组件 Combobox / 标题 Input / 模板字段 Textarea 或 MarkdownEditor)→ 按模板 `toMarkdo… - [Label](https://github.com/hulianui/hulian/blob/master/packages/ui/src/label/label.md): 表单标签原语 · `