# 快速上手

本节将介绍如何在项目中使用 dying-ui。

# 使用 vue-cli@3

基于 vue-cli 做了相应的适配功能,你可以用它们快速地搭建一个基于 dying-ui 的项目。

# 引入 dying-ui

你可以引入整个 dying,或是根据需要仅引入部分组件。我们先介绍如何引入完整的 dying。

# 完整引入

在 main.js 中写入以下内容:

import Vue from "vue";
import dyUi from "dying-ui";
import "dying-ui/dist/dying-ui.css";
import App from "./App.vue";

Vue.use(dyUi);

new Vue({
  el: "#app",
  render: (h) => h(App),
});

以上代码便完成了 dying-ui 的引入。需要注意的是,样式文件需要单独引入。

# 按需引入

借助 babel-plugin-component (opens new window),我们可以只引入需要的组件,以达到减小项目体积的目的。

首先,安装 babel-plugin-component:

npm install babel-plugin-component -D

然后,将 .babelrc 修改为:

{
  "presets": [["es2015", { "modules": false }]],
  "plugins": [
    [
      "component",
      {
        "libraryName": "dying-ui",
        "styleLibraryName": "theme-chalk"
      }
    ]
  ]
}

接下来,如果你只希望引入部分组件,比如 Button 和 Select,那么需要在 main.js 中写入以下内容:

import Vue from "vue";
import { DyButton, DyIcon } from "dying-ui";
import App from "./App.vue";

Vue.component(DyButton.name, DyButton);
Vue.component(DyIcon.name, DyIcon);
/* 或写为
 * Vue.use(DyButton)
 * Vue.use(DyButton)
 */

new Vue({
  el: "#app",
  render: (h) => h(App),
});

完整组件列表和引入方式(完整组件列表以 components.json (opens new window) 为准)

import Vue from "vue";
import {
  DyButton,
  DyIcon,
  DyButtonGroup,
  DyCol,
  DyRow,
  DyAside,
  DyContainer,
  DyFooter,
  DyHeader,
  DyMain,
  DyInput,
  DyUpload,
  DyProgress,
  DyPopover,
} from "dying-ui";
Vue.use(DyButton);
Vue.use(DyIcon);
Vue.use(DyButtonGroup);
vue.use(DyCol);
vue.use(DyRow);
vue.use(DyAside);
vue.use(DyContainer);
vue.use(DyFooter);
vue.use(DyHeader);
vue.use(DyMain);
vue.use(DyInput);
vue.use(DyUpload);
vue.use(DyProgress);
vue.use(DyPopover);

# 开始使用

至此,一个基于 Vue 和 dying-ui 的开发环境已经搭建完毕,现在就可以编写代码了。各个组件的使用方法请参阅它们各自的文档。