diff --git a/guide/english/react/fragments/index.md b/guide/english/react/fragments/index.md index ff450658742..7e2c741045d 100644 --- a/guide/english/react/fragments/index.md +++ b/guide/english/react/fragments/index.md @@ -4,9 +4,13 @@ title: Fragments # Fragments -Fragments are way to render multiple elements without using a wrapper element. When attempting to render elements without an enclosing tag in JSX, you will see the error message `Adjacent JSX elements must be wrapped in an enclosing tag`. This is because when JSX transpiles, it's creating elements with their corresponding tag names, and doesn't know what tag name to use if multiple elements are found. In the past, a frequent solution to this was to use a wrapper div to solve this problem. However, version 16 of React brought the addition of `Fragment`, which makes this no longer necessary. +Fragments are a way to return multiple elements from the render method without using an additional wrapping DOM element. -`Fragment` acts a wrapper without adding unnecessary divs to the DOM. You can use it directly from the React import, or deconstruct it: +When attempting to render multiple sibling elements without an enclosing tag in JSX, you will see the error message of `Adjacent JSX elements must be wrapped in an enclosing tag`. + +In the past, a frequent solution was to use either a wrapping div or span element. However, version 16.0 of React introduced the addition of `Fragment`, which makes this no longer necessary. + +`Fragment` acts a wrapper without adding unnecessary divs or spans elements to the DOM. You can use it directly from the React import: ```jsx import React from 'react'; @@ -26,6 +30,9 @@ export default MyComponent; ``` +`Fragments` only accept the key attribute. + +Or you can additionally deconstruct it for use: ```jsx // Deconstructed import React, { Component, Fragment } from 'react'; @@ -44,7 +51,8 @@ class MyComponent extends Component { export default MyComponent; ``` -React version 16.2 simplified this process further, allowing for empty JSX tags to interpretted as Fragments: + +React version 16.2 simplified this process further, allowing for empty JSX tags `<>` to be interpreted as Fragments: ```jsx return ( @@ -55,6 +63,8 @@ return ( ); ``` +Empty JSX tags cannot be used with attributes, including key. + #### More Information: * [React.Fragment (Official Documentation)](https://reactjs.org/docs/react-api.html#reactfragment) * [React v16.2.0: Improved Support for Fragments](https://reactjs.org/blog/2017/11/28/react-v16.2.0-fragment-support.html)