From 158adf7dd4be1353e16d1e8bd0170304eaa94ff6 Mon Sep 17 00:00:00 2001 From: Yukon123 <82578034+Yukon123@users.noreply.github.com> Date: Sun, 22 Aug 2021 02:32:51 +0800 Subject: [PATCH 1/6] Update refs-api.md --- src/api/refs-api.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/src/api/refs-api.md b/src/api/refs-api.md index 9494df05b..52932ba24 100644 --- a/src/api/refs-api.md +++ b/src/api/refs-api.md @@ -16,7 +16,7 @@ count.value++ console.log(count.value) // 1 ``` -如果将对象分配为 ref 值，则通过 [reactive](./basic-reactivity.html#reactive) 方法使该对象具有高度的响应式。 +如果将对象分配为 ref 值，则通过 [reactive](./basic-reactivity.html#reactive) 函数使该对象具有高度的响应式。 **类型声明：** @@ -57,7 +57,7 @@ function useFoo(x: number | Ref) { ## `toRef` -可以用来为源响应式对象上的某个 property 新创建一个 [`ref`](#ref)。然后，ref 可以被传递，它会保持对其源 property 的响应式连接。 +可以用来为源 reactive 对象上的某个 property 新创建一个 [`ref`](#ref)。然后，ref 可以被传递，它会保持对其源 property 的响应式连接。 ```js const state = reactive({ @@ -88,7 +88,7 @@ export default { ## `toRefs` -将响应式对象转换为普通对象，其中结果对象的每个 property 都是指向原始对象相应 property 的 [`ref`](#ref)。 +将 reactive 对象转换为普通对象，其中结果对象的每个 property 都是指向原始对象相应 property 的 [`ref`](#ref)。 ```js const state = reactive({ @@ -114,7 +114,7 @@ stateAsRefs.foo.value++ console.log(state.foo) // 3 ``` -当从组合式函数返回响应式对象时，`toRefs` 非常有用，这样消费组件就可以在不丢失响应性的情况下对返回的对象进行分解/扩散： +当从组合式函数返回 reactive 对象时，`toRefs` 非常有用，这样消费组件就可以在不丢失响应性的情况下对返回的对象进行解构/展开： ```js function useFeatureX() { @@ -217,7 +217,7 @@ isReactive(foo.value) // false ## `triggerRef` -手动执行与 [`shallowRef`](#shallowref) 关联的任何副作用。 +手动执行与 [`shallowRef`](#shallowref) 关联的任何effect。 ```js const shallow = shallowRef({ @@ -229,7 +229,7 @@ watchEffect(() => { console.log(shallow.value.greet) }) -// 这不会触发副作用，因为 ref 是浅层的 +// 这不会触发effect，因为 ref 是浅层的 shallow.value.greet = 'Hello, universe' // 记录 "Hello, universe" From c5ac5a39b7cc73d84156aab024fa2be6a528a7b1 Mon Sep 17 00:00:00 2001 From: Yukon123 <82578034+Yukon123@users.noreply.github.com> Date: Tue, 24 Aug 2021 16:21:14 +0800 Subject: [PATCH 2/6] Update src/api/refs-api.md Co-authored-by: wxsm --- src/api/refs-api.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/api/refs-api.md b/src/api/refs-api.md index 52932ba24..129dada9b 100644 --- a/src/api/refs-api.md +++ b/src/api/refs-api.md @@ -217,7 +217,7 @@ isReactive(foo.value) // false ## `triggerRef` -手动执行与 [`shallowRef`](#shallowref) 关联的任何effect。 +手动执行与 [`shallowRef`](#shallowref) 关联的任何 effect。 ```js const shallow = shallowRef({ From dba632bec310193c6ce96ea80ac7f03fcaa56b00 Mon Sep 17 00:00:00 2001 From: Yukon123 <82578034+Yukon123@users.noreply.github.com> Date: Tue, 24 Aug 2021 16:21:25 +0800 Subject: [PATCH 3/6] Update src/api/refs-api.md Co-authored-by: wxsm --- src/api/refs-api.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/api/refs-api.md b/src/api/refs-api.md index 129dada9b..bc724decf 100644 --- a/src/api/refs-api.md +++ b/src/api/refs-api.md @@ -229,7 +229,7 @@ watchEffect(() => { console.log(shallow.value.greet) }) -// 这不会触发effect，因为 ref 是浅层的 +// 这不会触发 effect，因为 ref 是浅层的 shallow.value.greet = 'Hello, universe' // 记录 "Hello, universe" From 140fd7fed0e94f241464671aafb1ffda0e5fe1fb Mon Sep 17 00:00:00 2001 From: Jinjiang Date: Sun, 19 Sep 2021 13:38:53 +0800 Subject: [PATCH 4/6] Apply suggestions from code review --- src/api/refs-api.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/api/refs-api.md b/src/api/refs-api.md index bc724decf..90abc4869 100644 --- a/src/api/refs-api.md +++ b/src/api/refs-api.md @@ -57,7 +57,7 @@ function useFoo(x: number | Ref) { ## `toRef` -可以用来为源 reactive 对象上的某个 property 新创建一个 [`ref`](#ref)。然后，ref 可以被传递，它会保持对其源 property 的响应式连接。 +可以用来源响应式对象上的某个 property 新创建一个 [`ref`](#ref)。然后，ref 可以被传递，它会保持对其源 property 的响应式连接。 ```js const state = reactive({ From 9a673bc4b2f2cfc8e1a5e2aa498ce3725906d019 Mon Sep 17 00:00:00 2001 From: Jinjiang Date: Sun, 19 Sep 2021 13:39:42 +0800 Subject: [PATCH 5/6] Apply suggestions from code review --- src/api/refs-api.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/src/api/refs-api.md b/src/api/refs-api.md index 90abc4869..015f4b431 100644 --- a/src/api/refs-api.md +++ b/src/api/refs-api.md @@ -88,7 +88,7 @@ export default { ## `toRefs` -将 reactive 对象转换为普通对象，其中结果对象的每个 property 都是指向原始对象相应 property 的 [`ref`](#ref)。 +将响应式对象转换为普通对象，其中结果对象的每个 property 都是指向原始对象相应 property 的 [`ref`](#ref)。 ```js const state = reactive({ @@ -114,7 +114,7 @@ stateAsRefs.foo.value++ console.log(state.foo) // 3 ``` -当从组合式函数返回 reactive 对象时，`toRefs` 非常有用，这样消费组件就可以在不丢失响应性的情况下对返回的对象进行解构/展开： +当从组合式函数返回响应式对象时，`toRefs` 非常有用，这样消费组件就可以在不丢失响应性的情况下对返回的对象进行解构/展开： ```js function useFeatureX() { @@ -217,7 +217,7 @@ isReactive(foo.value) // false ## `triggerRef` -手动执行与 [`shallowRef`](#shallowref) 关联的任何 effect。 +手动执行与 [`shallowRef`](#shallowref) 关联的任何作用 (effect)。 ```js const shallow = shallowRef({ @@ -229,7 +229,7 @@ watchEffect(() => { console.log(shallow.value.greet) }) -// 这不会触发 effect，因为 ref 是浅层的 +// 这不会触发作用 (effect)，因为 ref 是浅层的 shallow.value.greet = 'Hello, universe' // 记录 "Hello, universe" From 6896e17e9ab8272fb16e2b0593876b8af390de95 Mon Sep 17 00:00:00 2001 From: Jinjiang Date: Sun, 19 Sep 2021 13:40:45 +0800 Subject: [PATCH 6/6] Apply suggestions from code review --- src/api/refs-api.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/api/refs-api.md b/src/api/refs-api.md index 015f4b431..761261a9b 100644 --- a/src/api/refs-api.md +++ b/src/api/refs-api.md @@ -57,7 +57,7 @@ function useFoo(x: number | Ref) { ## `toRef` -可以用来源响应式对象上的某个 property 新创建一个 [`ref`](#ref)。然后，ref 可以被传递，它会保持对其源 property 的响应式连接。 +可以用来为源响应式对象上的某个 property 新创建一个 [`ref`](#ref)。然后，ref 可以被传递，它会保持对其源 property 的响应式连接。 ```js const state = reactive({