setPageLayout

setPageLayout 允许你动态更改页面的布局。

setPageLayout 允许你动态更改页面的布局。它依赖于对 Nuxt 上下文的访问，因此只能在 Nuxt 上下文中调用。 :

app/middleware/custom-layout.ts

export default defineNuxtRouteMiddleware((to) => {
  // 为你正在导航_到_的路由设置布局
  setPageLayout('other')
})

向布局传递 Props v4.3

你可以通过传入一个对象作为第二个参数来向布局传递 props：

app/middleware/admin-layout.ts

export default defineNuxtRouteMiddleware((to) => {
  setPageLayout('admin', {
    sidebar: true,
    title: 'Dashboard',
  })
})

布局随后就可以接收这些 props：

app/layouts/admin.vue

<script setup lang="ts">
const props = defineProps<{
  sidebar?: boolean
  title?: string
}>()
</script>

<template>
  <div>
    <aside v-if="sidebar">
      Sidebar
    </aside>
    <main>
      <h1>{{ title }}</h1>
      <slot />
    </main>
  </div>
</template>

如果你选择在服务端动态设置布局，你必须在布局被 Vue 渲染之前（即在插件或路由中间件中）完成，以避免 hydration 不匹配。 :