San Component 组件开发

组件要求是不涉及具体业务的逻辑、粒度合理的单元。

一般来讲,组件分为项目公共组件、全局组件和页面的组件三类。

  • 公共组件:通过 npm 维护,项目使用package.json引入
  • 全局组件:放在src/components/下面维护,主要是全局性的,或通用性很强的组件,具备良好的封装性
  • 页面的组件:放在src/pages/*/components下面维护,仅限某个页面内使用

百度公司内部更加详细的组件开发规范或者开发 Nano 组件,请参考 Nano 组件库规范!

组件开发

可以将自己团队的组件规范对应的组件目录结构创建一个脚手架,然后使用 San CLI 的init命令在对应的组件路径中创建一个组件项目结构:

san init <component-scaffold> <folder-name>

例如我们的组件目录结构如下:

├── README.md          # 组件介绍
├── __tests__          # 测试相关
│   └── index.spec.js
├── docs               # 文档相关
│   ├── basic.md
│   └── index.js
├── index.js
├── package.json
└── style
    └── index.less