<Fragment>는 <>...</> 문법으로 자주 사용되며, 래퍼 노드 없이 엘리먼트를 그룹화할 수 있게 해줍니다.
<>
<OneChild />
<AnotherChild />
</>레퍼런스
<Fragment>
하나의 엘리먼트가 필요한 상황에서 엘리먼트를 <Fragment>로 감싸서 그룹화하세요. Fragment 안에서 그룹화된 엘리먼트는 DOM 결과물에 영향을 주지 않습니다. 즉, 엘리먼트가 그룹화되지 않은 것과 같습니다. 대부분의 경우 빈 JSX 태그인 <></>는 <Fragment></Fragment>의 축약형입니다.
Props
-
key(선택사항): 명시적<Fragment>로 선언된Fragment에는key를 사용할 수 있습니다. -
Canary only
ref(선택사항): ref 객체(예:useRef에서 반환된 것) 또는 콜백 함수입니다. React는Fragment로 감싼 DOM 노드와 상호작용하기 위한 메서드를 구현한FragmentInstance를 ref 값으로 제공합니다.
주의 사항
-
Fragment에
key를 사용하려면<>...</>구문을 사용할 수 없습니다. 명시적으로react에서Fragment를 불러오고Import<Fragment key={yourKey}>...</Fragment>를 렌더링해야 합니다. -
React는
<><Child /></>에서[<Child />]로 렌더링하거나 (또는 반대의 경우), 혹은<><Child /></>에서<Child />렌더링하거나 (또는 반대의 경우) State를 초기화하지 않습니다. 이는 오직 한 단계 깊이Single Level Deep까지만 적용됩니다. 예를 들어<><><Child /></></>에서<Child />로 렌더링하는 것은 State가 초기화됩니다. 정확한 의미는 여기서 확인할 수 있습니다. -
Canary only Fragment에
ref를 전달하려면<>...</>문법을 사용할 수 없습니다. 명시적으로'react'에서Fragment를 불러오고<Fragment ref={yourRef}>...</Fragment>를 렌더링해야 합니다.
FragmentInstance
Fragment에 ref를 전달하면 React는 FragmentInstance 객체를 제공합니다. 이 객체는 Fragment로 감싼 최상위 DOM 자식과 상호작용하기 위한 메서드를 구현합니다.
addEventListener와removeEventListener는 모든 최상위 DOM 자식의 이벤트 리스너를 관리합니다.dispatchEvent는 Fragment에서 이벤트를 발생시키며, 이 이벤트는 DOM 부모로 버블링될 수 있습니다.focus,focusLast,blur는 중첩된 모든 자식을 깊이 우선으로 탐색하며 포커스를 관리합니다.observeUsing과unobserveUsing은IntersectionObserver또는ResizeObserver인스턴스를 연결하고 해제합니다.getClientRects는 모든 최상위 DOM 자식의 경계 사각형을 반환합니다.getRootNode는 Fragment 부모의 루트 노드를 반환합니다.compareDocumentPosition은 Fragment의 위치를 다른 노드와 비교합니다.scrollIntoView는 Fragment의 자식이 화면에 보이도록 스크롤합니다.
addEventListener(type, listener, options?)
Fragment의 모든 최상위 DOM 자식에 이벤트 리스너를 추가합니다.
fragmentRef.current.addEventListener('click', handleClick);매개변수
type: 수신할 이벤트 타입을 나타내는 문자열입니다(예:'click','focus').listener: 이벤트 핸들러 함수입니다.- 선택 사항
options: 캡처 여부를 지정하는 옵션 객체 또는 불리언 값으로, DOMaddEventListenerAPI와 동일합니다.
반환값
addEventListener는 아무것도 반환하지 않습니다(undefined).
removeEventListener(type, listener, options?)
Fragment의 모든 최상위 DOM 자식에서 이벤트 리스너를 제거합니다.
fragmentRef.current.removeEventListener('click', handleClick);매개변수
type: 이벤트 타입 문자열입니다.listener: 제거할 이벤트 핸들러 함수입니다.- 선택 사항
options: 옵션 객체 또는 불리언 값으로, DOMremoveEventListenerAPI와 동일합니다.
반환값
removeEventListener는 아무것도 반환하지 않습니다(undefined).
dispatchEvent(event)
Fragment에서 이벤트를 발생시킵니다. 추가된 이벤트 리스너가 호출되며, 이벤트는 Fragment의 DOM 부모로 버블링될 수 있습니다.
fragmentRef.current.dispatchEvent(new Event('custom', { bubbles: true }));매개변수
event: 발생시킬Event객체입니다.bubbles가true이면 이벤트가 Fragment의 부모 DOM 노드로 버블링됩니다.
반환값
이벤트가 취소되지 않았다면 true를, preventDefault()가 호출되었다면 false를 반환합니다.
focus(options?)
Fragment 안에서 포커스할 수 있는 첫 번째 DOM 노드에 포커스를 줍니다. DOM 엘리먼트에서 element.focus()를 호출하는 것과 달리, 이 메서드는 엘리먼트 자신이나 직접적인 자식만 확인하지 않고 포커스할 수 있는 엘리먼트를 찾을 때까지 중첩된 모든 자식을 깊이 우선으로 탐색합니다.
fragmentRef.current.focus();매개변수
- 선택 사항
options:FocusOptions객체입니다(예:{ preventScroll: true }).
반환값
focus는 아무것도 반환하지 않습니다(undefined).
focusLast(options?)
Fragment 안에서 포커스할 수 있는 마지막 DOM 노드에 포커스를 줍니다. 중첩된 자식을 깊이 우선으로 탐색한 뒤 역순으로 순회합니다.
fragmentRef.current.focusLast();매개변수
- 선택 사항
options:FocusOptions객체입니다.
반환값
focusLast는 아무것도 반환하지 않습니다(undefined).
blur()
활성 엘리먼트가 Fragment 안에 있다면 포커스를 해제합니다. document.activeElement가 Fragment 안에 없다면 blur는 아무 동작도 하지 않습니다.
fragmentRef.current.blur();반환값
blur는 아무것도 반환하지 않습니다(undefined).
observeUsing(observer)
전달한 옵저버로 Fragment의 모든 최상위 DOM 자식을 관찰하기 시작합니다.
const observer = new IntersectionObserver(callback, options);
fragmentRef.current.observeUsing(observer);매개변수
observer:IntersectionObserver또는ResizeObserver인스턴스입니다.
반환값
observeUsing은 아무것도 반환하지 않습니다(undefined).
unobserveUsing(observer)
지정한 옵저버로 Fragment의 DOM 자식을 관찰하는 것을 중지합니다.
fragmentRef.current.unobserveUsing(observer);매개변수
observer: 앞서observeUsing에 전달했던 것과 같은IntersectionObserver또는ResizeObserver인스턴스입니다.
반환값
unobserveUsing은 아무것도 반환하지 않습니다(undefined).
getClientRects()
모든 최상위 DOM 자식의 경계 사각형을 나타내는 DOMRect 객체를 하나의 평탄한 배열로 반환합니다.
const rects = fragmentRef.current.getClientRects();반환값
모든 자식의 경계 사각형을 담은 Array<DOMRect>입니다.
getRootNode(options?)
Fragment의 부모 DOM 노드를 포함하는 루트 노드를 반환하며, Node.getRootNode()와 동일하게 동작합니다.
const root = fragmentRef.current.getRootNode();매개변수
- 선택 사항
options: 불리언 값인composed프로퍼티를 가진 객체로, DOMgetRootNodeAPI와 동일합니다.
반환값
Document 또는 ShadowRoot를 반환하며, 부모 DOM 노드가 없다면 FragmentInstance 자신을 반환합니다.
compareDocumentPosition(otherNode)
Fragment와 다른 노드의 문서 내 위치를 비교하고, Node.compareDocumentPosition()과 동일하게 비트마스크를 반환합니다.
const position = fragmentRef.current.compareDocumentPosition(otherElement);매개변수
otherNode: 비교할 DOM 노드입니다.
반환값
위치 플래그로 이루어진 비트마스크입니다. 빈 Fragment와 포털을 통해 렌더링된 자식을 가진 Fragment는 결과에 Node.DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC을 포함합니다.
scrollIntoView(alignToTop?)
Fragment의 자식이 화면에 보이도록 스크롤합니다. alignToTop이 true이거나 생략되면 첫 번째 자식이 스크롤 가능한 조상 엘리먼트의 위쪽에 맞춰지도록 스크롤합니다. alignToTop이 false이면 마지막 자식이 아래쪽에 맞춰지도록 스크롤합니다.
fragmentRef.current.scrollIntoView();매개변수
- 선택 사항
alignToTop: 불리언 값입니다.true(기본값)이면 첫 번째 자식을 스크롤 영역의 위쪽으로 스크롤합니다.false이면 마지막 자식을 아래쪽으로 스크롤합니다.Element.scrollIntoView()와 달리 이 메서드는ScrollIntoViewOptions객체를 받지 않습니다.
반환값
scrollIntoView는 아무것도 반환하지 않습니다(undefined).
주의 사항
scrollIntoView는 옵션 객체를 받지 않습니다. 옵션 객체를 전달하면 오류가 발생하므로 대신 불리언 값인alignToTop을 사용하세요.- Fragment에 자식이 없으면
scrollIntoView는 대신 가장 가까운 형제나 부모가 화면에 보이도록 스크롤합니다.
FragmentInstance 주의 사항
- 자식을 대상으로 하는 메서드(
addEventListener,observeUsing,getClientRects등)는 Fragment의 최상위 호스트(DOM) 자식에서 동작합니다. 다른 DOM 엘리먼트 안에 중첩된 자식은 직접 대상으로 삼지 않습니다. - 최상위 호스트 자식만 대상으로 하는 이벤트 및 옵저버 메서드와 달리,
focus와focusLast는 중첩된 자식을 깊이 우선으로 탐색해 포커스할 수 있는 엘리먼트를 찾습니다. observeUsing은 텍스트 노드에서는 동작하지 않습니다. Fragment에 텍스트 자식만 있으면 React는 개발 환경에서 경고를 출력합니다.- React는
addEventListener로 추가한 이벤트 리스너를 숨겨진<Activity>트리에는 적용하지 않습니다.Activity경계가 숨김 상태에서 표시 상태로 바뀌면 리스너가 자동으로 적용됩니다. ref를 가진 Fragment의 각 최상위 DOM 자식에는reactFragments프로퍼티가 생깁니다. 이 프로퍼티는 해당 엘리먼트를 소유한 모든 Fragment 인스턴스를 담은Set<FragmentInstance>입니다. 이를 통해 여러 Fragment에서 공유 옵저버를 캐싱할 수 있습니다.
사용법
여러 엘리먼트 반환하기
여러 엘리먼트를 함께 그룹화하기 위해 Fragment나 <>...</> 문법을 사용하세요. 한 개의 엘리먼트가 존재할 수 있는 곳에 여러 엘리먼트를 넣을 수 있습니다. 예를 들어 컴포넌트는 한 개의 엘리먼트만 반환할 수 있지만 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 것과 동일합니다.
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>
);
}텍스트와 함께 엘리먼트 그룹화
Fragment를 사용하여 텍스트를 컴포넌트와 함께 그룹화할 수 있습니다.
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>
);
}DOM을 검사하여 Fragment 자식 주위에 래퍼 엘리먼트가 없는 것을 확인할 수 있습니다.
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> ); }
래퍼 엘리먼트 없이 이벤트 리스너 추가하기
Fragment ref를 사용하면 래퍼 DOM 노드를 추가하지 않고도 여러 엘리먼트에 이벤트 리스너를 추가할 수 있습니다. ref 콜백을 사용해 리스너를 연결하고 정리하세요.
import { Fragment, useState, useRef, useEffect } from 'react'; function ClickableFragment({ children, onClick }) { const fragmentRef = useRef(null); useEffect(() => { const fragmentInstance = fragmentRef.current; if (fragmentInstance === null) { return; } fragmentInstance.addEventListener('click', onClick); return () => { fragmentInstance.removeEventListener( 'click', onClick ); }; }, [onClick]) return ( <Fragment ref={fragmentRef}> {children} </Fragment> ); } export default function App() { const [clicks, setClicks] = useState(0); return ( <> <p>Total clicks: {clicks}</p> <ClickableFragment onClick={() => { setClicks(c => c + 1); }}> <button>Button A</button> <button>Button B</button> <button>Button C</button> </ClickableFragment> </> ); }
addEventListener를 호출하면 Fragment의 모든 최상위 DOM 자식에 리스너가 적용됩니다. 자식이 동적으로 추가되거나 제거되면 FragmentInstance가 자동으로 리스너를 추가하거나 제거합니다.
자세히 살펴보기
FragmentInstance는 Fragment의 최상위 호스트(DOM) 자식을 대상으로 합니다. 다음 트리를 살펴봅시다.
<Fragment ref={ref}>
<div id="A" />
<Wrapper>
<div id="B">
<div id="C" />
</div>
</Wrapper>
<div id="D" />
</Fragment>Wrapper는 React 컴포넌트이므로 FragmentInstance는 그 안을 들여다보며 DOM 노드를 찾습니다. 대상이 되는 자식은 A, B, D입니다. C는 DOM 엘리먼트 B 안에 중첩되어 있으므로 대상이 아닙니다.
addEventListener, observeUsing, getClientRects 같은 메서드는 이러한 최상위 DOM 자식에서 동작합니다. focus와 focusLast는 다릅니다. 이 두 메서드는 포커스할 수 있는 엘리먼트를 찾기 위해 중첩된 모든 자식을 깊이 우선으로 탐색합니다.
여러 엘리먼트에 걸쳐 포커스 관리하기
Fragment ref는 Fragment 안의 모든 DOM 노드를 대상으로 동작하는 focus, focusLast, blur 메서드를 제공합니다.
import { Fragment, useRef } from 'react'; function FormFields({ children }) { const fragmentRef = useRef(null); return ( <> <div className="buttons"> <button onClick={() => { fragmentRef.current.focus(); }}> Focus first </button> <button onClick={() => { fragmentRef.current.focusLast(); }}> Focus last </button> <button onClick={() => { fragmentRef.current.blur(); }}> Blur </button> </div> <Fragment ref={fragmentRef}> {children} </Fragment> </> ); } // input이 깊이 중첩되어 있더라도 // focus()는 깊이 우선으로 탐색해 찾아냅니다. export default function App() { return ( <FormFields> <fieldset> <legend>Shipping</legend> <label> Street: <input name="street" /> </label> <label> City: <input name="city" /> </label> </fieldset> </FormFields> ); }
focus()를 호출하면 street 입력 필드가 <fieldset>과 <label> 안에 중첩되어 있더라도 포커스를 받습니다. focus()는 Fragment의 직접적인 자식뿐 아니라 중첩된 모든 자식을 깊이 우선으로 탐색합니다. focusLast()는 같은 작업을 역순으로 수행하며, blur()는 현재 포커스된 엘리먼트가 Fragment 안에 있으면 포커스를 해제합니다.
여러 엘리먼트가 화면에 보이도록 스크롤하기
scrollIntoView를 사용하면 래퍼 엘리먼트 없이 Fragment의 자식이 화면에 보이도록 스크롤할 수 있습니다. true를 전달하거나 인수를 생략하면 첫 번째 자식을 위쪽으로 스크롤합니다. false를 전달하면 마지막 자식을 아래쪽으로 스크롤합니다.
import { Fragment, useRef } from 'react'; function ScrollableSection({ children }) { const fragmentRef = useRef(null); return ( <> <div className="buttons"> <button onClick={() => { fragmentRef.current.scrollIntoView(); }}> Scroll to top </button> <button onClick={() => { fragmentRef.current.scrollIntoView(false); }}> Scroll to bottom </button> </div> <div className="container"> <Fragment ref={fragmentRef}> {children} </Fragment> </div> </> ); } const items = []; for (let i = 1; i <= 25; i++) { items.push('Item ' + i); } export default function App() { return ( <ScrollableSection> <h3>Section Start</h3> {items.map((item) => ( <p key={item}>{item}</p> ))} <h3>Section End</h3> </ScrollableSection> ); }
래퍼 엘리먼트 없이 가시성 관찰하기
observeUsing을 사용해 Fragment의 모든 최상위 DOM 자식에 IntersectionObserver를 연결하세요. 이렇게 하면 자식 컴포넌트가 ref를 노출하거나 래퍼 엘리먼트를 추가하지 않아도 가시성을 추적할 수 있습니다.
import { Fragment, useRef, useLayoutEffect, useState, } from 'react'; import Card from './Card'; function VisibleGroup({ onVisibilityChange, children }) { const fragmentRef = useRef(null); useLayoutEffect(() => { const visibleElements = new Set(); const observer = new IntersectionObserver( (entries) => { entries.forEach(e => { if (e.isIntersecting) { visibleElements.add(e.target); } else { visibleElements.delete(e.target); } }); onVisibilityChange(visibleElements.size > 0); } ); const fragmentInstance = fragmentRef.current; fragmentInstance.observeUsing(observer); return () => { fragmentInstance.unobserveUsing(observer); }; }, [onVisibilityChange]); return ( <Fragment ref={fragmentRef}> {children} </Fragment> ); } export default function App() { const [isVisible, setIsVisible] = useState(true); return ( <div className={isVisible ? 'page visible' : 'page'}> <div className="filler">Scroll down</div> <VisibleGroup onVisibilityChange={setIsVisible}> <Card title="First section" /> <Card title="Second section" /> </VisibleGroup> <div className="filler">Scroll up</div> </div> ); }
전역 IntersectionObserver 캐싱하기
옵저버가 많은 사이트에서 흔히 쓰는 성능 최적화 기법은 설정마다 IntersectionObserver를 하나만 두고 공유하면서, 어떤 엘리먼트가 교차했는지에 따라 각 항목Entry을 알맞은 콜백으로 전달하는 것입니다. Fragment ref는 reactFragments 프로퍼티를 통해 같은 패턴을 지원합니다.
ref를 가진 Fragment의 각 최상위 DOM 자식에는 reactFragments 프로퍼티가 있으며, 이는 해당 엘리먼트를 포함하는 FragmentInstance 객체의 Set입니다. 공유 옵저버가 실행되면 이 프로퍼티로 교차한 엘리먼트를 소유한 FragmentInstance를 찾아 알맞은 콜백을 실행할 수 있습니다.
import { useState, useCallback } from 'react'; import ObservedGroup from './ObservedGroup'; import Card from './Card'; export default function App() { const [bgColor, setBgColor] = useState(null); const onGreen = useCallback((entry) => { if (entry.isIntersecting) { setBgColor('#d4edda'); } }, []); const onBlue = useCallback((entry) => { if (entry.isIntersecting) { setBgColor('#cce5ff'); } }, []); return ( <div className="page" style={{ background: bgColor || 'white', }}> <div className="filler">Scroll down</div> <ObservedGroup onIntersection={onGreen}> <Card title="Green section" className="green" /> </ObservedGroup> <div className="filler" /> <ObservedGroup onIntersection={onBlue}> <Card title="Blue section" className="blue" /> </ObservedGroup> <div className="filler">Scroll up</div> </div> ); }
옵션이 같은 여러 ObservedGroup 컴포넌트는 하나의 IntersectionObserver를 재사용합니다. 두 섹션 중 하나가 스크롤되어 화면에 들어오면 공유 옵저버가 실행되고, reactFragments를 사용해 항목을 알맞은 콜백으로 전달합니다.