开启掘金成长之旅!这是我参与「掘金日新计划 · 12 月更文挑战」的第5天,点击查看活动详情
交互
wx.showToast
显示消息提示框
代码示例:
wx.showModal
显示模态对话框
示例代码:
wx.showLoading
显示loading提示框。需要主动调用wx.hideLoading才能关闭提示框
示例代码:
wx.showActionSheet
显示操作菜单
代码示例:
效果:
console的结果
wx.showToast
隐藏消息提示框
wx.hideLoading(Object object)
隐藏 loading 提示框
wx.enableAlertBeforeUnload(Object object)
开启小程序页面返回询问对话框
弹窗条件
- 当用户在小程序内非首页页面/最底层页
- 官方导航栏上的的返回
- 全屏模式下自绘返回键
- android 系统 back 键时
注意事项
- 手势滑动返回时不做拦截
- 在任何场景下,此功能都不应拦住用户退出小程序的行为
代码示例:
效果:
wx.disableAlertBeforeUnload(Object object)
关闭小程序页面返回询问对话框
导航栏
wx.showNavigationBarLoading
在当前页面显示导航条加载动画
wx.setNavigationBarTitle(Object object)
动态设置当前页面的标题
代码设置
wx.setNavigationBarColor(Object object)
设置页面导航条颜色
代码示例:
# wx.hideNavigationBarLoading(Object object)
在当前页面隐藏导航条加载动画
wx.hideHomeButton(Object object)
隐藏返回首页按钮。微信7.0.7版本起,当用户打开的小程序最底层页面是非首页时,默认展示“返回首页”按钮,开发者可在页面 onShow 中调用 hideHomeButton 进行隐藏
背景
wx.setBackgroundTextStyle(Object object)
动态设置下拉背景字体、loading 图的样式
代码示例:
wx.setBackgroundColor(Object object)
动态设置窗口的背景色
示例代码:
tabbar
wx.showTabBarRedDot(Object object)
显示 tabBar 某一项的右上角的红点
wx.showTabBar(Object object
显示 tabBar
wx.setTabBarStyle(Object object)
动态设置 tabBar 的整体样式
示例代码:
wx.setTabBarItem(Object object)
动态设置 tabBar 某一项的内容,2.7.0 起图片支持临时文件和网络文件
示例代码:
wx.setTabBarBadge(Object object)
为 tabBar 某一项的右上角添加文本
示例代码:
wx.removeTabBarBadge(Object object)
移除 tabBar 某一项右上角的文本
wx.hideTabBarRedDot(Object object
隐藏 tabBar 某一项的右上角的红点
wx.hideTabBar(Object object)
隐藏 tabBar
字体
# wx.loadFontFace(Object object)
动态加载网络字体,文件地址需为下载类型。2.10.0起支持全局生效,需在 app.js 中调用
注意:
- 字体文件返回的 contet-type 参考 font,格式不正确时会解析失败。
- 字体链接必须是https(ios不支持http)
- 字体链接必须是同源下的,或开启了 cors 支持,小程序的域名是
servicewechat.com - 工具里提示 Faild to load font可以忽略
- ['2.10.0'] 以前仅在调用页面生效
示例代码:
下拉刷新
wx.stopPullDownRefresh(Object object)
停止当前页面下拉刷新
示例代码:
wx.startPullDownRefresh(Object object)
开始下拉刷新。调用后触发下拉刷新动画,效果与用户手动下拉刷新一致
示例代码:
滚动
wx.pageScrollTo(Object object)
将页面滚动到目标位置,支持选择器和滚动距离两种方式定位
selector 语法
selector类似于 CSS 的选择器,但仅支持下列语法。
- ID选择器:#the-id
- class选择器(可以连续指定多个):.a-class.another-class
- 子元素选择器:.the-parent > .the-child
- 后代选择器:.the-ancestor .the-descendant
- 跨自定义组件的后代选择器:.the-ancestor >>> .the-descendant
- 多选择器的并集:#a-node, .some-other-nodes
ScrollViewContext
增强 ScrollView 实例,可通过 [wx.createSelectorQuery] 的 [NodesRef.node] 方法获取。 仅在 scroll-view 组件开启 enhanced 属性后生效
ScrollViewContext.scrollIntoView(string selector)
滚动至指定位置
ScrollViewContext.scrollTo(Object object)
滚动至指定位置
动画
[Animation] wx.createAnimation(Object object)
创建一个动画实例 [animation]调用实例的方法来描述动画。最后通过动画实例的 export 方法导出动画数据传递给组件的 animation 属性、
返回值
Animation