<Fragment> (<>...</>)

<Fragment> は頻繁に <>...</> 構文で使用され、ノードでラップせずに要素をグループ化することができます。

<>
<OneChild />
<AnotherChild />
</>

リファレンス

<Fragment>

単一の要素が必要な場合は、<Fragment> でラップすると複数の要素をグループ化することができます。Fragment で要素をグループ化しても、出力される DOM には影響を与えません。要素がグループ化されていないときの DOM と同じです。空の JSX タグ <></> は、ほとんどの場合 <Fragment></Fragment> の省略記法です。

props

  • 省略可能 key: 明示的な <Fragment> 構文で宣言されたフラグメントは keys. を持つことができます。

注意点

  • key をフラグメントに渡したい場合は、<>...</> の構文を使用することはできません。'react' から Fragment を明示的にインポートし、<Fragment key={yourKey}>...</Fragment> をレンダーしなければなりません。
  • React は、<><Child /></> のレンダリングから [<Child />] に戻るとき、または <><Child /></> のレンダリングから <Child /> に戻るときは state をリセット されません。これは 1 つ分の階層のみ動作します:例えば、<><><Child /></></> から <Child /> への変更は state がリセットされます。詳しくは こちらを参照してください。

使い方

複数の要素を返す

複数の要素をグループ化するために Fragment や同等の <>...</> 構文を使用することができます。You can use it to put multiple elements in any place where a single element can go.例えば、1 つのコンポーネントは 1 つの要素しか返すことができませんが、Fragment を使用すれば、複数の要素を一緒にグループ化して、グループとして返します。

function Post() {
return (
<>
<PostTitle />
<PostBody />
</>
);
}

Fragment は実用的です。理由として、DOM 要素のような他のコンテナで要素をラップする場合と異なり、Fragment で要素をグループ化してもレイアウトやスタイルに影響を与えないからです。この例をブラウザツールで検証すると、全ての <h1><article> DOM ノードがそれらを囲むラッパーなしに兄弟として表示されることがわかります。

export default function Blog() {
  return (
    <>
      <Post title="An update" body="It's been a while since I posted..." />
      <Post title="My new blog" body="I am starting a new blog!" />
    </>
  )
}

function Post({ title, body }) {
  return (
    <>
      <PostTitle title={title} />
      <PostBody body={body} />
    </>
  );
}

function PostTitle({ title }) {
  return <h1>{title}</h1>
}

function PostBody({ body }) {
  return (
    <article>
      <p>{body}</p>
    </article>
  );
}

さらに深く知る

特別な構文を使わずにFragmentをどのように記述するか?

上述の例は、React から Fragment をインポートすることと同じです:

import { Fragment } from 'react';

function Post() {
return (
<Fragment>
<PostTitle />
<PostBody />
</Fragment>
);
}

通常なら Fragment に key を渡す 必要がある場合以外では必要ありません。


複数の要素を変数に割り当てる

他の要素と同じように、Fragment の要素を変数に割り当てたり、props として渡したりすることができます:

function CloseDialog() {
const buttons = (
<>
<OKButton />
<CancelButton />
</>
);
return (
<AlertDialog buttons={buttons}>
Are you sure you want to leave this page?
</AlertDialog>
);
}

Grouping elements with text

You can use Fragment to group text together with components:

function DateRangePicker({ start, end }) {
return (
<>
From
<DatePicker date={start} />
to
<DatePicker date={end} />
</>
);
}

Fragment のリストをレンダーする

以下は <></> 構文の代わりに Fragment を明示的に記述する必要がある場面です。ループ内で複数の要素をレンダーするときには、各要素に key を割り当てる必要があります。ループ内の要素が Fragment である場合は、key 属性を提供するために標準的な JSX 要素の構文を使用する必要があります。

function Blog() {
return posts.map(post =>
<Fragment key={post.id}>
<PostTitle title={post.title} />
<PostBody body={post.body} />
</Fragment>
);
}

Fragment の子要素の周りにラッパー要素がないことを確認するために、DOM を検査できます:

import { Fragment } from 'react';

const posts = [
  { id: 1, title: 'An update', body: "It's been a while since I posted..." },
  { id: 2, title: 'My new blog', body: 'I am starting a new blog!' }
];

export default function Blog() {
  return posts.map(post =>
    <Fragment key={post.id}>
      <PostTitle title={post.title} />
      <PostBody body={post.body} />
    </Fragment>
  );
}

function PostTitle({ title }) {
  return <h1>{title}</h1>
}

function PostBody({ body }) {
  return (
    <article>
      <p>{body}</p>
    </article>
  );
}