<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> ); }
さらに深く知る
上述の例は、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> ); }