# page-meta
页面元数据，用于设置页面的一些属性，如背景色、下拉刷新等
# 兼容性 ?
| Web | 微信小程序 | Android | iOS | HarmonyOS |
|---|---|---|---|---|
| x | 4.41 | x | x | x |
# 属性
| 名称 | 类型 | 兼容性 | 描述 |
|---|---|---|---|
| background-text-style | string | 下拉背景字体、loading 图的样式，仅支持 dark 和 light | |
| background-color | string | 窗口的背景色，必须为十六进制颜色值 | |
| background-color-top | string | 顶部窗口的背景色，必须为十六进制颜色值，仅 iOS(uni-app) 支持 | |
| background-color-bottom | string | 底部窗口的背景色，必须为十六进制颜色值，仅 iOS(uni-app) 支持 | |
| scroll-top | string | 滚动位置，可以使用 px 或者 rpx 为单位，在被设置时，页面会滚动到对应位置（WebView 特有属性） | |
| scroll-duration | number | 滚动动画时长（WebView 特有属性） | |
| page-style | string | 页面根节点样式，页面根节点是所有页面节点的祖先节点，相当于 HTML 中的 body 节点 | |
| root-font-size | string | 页面的根字体大小，页面中的所有 rem 单位，将使用这个字体大小作为参考值，即 1rem 等于这个字体大小 | |
| root-background-color | string | (string) 页面内容的背景色，用于页面中的空白部分和页面大小变化 resize 动画期间的临时空闲区域 | |
| page-font-size | string | (string) 页面 page 的字体大小，可以设置为 system ，表示使用当前用户设置的微信字体大小 | |
| page-orientation | string | (string) 页面的方向，可为 auto portrait 或 landscape | |
| @resize | (event: UniEvent) => void | 页面尺寸变化时会触发 resize 事件， event.detail = { size: { windowWidth, windowHeight } } | |
| @scroll | (event: UniEvent) => void | 页面滚动时会触发 scroll 事件， event.detail = { scrollTop }（WebView 特有属性） | |
| @scrolldone | (event: UniEvent) => void | 如果通过改变 scroll-top 属性来使页面滚动，页面滚动结束后会触发 scrolldone 事件（WebView 特有属性） |
# 示例
示例为hello uni-app x alpha分支，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例另见
该 API 不支持 Web，请运行 hello uni-app x 到 App 平台体验
<template>
<page-meta
:background-text-style="data.bgTextStyle"
:background-color="data.bgColor"
:background-color-top="data.bgColorTop"
:background-color-bottom="data.bgColorBottom"
:scroll-top="data.scrollTop"
:scroll-duration="2000"
@scroll="scroll"
@scrolldone="scrolldone"
page-style="color: green"
root-font-size="30px"
>
<navigation-bar
:title="data.nbTitle"
:loading="data.nbLoading"
:front-color="data.nbFrontColor"
:background-color="data.nbBackgroundColor"
/>
</page-meta>
<view class="content">
<page-intro content="本页演示 page-meta 与 navigation-bar：配置页面背景色、滚动、导航栏标题与样式，通过按钮触发滚动到指定位置并监听 scroll 与 scrolldone。"></page-intro>
<text class="title">页面内容</text>
<button @click="scrollTo">点击跳到 300px 处</button>
<view class="uni-list" v-for="(_, index) in 30" :key="index">
<view class="uni-list-cell">{{ index }}</view>
</view>
</view>
</template>
<script setup lang="uts">
type DataType = {
bgTextStyle: string,
scrollTop: string,
bgColor: string,
bgColorTop: string,
bgColorBottom: string,
nbTitle: string,
nbLoading: boolean,
nbFrontColor: string,
nbBackgroundColor: string,
scrollType: string | null,
scrolldoneType: string | null,
}
// 使用reactive避免ref数据在自动化测试中无法访问
const data = reactive({
bgTextStyle: 'dark',
scrollTop: '0px',
bgColor: '#ff0000',
bgColorTop: '#00ff00',
bgColorBottom: '#0000ff',
nbTitle: '标题',
nbLoading: false,
nbFrontColor: '#ffffff',
nbBackgroundColor: '#00aaff',
scrollType: null as string | null,
scrolldoneType: null as string | null,
} as DataType)
// Methods
function scrollTo() {
data.scrollTop = '300px'
}
function scroll(e : any) {
data.scrollType = e.type
}
function scrolldone(e : any) {
data.scrolldoneType = e.type
}
// Lifecycle
onLoad(() => {
setTimeout(() => {
data.nbLoading = true
}, 2000)
})
defineExpose({
data
})
</script>
