setPageLayout

源文件
setPageLayout 允许你动态更改页面的布局。
setPageLayout 允许你动态更改页面的布局。它依赖于对 Nuxt 上下文(context)的访问,因此只能在 Nuxt 上下文 中调用。
app/middleware/custom-layout.ts
export default defineNuxtRouteMiddleware((to) => {
  // Set the layout on the route you are navigating _to_
  setPageLayout('other')
})

向布局传递 Props

你可以通过将一个对象作为第二个参数传入,从而向布局传递 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 不匹配的问题。