page-meta

基础库 2.9.0 开始支持,低版本需做兼容处理

页面属性配置节点,用于指定页面的一些属性、监听页面事件。只能是页面内的第一个节点。可以配合 navigation-bar 组件一同使用。

通过这个节点可以获得类似于调用 wx.setBackgroundTextStyle wx.setBackgroundColor 等接口调用的效果。

属性类型默认值必填说明最低版本
background-text-stylestring下拉背景字体、loading 图的样式,仅支持 darklight2.9.0
background-colorstring窗口的背景色,必须为十六进制颜色值2.9.0
background-color-topstring顶部窗口的背景色,必须为十六进制颜色值,仅 iOS 支持2.9.0
background-color-bottomstring底部窗口的背景色,必须为十六进制颜色值,仅 iOS 支持2.9.0
root-background-colorstring页面内容的背景色,用于页面中的空白部分和页面大小变化 resize 动画期间的临时空闲区域2.12.1
scroll-topstring“”滚动位置,可以使用 px 或者 rpx 为单位,在被设置时,页面会滚动到对应位置2.9.0
scroll-durationnumber300滚动动画时长2.9.0
page-stylestring“”页面根节点样式,页面根节点是所有页面节点的祖先节点,相当于 HTML 中的 body 节点2.9.0
body-font-sizestring“”页面 page 的字体大小,可以设置为 system ,表示使用当前用户设置的微信字体大小2.11.0
root-font-sizestring“”页面的根字体大小,页面中的所有 rem 单位,将使用这个字体大小作为参考值,即 1rem 等于这个字体大小;自小程序版本 2.11.0 起,也可以设置为 system2.9.0
page-orientationstring“”页面的方向,可为 auto portraitlandscape2.12.0
bindresizeeventhandle页面尺寸变化时会触发 resize 事件, event.detail = { size: { windowWidth, windowHeight } }2.9.0
bindscrolleventhandle页面滚动时会触发 scroll 事件, event.detail = { scrollTop }2.9.0
bindscrolldoneeventhandle如果通过改变 scroll-top 属性来使页面滚动,页面滚动结束后会触发 scrolldone 事件2.9.0

示例代码

在开发者工具中预览效果

  1. <page-meta
  2. background-text-style="{{bgTextStyle}}"
  3. background-color="{{bgColor}}"
  4. background-color-top="{{bgColorTop}}"
  5. background-color-bottom="{{bgColorBottom}}"
  6. scroll-top="{{scrollTop}}"
  7. page-style="color: green"
  8. root-font-size="16px"
  9. >
  10. <navigation-bar
  11. title="{{nbTitle}}"
  12. loading="{{nbLoading}}"
  13. front-color="{{nbFrontColor}}"
  14. background-color="{{nbBackgroundColor}}"
  15. />
  16. </page-meta>
  1. Page({
  2. data: {
  3. bgTextStyle: 'dark',
  4. scrollTop: '200rpx',
  5. bgColor: '#ff0000',
  6. bgColorTop: '#00ff00',
  7. bgColorBottom: '#0000ff',
  8. nbTitle: '标题',
  9. nbLoading: false,
  10. nbFrontColor: '#000000',
  11. nbBackgroundColor: '#ffffff',
  12. },
  13. })