小程序界面

477 阅读3分钟

开启掘金成长之旅!这是我参与「掘金日新计划 · 12 月更文挑战」的第5天,点击查看活动详情

交互

wx.showToast

显示消息提示框

image.png 代码示例:

image.png

image.png

image.png

wx.showModal

显示模态对话框

image.png

image.png
示例代码:

image.png

image.png

image.png

image.png

wx.showLoading

显示loading提示框。需要主动调用wx.hideLoading才能关闭提示框

image.png
示例代码:

image.png

image.png

wx.showActionSheet

显示操作菜单

image.png

image.png
代码示例:

image.png
效果:

image.png
console的结果

image.png

wx.showToast

隐藏消息提示框

image.png

wx.hideLoading(Object object)

隐藏 loading 提示框

image.png

wx.enableAlertBeforeUnload(Object object)

开启小程序页面返回询问对话框

弹窗条件
  • 当用户在小程序内非首页页面/最底层页
  • 官方导航栏上的的返回
  • 全屏模式下自绘返回键
  • android 系统 back 键时

注意事项

  • 手势滑动返回时不做拦截
  • 在任何场景下,此功能都不应拦住用户退出小程序的行为 image.png
    代码示例:

image.png 效果:

image.png

wx.disableAlertBeforeUnload(Object object)

关闭小程序页面返回询问对话框

image.png

导航栏

wx.showNavigationBarLoading

在当前页面显示导航条加载动画

image.png

wx.setNavigationBarTitle(Object object)

动态设置当前页面的标题

image.png
代码设置

image.png

wx.setNavigationBarColor(Object object)

设置页面导航条颜色

image.png

image.png
代码示例:

image.png

# wx.hideNavigationBarLoading(Object object)

在当前页面隐藏导航条加载动画

image.png

wx.hideHomeButton(Object object)

隐藏返回首页按钮。微信7.0.7版本起,当用户打开的小程序最底层页面是非首页时,默认展示“返回首页”按钮,开发者可在页面 onShow 中调用 hideHomeButton 进行隐藏

image.png

背景

wx.setBackgroundTextStyle(Object object)

动态设置下拉背景字体、loading 图的样式

image.png
代码示例:

image.png

wx.setBackgroundColor(Object object)

动态设置窗口的背景色

image.png
示例代码:

image.png

tabbar

wx.showTabBarRedDot(Object object)

显示 tabBar 某一项的右上角的红点

image.png

wx.showTabBar(Object object

显示 tabBar

image.png

wx.setTabBarStyle(Object object)

动态设置 tabBar 的整体样式

image.png
示例代码:

image.png

wx.setTabBarItem(Object object)

动态设置 tabBar 某一项的内容,2.7.0 起图片支持临时文件和网络文件

image.png
示例代码:

image.png

wx.setTabBarBadge(Object object)

为 tabBar 某一项的右上角添加文本

image.png
示例代码:

image.png

wx.removeTabBarBadge(Object object)

移除 tabBar 某一项右上角的文本

image.png

wx.hideTabBarRedDot(Object object

隐藏 tabBar 某一项的右上角的红点

image.png

wx.hideTabBar(Object object)

隐藏 tabBar

image.png

字体

# wx.loadFontFace(Object object)

动态加载网络字体,文件地址需为下载类型。2.10.0起支持全局生效,需在 app.js 中调用
注意:

  1. 字体文件返回的 contet-type 参考 font,格式不正确时会解析失败。
  2. 字体链接必须是https(ios不支持http)
  3. 字体链接必须是同源下的,或开启了 cors 支持,小程序的域名是servicewechat.com
  4. 工具里提示 Faild to load font可以忽略
  5. ['2.10.0'] 以前仅在调用页面生效

image.png

image.png

image.png

image.png
示例代码:

image.png

下拉刷新

wx.stopPullDownRefresh(Object object)

停止当前页面下拉刷新

image.png
示例代码:

image.png

wx.startPullDownRefresh(Object object)

开始下拉刷新。调用后触发下拉刷新动画,效果与用户手动下拉刷新一致

image.png
示例代码:

image.png

滚动

wx.pageScrollTo(Object object)

将页面滚动到目标位置,支持选择器和滚动距离两种方式定位

image.png

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

image.png

ScrollViewContext

增强 ScrollView 实例,可通过 [wx.createSelectorQuery] 的 [NodesRef.node] 方法获取。 仅在 scroll-view 组件开启 enhanced 属性后生效

image.png

image.png

image.png

ScrollViewContext.scrollIntoView(string selector)

滚动至指定位置

ScrollViewContext.scrollTo(Object object)

滚动至指定位置

image.png

动画

[Animation] wx.createAnimation(Object object)

创建一个动画实例 [animation]调用实例的方法来描述动画。最后通过动画实例的 export 方法导出动画数据传递给组件的 animation 属性、

image.png

返回值

Animation