<title> - This feature is available in the latest Canary

Canary

React의 <title> 확장은 현재 React의 카나리(Canary) 버전 및 실험 채널에서만 사용할 수 있습니다. React의 안정적인 릴리즈에서는 <title>내장 브라우저 HTML 컴포넌트로만 작동합니다. 여기에서 React 릴리즈 채널에 대해 자세히 알아보십시오.

내장된 브라우저 <title> 컴포넌트를 사용하면 문서의 제목을 지정할 수 있습니다.

<title>My Blog</title>

레퍼런스

<title>

문서의 제목을 지정하려면 내장된 브라우저 <title> 컴포넌트를 렌더링하십시오. <title>은 어떤 컴포넌트에서든 렌더링할 수 있으며, React는 항상 해당하는 DOM 요소를 문서의 헤드에 배치합니다.

<title>My Blog</title>

아래에서 더 많은 예시를 확인하세요.

Props

<title>모든 컴포넌트 속성을 지원합니다.

  • children: <title>은 자식으로 텍스트만 허용합니다. 이 텍스트는 문서의 제목이 됩니다. 텍스트만 렌더링하는 한, 사용자 정의 컴포넌트도 전달할 수 있습니다.

특별한 렌더링 동작

React는 <title> 컴포넌트에 해당하는 DOM 요소를 React 트리 내 어디에서 렌더링하든 항상 문서의 <head> 내에 배치합니다. <head>는 DOM 내에서 <title>이 존재할 수 있는 유일한 위치이지만, 특정 페이지를 나타내는 컴포넌트가 자체적으로 <title>을 렌더링할 수 있으면 편리하고 구성 가능하게 유지됩니다.

여기에는 두 가지 예외가 있습니다.

  • <title><svg> 컴포넌트 내에 있는 경우, 특별한 동작이 없습니다. 이 context에서는 문서의 제목을 나타내는 것이 아니라 해당 SVG 그래픽에 대한 접근성 주석이기 때문입니다.
  • <title>itemProp 속성이 있는 경우, 특별한 동작이 없습니다. 이 경우 문서의 제목이 아니라 페이지의 특정 부분에 대한 메타데이터를 나타내기 때문입니다.

주의하세요!

한 번에 하나의 <title>만 렌더링하십시오. 여러 구성 요소가 동시에 <title> 태그를 렌더링하면 React는 모든 제목을 문서의 헤드에 배치합니다. 이렇게 되면 브라우저와 검색 엔진의 동작이 정의되지 않습니다.


사용법

문서 제목 설정하기

텍스트를 자식으로 갖는 <title> 컴포넌트를 어떤 컴포넌트에서도 렌더링할 수 있습니다. React는 문서의 <head><title> DOM 노드를 배치합니다.

import ShowRenderedHTML from './ShowRenderedHTML.js';

export default function ContactUsPage() {
  return (
    <ShowRenderedHTML>
      <title>My Site: Contact Us</title>
      <h1>Contact Us</h1>
      <p>Email us at support@example.com</p>
    </ShowRenderedHTML>
  );
}

제목에 변수 사용하기

<title> 컴포넌트의 자식은 단일 텍스트 문자열이어야 합니다. (또는 단일 숫자나 toString 메서드를 가진 단일 객체). JSX 중괄호를 다음과 같이 사용하면 명확하지 않을 수 있습니다.

<title>Results page {pageNumber}</title> // 🔴 Problem: This is not a single string

… 실제로는 <title> 컴포넌트에 두 개의 요소로 구성된 배열이 자식으로 전달됩니다 (문자열 "Results page"pageNumber의 값). 이는 오류를 발생시킵니다. 대신에 문자열 보간을 사용하여 <title>에 단일 문자열을 전달하십시오

<title>{`Results page ${pageNumber}`}</title>