Merge pull request #2 from vuejs/master

update repository

Author: Aaron

src/api/composition-api.md

@@ -167,11 +167,9 @@ const foo = inject<string>('foo') // string | undefined
   - [Provide / Inject](../guide/component-provide-inject.html)
   - [组合式 API Provide / Inject](../guide/composition-api-provide-inject.html)
 
-<!-- TODO: translation -->
-
 ## `getCurrentInstance`
 
-`getCurrentInstance` enables access to an internal component instance useful for advanced usages or for library creators.
+`getCurrentInstance` 支持访问内部组件实例，用于高阶用法或库的开发。
 
 ```ts
 import { getCurrentInstance } from 'vue'
@@ -180,14 +178,14 @@ const MyComponent = {
   setup() {
     const internalInstance = getCurrentInstance()
 
-    internalInstance.appContext.config.globalProperties // access to globalProperties
+    internalInstance.appContext.config.globalProperties // 访问 globalProperties
   }
 }
 ```
 
-`getCurrentInstance` **only** works during [setup](#setup) or [Lifecycle Hooks](#lifecycle-hooks)
+`getCurrentInstance` **只能**在 [setup](#setup) 或[生命周期钩子](#lifecycle-hooks)中调用。
 
-> When using outside of [setup](#setup) or [Lifecycle Hooks](#lifecycle-hooks), please call `getCurrentInstance()` on `setup` and use the instance instead.
+> 如需在 [setup](#setup) 或[生命周期钩子](#lifecycle-hooks)外使用，请先在 `setup` 中调用 `getCurrentInstance()` 获取该实例然后再使用。
 
 ```ts
 const MyComponent = {
@@ -218,7 +216,7 @@ const MyComponent = {
   }
 }
 
-// also works if called on a composable
+// 在组合式函数中调用也可以正常执行
 function useComponentId() {
   return getCurrentInstance().uid
 }

src/guide/component-slots.md

@@ -1,6 +1,6 @@
 # 插槽
 
-> 该页面假设你已经阅读过了[组件基础](component-basics.md)。如果你还对组件不太了解，推荐你先阅读它。
+> 该页面假设你已经阅读过了[组件基础](component-basics.md)。如果你对组件还不太了解，推荐你先阅读它。
 
 ## 插槽内容
 
@@ -96,17 +96,17 @@ Vue 实现了一套内容分发的 API，这套 API 的设计灵感源自 [Web C
 
 > 父级模板里的所有内容都是在父级作用域中编译的；子模板里的所有内容都是在子作用域中编译的。
 
-## 后备内容
+## 备用内容
 
-有时为一个插槽设置具体的后备 (也就是默认的) 内容是很有用的，它只会在没有提供内容的时候被渲染。例如在一个 `<submit-button>` 组件中：
+有时为一个插槽设置具体的备用 (也就是默认的) 内容是很有用的，它只会在没有提供内容的时候被渲染。例如在一个 `<submit-button>` 组件中：
 
 ```html
 <button type="submit">
   <slot></slot>
 </button>
 ```
 
-我们可能希望这个 `<button>` 内绝大多数情况下都渲染文本“Submit”。为了将“Submit”作为后备内容，我们可以将它放在 `<slot>` 标签内：
+我们可能希望这个 `<button>` 内绝大多数情况下都渲染文本“Submit”。为了将“Submit”作为备用内容，我们可以将它放在 `<slot>` 标签内：
 
 ```html
 <button type="submit">
@@ -120,7 +120,7 @@ Vue 实现了一套内容分发的 API，这套 API 的设计灵感源自 [Web C
 <submit-button></submit-button>
 ```
 
-后备内容“Submit”将会被渲染：
+备用内容“Submit”将会被渲染：
 
 ```html
 <button type="submit">
@@ -136,7 +136,7 @@ Vue 实现了一套内容分发的 API，这套 API 的设计灵感源自 [Web C
 </submit-button>
 ```
 
-则这个提供的内容将会被渲染从而取代后备内容：
+则这个提供的内容将会被渲染从而取代备用内容：
 
 ```html
 <button type="submit">
@@ -243,7 +243,7 @@ app.component('todo-list', {
 })
 ```
 
-我们可能需要替换插槽以在父组件上自定义它：
+我们可能需要替换插槽使它作用在父组件上：
 
 ```html
 <todo-list>
@@ -356,7 +356,7 @@ function (slotProps) {
 </todo-list>
 ```
 
-你甚至可以定义后备内容，用于插槽 prop 是 undefined 的情形：
+你甚至可以定义备用内容，用于插槽 prop 是 undefined 的情形：
 
 ```html
 <todo-list v-slot="{ item = 'Placeholder' }">

src/guide/composition-api-setup.md

@@ -48,9 +48,8 @@ setup(props) {
 }
 ```
 
-<!-- TODO: translation -->
 
-If `title` is an optional prop, it could be missing from `props`. In that case, `toRefs` won't create a ref for `title`. Instead you'd need to use `toRef`:
+如果 `title` 是可选的 prop，则传入的 `props` 中可能没有 `title` 。在这种情况下，`toRefs` 将不会为 `title` 创建一个 ref 。你需要使用 `toRef` 替代它：
 
 ```js
 // MyBook.vue
@@ -61,7 +60,7 @@ setup(props) {
 }
 ```
 
-### 上下文
+### Context
 
 传递给 `setup` 函数的第二个参数是 `context`。`context` 是一个普通的 JavaScript 对象，它暴露三个组件的 property：
 

src/guide/migration/v-on-native-modifier-removed.md

@@ -1,20 +1,18 @@
 ---
-title: v-on.native modifier removed
+title: 移除 v-on.native 修饰符
 badges:
   - breaking
 ---
 
-<!-- TODO: translation -->
+# 移除 `v-on.native` 修饰符 <MigrationBadges :badges="$frontmatter.badges" />
 
-# `v-on.native` modifier removed <MigrationBadges :badges="$frontmatter.badges" />
+## 概览
 
-## Overview
+`v-on` 的 `.native` 修饰符已被移除。
 
-The `.native` modifier for `v-on` has been removed.
+## 2.x 语法
 
-## 2.x Syntax
-
-Event listeners passed to a component with `v-on` are by default only triggered by emitting an event with `this.$emit`. To add a native DOM listener to the child component's root element instead, the `.native` modifier can be used:
+默认情况下，传递给带有 `v-on` 的组件的事件监听器只有通过 `this.$emit` 才能触发。要将原生 DOM 监听器添加到子组件的根元素中，可以使用 `.native` 修饰符：
 
 ```html
 <my-component
@@ -23,11 +21,11 @@ Event listeners passed to a component with `v-on` are by default only triggered
 />
 ```
 
-## 3.x Syntax
+## 3.x 语法
 
-The `.native` modifier for `v-on` has been removed. At the same time, the [new `emits` option](./emits-option.md) allows the child to define which events it does indeed emit.
+`v-on` 的 `.native` 修饰符已被移除。同时，[新增的 `emits` 选项](./emits-option.md)允许子组件定义真正会被触发的事件。
 
-Consequently, Vue will now add all event listeners that are _not_ defined as component-emitted events in the child as native event listeners to the child's root element (unless `inheritAttrs: false` has been set in the child's options).
+因此，对于子组件中*未*被定义为组件触发的所有事件监听器，Vue 现在将把它们作为原生事件监听器添加到子组件的根元素中 (除非在子组件的选项中设置了 `inheritAttrs: false`)。
 
 ```html
 <my-component
@@ -46,14 +44,14 @@ Consequently, Vue will now add all event listeners that are _not_ defined as com
 </script>
 ```
 
-## Migration Strategy
+## 迁移策略
 
-- remove all instances of the `.native` modifier.
-- ensure that all your components document their events with the `emits` option.
+- 删除 `.native` 修饰符的所有实例。
+- 确保所有组件都使用 `emits` 选项记录其事件。
 
-## See also
+## 参考
 
-- [Relevant RFC](https://github.com/vuejs/rfcs/blob/master/active-rfcs/0031-attr-fallthrough.md#v-on-listener-fallthrough)
-- [Migration guide - New Emits Option](./emits-option.md)
-- [Migration guide - `$listeners` removed](./listeners-removed.md)
-- [Migration guide - Changes in the Render Functions API](./render-function-api.md)
+- [相关的 RFC](https://github.com/vuejs/rfcs/blob/master/active-rfcs/0031-attr-fallthrough.md#v-on-listener-fallthrough)
+- [迁移指南 - 新增 Emits 选项](./emits-option.md)
+- [迁移指南 - 移除 `$listeners`](./listeners-removed.md)
+- [迁移指南 - 渲染函数 API 的更改](./render-function-api.md)

src/guide/render-function.md

@@ -338,7 +338,7 @@ render() {
       // 如果触发事件的元素不是事件绑定的元素
       // 则返回
       if (event.target !== event.currentTarget) return
-      // 如果向上键不是回车键，则中止
+      // 如果向上键不是回车键，则终止
       // 没有同时按下按键 (13) 和 shift 键
       if (!event.shiftKey || event.keyCode !== 13) return
       // 停止事件传播