TDesign-mobile 说明

• 该仓库用于 mobile 端（含 Vue 和 React ）的 TDesign 组件库的样式文件和 html 文件
• 使用 less 来管理和编写样式
• 基于 PBEM 命名，其中 P 代表 Prefix，B 代表 Block ，E 代表 Element ， M 代表 Modifier。更详细规范及命名推荐，请查看 CSS 命名规范
• 组件名称命名规则

文件目录说明

mobile
├── dist                        // 编译后的样式文件和图片素材
├── components                  // 组件样式
│   ├── button
│   │   ├── _index.less         // 组件的主样式文件，内含 base.less、自己变量/函数 及 相关依赖
|   |   ├── _mixin.less         // 组件的 mixin 文件
|   |   ├── _var.less           // 组件的变量文件
│   │   └── index.html          // 组件的html结构
│   ├── ...
│   └── index.less              // 统一引入各个组件样式的出口文件
├── assets                      // icon/图片素材
│   ├── image
│   │   ├── name.svg            // 各类图标
│   │   └── ...                 // 组件的html结构
├── mixins                      // 可复用
│   ├── _clearfix.less          // 清除浮动
│   ├── ...
│   └── _index.less             // mixin 统一入口
├── utilities                   // 定义可复用的代码片段,且可单独使用
│   ├── _float.less
│   └── index.less              // utilities 统一入口
├── theme                       // UI主题风格样式
│   ├── ...
│   └── index.less              // 覆盖默认主题
├── _reset.less                 // 重置标签默认样式
├── _variables.less             // 全局变量
├── base.less                   // 基础样式（内含 _reset.less 和 _variable.less）
├── index.less                  // 统一引入UI库所有样式的出口文件
└── index.js                    // webpack 入口文件，含各组件的主样式

开发

初始化

name为组件名（命名规则参考）

手动拷贝

复制 a-template ，修改为组件名，里面有需要的默认文件。 几个关键点：

• components 下创建组件文件夹
• 修改 index.html 开发者信息及 title信息(可在该组件文件夹下搜索<name>替换)。
• components 下的 _index.less 增加组件主样式 （注意依赖顺序关系）
• index.js 增加组件样式入口
• 如果有示例样式，添加到 /docs/<name>.css，并在docs.css里引入

启动

style/web目录下，启动项目，主要用于 less 编译。html 可通过本地服务的方式实现热更新（如 VS Code 的 Live Server）

npm run start

相关资料

web 端设计稿 移动端端设计稿 组件各个模块负责人 UI 开发排期