跳到主要内容

常见问题 ​

微信原生小程序能直接用 ruanno-ui 吗? ​

不能。ruanno-ui 的 Web 组件基于 DOM + CSS 变量 + Pointer Events 实现,微信原生小程序没有 DOM 环境。两条替代路线:

  1. 使用 @ruanno-ui/uniapp 开发 uni-app 项目,编译到微信小程序(推荐);
  2. 商城 / 活动页等场景用小程序 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 变量即可,无需构建主题:

css
:root {
  --rn-color-primary: #7c3aed;
  --rn-color-primary-hover: #8b5cf6;
  --rn-color-primary-active: #6d28d9;
}

完整做法见 主题定制。

暗色模式怎么接? ​

内置 mono-dark / aurora-dark 两套暗色主题,一行切换:

ts
setRnTheme(isDark ? "mono-dark" : "mono");

也可以跟随系统:监听 matchMedia("(prefers-color-scheme: dark)") 后调用 setRnTheme。

组件文案怎么换成英文 / 其他语言? ​

vue
<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 余额 0,跪求大佬赏点广告费

跪求大佬赏点广告费,token 不够用 😭

微信扫码进小程序,给这个项目回一口 token。你的每一次扫码,都是 AI 继续维护 ruanno-ui 的算力。