快速上手
高效的开发,离不开基础工程的搭建。在开始使用 iView 之前,有必要先了解以下基础知识,我们也假设您已经写过 Vue,并掌握了下面的内容。
- -以下概念贯穿 iView 前后,建议开发者花点时间来了解。
--
-
-
-
props
传递数据 -
- -
-
slot
内容分发 -
- -
-
events
$emit
@click
事件 -
-
使用
我们也为您准备好了基础工程,以此为基础开发,可以为您省去大量配置和调试环境的时间。
+在开始使用 iView Weapp 之前,你需要先阅读 微信小程序自定义组件 的相关文档。
+到 GitHub 下载 iView Weapp 的代码,将 dist
目录拷贝到自己的项目中。然后按照如下的方式使用组件,以 Button 为例,其它组件在对应的文档页查看:
- 推荐工程:iview-project + 1. 添加需要的组件。在页面的 json 中配置(路径根据自己项目位置配置):
-如果您使用了我们推荐的工程,可以略过下面的内容直接进入开发阶段,我们也推荐使用这套工程来构建您的项目。
-如果您希望自己配置或使用其它工程,比如 vue-cli,请继续往下阅读。
-一般在 webpack 入口页面 main.js
中如下配置:
借助插件 babel-plugin-import可以实现按需加载组件,减少文件体积。首先安装,并在文件 .babelrc
中配置:
然后这样按需引入组件,就可以减小体积了:
--
-
- 按需引用仍然需要导入样式,即在 main.js 或根组件执行
import 'iview/dist/styles/iview.css';
-
-
-
使用:prop
传递数据格式为 数字、布尔值或函数时,必须带:
(兼容String除外,具体看组件文档),比如:
在非 template/render 模式下(例如使用 CDN 引用时),组件名要分隔,例如 DatePicker
必须要写成 date-picker
。
以下组件,在非 template/render 模式下,需要加前缀 i-
:
-
-
- Button:
i-button
- - Col:
i-col
- - Table:
i-table
- - Input:
i-input
- - Form:
i-form
- - Menu:
i-menu
- - Select:
i-select
- - Option:
i-option
- - Progress:
i-progress
-
以下组件,在所有模式下,必须加前缀 i-
,除非使用
-
-
- Switch:
i-switch
- - Circle:
i-circle
-
+ 2. 在 wxml 中使用组件: +
+我们内置了所有组件的示例,您可以扫描右侧的小程序码体验,或按以下方式在微信开发者工具中查看:
+然后,将 examples
目录在微信开发者工具中打开即可。