# Demo 文档书写规范

Demo 中的控件命名统一采用驼峰大写的形式,不使用分隔符。

Demo 文档需要有 开发者信息安装引入控件 DemoAPI

# 开发者信息

控件基本都是要求有规范进行指导开发,但也存在没有规范的控件

  • 没有规范的控件需要说明控件最新版本、开发人员
  • 有规范的控件需要说明控件最新版本、开发人员、交互、UI、规范以及规范评审状态。
<!-- 没有规范 -->
<template>
  <author-info
    version="1.0.0"
    author="陈冠彬"
  />
</template>

<!-- 有规范(规范未评审) -->
<template>
  <author-info
    author="陈冠彬"
    ux="潘虹帆"
    ui="应源山"
    standard="http://10.33.43.73/huidesign/project/issues/57"
  />
</template>

<!-- 有规范(规范已评审) -->
<template>
  <author-info
    author="陈冠彬"
    ux="潘虹帆"
    ui="应源山"
    standard="http://10.33.43.73/huidesign/project/issues/57"
    reviewed
  />
</template>

# 安装 & 引入

目前项目采用 monorepo 模型对每个控件进行单独管理,每个控件都是单独安装和引入的,因此需要在文档里有安装和引入的说明。

安装大同小异,引入时需要注意,若控件有字体图标,需要另起一个 index.scss,修改字体图标的引用路径。

比如 Plan 控件的引入说明:

// main.js
import plan from '@hui-pro/plan';
import './assets/index.scss';
Vue.use(plan);
// assets/index.scss
$--plan-font-path: '~@hui-pro/plan/theme/fonts';
import '~@hui-pro/plan/theme/index.scss';

# 控件 Demo

列出控件的基本用法和最常用的扩展用法,能对开发人员使用控件提供帮助。

# API

API 内容主要包括:

  • Attributes(属性)
  • Methods(方法)
  • Events(事件)
  • Slot(插槽)