赞
踩
在线文档:https://mp.weixin.qq.com/debug/wxadoc/dev/
微信公众平台:https://mp.weixin.qq.com/
小程序开发者账号注册:https://mp.weixin.qq.com/wxopen/waregister?action=step1
微信开发者工具:https://mp.weixin.qq.com/debug/wxadoc/dev/devtools/download.html
主体部分由三个文件组成,必须放在项目的根目录,如下:
通过开发者工具快速创建了一个 QuickStart 项目。可以留意到这个项目里边生成了不同类型的文件:
.json
后缀的JSON
配置文件.wxml
后缀的WXML(Wei Xin Markup Language)
模板文件.wxss
后缀的WXSS(Wei Xin Style Sheets)
样式文件.js
后缀的JS
脚本逻辑文件接下来我们分别看看这4种文件的作用。
页面由四个文件组成,分别是:
文件类型 | 必填 | 作用 |
---|---|---|
js | 是 | 页面逻辑 ( 微信小程序没有window和document对象 ) |
wxml | 是 | 页面结构 ( XML语法,不是HTML语法 ) |
wxss | 否 | 页面样式表 ( 拓展了rpx尺寸单位,微信专属响应式像素 ) |
json | 否 | 页面配置 ( 不能写注释,否则编译报错 ) |
app.json
是当前小程序的全局配置,包括了小程序的所有页面路径、界面表现、网络超时时间、底部 tab 等。可以看到生成的app.json
配置内容如下:
| |
app.json
配置各项的含义
属性 | 类型 | 必填 | 描述 | 最低版本 |
---|---|---|---|---|
pages | String Array | 是 | 描述当前小程序所有页面路径,通常文件名和页面各文件名都相同 | |
window | Object | 否 | 定义小程序所有页面的顶部背景颜色,文字颜色定义等。 | |
tabBar | Object | 否 | 底部 tab 栏的表现 | |
networkTimeout | Object | 否 | 网络超时时间 | |
debug | Boolean | 否 | 是否开启 debug 模式,默认关闭 | |
functionalPages | Boolean | 否 | 是否启用插件功能页,默认关闭 | 2.1.0 |
subpackages | Object Array | 否 | 分包结构配置 | 1.7.3 |
workers | String | 否 | Worker 代码放置的目录 | 1.9.90 |
requiredBackgroundModes | String Array | 否 | 需要在后台使用的能力,如「音乐播放」 | |
plugins | Object | 否 | 使用到的插件 | 1.9.6 |
preloadRule | Object | 否 | 分包预下载规则 | 2.3.0 |
resizable | Boolean | 否 | iPad 小程序是否支持屏幕旋转,默认关闭 | 2.3.0 |
navigateToMiniProgramAppIdList | String Array | 否 | 需要跳转的小程序列表,详见 wx.navigateToMiniProgram | 2.4.0 |
usingComponents | Object | 否 | 全局自定义组件配置 | 开发者工具 1.02.1810190 |
permission | Object | 否 | 小程序接口权限相关设置 | 微信客户端 7.0.0 |
pages
用于指定小程序由哪些页面组成,每一项都对应一个页面的 路径+文件名 信息。文件名不需要写文件后缀,框架会自动去寻找对于位置的
.json
,.js
,.wxml
,.wxss
四个文件进行处理。
例如app.json
中,此时数组中第一项为默认首页,即index
是首页
| |
window
用于设置小程序的状态栏、导航条、标题、窗口背景色。
注意:页面的
.json
只能设置window
相关的配置项,以决定本页面的窗口表现,所以无需写window
这个键。
属性 | 类型 | 默认值 | 描述 | 最低版本 |
---|---|---|---|---|
navigationBarBackgroundColor | HexColor | #000000 | 导航栏背景颜色,如 #000000 | |
navigationBarTextStyle | String | white | 导航栏标题颜色,仅支持 black / white | |
navigationBarTitleText | String | 导航栏标题文字内容 | ||
navigationStyle | String | default | 导航栏样式,仅支持以下值: default 默认样式 custom 自定义导航栏,只保留右上角胶囊按钮。参见注2。 | 微信客户端 6.6.0 |
backgroundColor | HexColor | #ffffff | 窗口的背景色 | |
backgroundTextStyle | String | dark | 下拉 loading 的样式,仅支持 dark / light | |
backgroundColorTop | String | #ffffff | 顶部窗口的背景色,仅 iOS 支持 | 微信客户端 6.5.16 |
backgroundColorBottom | String | #ffffff | 底部窗口的背景色,仅 iOS 支持 | 微信客户端 6.5.16 |
enablePullDownRefresh | Boolean | false | 是否开启当前页面的下拉刷新。 详见 Page.onPullDownRefresh | |
onReachBottomDistance | Number | 50 | 页面上拉触底事件触发时距页面底部距离,单位为px。 详见 Page.onReachBottom | |
pageOrientation | String | portrait | 屏幕旋转设置,仅支持 auto / portrait 详见 响应显示区域变化 | 微信客户端 6.7.3 |
- 注1:HexColor(十六进制颜色值),如”#ff00ff”
- 注2:关于
navigationStyle
- 客户端 7.0.0 以下版本,
navigationStyle
只在app.json
中生效。- 客户端 6.7.2 版本开始,
navigationStyle: custom
对 组件无效- 开启 custom 后,低版本客户端需要做好兼容。开发者工具基础库版本切到 1.7.0(不代表最低版本,只供调试用)可方便切到旧视觉
如 app.json :
| |
微信接口功能演示
tabBar
如果小程序是一个多 tab 应用(客户端窗口的底部或顶部有 tab 栏可以切换页面),可以通过 tabBar 配置项指定 tab 栏的表现,以及 tab 切换时显示的对应页面。
属性 | 类型 | 必填 | 默认值 | 描述 | 最低版本 |
---|---|---|---|---|---|
color | HexColor | 是 | tab 上的文字默认颜色,仅支持十六进制颜色 | ||
selectedColor | HexColor | 是 | tab 上的文字选中时的颜色,仅支持十六进制颜色 | ||
backgroundColor | HexColor | 是 | tab 的背景色,仅支持十六进制颜色 | ||
borderStyle | String | 否 | black | tabbar上边框的颜色, 仅支持 black / white | |
list | Array | 是 | tab 的列表,详见 list 属性说明,最少2个、最多5个 tab | ||
position | String | 否 | bottom | tabBar的位置,仅支持 bottom / top | |
custom | Boolean | 否 | false | 自定义 tabBar,见详情 | 2.5.0 |
- tabBar 中的 list 是一个数组,只能配置最少2个、最多5个 tab,tab 按数组的顺序排序。
属性说明:
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
pagePath | String | 是 | 页面路径,必须在 pages 中先定义 |
text | String | 是 | tab 上按钮文字 |
iconPath | String | 否 | 图片路径,icon 大小限制为40kb,建议尺寸为 81px * 81px,当 postion 为 top 时,此参数无效 |
selectedIconPath | String | 否 | 选中时的图片路径,icon 大小限制为40kb,建议尺寸为 81px * 81px ,当 postion 为 top 时,此参数无效 |
示例:
| |
图示:
转存失败重新上传取消转存失败重新上传取消转存失败重新上传取消
networkTimeout
各类网络请求的超时时间,单位均为毫秒。
属性 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
request | Number | 否 | 60000 | wx.request 的超时时间,单位:毫秒。 |
connectSocket | Number | 否 | 60000 | wx.connectSocket 的超时时间,单位:毫秒。 |
uploadFile | Number | 否 | 60000 | wx.uploadFile 的超时时间,单位:毫秒。 |
downloadFile | Number | 否 | 60000 | wx.downloadFile 的超时时间,单位:毫秒。 |
debug
可以在开发者工具中开启
debug
模式,在开发者工具的控制台面板,调试信息以info
的形式给出,其信息有Page的注册,页面路由,数据更新,事件触发等。可以帮助开发者快速定位一些常见的问题。
functionalPages
基础库 2.1.0 开始支持,低版本需做兼容处理。
启用插件功能页时,插件所有者小程序需要设置其
functionalPages
为true
。
subpackages
微信客户端 6.6.0 ,基础库 1.7.3 及以上版本支持。
启用分包加载时,声明项目分包结构。
写成 subPackages 也支持。
workers
基础库 1.9.90 开始支持,低版本需做兼容处理。
requiredBackgroundModes
微信客户端 6.7.2 及以上版本支持。
申明需要后台运行的能力,类型为数组。目前支持以下项目:
audio
: 后台音乐播放如:
| |
注:在此处申明了后台运行的接口,开发版和体验版上可以直接生效,正式版还需通过审核。
plugins
基础库 1.9.6 开始支持,低版本需做兼容处理。
声明小程序需要使用的插件。
preloadRule
基础库 2.3.0 开始支持,低版本需做兼容处理。
声明分包预下载的规则。
resizable
基础库 2.3.0 开始支持,低版本需做兼容处理。
在 iPad 上运行的小程序可以设置支持屏幕旋转。
navigateToMiniProgramAppIdList
基础库 2.4.0 开始支持,低版本需做兼容处理。
当小程序需要使用 wx.navigateToMiniProgram 接口跳转到其他小程序时,需要先在配置文件中声明需要跳转的小程序 appId 列表,最多允许填写 10 个。
usingComponents
开发者工具 1.02.1810190 及以上版本支持。
在此处声明的自定义组件视为全局自定义组件,在小程序内的页面或自定义组件中可以直接使用而无需再声明。
permission
微信客户端 7.0.0 及以上版本支持
小程序接口权限相关设置。字段类型为 Object
,结构为:
属性 | 类型 | 必填 | 默认值 | 描述 |
---|---|---|---|---|
scope.userLocation | PermissionObject | 否 | 位置相关权限声明 |
PermissionObject 结构
属性 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
desc | string | 是 | 小程序获取权限时展示的接口用途说明。最长30个字符 |
如:
| |
每一个小程序页面也可以使用
.json
文件来对本页面的窗口表现进行配置。页面的配置只能设置
app.json
中部分window
配置项的内容,页面中配置项会覆盖app.json
的window
中相同的配置项。
| |
属性 | 类型 | 默认值 | 描述 | 最低版本 |
---|---|---|---|---|
navigationBarBackgroundColor | HexColor | #000000 | 导航栏背景颜色,如 #000000 | |
navigationBarTextStyle | String | white | 导航栏标题颜色,仅支持 black / white | |
navigationBarTitleText | String | 导航栏标题文字内容 | ||
navigationStyle | String | default | 导航栏样式,仅支持以下值: default 默认样式 custom 自定义导航栏,只保留右上角胶囊按钮 | 微信客户端 7.0.0 |
backgroundColor | HexColor | #ffffff | 窗口的背景色 | |
backgroundTextStyle | String | dark | 下拉 loading 的样式,仅支持 dark / light | |
enablePullDownRefresh | Boolean | false | 是否全局开启下拉刷新。 详见 Page.onPullDownRefresh | |
onReachBottomDistance | Number | 50 | 页面上拉触底事件触发时距页面底部距离,单位为px。 详见 Page.onReachBottom | |
disableScroll | Boolean | false | 设置为 true 则页面整体不能上下滚动。 只在页面配置中有效,无法在 app.json 中设置 | |
disableSwipeBack | Boolean | false | 禁止页面右滑手势返回 | 微信客户端 7.0.0 |
页面的
.json
只能设置window
相关的配置项,以决定本页面的窗口表现,所以无需写window
这个属性。
小程序开发框架的逻辑层使用
JavaScript
引擎为小程序提供开发者JavaScript
代码的运行环境以及微信小程序的特有功能。逻辑层将数据进行处理后发送给视图层,同时接受视图层的事件反馈。
BOM
和DOM
对象,就意味着没有document
和window
console.log(getCurrentPage())
打印出来是一个数组,意味着返回值是一个数组,然后this
指向当前的页面,是当前页面的调用栈JS
是支持CommonJS
规范的,也就是说可以通过require
载入模块,通过module.exports
导出模块,但不支持exports.xxx
框架的视图层由 WXML 与 WXSS 编写,由组件来进行展示。
将逻辑层的数据反应成视图,同时将视图层的事件发送给逻辑层。
WXML(WeiXin Markup language) 用于描述页面的结构。
WXS(WeiXin Script) 是小程序的一套脚本语言,结合
WXML
,可以构建出页面的结构。WXSS(WeiXin Style Sheet) 用于描述页面的样式。
组件(Component)是视图的基本组成单元。
WXML(WeiXin Markup Language)是框架设计的一套标签语言,结合基础组件、事件系统,可以构建出页面的结构。
将数据动态渲染到页面中
简单数据绑定
数据在哪?
| |
绑定到哪?
双大括号
的形式,绑定数据到想要输出的位置<text></text>
简单数据绑定
text
文本节点class
,为元素添加样式或者拼接样式双大括号
的语法
innerHTML
上true
或者false
包裹在双大括号
内进行解析,防止被JS误解为字符串列表渲染
将数组中的数据在页面中循环渲染
index.js
文件的data
中定义一个数组,数组中的每一个成员都是一个对象index.wxml
中利用wx:for=""
遍历输出,注意这里的wx:for
中间不能有空格 | |
| |
item
关键词,解决方法可以直接在循环的属性后面加上wx:for-item="项目名称缩写"
,那么下面遍历的时候也需要用你起的别名进行遍历,看下面示例 | |
wx:for-index="i"
去拿,那么下面拿序号的时候,就要用拿 | |
wx:for
的值在下面是可以点出来legth
值的,我在代码中试了试 | |
wx:for
也可以嵌套,下边是一个九九乘法表 ,我们将这个乘法口诀代码粘贴到自己的测试项目中看一下 | |
wx:for
用在<block/>
标签上 | |
wx:key
来指定列表中项目的唯一的标识符
<input>
中的输入内容,<switch>
的选中状态)wx:key
的值以两种形式提供
*this
代表在 for 循环中的 item 本身,这种表示需要 item 本身是一个唯一的字符串或者数字 ,如当数据改变触发渲染层重新渲染的时候,会校正带有 key 的组件,框架会确保他们被重新排序,而不是重新创建,以确保使组件保持自身的状态,并且提高列表渲染时的效率
| |
| |
wx:for="string"
的时候,会把字符串解析为数组,例如下面两个等价的代码 | |
2. 注意:花括号和引号之间如果有空格,将最终被解析成为字符串
| |
条件渲染
wx:if
, 当需要判断是否添加一个代码块的时候,要用到wx:elif
或者wx:else
示例:用在wx:for
章节的代码,跟着后面添加了几句判断
| |
<block/>
标签将多个组件包装起来,并在上边使用 wx:if
控制属性。 | |
<block/>
并不是一个组件,它仅仅是一个包装元素,不会在页面中做任何渲染,只接受控制属性。因为
wx:if
之中的模板也可能包含数据绑定,所以当wx:if
的条件值切换时,框架有一个局部渲染的过程,因为它会确保条件块在切换时销毁或重新渲染。同时
wx:if
也是惰性的,如果在初始渲染条件为false
,框架什么也不做,在条件第一次变成真的时候才开始局部渲染。相比之下,
hidden
就简单的多,组件始终会被渲染,只是简单的控制显示与隐藏。一般来说,
wx:if
有更高的切换消耗而hidden
有更高的初始渲染消耗。因此,如果需要频繁切换的情景下,用hidden
更好,如果在运行时条件不大可能改变则wx:if
较好。
WXML提供模板(template),可以在模板中定义代码片段,然后在不同的地方调用。
定义模板
使用 name 属性,作为模板的名字。然后在
<template/>
内定义代码片段,如:
| |
使用模板
使用 is 属性,声明需要的使用的模板,然后将模板所需要的 data 传入,如:
| |
| |
is 属性可以使用 Mustache 语法,来动态决定具体需要渲染哪个模板:
| |
模板的作用域
模板拥有自己的作用域,只能使用
data
传入的数据以及模板定义文件中定义的<wxs />
模块
事件是视图层到逻辑层的通讯方式。
事件可以将用户的行为反馈到逻辑层进行处理。
事件可以绑定在组件上,当达到触发事件,就会执行逻辑层中对应的事件处理函数。
事件对象可以携带额外信息,如 id, dataset, touches
事件的使用方式
| |
| |
buttonTap
函数传参,但是微信开发中绑定事件函数的时候,明确的规定不能直接在后面加括号传参的,不然会报错,这时候和H5
开发的时候一样,需要给元素添加自定义属性data-xxx
,在逻辑层通过dataset
拿到数据 | |
| |
e对象
里面有很多属性和方法方便以后使用e.target
对象是这样的事件分类
事件分为冒泡事件和非冒泡事件:
- 冒泡事件:当一个组件上的事件被触发后,该事件会向父节点传递。
- 非冒泡事件:当一个组件上的事件被触发后,该事件不会向父节点传递。
WXML的冒泡事件列表:
类型 | 触发条件 | 最低版本 |
---|---|---|
touchstart | 手指触摸动作开始 | |
touchmove | 手指触摸后移动 | |
touchcancel | 手指触摸动作被打断,如来电提醒,弹窗 | |
touchend | 手指触摸动作结束 | |
tap | 手指触摸后马上离开 | |
longpress | 手指触摸后,超过350ms再离开,如果指定了事件回调函数并触发了这个事件,tap事件将不被触发 | 1.5.0 |
longtap | 手指触摸后,超过350ms再离开(推荐使用longpress事件代替) | |
transitionend | 会在 WXSS transition 或 wx.createAnimation 动画结束后触发 | |
animationstart | 会在一个 WXSS animation 动画开始时触发 | |
animationiteration | 会在一个 WXSS animation 一次迭代结束时触发 | |
animationend | 会在一个 WXSS animation 动画完成时触发 | |
touchforcechange | 在支持 3D Touch 的 iPhone 设备,重按时会触发 | 1.9.90 |
注:除上表之外的其他组件自定义事件如无特殊声明都是非冒泡事件,如的submit事件,的input事件,的scroll事件,(详见各个组件)
事件绑定和冒泡
事件绑定的写法同组件的属性,以 key、value 的形式 :
| |
| |
实际上熟悉JS事件冒泡的对于这个都不难理解,就是子元素的事件会向上冒泡给相同事件的父元素
阻止事件冒泡
cstch + xxx
阻止冒泡
将上面的案例中的其中一个父元素绑定一下阻止冒泡的事件,观察下
| |
这样的话,事件冒泡到我是他爸爸
这个盒子之后就不会再冒泡了
事件捕获
自基础库版本 1.5.0 起,触摸类事件支持捕获阶段。捕获阶段位于冒泡阶段之前,且在捕获阶段中,事件到达节点的顺序与冒泡阶段恰好相反。需要在捕获阶段监听事件时,可以采用
capture-bind
、capture-catch
关键字,后者将中断捕获阶段和取消冒泡阶段。在下面的代码中,点击 inner view 会先后调用
handleTap2
、handleTap4
、handleTap3
、handleTap1
| |
| |
转存失败重新上传取消转存失败重新上传取消转存失败重新上传取消
如果将上面代码中的第一个capture-bind
改为capture-catch
,将只触发handleTap2
事件对象
如无特殊说明,当组件触发事件时,逻辑层绑定该事件的处理函数会收到一个事件对象
BaseEvent 基础事件对象属性列表:
属性 | 类型 | 说明 |
---|---|---|
type | String | 事件类型 |
timeStamp | Integer | 事件生成时的时间戳 |
target | Object | 触发事件的组件的一些属性值集合 |
currentTarget | Object | 当前组件的一些属性值集合 |
CustomEvent 自定义事件对象属性列表(继承 BaseEvent):
属性 | 类型 | 说明 |
---|---|---|
detail | Object | 额外的信息 |
TouchEvent 触摸事件对象属性列表(继承 BaseEvent):
属性 | 类型 | 说明 |
---|---|---|
touches | Array | 触摸事件,当前停留在屏幕中的触摸点信息的数组 |
changedTouches | Array | 触摸事件,当前变化的触摸点信息的数组 |
特殊事件: 中的触摸事件不可冒泡,所以没有 currentTarget。
type
代表事件的类型
timeStamp
页面打开到触发事件所经过的毫秒数
target
触发事件的源组件
属性 | 类型 | 说明 |
---|---|---|
id | String | 事件源组件的id |
tagName | String | 当前组件的类型 |
dataset | Object | 事件源组件上由data- 开头的自定义属性组成的集合 |
currentTarget
事件绑定的当前组件
属性 | 类型 | 说明 |
---|---|---|
id | String | 当前组件的id |
tagName | String | 当前组件的类型 |
dataset | Object | 当前组件上由data- 开头的自定义属性组成的集合 |
说明: target 和 currentTarget 可以参考前面的例子
dataset
这个在前面传参中也有提到过
在组件中可以定义数据,这些数据将会通过事件传递给 SERVICE。 书写方式: 以
data-
开头,多个单词由连字符-
链接,不能有大写(大写会自动转成小写)如data-element-type
,最终在 event.currentTarget.dataset 中会将连字符转成驼峰elementType
示例:
| |
| |
touches
touches 是一个数组,每个元素为一个 Touch 对象(canvas 触摸事件中携带的 touches 是 CanvasTouch 数组)。 表示当前停留在屏幕上的触摸点
Touch 对象
属性 | 类型 | 说明 |
---|---|---|
identifier | Number | 触摸点的标识符 |
pageX, pageY | Number | 距离文档左上角的距离,文档的左上角为原点 ,横向为X轴,纵向为Y轴 |
clientX, clientY | Number | 距离页面可显示区域(屏幕除去导航条)左上角距离,横向为X轴,纵向为Y轴 |
CanvasTouch 对象
属性 | 类型 | 说明 | 特殊说明 |
---|---|---|---|
identifier | Number | 触摸点的标识符 | |
x, y | Number | 距离 Canvas 左上角的距离,Canvas 的左上角为原点 ,横向为X轴,纵向为Y轴 |
changedTouches
changedTouches 数据格式同 touches。 表示有变化的触摸点,如从无变有(touchstart),位置变化(touchmove),从有变无(touchend、touchcancel)
detail
自定义事件所携带的数据,如表单组件的提交事件会携带用户的输入,媒体的错误事件会携带错误信息,详见组件定义中各个事件的定义
点击事件的
detail
带有的 x, y 同 pageX, pageY 代表距离文档左上角的距离
WXML 提供两种文件引用方式
import
和include
import
import
可以在该文件中使用目标文件定义的template
,如:在 item.wxml 中定义了一个叫
item
的template
:
| |
在 index.wxml 中引用了 item.wxml,就可以使用
item
模板:
| |
import 的作用域
import 有作用域的概念,即只会 import 目标文件中定义的 template,而不会 import 目标文件 import 的 template
如:C import B,B import A,在C中可以使用B定义的template,在B中可以使用A定义的template,但是C不能使用A定义的template。
| |
| |
| |
include
include
可以将目标文件除了<template/>
<wxs/>
外的整个代码引入,相当于是拷贝到include
位置,如:
| |
由于微信小程序框架中没有像Angular
中的ngMoudel
或者Vue
中的v-model
的双向数据绑定,所以默认微信小程序中的数据流只有单向数据流
| |
| |
发现只有内存中的数据改变了,页面却不能跟随变化
利用setData()
这个内部方法进行双向数据绑定
| |
这样实现内存和页面中数据同步更新
WXSS(WeiXin Style Sheets)是一套样式语言。
与 CSS 相比,WXSS 扩展以下2个特性:
组件文档:https://developers.weixin.qq.com/miniprogram/dev/component/
| |
注意:image组件默认宽度300px、高度225px,很多时候我们都不需要这个默认宽高,记得手动设置宽高
参考文档https://qqqww.com/Flex%E5%B8%83%E5%B1%80/
当我们新建页面的时候,自己去新建一个页面,每个页面还要新建好几个文件,很麻烦,这里其实不需要直接新建,在配置app.json
的时候,微信开发者工具会自动帮我们创建好,看下图,我左侧是没有demo4
这个页面的,但是右边配置中写上了"pages/demo4/deom4"
,那么ctrl+s
保存之后,可以看到,左边的页面以及需求的文件都被自动创建出来了
转存失败重新上传取消转存失败重新上传取消转存失败重新上传取消
语法:
| |
json
,不然页面跳转无法显示 | |
以往通过?
或者请求体进行传值
在小程序中,页面间的传值,也可以利用?
传参,在需要使用的传过来的数的时候,在该页面的js
文件的onLoad
生命周期的时候通过options
去接受参数
| |
| |
通过redirect
进行重定向,类型时布尔类型
| |
利用hover-class
控制点击时添加自定义的高亮的类
| |
| |
cursor pointer 的方式是一个小技巧,可以让任何元素点击时高亮
| |
| |
可以利用wx.navigateTo
进行跳转,并可以在url
中添加链接,?
后面接收参数
| |
| |
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
type | String | icon的类型,有效值:success, success_no_circle, info, warn, waiting, cancel, download, search, clear | |
size | Number / String | 23px | icon的大小,单位px(2.4.0起支持rpx) |
color | Color | icon的颜色,同css的color | |
aria-label | String | 无障碍访问,(属性)元素的额外描述 2.5.0 |
属性type
| |
属性size
| |
属性color
| |
tip
: nodes 不推荐使用 String 类型,性能会有所下降。tip
:rich-text
组件内屏蔽所有节点的事件。tip
: attrs 属性不支持 id ,支持 class 。tip
: name 属性大小写不敏感。tip
: 如果使用了不受信任的HTML节点,该节点及其所有子节点将会被移除。tip
: img 标签仅支持网络图片。tip
: 如果在自定义组件中使用rich-text
组件,那么仅自定义组件的 wxss 样式对rich-text
中的 class 生效。
| |
| |
| |
flex
且align-item:center
导致没有宽度,需要自己加宽度才能显示,看下图,修改了控制台内其父元素的样式之后就可以了active
属性,有一个从左到右的进度条动画属性名 | 类型 | 默认值 | 说明 | 最低版本 |
---|---|---|---|---|
percent | Float | 无 | 百分比0~100 | |
show-info | Boolean | false | 在进度条右侧显示百分比 | |
border-radius | Number / String | 0 | 圆角大小,单位px(2.4.0起支持rpx) | 2.3.1 |
font-size | Number / String | 16 | 右侧百分比字体大小,单位px(2.4.0起支持rpx) | 2.3.1 |
stroke-width | Number / String | 6 | 进度条线的宽度,单位px(2.4.0起支持rpx) | |
color | Color | #09BB07 | 进度条颜色 (请使用 activeColor) | |
activeColor | Color | 已选择的进度条的颜色 | ||
backgroundColor | Color | 未选择的进度条的颜色 | ||
active | Boolean | false | 进度条从左往右的动画 | |
active-mode | String | backwards | backwards: 动画从头播;forwards:动画从上次结束点接着播 | 1.7.0 |
bindactiveend | EventHandle | 动画完成事件 | 2.4.1 | |
aria-label | String | 无障碍访问,(属性)元素的额外描述 | 2.5.0 |
| |
type有效值
| |
size有效值
| |
form-type 有效值
值 | 说明 |
---|---|
submit | 提交表单 |
reset | 重置表单 |
hover-class
当按钮按下去,将hover-class
指向想要展示出来的类
| |
| |
演示图片:
转存失败重新上传取消转存失败重新上传取消转存失败重新上传取消
checkbox
多选框
checkbox-group
多项选择器,内部由多个checkbox
组成。
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
bindchange | EventHandle | <checkbox-group> 中选中项发生改变时触发 change 事件,detail = {value:[选中的checkbox的value的数组]} |
checkbox
多选项目。
属性名 | 类型 | 默认值 | 说明 | 最低版本 |
---|---|---|---|---|
value | String | 标识,选中时触发的 change 事件,并携带 的 value | ||
disabled | Boolean | false | 是否禁用 | |
checked | Boolean | false | 当前是否选中,可用来设置默认选中 | |
color | Color | checkbox的颜色,同css的color | ||
aria-label | String | 无障碍访问,(属性)元素的额外描述 | 2.5.0 |
演示图片:
类似于HTML的form,将一些需要在表单中呈现的元素框起来
区别:
这里的form事件绑定方式是通过:bindsubmit
提交,和bindreset
重置
注意:
表单,将组件内的用户输入的<switch>、<input>、<checkbox>、<slider>、<radio>、<picker>
提交。
当点击<form>
表单中 form-type 为 submit 的<button>
组件时,会将表单组件中的 value 值进行提交,需要在表单组件中加上 name 来作为 key。
| |
| |
和原生基本类似,体验
| |
| |
基本和HTML差不多
用来改进表单组件的可用性,使用
for
属性找到对应的id
,或者将控件放在该标签下,当点击时,就会触发对应的控件。
for
优先级高于内部控件,内部有多个控件的时候默认触发第一个控件。目前可以绑定的控件有:[
button checkbox radio switch
属性名 | 类型 | 说明 |
---|---|---|
for | String | 绑定控件的 id |
支持滚动的选择器,类似下图这样
目前picker
支持五类选择器,普通选择器,多列选择器,时间选择器(一天内的时间),日期选择器(年月日),省市选择器
| |
| |
|
|
和picker类似
单项选择器,用法同html
滑动选择器
开关选择器
多行输入框,和html一样
通过方法调用来呈现组件(交互操作组件必须通过调用API的方式来调用)
| |
| |
另外模态框和上面用法一致….
| |
探索:实现无缝轮播怎么办?
XML
标准(例如结束标签问题要注意) | |
| |
WXS(WeiXin Script)是小程序的一套脚本语言,功能类似
<script>
标签,用于在视图层定义函数(比较少用)
| |
Copyright © 2003-2013 www.wpsshop.cn 版权所有,并保留所有权利。