PageMeta

页面属性配置节点，用于指定页面的一些属性、监听页面事件。只能是页面内的第一个节点。可以配合 navigation-bar 组件一同使用。 通过这个节点可以获得类似于调用 Taro.setBackgroundTextStyle Taro.setBackgroundColor 等接口调用的效果。

参考文档

类型

ComponentType<PageMetaProps>

PageMetaProps

参数	类型	默认值	必填	说明
backgroundTextStyle	string		否	下拉背景字体、loading 图的样式，仅支持 dark 和 light
backgroundColor	string		否	窗口的背景色，必须为十六进制颜色值
backgroundColorTop	string		否	顶部窗口的背景色，必须为十六进制颜色值，仅 iOS 支持
backgroundColorBottom	string		否	底部窗口的背景色，必须为十六进制颜色值，仅 iOS 支持
scrollTop	string	""	否	滚动位置，可以使用 px 或者 rpx 为单位，在被设置时，页面会滚动到对应位置
scrollDuration	number	300	否	滚动动画时长
pageStyle	string	""	否	页面根节点样式，页面根节点是所有页面节点的祖先节点，相当于 HTML 中的 body 节点
rootFontSize	string	""	否	页面的根字体大小，页面中的所有 rem 单位，将使用这个字体大小作为参考值，即 1rem 等于这个字体大小
onResize	BaseEventOrigFunction<onResizeEventDetail>		否	页面尺寸变化时会触发 resize 事件，event.detail = { size: { windowWidth, windowHeight } }
onScroll	BaseEventOrigFunction<onScrollEventDetail>		否	页面滚动时会触发 scroll 事件，event.detail = { scrollTop }
onScrollDone	BaseEventOrigFunction<any>		否	如果通过改变 scroll-top 属性来使页面滚动，页面滚动结束后会触发 scrolldone 事件

API 支持度

API	微信小程序	H5	React Native
PageMetaProps.backgroundTextStyle	✔️
PageMetaProps.backgroundColor	✔️
PageMetaProps.backgroundColorTop	✔️
PageMetaProps.backgroundColorBottom	✔️
PageMetaProps.scrollTop	✔️
PageMetaProps.scrollDuration	✔️
PageMetaProps.pageStyle	✔️
PageMetaProps.rootFontSize	✔️
PageMetaProps.onResize	✔️
PageMetaProps.onScroll	✔️
PageMetaProps.onScrollDone	✔️

onResizeEventDetail

参数	类型	说明
size	resizeType	窗口尺寸

resizeType

窗口尺寸类型

参数	类型	说明
windowWidth	number	窗口宽度
windowHeight	number	窗口高度

onScrollEventDetail

参数	类型
scrollTop	number

API 支持度

API	微信小程序	H5	React Native
PageMeta	✔️