Appearance
安装与运行
开发示例
根工程使用 Node 20.19.1、pnpm 9.2.0 和 DCloud 编译批次 3.0.0-4080720251210001。
先执行 pnpm install --frozen-lockfile。分别在两个终端运行 pnpm dev:h5 和 pnpm dev:docs。
H5 在 http://127.0.0.1:5173/#/subPages/notebook/Index。文档站在 http://127.0.0.1:5174。运行 pnpm dev:mp-weixin 后,用微信开发者工具打开 dist/dev/mp-weixin。开发工具的 AppID 按你自己的测试项目配置。
微信示例使用按需组件注入,从首页只加载当前页面及其依赖。更多配置见 DCloud manifest。
从 npm 安装
sh
pnpm add looseleaf-uni在宿主 pages.json 根级配置 easycom。用 vue-tsc 的项目可在自己的类型入口导入 looseleaf-uni/global。
json
{
"easycom": {
"custom": {
"^ll-(.*)$": "looseleaf-uni/lib/components/ll-$1/ll-$1.vue"
}
}
}如需验证当前源码,在组件库仓库运行 pnpm package:local,再在宿主项目中安装生成的 dist/release/looseleaf-uni-0.1.0.tgz。
本地 uni_modules
把 dist/release/uni_modules/looseleaf-uni 复制到宿主的 src/uni_modules。HBuilderX 建立的项目将模块放在项目根的 uni_modules。uni-app 会按同名目录自动识别组件。
两个安装入口都随组件带上样式。在页面里加入 <ll-button>保存</ll-button> 即可使用。
可独立安装的最小工程
先运行 pnpm package:local。用 node scripts/create-consumer.mjs npm <全新绝对路径> 或 node scripts/create-consumer.mjs uni_modules <全新绝对路径> 生成对应宿主。两个项目分别运行 pnpm install、pnpm type-check 和 pnpm dev,可验证组件标签、公开类型和 Card 内嵌 Tape。宿主自带的 dev:mp-weixin 可生成微信开发态目录。