常见问题
微信原生小程序能直接用 ruanno-ui 吗?
不能。ruanno-ui 的 Web 组件基于 DOM + CSS 变量 + Pointer Events 实现,微信原生小程序没有 DOM 环境。两条替代路线:
- 使用
@ruanno-ui/uniapp开发 uni-app 项目,编译到微信小程序(推荐); - 商城 / 活动页等场景用小程序
web-view内嵌 H5 页面,直接使用ruanno-ui的 H5 适配。
详见 跨端接入。
ruanno-ui 与 @ruanno-ui/uniapp 什么关系?
同一套设计体系(tokens / 主题 / API 约定)下的两个实现:
ruanno-ui:浏览器端(桌面 + H5),97 个组件;@ruanno-ui/uniapp:uni-app / uni-app X 端(H5 / 微信小程序 / App),97/97 同名对应。
两端组件名、props、事件基本一致;已知差异(布尔绑定 v-model vs v-model:checked、图标实现等)见 API 约定 · 跨端差异表。
样式需要按组件引入吗?
不需要。ruanno-ui/style.css(或 @ruanno-ui/uniapp/styles)全局引入一次即可。样式全部是 --rn-* CSS 变量与组件类,体积小且支持主题切换,未使用的组件样式不会产生实际开销。
如何只改主色?
覆盖 CSS 变量即可,无需构建主题:
:root {
--rn-color-primary: #7c3aed;
--rn-color-primary-hover: #8b5cf6;
--rn-color-primary-active: #6d28d9;
}完整做法见 主题定制。
暗色模式怎么接?
内置 mono-dark / aurora-dark 两套暗色主题,一行切换:
setRnTheme(isDark ? "mono-dark" : "mono");也可以跟随系统:监听 matchMedia("(prefers-color-scheme: dark)") 后调用 setRnTheme。
组件文案怎么换成英文 / 其他语言?
<ConfigProvider locale="en">...</ConfigProvider>内置 zh-CN(默认)与 en,可用 registerLocale 注册任意语言包。见 国际化。
有 Nuxt / SSR 支持吗?
组件均通过 SSR 冒烟测试(setup 顶层不访问 window / document)。Nuxt 3 中在客户端插件里 app.use(createRuannoUI()) 并引入样式即可。
如何给 AI 编码助手投喂组件库文档?
文档站构建产物包含:
llms.txt:全库组件索引(名称 / 一句话说明 / 文档链接);llms-full.txt:全部组件的 props / events / slots / 示例内联版。
直接把 llms-full.txt 放进上下文或作为知识库即可。每个组件目录的 meta.json 是同一信息的结构化版本。
版本号与发布节奏?
使用 changesets 管理:每次功能变更生成 .changeset/*.md,合入主干后统一升版发布。可发布包为 @ruanno-ui/tokens / ruanno-ui / @ruanno-ui/resolver(均 public);@ruanno-ui/uniapp 处于实验性预览阶段,暂不发布 npm。
图标 / 字体的版权?
- 图标:本项目原创手绘 SVG,MIT 授权;
- 字体:Inter 与 Noto Sans SC(思源黑体),SIL OFL 授权,可自由商用。
支持作者


跪求大佬赏点广告费,token 不够用 😭
微信扫码进小程序,给这个项目回一口 token。你的每一次扫码,都是 AI 继续维护 ruanno-ui 的算力。