definePageMeta
在页面内声明元信息(布局/样式等)
definePageMeta() 用于在页面文件内声明“页面元信息”。这些元信息会参与路由注册、页面样式以及布局选择等能力。
使用位置
- 只能在路由中使用(例如
<srcDir>/pages/**/*.vue或<srcDir>/<subPackageDir>/**/*.vue) - 推荐放在页面的
<script setup>顶层
definePageMeta() 只能作用于页面文件,不能在 App.vue、布局组件等非页面文件中使用。签名
definePageMeta(meta: PageMeta): void
常用字段
下面是文档中最常用的字段。完整字段与类型以 @skiyee/oiyo/types 的定义为准。
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
type | 'page' | 'home' | page | 页面类型。home 将会被当成首页。 |
layout | string | false | default | 使用的布局名称;false 表示禁用布局。未设置时默认使用 default(前提是应用启用了布局占位符)。 |
style | PageStyle | - | 页面样式配置,遵循 uni-app 的 pages.json 字段。 |
tab | TabBar 单项配置 | - | 当前页面作为 TabBar 项时的配置;pagePath 会根据页面路径自动生成。 |