Sync #6d4e543c #1005

ikxin · 2024-09-09T16:36:49Z

Description of Problem

vuejs/docs@3ba5add...6d4e543

Bumps [vue](https://github.com/vuejs/core) from 3.5.0-beta.1 to 3.5.0-beta.2. - [Release notes](https://github.com/vuejs/core/releases) - [Changelog](https://github.com/vuejs/core/blob/main/CHANGELOG.md) - [Commits](vuejs/core@v3.5.0-beta.1...v3.5.0-beta.2) --- updated-dependencies: - dependency-name: vue dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

…2971) * chore: added a link to inheritAttrs option * fix: fixed closing tag

Bumps [vitepress](https://github.com/vuejs/vitepress) from 1.3.2 to 1.3.4. - [Release notes](https://github.com/vuejs/vitepress/releases) - [Changelog](https://github.com/vuejs/vitepress/blob/main/CHANGELOG.md) - [Commits](vuejs/vitepress@v1.3.2...v1.3.4) --- updated-dependencies: - dependency-name: vitepress dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Bumps [vue](https://github.com/vuejs/core) from 3.5.0-beta.2 to 3.5.0-rc.1. - [Release notes](https://github.com/vuejs/core/releases) - [Changelog](https://github.com/vuejs/core/blob/main/CHANGELOG.md) - [Commits](vuejs/core@v3.5.0-beta.2...v3.5.0-rc.1) --- updated-dependencies: - dependency-name: vue dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Co-authored-by: Natalia Tepluhina <[email protected]>

Update watchers.md

docs: remarks about minor version (follow up to b6339b6)

vercel · 2024-09-09T16:36:53Z

@ikxin is attempting to deploy a commit to the vuejs Team on Vercel.

A member of the Team first needs to authorize it.

ikxin · 2024-09-09T16:40:42Z

Vue 3.5 发布有一段时间了，我看到中文文档迟迟没有同步，所以我发起了这个 PR，翻译内容大部分是用了 ChatGPT，如有翻译不妥的地方还请指正，非常感谢

src/api/application.md

src/api/built-in-components.md

src/api/utility-types.md

src/guide/best-practices/performance.md

src/guide/built-ins/teleport.md

Co-authored-by: 时瑶 <[email protected]>

ikxin · 2024-09-10T02:29:00Z

@KiritaniAyaka 感谢建议

KiritaniAyaka · 2024-09-10T01:56:58Z

src/guide/components/async.md

+## 延迟水合 <sup class="vt-badge" data-text="3.5+" /> {#lazy-hydration}
+
+> 如果你正在使用[服务器端渲染](/guide/scaling-up/ssr)，这一部分才会适用。
+
+在 Vue 3.5+ 中，异步组件可以通过提供水合策略来控制何时进行水合。
+
+- Vue 提供了一些内置的水合策略。这些内置策略需要分别导入，以便在未使用时进行 tree-shaking。
+
+- 这个设计有意为之，低级别以获得灵活性。将来编译器语法糖可能可以在核心或高级别解决方案（如 Nuxt）中构建在此基础之上。
+
+### 在空闲时进行水合作用
+
+通过 `requestIdleCallback` 进行水合作用：


Suggested change

## 延迟水合 <sup class="vt-badge" data-text="3.5+" /> {#lazy-hydration}

> 如果你正在使用[服务器端渲染](/guide/scaling-up/ssr)，这一部分才会适用。

在 Vue 3.5+ 中，异步组件可以通过提供水合策略来控制何时进行水合。

- Vue 提供了一些内置的水合策略。这些内置策略需要分别导入，以便在未使用时进行 tree-shaking。

- 这个设计有意为之，低级别以获得灵活性。将来编译器语法糖可能可以在核心或高级别解决方案（如 Nuxt）中构建在此基础之上。

### 在空闲时进行水合作用

通过 `requestIdleCallback` 进行水合作用：

## 延迟激活<sup class="vt-badge" data-text="3.5+" /> {#lazy-hydration}

> 这部分仅当你正在使用[服务端渲染](/guide/scaling-up/ssr)才适用。

在 Vue 3.5+ 中，异步组件可以通过提供激活策略来控制何时进行激活。

- Vue 提供了一些内置的激活策略。这些内置策略需要分别导入，以便在未使用时进行 tree-shaking。

- 该设计有意采用低级设计以提高灵活性。未来不论是核心还是更高级的解决方案（如 Nuxt）的编译器语法糖将可能在此基础上构建。

### 空闲时激活

通过 `requestIdleCallback` 激活：

src/guide/components/async.md

KiritaniAyaka · 2024-09-10T02:00:02Z

src/guide/components/async.md

+### 在可见时水合
+
+当元素通过 `IntersectionObserver` 变为可见时进行水合。


Suggested change

### 在可见时水合

当元素通过 `IntersectionObserver` 变为可见时进行水合。

### 可见时激活

借助 `IntersectionObserver`，当元素可见时激活。

KiritaniAyaka · 2024-09-10T02:05:28Z

src/guide/components/async.md

+### 在媒体查询匹配时进行水合作用
+
+当指定的媒体查询匹配时进行水合作用。


Suggested change

### 在媒体查询匹配时进行水合作用

当指定的媒体查询匹配时进行水合作用。

### 媒体查询匹配时激活

当指定的媒体查询匹配时激活。

KiritaniAyaka · 2024-09-10T02:07:24Z

src/guide/components/async.md

+### 交互时水合
+
+当组件元素上触发指定事件时进行水合。完成水合后，触发水合的事件也将被重新播放。


Suggested change

### 交互时水合

当组件元素上触发指定事件时进行水合。完成水合后，触发水合的事件也将被重新播放。

### 交互时激活

当组件元素上触发指定事件时激活。触发激活的事件将在完毕后重放。

src/guide/essentials/watchers.md

KiritaniAyaka · 2024-09-10T03:16:25Z

src/guide/essentials/watchers.md

+    id(newId, oldId, onCleanup) {
+      // ...
+      onCleanup(() => {
+        // cleanup logic


Suggested change

// cleanup logic

// 清理逻辑

src/guide/essentials/watchers.md

.vitepress/config.ts

src/api/application.md

src/guide/typescript/composition-api.md

Justineo · 2024-09-10T03:44:16Z

src/guide/typescript/composition-api.md

@@ -360,6 +371,17 @@ const foo = inject('foo') as string

 ## 为模板引用标注类型 {#typing-template-refs}

+使用 Vue 3.5 和 `@vue/language-tools` 2.1（为 IDE 语言服务和 `vue-tsc` 提供支持），在单文件组件中，`useTemplateRef()` 创建的 ref 类型可以根据匹配的 `ref` 属性使用的元素**自动推断**为静态 ref。 
+
+在无法进行自动推断的情况下，仍然可以通过通用参数将模板 ref 转换为显式类型。


Suggested change

在无法进行自动推断的情况下，仍然可以通过通用参数将模板 ref 转换为显式类型。

在无法自动推断的情况下 (如非 SFC 使用或动态组件)，仍然可以通过泛型参数将模板 ref 强制转换为显式类型。

Justineo · 2024-09-10T03:44:49Z

src/guide/typescript/composition-api.md

-```
-
-为了获取 `MyModal` 的类型，我们首先需要通过 `typeof` 得到其类型，再使用 TypeScript 内置的 `InstanceType` 工具类型来获取其实例类型：
+为了获取导入组件的实例类型，我们需要先通过 `typeof` 获取其类型，然后使用 TypeScript 的内置 `InstanceType` 实用程序提取其实例类型：


Suggested change

为了获取导入组件的实例类型，我们需要先通过 `typeof` 获取其类型，然后使用 TypeScript 的内置 `InstanceType` 实用程序提取其实例类型：

为了获取导入组件的实例类型，我们需要先通过 `typeof` 获取其类型，然后使用 TypeScript 的内置 `InstanceType` 工具类型提取其实例类型：

src/guide/typescript/composition-api.md

src/api/built-in-components.md

src/api/built-in-directives.md

src/guide/components/async.md

Co-authored-by: 时瑶 <[email protected]>

src/api/composition-api-helpers.md

src/api/custom-elements.md

Co-authored-by: 时瑶 <[email protected]>

src/guide/components/props.md

dependabot bot and others added 30 commits August 20, 2024 13:34

Added a link explaining how to use inheritAttrs in normal <script> (#…

9a4c812

…2971) * chore: added a link to inheritAttrs option * fix: fixed closing tag

docs: update defcc latest information (#2979)

44fc18f

Update Yiling's personal information (#2983)

059bdf2

chore: update devtools info to point to new version

c8d996e

fix: update links to Vue Loader docs (#2988)

253615a

3.5: failSilently for onScopeDispose

290f997

3.5: reactive props destructure

ad9a9c5

3.5: watcher side effect cleanup + WatchHandle pause / resume

66a8ced

3.5: watch deep support number

cd4b2e1

3.5: useId and app.config.idPrefix

b9ed0eb

3.5: lazy hydration

e1a923e

3.5: data-allow-mismatch

9bc11b2

3.5: add composition api helpers page

e3d9fc6

useAttrs, useSlots, useModel

9d52084

3.5: useTemplateRef()

71cec81

app.config.throwUnhandledErrorInProduction

3c4ecd8

remove version badages for previous minors

b6339b6

3.5: deferred teleport

444c780

3.5: custom elements

83a0cf1

3.5: props destructure extras

b9c86c0

fix dead link

e565332

Update src/api/application.md

60cebdc

Co-authored-by: Natalia Tepluhina <[email protected]>

bump vue to 3.5

2584dd1

fix(typo): watch guide typo (#2989)

bfcf01f

Update watchers.md

docs: remarks about minor versions (#2990)

7f55589

docs: remarks about minor version (follow up to b6339b6)

feat(*): add vuetoronto banner (#2992)

6d4e543

docs: sync upstream translate

d044079

KiritaniAyaka suggested changes Sep 10, 2024

View reviewed changes

Apply suggestions from code review

07b415c

Co-authored-by: 时瑶 <[email protected]>

KiritaniAyaka suggested changes Sep 10, 2024

View reviewed changes

Justineo requested changes Sep 10, 2024

View reviewed changes