小程序UI界面之导航组件、媒体组件、地图组件、画布组件详解
小程序组件构建UI界面(3
Part 1导航组件
小程序可以在页面中设置导航,可以使用navigator页面链接组件,也可以在js文件里设置导航进行页面跳转,同时可以设置导航条标题和显示效果。
1.1navigator页面链接组件
navigator页面链接组件用来在wxml页面实现跳转,它有3种类型:
1)保留当前页跳转、跳转后可以返回当前页,它与wx.navigateTo调整效果是一样的
2)关闭当前页跳转,无法返回当前页,它与wx.redirectTo跳转效果是一样的
3)跳转到底部标签导航指定的页面,它与wx.switchTab跳转效果是一样的
表3J8时tor页面链接组件的属性
属性
类型
默认值
Uli
String
应用内的跳转链接
redirect
Boolean
Else
打开方式为页囹垂定向.对应wRicdircctTo(将被度奔,推荐使用opcnfpc)
o-pcn-typc
Sttint
可选值Rredirect"^switchTab"『对应于
wx.navigalcTowx.ncdimctTckwx.wwitchTiih的功能
hover-class,
String
navigator-htivcT
指定单击时的样式类,?Mhovcr-class=Hnonc!,时,没有单击态效果
hoverslart-time
NumbcF
so
按住后多久出睨单击态,单位为墓秒
hgvcr-stay-lim^
导航页源码
Number
6Q0
手指松开后单击态的保留时间.单位为毫秒
1.2wx.navigateTo保留当前页跳转
表3,19nawigateTcs的属(性
属性
类型
必填
说明
:
url
String
需要跳转的应用内非t讣4ir的页面的躇芹,痛迳后可以带参数:参数与路怪之间使用分隔,参数健与参数值用,"相逐,不同参数之间用分隔t|ialh?key=value&key2=va]uc2B,
success
Function
接口调用成功的回调函数
FuHetinn
接口调用失败的回调函数
complete
Function
接口调用结束做回调的散〔调用成功、失败都笳执行)
1.3保留当前页跳转
表工di「里ctT。的属性
类型
必填
期明
ml
String
需要跳转的府国内非㈤汨酎的页面的路部.招辞后可以带参数。参数与躇径之间停用"7"分隔,参数便与参数值用相连,不同参数之间」耳'A1分隔,如"pat]i?key-valuC[5Lkcy2=\'a]Ljc2"
success
Funct3oi]i
接口调用成功的回调函数
fail
Funcduni
接口调用失败的回调函数
compleli:
Funclion
接口调用结束的回调函数(调用成功、失败都会执行)
1.4跳转到tabBar页面
wx.switchTab跳转至UtabBar页面,并关闭其他所有非tabBar页面。
表3.21wk"itchTmb的属性
必填
说明
url
String
‘‘
需^跳转的tabBar页面的踽径(需在.-Xpp.jsun的labBar字段定义的页面),路警后不能带参数
SUCCESS
Function
接口调用成功的回调函数
「ail
Function
搂口调用失败的回调函数
complete
Function
接口调用结束的向调函数(调用成功、失败都会执行)
1.5wx.navigateBack返回上一页
wx.navigateBack关闭当前页面,返回上一页或多级页面。可以通过getCurrentPages(获取当前的页面栈,决定需要返回几层。
表3,22胜,n君yifiatsRack的属性
属性
类型
必填
说明
delta
Numtn?T
1
返回的面散!如果加临大于现有页面数1则返回到首页
1.6wx.setNavigationBarTitle(OBJECT)设置导航条
wx.setNavigationBarTitle(OBJECT动态设置当前页面的标题。
^3.23wm.占etNavi即it3的属性
属性
类型
必堪
说明
title
String
页面标题
皿JiWt监
Funclioii
接口调用成功的回调函数
Jail
Function
接口调用失败的回调函数
complete
Function
接口调用结束的回调函数t调用成功、失败都会执行)
Part 2媒体组件
2.1audio音频
audio音频组件需要有唯一的id,根据id使用wx.createAudioContext('myAudio')创建音频播放的环境,src属性是音频播放的资源路径,poster属性是音频的播放图片,name属性为音频名称,绑定播放、暂停播等事件。
表3,24自比2音频的属性
产.同性
类型1
默以值
说明
id
String
vider组件的唯一标识符
--Ik
String
要播放音频的资源地址
loop
Boolean
false
是否循环播放
canuuls
BooJeaii
Ciuc
是否显示歌认控件
pester
String
恭认控件上的音频封面的图片资源地址如果性值为false则设胃poster无效
name
String
未知音频
熟认拴件上的音板名字.如果luhItoN属性僚为fake则设置name无效
author
Siring
未知作者
默认料件上的作者名字,如果rontruls属性值为false则设满author无效
binderror
EvcntHnndle
当发牛错漫时触发error事件,detail=|crrMs^:
McdiaEironcodic}
bindplny
FventHandk
当开蛤/■继续福放时触,发口值¥事件
bindpuuse
EvculHandlE
当替停播放时触发pause事件
bindiimeupdaile
EveiitHandle
当播放进度改变时触发tifficupdaie事件,detail=
-currentJimc.durau^n;
bind6Hded
Eveiiiihndlc
当播放到束尾只触发ended事件
表3.25错误码
错误码
说明
MEDIAERRABORTED
获取流源被用户禁止
MEDIAERRNBBVORD
网络错误
MED1AERRDECODP
解码错误
MiDlA_Ekk_SRC_NOT_SLPI<iKRrFb
J不合适资源
2.2image图片
image图片组件有两类展现模式:
一类是缩放模式,在缩放模式里包括4种方式;一类是裁剪模式,在剪裁模式里包括9种方式
表I26image图片的属性
属性
类型
默认值
说明
5FC
1
StrinE
图片资源地址
mode
Slrinfi
s^leToriir
图片新英、缩放的模式
binderrer
HandleEvciil
当错误发生时勺发布到AppSuvicc的事件名,事件对象cvcnl.Lkiail={urrMig;\omelhingwro阴'}
bindload
HandleEvent
当图片载入完毕时,发布到AppServiH的事件名事件对象以恒1.加面1-1h(?ij0tq图片高度px:width/图计宽度M1|
通过旧力盘属性来设置4种缩放模式,如表3,打斫小
表3.274种缩放模式
模式
不保持辕横比储放图片,使图片的宽高完全拉伸至填满加前型元素
保持纵横比瑞旗圈片T使图片的长边能亮全显示出来。也就是说,可以兜按地将朝片显示出来
I保持纵横匕缩放图片,艮保证图片的短边能完仝显示出来口也就是说,图片通常只在水平或垂音方向是完整的,另一个方向将会发生戳取
通过mock属性来设置9稗裁翦摸式.如表3N8所示.
表3一289种裁剪模式
模式
说明
top
不缩放图片只显示图片的顶部区域
bottoni
不缩放图片,只显示图片的底部区域
center
不缩放图片,只显示图片的中间区域
left
不能放图片,只显示图片的左边区域
right
不缩放图片,只显示图片的右边区域
topleft
不缩放图片,只显示图片的左上边区域
lopright
不缩放图片,只显示图片的古上边区域
hottornleft
不缩放图片,只显示图片的左下边区域
bottomright
不需放图片只显示图片的右下边区域
2.3video视频
video视频组件是用来播放视频的组件,这个组件可以控制是否显示默认播放控件(播放/暂停按钮、播放进度、时间),还可以发送弹幕信息等,video组件默认宽度为300Px、高度为225Px,设置宽高需要通过wxss设置widthheight
表3."Yickc■视频的属性
雇性
类型
疗认值
谢明
src
String
要播放视频的资源地址
controls
Boolean
true
星否显示默认福第控件,播放,'笆停按钮、播放法度、时间:
Object
Array
弹幕到来
dainmu-btn
Boolean
false
是否显示弹幕按钮,只在初始化时有效,不能动态变更
cn^bk-dariiTLU
Boulean
自Ise
是否展示押幕.只在初始化时有效,不能动态变更
MLilophy
Boolean
false
是否自过播故
bindplay
EventHandlE
当开始,继续播放时触发pl个事件
bindpaii^e
EvcniHandle
当暂停播放时触发pau髭事件
binden出d
EventHandk
播放至1末尾时触发end前事件
biiidhmcupdate
EventndIt
播放进度变化时聃发,cvenrdetat]--:currentTime:'当前播放时间'}由触发频率应该在25mls/次
objectFit
Siring
contain
当视频大小与video容第大小不一致时视频的表现形式ciiiiuiiit包含fill填充,cover覆盖
2.4camera相机
camera相机组件在使用的时候需要用户授权scope.camera,它是由客户端创建的原生组件,它的层级是最高的,不能通过z-index控制层级,可使用cover-viewcover-image覆盖在上面,同一页面只能插入一个camera组件,不能在scroll-viewswiperpicker-viewmovabel-view中使用camera组件。
camera相机组件属性
device
String
Back
前置或后置,值为frontback
flash
String
Auto
闪光灯,值为autoonoff
bindstop
EvenHandle
摄像灯在非正常终止时触发,如退出后台等情况
binderror
EvenHandle
用户不允许使用摄像头时触发

版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。