0.0.4 • Published 5 years ago
pre-ui-theme v0.0.4
ui
主要是为了 统一 项目间基础组件的展示样式。纯从开发效率和维护成本上来说,当然是这样有点折腾!
base
每个组件:公用一个样式文件、各技术栈独立编写对应的交互文件(具体参考各相关库)。
至于组件的导出、引用和组织方式可以优化。大家也可以更新上自己的想法和实现方案。让后续master版本向自己更酷的方案变更。
ui库(本库)只维护样式。
目录结构
//目录结构
┌root/
├── demos/ 你的项目 project (参考) : 调试组件用
│ └── common/
│ └── mixins/ 项目中的业务组件 (公共库中没有,项目中频繁使用的封装)
│ └── pages/ 页面 (这里是 具体组件的 使用demos)
│ └── style/ 页面样式 (和pages一一对应,没有可以不写)
│ └── index 入口文件
│ └──
├── test/ 自动化测试
│
├── src/ 纯组件样式相关的代码和依赖。
│ └── iconfont/ 字体图标库
│ └── img/ 组件图片库 (后续优化 将所有组件图片 base64.这样推荐将组件用的图片放置到组件对应的文件夹中维护)
│ └── components/ 组件样式文件 (如果你的样式文件拆分成多个文件请使用文件夹谢谢!)
│ └── exports 对外统一导出文件
│ └── conmon/
│ └── base 通用样式,各项目间的一些基类、常用类等:
│ └── dom 基本样式,浏览器兼容或者统一浏览器基本样式
│ └── vari 变量定义 (项目中 的变量文件建议继承。而不是直接修改该文件!)
│
│
├── site/ 在线开发文档 目录 (采用崔正阳的storybook后续整合进来)
│
├──
├── others files...
注意点
- dev 提交文件时不要整个项目提交....(只提交你修改、期望的文件!)
- 花一分钟看一下目录结构。花三分钟看一下规范。统一一下代码风格(有好的风格直接提出来,大家都转向更酷的方案)
- dev中或者自己分支中测试通过之后,可以提交合并请求到 master 分支。楠姐那边审核通过会合并到master中!
use
参考 use!
组件规范
参考 组件规范文档!
todo
- zepto、react、vue的交互方案待定。
- 组件代码的导出、引用和组织方式待优化
- gulp 打包出less版、css版
- 所有组件图片 base64内联.
备注
对应组件 需要的icon或者图片,请联系设计添加到对应的iconfont库中!
src/components/filename 对应组件样式文件 (如果有分拆,则对应文件夹)
site/pages/folder 对应的开发文档。统一生成组件API网页
demos/pages/filename 对应组件样式 测试文件 (如果有分拆,则对应文件夹)。这个不是必要的,只是建议。