docs: sync Chinese doc to 3.0.0-rc.2 (#712)

* docs: sync Chinese doc to 3.0.0-rc.1

* docs: sync Chinese doc to 3.0.0-rc.2
This commit is contained in:
Gao Yingjian
2019-07-26 18:50:03 +08:00
committed by Guillaume Chau
parent 388dd2a6a4
commit f62d4fbc8d
7 changed files with 47 additions and 5 deletions
+1 -1
View File
@@ -47,7 +47,7 @@ To enable support of `gql` string tag in Vue templates, see the necessary setup
- `debounce`: Number of milliseconds for debouncing refetches (for example when the variables are changed)
- `throttle`: Number of milliseconds for throttling refetches (for example when the variables are changed)
- `prefetch`: If `false`, will skip prefetching during SSR
- `options`: Other Apollo Watch Query options.
- `options`: Other Apollo Watch Query options
## Scoped slot
+3 -3
View File
@@ -77,14 +77,14 @@ You can then use your property as usual in your vue component:
</template>
```
## Name macthing
## Name matching
Please note that a common beginner's error is to use a different data name from the field name in query, eg:
```js
apollo: {
world: gql`query {
hello
hello
}`
}
```
@@ -107,7 +107,7 @@ You can also rename the field in the GraphQL document directly:
```js
apollo: {
world: gql`query {
world: hello
world: hello
}`
}
```
+1 -1
View File
@@ -54,5 +54,5 @@ footer: LICENCE MIT - Created by Guillaume CHAU (@Akryum)
</p>
::: tip 当前版本
中文文档现在同步至 v3.0.0-beta.30
中文文档现在同步至 v3.0.0-rc.2
:::
+1
View File
@@ -47,6 +47,7 @@
- `debounce`:对重新获取查询结果的防抖毫秒数(例如当变量更改时)
- `throttle`:对重新获取查询结果的节流毫秒数(例如当变量更改时)
- `prefetch`:如为 `false`,将跳过 SSR 期间的预取
- `options`:其他可用的 Apollo 监听查询选项
## 作用域插槽
+1
View File
@@ -9,6 +9,7 @@
- `throttle`:变量更新节流时间(毫秒)。
- `debounce`:变量更新防抖时间(毫秒)。
- `result(data, key)` 是收到结果时调用的钩子。
- `error(error)` 是有错误时调用的钩子。`error` 是一个具有 `graphQLErrors` 属性或 `networkError` 属性的 Apollo 错误对象。
## 属性
+3
View File
@@ -41,5 +41,8 @@ const js = ApolloSSR.exportStates(apolloProvider, options)
attachTo: 'window',
// 每个 apollo 客户端状态的 key 的前缀
exportNamespace: '',
// 我们默认使用 sanitize js 库来阻止 XSS
// 在这里传入 true 将对状态执行标准的 JSON.stringify
useUnsafeSerializer: false,
}
```
+37
View File
@@ -77,6 +77,43 @@ export const resolvers = {
</template>
```
## 名称匹配
请注意,初学者常见的错误是使用与查询中的字段名不相同的数据名称,例如:
```js
apollo: {
world: gql`query {
hello
}`
}
```
注意 `world``hello` 的不同之处:vue-apollo 不会去猜测你想要将哪些数据从查询结果中放入组件中。默认情况下,它只会尝试你在组件中使用的数据名称(即 `apollo` 对象中的键),在本例中为 `world`。如果名称不匹配,你可以使用 `update` 选项来告诉 vue-apollo 在结果中使用什么样的数据:
```js
apollo: {
world: {
query: gql`query {
hello
}`,
update: data => data.hello
}
}
```
你也可以直接在 GraphQL 文档中重命名该字段:
```js
apollo: {
world: gql`query {
world: hello
}`
}
```
在本例中,我们将 `hello` 字段重命名为 `world`,以便 vue-apollo 来自动推断应该从结果中取回什么。
## 带参数的查询
你可以通过在对象中声明 `query``variables` 将变量(读取参数)添加到 `gql` 查询中: