ant-design-vue/docs/vue/introduce.zh-CN.md
2018-04-10 12:08:41 +08:00

5.2 KiB
Raw Blame History

Ant Design of Vue

这里是 Ant Design 3.X 的 Vue 实现,开发和服务于企业级后台产品。

+

特性

  • 提炼自企业级中后台产品的交互语言和视觉风格。
  • 开箱即用的高质量 Vue 组件。
  • 共享Ant Design of React设计工具体系。

支持环境

  • 现代浏览器和 IE9 及以上(需要 polyfills)。
  • 支持服务端渲染。

版本

  • 稳定版:npm package

你可以订阅:https://github.com/vueComponent/ant-design/releases.atom 来获得稳定版发布的通知。

安装

使用 npm 或 yarn 安装

我们推荐使用 npm 或 yarn 的方式进行开发,不仅可在开发环境轻松调试,也可放心地在生产环境打包部署使用,享受整个生态圈和工具链带来的诸多好处。

$ npm install vue-antd-ui --save
$ yarn add vue-antd-ui

如果你的网络环境不佳,推荐使用 cnpm

组件库使用了 vue 的新特性slot-scope(2.5.0新增), provide / inject(2.2.0新增)

浏览器引入

在浏览器中使用 scriptlink 标签直接引入文件,并使用全局变量 antd

我们在 npm 发布包内的 vue-antd-ui/dist 目录下提供了 antd.js antd.css 以及 antd.min.js antd.min.css。你也可以通过 jsdelivrUNPKG 进行下载。

强烈不推荐使用已构建文件,这样无法按需加载,而且难以获得底层依赖模块的 bug 快速修复支持。

注意:引入 antd.js 前你需要自行引入 moment

示例

import Vue from 'vue'
import { DatePicker } from 'vue-antd-ui';
Vue.component(DatePicker.name, DatePicker)

引入样式:

import 'vue-antd-ui/dist/antd.css';  // or 'vue-antd-ui/dist/antd.less'

按需加载

下面两种方式都可以只加载用到的组件。

  • 使用 babel-plugin-import(推荐)。

    // .babelrc or babel-loader option
    {
      "plugins": [
        ["import", { "libraryName": "vue-antd-ui", "libraryDirectory": "es", "style": "css" }] // `style: true` 会加载 less 文件
      ]
    }
    

    注意webpack 1 无需设置 libraryDirectory

    然后只需从 vue-antd-ui 引入模块即可,无需单独引入样式。等同于下面手动引入的方式。

    // babel-plugin-import 会帮助你加载 JS 和 CSS
    import { DatePicker } from 'vue-antd-ui';
    
  • 手动引入

    import DatePicker from 'vue-antd-ui/lib/date-picker';  // 加载 JS
    import 'vue-antd-ui/lib/date-picker/style/css';        // 加载 CSS
    // import 'vue-antd-ui/lib/date-picker/style';         // 加载 LESS
    

链接

如何贡献

如果你希望参与贡献,欢迎 Pull Request,或给我们 报告 Bug

强烈推荐阅读 《提问的智慧》《如何向开源社区提问题》《如何有效地报告 Bug》《如何向开源项目提交无法解答的问题》,更好的问题更容易获得帮助。

关于vue-antd-ui

众所周知Ant Design作为一门设计语言面世经历过多年的迭代和积累它对UI的设计思想已经成为一套事实标准受到众多前端开发者及企业的追捧和喜爱也是React开发者手中的神兵利器。希望vue-antd-ui能够让Vue开发者也享受到Ant Design的优秀设计。

vue-antd-ui是Ant Design 3.X的Vue实现该组件库目前以实现Ant Design React版80%以上的组件组件的风格与Ant Design 3.4.0版本保持同步组件的html结构和css样式也保持一致真正做到了样式0修改组件API也尽量保持了一致。

Ant Design Vue 致力于提供给程序员愉悦的开发体验。

特别感谢

Ant Design Team