发布·  

Nuxt 3.13

Nuxt 3.13 发布了——移植了我们为 Nuxt 4 构建的一些新功能!
Daniel Roe

Daniel Roe

@danielroe.dev

🏘️ 路由组

我们现在支持使用括号来命名目录,以组织您的路由,而不会影响路径。

例如

目录结构
-| pages/
---| index.vue
---| (marketing)/
-----| about.vue
-----| contact.vue

这将在你的应用中生成 //about/contact 页面。 marketing 组在 URL 结构中会被忽略。

阅读更多内容原始 PR.

🏝️ Islands 和 Head 元数据

现在,服务器组件 islands 可以在渲染时操作 head,例如添加 SEO 元数据。

阅读更多内容#27987.

🪝 自定义预取触发器

我们现在支持 NuxtLink 的自定义预取触发器(#27846).

例如

pages/index.vue
<template>
  <div>
    <NuxtLink prefetch-on="interaction">
      This will prefetch when hovered or when it gains focus
    </NuxtLink>
    <!-- note that you probably don't want both enabled! -->
    <NuxtLink :prefetch-on="{ visibility: true, interaction: true }">
      This will prefetch when hovered/focus - or when it becomes visible
    </NuxtLink>
  </div>
</template>

还可以为您的应用程序全局启用/禁用这些功能,并按链接覆盖它们。

例如

nuxt.config.ts
export default defineNuxtConfig({
  experimental: {
    defaults: {
      nuxtLink: {
        prefetch: true,
        prefetchOn: { visibility: false, interaction: true }
      }
    }
  }
})

🗺️ 更好的服务器源映射

当使用 node --enable-source-maps 运行时,您可能已经注意到服务器构建中 Vue 文件的源映射指向 Vite 构建输出(例如 .nuxt/dist/server/_nuxt/index-O15BBwZ3.js)。

现在,即使在 Nitro 构建之后,您的服务器源映射仍将引用您的原始源文件(#28521).

请注意,提高构建性能的最简单方法之一是如果您不使用源映射,则将其关闭,您可以在 nuxt.config.ts 中轻松完成此操作

nuxt.config.ts
export default defineNuxtConfig({
  sourcemap: {
    server: false,
    client: true,
  },
})

🎁 模块作者的新功能

在 Nuxt v4 发布之前,我们正在努力为模块作者添加一些关键功能,包括在需要时新的 isNuxtMajorVersion 工具(#27579)以及使用新的 defineNuxtModule().with() 方法更好地推断合并模块选项的类型(#27520).

✨ 改进的开发警告

我们不再在中间件中使用数据获取可组合项时发出警告(#28604)并且当用户组件的名称以 Lazy 开头时发出警告(#27838).

🚨 Vue TypeScript 更改

一段时间以来,在 Vue 生态系统中,我们一直在增强 @vue/runtime-core 以向 vue 添加自定义属性等。然而,这无意中破坏了增强 vue 的项目的类型——这现在是官方推荐和记录的增强这些接口的方式(例如,ComponentCustomProperties, GlobalComponents等等等等).

这意味着 所有 库都必须更新其代码(否则它将破坏增强 vue 的库的类型)。

我们已经根据这些原则更新了 Nuxt 中的类型,但当与尚未这样做的库一起使用时,您可能会遇到最新 vue-router 的问题。

请创建一个带有重现的问题——我很乐意帮助创建一个 PR 来解决相关上游库中的问题。或者您可以通过在项目根目录中创建一个 declarations.d.ts 并包含以下代码来解决问题(致谢@BobbieGoede@BobbieGoede):

declarations.d.ts
import type {
  ComponentCustomOptions as _ComponentCustomOptions,
  ComponentCustomProperties as _ComponentCustomProperties,
} from 'vue';

declare module '@vue/runtime-core' {
  interface ComponentCustomProperties extends _ComponentCustomProperties {}
  interface ComponentCustomOptions extends _ComponentCustomOptions {}
}

✅ 升级

像往常一样,我们建议您运行以下命令进行升级

npx nuxi@latest upgrade --force

这也将刷新你的 lockfile,并确保你拉取 Nuxt 依赖的其他依赖项(尤其是在 unjs 生态系统中)的更新。

完整发布说明

阅读 Nuxt v3.13.0 的完整发行说明。

衷心感谢所有参与此版本的人——是你们让 Nuxt 成为可能。❤️

如果你有任何反馈或问题,请随时告诉我们!🙏