- 基础组件
- 属性类型
- 共同属性类型
- 特殊属性
- 组件列表
- 扩展组件(uni-ui):
基础组件
框架为开发者提供了一系列基础组件,类似HTML里的基础标签元素。
但uni-app的组件与HTML不同,而是与微信小程序相同,更适合手机端使用。
虽然不推荐使用HTML标签,但实际上如果开发者写了div等标签,在编译到非H5平台时也会被编译器转换为view标签,类似的还有span转text、a转navigator等,包括css里的元素选择器也会转。但为了管理方便、策略统一,新写代码时仍然建议使用view等组件。
开发者可以通过组合这些基础组件进行快速开发。基于内置的基础组件,可以开发各种扩展组件,组件规范与vue组件相同。
DCloud提供了扩展组件框架uni-ui(见文末),同时更多三方开发的组件也收录到插件市场。
什么是组件:
- 组件是视图层的基本组成单元。
- 一个组件通常包括开始标签和结束标签,属性用来修饰这个组件,内容在两个标签之内。
<template><view><tagname property="value">content</tagname></view></template>
Tips
- 所有组件与属性名都是小写,单词之间以连字符
-连接。 - 根节点为
<template>,这个<template>下只能有一个根<view>组件。 - 平台差异说明若无特殊说明,则表示所有平台均支持。
属性类型
| 类型 | 描述 | 注解 |
|---|---|---|
| Boolean | 布尔值 | 组件写上该属性,不管该属性等于什么,其值都为 true,只有组件上没有写该属性时,属性值才为 false。如果属性值为变量,变量的值会被转换为 Boolean 类型。 |
| Number | 数字 | 1, 2.5 |
| String | 字符串 | "string" |
| Array | 数组 | [ 1, "string" ] |
| Object | 对象 | { key: value } |
| EventHandler | 事件处理函数名 | handlerName 是 methods 中定义的事件处理函数名 |
| Any | 任意属性 |
共同属性类型
所有组件都有的属性:
| 属性名 | 类型 | 描述 | 注解 |
|---|---|---|---|
| id | String | 组件的唯一标示 | 保持整个页面唯一 |
| class | String | 组件的样式类 | 在对应的 css 中定义的样式类 |
| style | String | 组件的内联样式 | 可以动态设置的内联样式 |
| hidden | Boolean | 组件是否隐藏 | 所有组件默认是显示的 |
| data- | Any | 自定义属性 | 组件上触发的事件时,会发送给事件处理函数 |
| @ | EventHandler | 组件的事件 | 详见各组件详细文档,事件绑定参考 事件处理器 |
特殊属性
几乎所有组件都有各自自定义的属性,可以对该组件的功能或样式进行修饰,请参考各个组件的定义。
组件列表
基础组件分为以下八大类:
视图容器(View Container):
| 组件名 | 说明 |
|---|---|
| view | 视图容器 |
| scroll-view | 可滚动视图容器 |
| swiper | 滑块视图容器 |
基础内容(Basic Content):
| 组件名 | 说明 |
|---|---|
| icon | 图标 |
| text | 文字 |
| rich-text | 富文本 |
| progress | 进度条 |
表单组件(Form):
| 标签名 | 说明 |
|---|---|
| button | 按钮 |
| form | 表单 |
| input | 输入框 |
| checkbox | 多项选择器 |
| radio | 单项选择器 |
| picker | 列表选择器 |
| picker-view | 内嵌列表选择器 |
| slider | 滚动选择器 |
| switch | 开关选择器 |
| label | 标签 |
导航(Navigation):
| 组件名 | 说明 |
|---|---|
| navigator | 应用链接 |
媒体组件(Media):
| 组件名 | 说明 |
|---|---|
| audio | 音频 |
| camera | 相机 |
| image | 图片 |
| video | 视频 |
| live-player | 直播 |
地图(Map):
| 组件名 | 说明 |
|---|---|
| map | 地图 |
画布(Canvas):
| 组件名 | 说明 |
|---|---|
| canvas | 画布 |
webview(Web-view):
| 组件名 | 说明 |
|---|---|
| web-view | web浏览器组件 |
平台开放数据(Open-data):
| 组件名 | 说明 |
|---|---|
| open-data | 展示平台开放的数据 |
扩展组件(uni-ui):
uni-ui是DCloud提供的一个跨端ui库,它是基于vue组件的、flex布局的、无dom的跨全端ui框架。
注意与web开发不同,uni-ui不包括基础组件,它是基础组件的补充。
web开发中有的开发者习惯用一个ui库完成所有开发,但在uni-app体系中,推荐开发者首先使用性能更高的基础组件,然后按需引入必要的扩展组件。
uni-ui支持npm安装和zip下载安装2种方式。
npm安装参考:https://ext.dcloud.net.cn/plugin?id=55
下表为uni-ui的扩展组件清单,点击每个组件可单独安装。
| 组件名 | 说明 |
|---|---|
| Badge | 数字角标 |
| Calendar | 日历 |
| Card | 卡片 |
| Collapse | 折叠面板 |
| CountDown | 倒计时 |
| Drawer | 抽屉 |
| Fab | 悬浮按钮 |
| Grid | 宫格 |
| Icon | 图标 |
| IndexedList | 索引列表 |
| List | 列表 |
| LoadMore | 加载更多 |
| NavBar | 自定义导航栏 |
| NoticeBar | 通告栏 |
| NumberBox | 数字输入框 |
| Pagination | 分页器 |
| PopUp | 弹出层 |
| Rate | 评分 |
| SegmentedControl | 分段器 |
| Steps | 步骤条 |
| SwipeAction | 滑动操作 |
| SwiperDot | 轮播图指示点 |
| Tag | 标签 |
更多组件
除了基础组件、uni-ui,插件市场还有更多扩展组件、模板,包括前端组件和原生扩展组件,具体见插件市场。
关于其他vue的web组件库、小程序组件库是否能在uni-app中使用的问题,参考http://ask.dcloud.net.cn/article/35489
发现错误?想参与编辑?在 GitHub 上编辑此页面!
