Skip to content

Commit a5e0297

Browse files
chenshuai2144QC-L
authored andcommitted
docs(cn): translated content/docs/fragments.md into Chinese (reactjs#132)
translated fragments document
1 parent b160b3c commit a5e0297

File tree

1 file changed

+19
-19
lines changed

1 file changed

+19
-19
lines changed

content/docs/fragments.md

+19-19
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ title: Fragments
44
permalink: docs/fragments.html
55
---
66

7-
A common pattern in React is for a component to return multiple elements. Fragments let you group a list of children without adding extra nodes to the DOM.
7+
React 中的一个常见模式是一个组件返回多个元素。Fragments 允许你将子列表分组,而无需向 DOM 添加额外节点。
88

99
```js
1010
render() {
@@ -18,11 +18,11 @@ render() {
1818
}
1919
```
2020

21-
There is also a new [short syntax](#short-syntax) for declaring them, but it isn't supported by all popular tools yet.
21+
还有一种新的[短语法](#short-syntax)可用于声明它们,但尚未得到所有流行工具的支持。
2222

23-
## Motivation {#motivation}
23+
## 动机 {#motivation}
2424

25-
A common pattern is for a component to return a list of children. Take this example React snippet:
25+
一种常见模式是组件返回一个子元素列表。以此 React 代码片段为例:
2626

2727
```jsx
2828
class Table extends React.Component {
@@ -38,7 +38,7 @@ class Table extends React.Component {
3838
}
3939
```
4040

41-
`<Columns />` would need to return multiple `<td>` elements in order for the rendered HTML to be valid. If a parent div was used inside the `render()` of `<Columns />`, then the resulting HTML will be invalid.
41+
`<Columns />` 需要返回多个 `<td>` 元素以使渲染的 HTML 有效。如果在 `<Columns />``render()` 中使用了父 div,则生成的 HTML 将无效。
4242

4343
```jsx
4444
class Columns extends React.Component {
@@ -53,7 +53,7 @@ class Columns extends React.Component {
5353
}
5454
```
5555

56-
results in a `<Table />` output of:
56+
得到一个 `<Table />` 输出:
5757

5858
```jsx
5959
<table>
@@ -66,9 +66,9 @@ results in a `<Table />` output of:
6666
</table>
6767
```
6868

69-
Fragments solve this problem.
69+
Fragments 解决了这个问题。
7070

71-
## Usage {#usage}
71+
## 用法 {#usage}
7272

7373
```jsx{4,7}
7474
class Columns extends React.Component {
@@ -83,7 +83,7 @@ class Columns extends React.Component {
8383
}
8484
```
8585

86-
which results in a correct `<Table />` output of:
86+
这样可以正确的输出 `<Table />`
8787

8888
```jsx
8989
<table>
@@ -94,9 +94,9 @@ which results in a correct `<Table />` output of:
9494
</table>
9595
```
9696

97-
### Short Syntax {#short-syntax}
97+
### 短语法 {#short-syntax}
9898

99-
There is a new, shorter syntax you can use for declaring fragments. It looks like empty tags:
99+
你可以使用一种新的,且更简短的语法来声明 Fragments。它看起来像空标签:
100100

101101
```jsx{4,7}
102102
class Columns extends React.Component {
@@ -111,20 +111,20 @@ class Columns extends React.Component {
111111
}
112112
```
113113

114-
You can use `<></>` the same way you'd use any other element except that it doesn't support keys or attributes.
114+
你可以像使用任何其他元素一样使用 `<> </>`,除了它不支持 key 或属性。
115115

116-
Note that **[many tools don't support it yet](/blog/2017/11/28/react-v16.2.0-fragment-support.html#support-for-fragment-syntax)** so you might want to explicitly write `<React.Fragment>` until the tooling catches up.
116+
请注意 **[目前许多工具尚不支持](/blog/2017/11/28/react-v16.2.0-fragment-support.html#support-for-fragment-syntax)** ,所以直到工具支持之前,你可能要显式的使用 `<React.Fragment>`
117117

118-
### Keyed Fragments {#keyed-fragments}
118+
### 带 key 的 Fragments {#keyed-fragments}
119119

120-
Fragments declared with the explicit `<React.Fragment>` syntax may have keys. A use case for this is mapping a collection to an array of fragments -- for example, to create a description list:
120+
使用显式 `<React.Fragment>` 语法声明的片段可能具有 key。一个使用场景是将一个集合映射到一个 Fragments 数组 - 举个例子,创建一个描述列表:
121121

122122
```jsx
123123
function Glossary(props) {
124124
return (
125125
<dl>
126126
{props.items.map(item => (
127-
// Without the `key`, React will fire a key warning
127+
// 没有`key`React 会发出一个关键警告
128128
<React.Fragment key={item.id}>
129129
<dt>{item.term}</dt>
130130
<dd>{item.description}</dd>
@@ -135,8 +135,8 @@ function Glossary(props) {
135135
}
136136
```
137137

138-
`key` is the only attribute that can be passed to `Fragment`. In the future, we may add support for additional attributes, such as event handlers.
138+
`key` 是唯一可以传递给 `Fragment` 的属性。未来我们可能会添加对其他属性的支持,例如事件。
139139

140-
### Live Demo {#live-demo}
140+
### 在线 Demo {#live-demo}
141141

142-
You can try out the new JSX fragment syntax with this [CodePen](https://codepen.io/reactjs/pen/VrEbjE?editors=1000).
142+
你可以在 [CodePen](https://codepen.io/reactjs/pen/VrEbjE?editors=1000) 中尝试这个新的 JSX Fragment 语法。

0 commit comments

Comments
 (0)