taro-plain-ui

基于taro平台的Vue3.0移动端组件库

本地环境搭建

yarn install

# 启动H5
yarn dev

# 启动微信小程序
yarn we

开发规范

• 执行 yarn scan 自动扫描页面；
• src/pages 中的页面文件，必须以 ***-page 结尾，页面所对应的配置文件也一样的规则命名，在执行scan命令的时候会自动扫描注册分包；
• 用definePageConfig等宏函数定义页面配置信息时，注意的是必须得是静态的值，不能是变量值或者计算值。

关于自动分包以及注册页面

• 执行脚本 fresh 会自动扫描src/pages目录下的所有文件以及文件夹；
• 文件会注册到 app.config 中的pages
• 文件夹会自动分包注册为 subpackages
• 生成 src/app.config.ts
• 接着会生成 project.config.json
• 以及 project.private.config.json

关于备份 project.private.config.json

• 每个开发者可能会有一份自己对微信开发者工具的编译配置
• 在重启taro的时候，这个编译配置会被重置，开发体验属实不好
• 这里在fresh的时候，去检查是否存在/weapp/project.private.config.json是否存在，存在则备份到项目根目录下，不存在则创建一个空的json文件；在启动的时候将这个文件拷贝到weapp根目录下

关于不同的环境使用不同的appid

• 为了使得启动不同环境的时候使用不同的appid，这里在 build/index.js 中执行的时候（此时fresh命令已经先执行，根目录下project.config.json已经创建），将环境变量配置文件中的wxAppId写入到根目录下的project.config.json中的appid；
• 在调试期间，由于会执行fresh，执行fresh会重新生成project.config.json。这里为了确保根目录下的project.config.json一直是最新的（实际上这个文件，只有启动编译的时候才会有小，其中修改这个文件是没有作用的），在fresh的时候会去找weapp/project.config.json中的appid，拿出来此时正在运行的appid

FAQ

弹框在关闭的时候，如果里边的input获取了焦点，那么弹框关闭的时候导致页面上第一个input获取了焦点

需要给弹框里边的input加key

H5中文本的渲染位置与代码位置不符合

尽量给文本包裹View或者Text节点，否则在web-component的渲染模式下，纯文字的渲染位置没法保证正确