快速上手

快速上手

使用之前

高效的开发,离不开基础工程的搭建。在开始使用 iView 之前,有必要先了解以下基础知识,我们也假设您已经写过 Vue,并掌握了下面的内容。

以下概念贯穿 iView 前后,建议开发者花点时间来了解。

  • props 传递数据

你也可以通过 学习组件基础内容 来快速入门。

使用 Vue CLI 3

我们为最新的 Vue CLI 3 提供了相应的 iView 插件,如果你正在用 Vue CLI 3,可以直接在插件中搜索 iview,安装插件来使用。

使用推荐工程

我们也为您准备好了基础工程,以此为基础开发,可以为您省去大量配置和调试环境的时间。

推荐工程:iview-project

如果您使用了我们推荐的工程,可以略过下面的内容直接进入开发阶段,我们也推荐使用这套工程来构建您的项目。

如果您希望自己配置或使用其它工程,请继续往下阅读。

如果你未接触过 webpack,建议 学习 webpack 内容

引入 iView

一般在 webpack 入口页面 main.js 中如下配置:

import Vue from 'vue'; import VueRouter from 'vue-router'; import App from 'components/app.vue'; import Routers from './router.js'; import iView from 'iview'; import 'iview/dist/styles/iview.css'; Vue.use(VueRouter Vue.use(iView // The routing configuration const RouterConfig = { routes: Routers }; const router = new VueRouter(RouterConfig new Vue{ el: '#app', router: router, render: h => h(App) }

按需引用

借助插件 babel-plugin-import可以实现按需加载组件,减少文件体积。首先安装,并在文件 .babelrc 中配置:

npm install babel-plugin-import --save-dev // .babelrc { "plugins": [["import", { "libraryName": "iview", "libraryDirectory": "src/components" }]] }

然后这样按需引入组件,就可以减小体积了:

import { Button, Table } from 'iview'; Vue.component('Button', Button Vue.component('Table', Table

特别提醒

  • 按需引用仍然需要导入样式,即在 main.js 或根组件执行 import 'iview/dist/styles/iview.css';

组件使用规范

使用:prop传递数据格式为 数字、布尔值或函数时,必须带:(兼容String除外,具体看组件文档),比如:

Correct usage: <Page :current="1" :total="100"></Page> Incorrect usage: <Page current="1" total="100"></Page>

在非 template/render 模式下(例如使用 CDN 引用时),组件名要分隔,例如 DatePicker 必须要写成 date-picker

以下组件,在非 template/render 模式下,需要加前缀 i-

  • Button: i-button

以下组件,在所有模式下,必须加前缀 i-,除非使用 iview-loader:

  • Switch: i-switch