<NuxtIsland>

Nuxt 提供了 <NuxtIsland> 组件,用于渲染无任何客户端 JS 的非交互组件。

当渲染一个岛屿组件时,该岛屿组件的内容是静态的,因此不会在客户端下载任何 JS。

更改岛屿组件的 props 会触发重新获取岛屿组件以重新渲染。

应用的全局样式会随响应一起发送。
仅服务器组件在底层使用 <NuxtIsland>

Props

  • name :要渲染的组件名称。
    • 类型string
    • 必需
  • lazy:使组件非阻塞加载。
    • 类型boolean
    • 默认值false
  • props:传递给渲染组件的属性。
    • 类型Record<string, any>
  • source:调用远程资源以渲染该岛屿。
    • 类型string
  • dangerouslyLoadClientComponents:加载远程源组件时必需。
    • 类型boolean
    • 默认值false
远程岛屿需要在你的 nuxt.config 中将 experimental.componentIslands 设置为 'local+remote'。 强烈不建议启用 dangerouslyLoadClientComponents,因为无法信任远程服务器的 JavaScript。
默认情况下,组件岛屿会从 ~/components/islands/ 目录扫描。 因此,~/components/islands/MyIsland.vue 组件可以通过 <NuxtIsland name="MyIsland" /> 渲染。

Slots

如果声明了插槽,可以向岛屿组件传递插槽。

每个插槽都是交互式的,因为提供插槽的是父组件。

某些插槽为 NuxtIsland 保留,用于特殊情况。

  • #fallback:指定岛屿加载前(如果组件为懒加载)或 NuxtIsland 获取组件失败时显示的内容。

Ref

  • refresh()
    • 类型() => Promise<void>
    • 描述:通过重新获取服务端组件来强制刷新组件。

Events

  • error
    • 参数
      • error
        • 类型unknown
    • 描述:当 NuxtIsland 获取新岛屿失败时触发。