docs(zh): sync update to 35a9c1b (#2084)

Author: Jinjiang

packages/docs/.vitepress/config/zh.ts

@@ -48,6 +48,10 @@ export const zhConfig: LocaleSpecificConfig<DefaultTheme.Config> = {
             text: '更新日志',
             link: 'https://github.com/vuejs/router/blob/main/packages/router/CHANGELOG.md',
           },
+          {
+            text: 'Vue.js 认证',
+            link: 'https://certification.vuejs.org/?friend=VUEROUTER',
+          },
         ],
       },
     ],
@@ -139,6 +143,10 @@ export const zhConfig: LocaleSpecificConfig<DefaultTheme.Config> = {
               text: '组合式 API',
               link: '/zh/guide/advanced/composition-api.html',
             },
+            {
+              text: 'RouterView 插槽',
+              link: '/guide/advanced/router-view-slot.html',
+            },
             {
               text: '过渡动效',
               link: '/zh/guide/advanced/transitions.html',

packages/docs/.vitepress/translation-status.json

@@ -1,6 +1,6 @@
 {
   "zh": {
-    "hash": "1a3a28f",
-    "date": "2023-04-08"
+    "hash": "35a9c1b",
+    "date": "2023-12-16"
   }
-}
+}

packages/docs/zh/api/index.md

@@ -20,37 +20,43 @@ API 文档
 - [RouteLocationNormalizedLoaded](interfaces/RouteLocationNormalizedLoaded.md)
 - [RouteLocationOptions](interfaces/RouteLocationOptions.md)
 - [RouteMeta](interfaces/RouteMeta.md)
+- [RouteRecordMultipleViews](interfaces/RouteRecordMultipleViews.md)
+- [RouteRecordMultipleViewsWithChildren](interfaces/RouteRecordMultipleViewsWithChildren.md)
 - [RouteRecordNormalized](interfaces/RouteRecordNormalized.md)
+- [RouteRecordRedirect](interfaces/RouteRecordRedirect.md)
+- [RouteRecordSingleView](interfaces/RouteRecordSingleView.md)
+- [RouteRecordSingleViewWithChildren](interfaces/RouteRecordSingleViewWithChildren.md)
 - [Router](interfaces/Router.md)
 - [RouterHistory](interfaces/RouterHistory.md)
 - [RouterLinkProps](interfaces/RouterLinkProps.md)
 - [RouterOptions](interfaces/RouterOptions.md)
 - [RouterScrollBehavior](interfaces/RouterScrollBehavior.md)
 - [RouterViewProps](interfaces/RouterViewProps.md)
+- [\_RouteRecordBase](interfaces/RouteRecordBase.md)
 
 ## TS 类型别名 %{#Type-Aliases}%
 
 ### LocationQuery %{#Type-Aliases-LocationQuery}%
 
-Ƭ **LocationQuery**: `Record`<`string`, `LocationQueryValue` \| `LocationQueryValue`[]\>
+Ƭ **LocationQuery**: `Record`\<`string`, `LocationQueryValue` \| `LocationQueryValue`[]\>
 
 出现在 [RouteLocationNormalized](interfaces/RouteLocationNormalized.md) 中的规范化查询对象。
 
 ___
 
 ### LocationQueryRaw %{#Type-Aliases-LocationQueryRaw}%
 
-Ƭ **LocationQueryRaw**: `Record`<`string` \| `number`, `LocationQueryValueRaw` \| `LocationQueryValueRaw`[]\>
+Ƭ **LocationQueryRaw**: `Record`\<`string` \| `number`, `LocationQueryValueRaw` \| `LocationQueryValueRaw`[]\>
 
 松散的 [LocationQuery](index.md#locationquery) 对象，可以被传递给诸如
-[push](interfaces/Router.md#push)、[replace](interfaces/Router.md#replace) 或任何创建
+[Router.push](interfaces/Router.md#push)、[Router.replace](interfaces/Router.md#replace) 或任何创建
 [RouteLocationRaw](index.md#routelocationraw) 的函数。
 
 ___
 
 ### PathParserOptions %{#Type-Aliases-PathParserOptions}%
 
-Ƭ **PathParserOptions**: `Pick`<`_PathParserOptions`, ``"end"`` \| ``"sensitive"`` \| ``"strict"``\>
+Ƭ **PathParserOptions**: `Pick`\<`_PathParserOptions`, ``"end"`` \| ``"sensitive"`` \| ``"strict"``\>
 
 ___
 
@@ -72,13 +78,13 @@ ___
 
 ### RouteParams %{#Type-Aliases-RouteParams}%
 
-Ƭ **RouteParams**: `Record`<`string`, `RouteParamValue` \| `RouteParamValue`[]\>
+Ƭ **RouteParams**: `Record`\<`string`, `RouteParamValue` \| `RouteParamValue`[]\>
 
 ___
 
 ### RouteParamsRaw %{#Type-Aliases-RouteParamsRaw}%
 
-Ƭ **RouteParamsRaw**: `Record`<`string`, `RouteParamValueRaw` \| `Exclude`<`RouteParamValueRaw`, ``null`` \| `undefined`\>[]\>
+Ƭ **RouteParamsRaw**: `Record`\<`string`, `RouteParamValueRaw` \| `Exclude`\<`RouteParamValueRaw`, ``null`` \| `undefined`\>[]\>
 
 ___
 
@@ -100,13 +106,13 @@ ___
 
 ### RouteRecordRaw %{#Type-Aliases-RouteRecordRaw}%
 
-Ƭ **RouteRecordRaw**: `RouteRecordSingleView` \| `RouteRecordSingleViewWithChildren` \| `RouteRecordMultipleViews` \| `RouteRecordMultipleViewsWithChildren` \| `RouteRecordRedirect`
+Ƭ **RouteRecordRaw**: [`RouteRecordSingleView`](interfaces/RouteRecordSingleView.md) \| [`RouteRecordSingleViewWithChildren`](interfaces/RouteRecordSingleViewWithChildren.md) \| [`RouteRecordMultipleViews`](interfaces/RouteRecordMultipleViews.md) \| [`RouteRecordMultipleViewsWithChildren`](interfaces/RouteRecordMultipleViewsWithChildren.md) \| [`RouteRecordRedirect`](interfaces/RouteRecordRedirect.md)
 
 ___
 
 ### UseLinkOptions %{#Type-Aliases-UseLinkOptions}%
 
-Ƭ **UseLinkOptions**: `VueUseOptions`<`RouterLinkOptions`\>
+Ƭ **UseLinkOptions**: `VueUseOptions`\<`RouterLinkOptions`\>
 
 ## 变量 %{#Variables}%
 
@@ -120,14 +126,24 @@ ___
 
 ### RouterView %{#Variables-RouterView}%
 
-• `Const` **RouterView**: () => { `$props`: `AllowedComponentProps` & `ComponentCustomProps` & `VNodeProps` & [`RouterViewProps`](interfaces/RouterViewProps.md) ; `$slots`: { `default?`: (`__namedParameters`: { `Component`: `VNode`<`RendererNode`, `RendererElement`, { `[key: string]`: `any`;  }\> ; `route`: [`RouteLocationNormalizedLoaded`](interfaces/RouteLocationNormalizedLoaded.md)  }) => `VNode`<`RendererNode`, `RendererElement`, { `[key: string]`: `any`;  }\>[]  }  }
+• `Const` **RouterView**: () => \{ `$props`: `AllowedComponentProps` & `ComponentCustomProps` & `VNodeProps` & [`RouterViewProps`](interfaces/RouterViewProps.md) ; `$slots`: \{ `default?`: (`__namedParameters`: \{ `Component`: `VNode`\<`RendererNode`, `RendererElement`, \{ `[key: string]`: `any`;  }\> ; `route`: [`RouteLocationNormalizedLoaded`](interfaces/RouteLocationNormalizedLoaded.md)  }) => `VNode`\<`RendererNode`, `RendererElement`, \{ `[key: string]`: `any`;  }\>[]  }  }
 
 #### 类型声明 %{#Variables-RouterView-Type-declaration}%
 
-• **new RouterView**()
+• **new RouterView**(): `Object`
 
 用于显示用户当前所处路由的组件。
 
+##### 返回值 %{#Variables-RouterView-Returns}%
+
+`Object`
+
+| 名称 | 类型 |
+| :------ | :------ |
+| `$props` | `AllowedComponentProps` & `ComponentCustomProps` & `VNodeProps` & [`RouterViewProps`](interfaces/RouterViewProps.md) |
+| `$slots` | \{ `default?`: (`__namedParameters`: \{ `Component`: `VNode`\<`RendererNode`, `RendererElement`, \{ `[key: string]`: `any`;  }\> ; `route`: [`RouteLocationNormalizedLoaded`](interfaces/RouteLocationNormalizedLoaded.md)  }) => `VNode`\<`RendererNode`, `RendererElement`, \{ `[key: string]`: `any`;  }\>[]  } |
+| `$slots.default?` | (`__namedParameters`: \{ `Component`: `VNode`\<`RendererNode`, `RendererElement`, \{ `[key: string]`: `any`;  }\> ; `route`: [`RouteLocationNormalizedLoaded`](interfaces/RouteLocationNormalizedLoaded.md)  }) => `VNode`\<`RendererNode`, `RendererElement`, \{ `[key: string]`: `any`;  }\>[] |
+
 ___
 
 ### START\_LOCATION %{#Variables-START_LOCATION}%
@@ -194,6 +210,16 @@ ___
 
 创建一个 hash 模式的历史。在没有主机的 web 应用 (如 `file://`) 或无法通过配置服务器来处理任意 URL 的时候非常有用。
 
+#### 参数 %{#Functions-createWebHashHistory-Parameters}%
+
+| 名称 | 类型 | 描述 |
+| :------ | :------ | :------ |
+| `base?` | `string` | 可选提供的基础位置。默认为 `location.pathname + location.search`。如果在 `head` 中有一个 `<base>` 标签，它的值会因此被忽略，**但注意它会影响所有 history.pushState() 的调用**，这意味着如果你使用一个 `<base>` 标签，它的 `href` 值**必须与这个参数匹配** (忽略 `#` 后的任何东西)。 |
+
+#### 返回值 %{#Functions-createWebHashHistory-Returns}%
+
+[`RouterHistory`](interfaces/RouterHistory.md)
+
 **示例**
 
 ```js
@@ -210,16 +236,6 @@ createWebHashHistory('/other-folder/') // 给出一个 `https://example.com/othe
 createWebHashHistory('/iAmIgnored') // 给出一个 `file:///usr/etc/folder/index.html#` 的 URL
 ```
 
-#### 参数 %{#Functions-createWebHashHistory-Parameters}%
-
-| 名称 | 类型 | 描述 |
-| :------ | :------ | :------ |
-| `base?` | `string` | 可选提供的基础位置。默认为 `location.pathname + location.search`。如果在 `head` 中有一个 `<base>` 标签，它的值会因此被忽略，**但注意它会影响所有 history.pushState() 的调用**，这意味着如果你使用一个 `<base>` 标签，它的 `href` 值**必须与这个参数匹配** (忽略 `#` 后的任何东西)。 |
-
-#### 返回值 %{#Functions-createWebHashHistory-Returns}%
-
-[`RouterHistory`](interfaces/RouterHistory.md)
-
 ___
 
 ### createWebHistory %{#Functions-createWebHistory}%
@@ -246,6 +262,17 @@ ___
 
 检查一个对象是否是 [NavigationFailure](interfaces/NavigationFailure.md)。
 
+#### 参数 %{#Functions-isNavigationFailure-Parameters}%
+
+| 名称 | 类型 | 描述 |
+| :------ | :------ | :------ |
+| `error` | `any` | 可能的 [NavigationFailure](interfaces/NavigationFailure.md) |
+| `type?` | `NAVIGATION_GUARD_REDIRECT` | 可选的待检查类型 |
+
+#### 返回值 %{#Functions-isNavigationFailure-Returns}%
+
+error is NavigationRedirectError
+
 **示例**
 
 ```js
@@ -267,17 +294,6 @@ router.afterEach((to, from, failure) => {
 })
 ```
 
-#### 参数 %{#Functions-isNavigationFailure-Parameters}%
-
-| 名称 | 类型 | 描述 |
-| :------ | :------ | :------ |
-| `error` | `any` | 可能的 [NavigationFailure](interfaces/NavigationFailure.md) |
-| `type?` | `NAVIGATION_GUARD_REDIRECT` | 可选的待检查类型 |
-
-#### 返回值 %{#Functions-isNavigationFailure-Returns}%
-
-error is NavigationRedirectError
-
 ▸ **isNavigationFailure**(`error`, `type?`): error is NavigationFailure
 
 #### 参数 %{#Functions-isNavigationFailure-Parameters_1}%
@@ -295,7 +311,7 @@ ___
 
 ### loadRouteLocation %{#Functions-loadRouteLocation}%
 
-▸ **loadRouteLocation**(`route`): `Promise`<[`RouteLocationNormalizedLoaded`](interfaces/RouteLocationNormalizedLoaded.md)\>
+▸ **loadRouteLocation**(`route`): `Promise`\<[`RouteLocationNormalizedLoaded`](interfaces/RouteLocationNormalizedLoaded.md)\>
 
 确保路由被加载，所以它可以作为一个 prop 传递给 `<RouterView>`。
 
@@ -307,7 +323,7 @@ ___
 
 #### 返回值 %{#Functions-loadRouteLocation-Returns}%
 
-`Promise`<[`RouteLocationNormalizedLoaded`](interfaces/RouteLocationNormalizedLoaded.md)\>
+`Promise`\<[`RouteLocationNormalizedLoaded`](interfaces/RouteLocationNormalizedLoaded.md)\>
 
 ___
 
@@ -355,7 +371,7 @@ ___
 
 | 名称 | 类型 |
 | :------ | :------ |
-| `props` | `VueUseOptions`<`RouterLinkOptions`\> |
+| `props` | `VueUseOptions`\<`RouterLinkOptions`\> |
 
 #### 返回值 %{#Functions-useLink-Returns}%
 
@@ -364,10 +380,10 @@ ___
 | 名称 | 类型 |
 | :------ | :------ |
 | `href` | `ComputedRef<string\>` |
-| `isActive` | `ComputedRef`<`boolean`\> |
-| `isExactActive` | `ComputedRef`<`boolean`\> |
-| `navigate` | (`e`: `MouseEvent`) => `Promise`<`void` \| [`NavigationFailure`](interfaces/NavigationFailure.md)\> |
-| `route` | `ComputedRef`<[`RouteLocation`](interfaces/RouteLocation.md) & { `href`: `string`  }\> |
+| `isActive` | `ComputedRef`\<`boolean`\> |
+| `isExactActive` | `ComputedRef`\<`boolean`\> |
+| `navigate` | (`e`: `MouseEvent`) => `Promise`\<`void` \| [`NavigationFailure`](interfaces/NavigationFailure.md)\> |
+| `route` | `ComputedRef`\<[`RouteLocation`](interfaces/RouteLocation.md) & { `href`: `string`  }\> |
 
 ___
 

packages/docs/zh/api/interfaces/NavigationGuard.md

@@ -6,13 +6,13 @@ editLink: false
 
 # 接口：NavigationGuard %{#interface-navigationguard}%
 
+导航守卫。详情可查阅[导航守卫](/zh/guide/advanced/navigation-guards.md)。
+
 ## 可调用函数 %{#Callable}%
 
 ### NavigationGuard %{#Callable-NavigationGuard}%
 
-▸ **NavigationGuard**(`to`, `from`, `next`): `NavigationGuardReturn` \| `Promise`<`NavigationGuardReturn`\>
-
-导航守卫。详情可查阅[导航守卫](/zh/guide/advanced/navigation-guards.md).
+▸ **NavigationGuard**(`to`, `from`, `next`): `NavigationGuardReturn` \| `Promise`\<`NavigationGuardReturn`\>
 
 #### 参数 %{#Callable-NavigationGuard-Parameters}%
 
@@ -24,4 +24,4 @@ editLink: false
 
 #### 返回值 %{#Callable-NavigationGuard-Returns}%
 
-`NavigationGuardReturn` \| `Promise`<`NavigationGuardReturn`\>
+`NavigationGuardReturn` \| `Promise`\<`NavigationGuardReturn`\>

packages/docs/zh/api/interfaces/NavigationGuardWithThis.md

@@ -4,7 +4,9 @@ editLink: false
 
 [API 参考](../index.md) / NavigationGuardWithThis
 
-# 接口：NavigationGuardWithThis<T\> %{#interface-navigationguardwiththis-t}%
+# 接口：NavigationGuardWithThis\<T\> %{#interface-navigationguardwiththis-t}%
+
+导航守卫。详情可查阅[导航守卫](/zh/guide/advanced/navigation-guards.md)。
 
 ## 类型参数 %{#Type-parameters}%
 
@@ -16,9 +18,7 @@ editLink: false
 
 ### NavigationGuardWithThis %{#Callable-NavigationGuardWithThis}%
 
-▸ **NavigationGuardWithThis**(`this`, `to`, `from`, `next`): `NavigationGuardReturn` \| `Promise`<`NavigationGuardReturn`\>
-
-导航守卫。详情可查阅[导航守卫](/zh/guide/advanced/navigation-guards.md).
+▸ **NavigationGuardWithThis**(`this`, `to`, `from`, `next`): `NavigationGuardReturn` \| `Promise`\<`NavigationGuardReturn`\>
 
 #### 参数 %{#Callable-NavigationGuardWithThis-Parameters}%
 
@@ -31,4 +31,4 @@ editLink: false
 
 #### 返回值 %{#Callable-NavigationGuardWithThis-Returns}%
 
-`NavigationGuardReturn` \| `Promise`<`NavigationGuardReturn`\>
+`NavigationGuardReturn` \| `Promise`\<`NavigationGuardReturn`\>

packages/docs/zh/api/interfaces/RouteLocationMatched.md

@@ -30,7 +30,7 @@ ___
 
 ### beforeEnter %{#Properties-beforeEnter}%
 
-• **beforeEnter**: `undefined` \| [`NavigationGuardWithThis`](NavigationGuardWithThis.md)<`undefined`\> \| [`NavigationGuardWithThis`](NavigationGuardWithThis.md)<`undefined`\>[]
+• **beforeEnter**: `undefined` \| [`NavigationGuardWithThis`](NavigationGuardWithThis.md)\<`undefined`\> \| [`NavigationGuardWithThis`](NavigationGuardWithThis.md)\<`undefined`\>[]
 
 被注册的 beforeEnter 守卫
 
@@ -54,7 +54,7 @@ ___
 
 ### components %{#Properties-components}%
 
-• **components**: `undefined` \| ``null`` \| `Record`<`string`, [`RouteComponent`](../index.md#routecomponent)\>
+• **components**: `undefined` \| ``null`` \| `Record`\<`string`, [`RouteComponent`](../index.md#routecomponent)\>
 
 {@inheritDoc RouteRecordMultipleViews.components}
 
@@ -66,7 +66,7 @@ ___
 
 ### instances %{#Properties-instances}%
 
-• **instances**: `Record`<`string`, `undefined` \| ``null`` \| `ComponentPublicInstance`<{}, {}, {}, {}, {}, {}, {}, {}, ``false``, `ComponentOptionsBase`<`any`, `any`, `any`, `any`, `any`, `any`, `any`, `any`, `any`, {}, {}, `string`\>, {}\>\>
+• **instances**: `Record`\<`string`, `undefined` \| ``null`` \| `ComponentPublicInstance`\>
 
 <!-- TODO: translation -->
 
@@ -82,7 +82,9 @@ ___
 
 • **meta**: [`RouteMeta`](RouteMeta.md)
 
-{@inheritDoc _RouteRecordBase.meta}
+<!-- TODO: translation -->
+
+Arbitrary data attached to the record.
 
 #### 继承自 %{#Properties-meta-Inherited-from}%
 
@@ -94,7 +96,9 @@ ___
 
 • **name**: `undefined` \| [`RouteRecordName`](../index.md#routerecordname)
 
-{@inheritDoc _RouteRecordBase.name}
+<!-- TODO: translation -->
+
+Name for the route record. Must be unique.
 
 #### 继承自 %{#Properties-name-Inherited-from}%
 
@@ -106,7 +110,9 @@ ___
 
 • **path**: `string`
 
-{@inheritDoc _RouteRecordBase.path}
+<!-- TODO: translation -->
+
+Path of the record. Should start with `/` unless the record is the child of another record.
 
 #### 继承自 %{#Properties-path-Inherited-from}%
 
@@ -116,9 +122,11 @@ ___
 
 ### props %{#Properties-props}%
 
-• **props**: `Record`<`string`, `_RouteRecordProps`\>
+• **props**: `Record`\<`string`, `_RouteRecordProps`\>
+
+<!-- TODO: translation -->
 
-{@inheritDoc RouteRecordMultipleViews.props}
+Allow passing down params as props to the component rendered by `router-view`. Should be an object with the same keys as `components` or a boolean to be applied to every component.
 
 #### 继承自 %{#Properties-props-Inherited-from}%
 
@@ -130,7 +138,9 @@ ___
 
 • **redirect**: `undefined` \| `RouteRecordRedirectOption`
 
-{@inheritDoc _RouteRecordBase.redirect}
+<!-- TODO: translation -->
+
+Where to redirect if the route is directly matched. The redirection happens before any navigation guard and triggers a new navigation with the new target location.
 
 #### 继承自 %{#Properties-redirect-Inherited-from}%
 

packages/docs/zh/api/interfaces/RouteLocationNormalized.md

@@ -6,7 +6,7 @@ editLink: false
 
 # 接口：RouteLocationNormalized
 
-和 [RouteLocation](RouteLocation.md) 类似但是其 [matched](RouteLocationNormalized.md#matched) 无法包含重定向的记录
+和 [RouteLocation](RouteLocation.md) 类似但是其 [RouteLocationNormalized.matched](RouteLocationNormalized.md#matched) 无法包含重定向的记录
 
 ## 继承关系 %{#Hierarchy}%