서식 있는 텍스트 메시지
링크 대상과 리액트 동작은 애플리케이션 코드에 그대로 두고, 문장은 통째로 번역하세요.
링크는 문장 안에 들어가는 경우가 많습니다. 링크 앞뒤의 문구와 링크 안의 문구를 따로 번역하면 원문의 어순에 얽매이게 됩니다. l.rich를 사용하면 문장 전체를 번역할 수 있고, 번역된 템플릿에서 이름이 지정된 리액트 요소를 알맞은 위치에 배치할 수 있습니다.
문장을 하나로 유지하기 #
import { useLingo } from "@lingo.dev/react";
export function PurchaseNotice({ product }: { product: string }) {
const l = useLingo();
return (
<p>
{l.rich("Read the <link>refund policy</link> before buying {product}.", {
context: "Purchase notice linking to the refund policy",
values: { product },
tags: {
link: (children) => <a href="/refund-policy">{children}</a>,
},
})}
</p>
);
}이 컴포넌트를 공급자 하위에 렌더링하세요. l.text와 마찬가지로 원문과 컨텍스트에 따라 카탈로그 항목이 선택됩니다. 번역된 템플릿은 문구와 태그 위치를 결정하고, 콜백은 링크 대상, 속성, 스타일, 동작을 제공합니다.
l.rich는 ReactNode를 반환합니다. 해당 RichOptions에는 context가 필수이며, 문자열이나 숫자를 값으로 갖는 values 맵과 tags: Record<string, (children: ReactNode) => ReactNode>를 전달할 수 있습니다. 태그 이름은 정확히 일치해야 하므로 <link>에는 link 콜백이 필요합니다.
자식이 없는 요소 삽입하기 #
자체 닫힘 태그는 자식으로 null를 전달해 렌더러를 호출합니다. 예를 들어 다음 확인 메시지는 메시지 뒤에 장식용 아이콘을 배치합니다.
const confirmation = l.rich("Saved <icon/>", {
context: "Confirmation that account settings were saved",
tags: {
icon: () => <span aria-hidden="true">✓</span>,
},
});여기서 l는 컴포넌트의 useLingo() 결과입니다. <icon/>와 <icon /> 모두 지원됩니다. 요소를 중첩할 때는 <link><strong>refund policy</strong></link>처럼 서로 다른 이름을 사용하고 두 콜백을 모두 제공하세요. 파서는 다음에 나오는 이름이 일치하는 닫는 태그를 사용합니다. 같은 이름의 태그를 반복해서 중첩하는 방식은 여는 태그와 닫는 태그가 올바르게 짝을 이루는 HTML 구조로 처리되지 않습니다.
문구와 함께 번역된 태그도 확인하기 #
쌍을 이루는 태그나 자체 닫힘 태그에 콜백이 없으면 태그가 그대로 텍스트로 남습니다. 짝이 맞는 닫는 태그가 없는 여는 태그도 그대로 남습니다. 덕분에 메시지를 렌더링할 수는 있지만, 독자에게 작동하는 링크 대신 <link>가 보일 수 있습니다.
실제 콜백으로 번역된 템플릿을 테스트하세요. 링크 텍스트와 href를 검증하고, 태그가 누락된 사례도 포함해 의도치 않은 마크업을 개발 중에 발견할 수 있도록 하세요. 렌더링 테스트에는 번역 요청이 필요하지 않습니다.
지원되는 마크업은 이름이 지정된 태그이며, 임의의 HTML은 지원되지 않습니다. 속성은 번역문에 직접 작성하지 말고 콜백에 넣으세요. 짝이 맞지 않는 태그를 처리하는 데 dangerouslySetInnerHTML를 사용하면 이러한 역할 구분이 무너집니다.
서식 있는 메시지에 단순한 값 사용하기 #
서식 있는 텍스트는 텍스트 구간의 단순한 {name} 값을 치환합니다. l.text에서 사용하는 복잡한 ICU 포매터는 실행하지 않습니다. 수량에 따라 문법이 달라지는 경우 복수형과 선택 구문을 사용하거나, 지원되는 서식 표현으로 나타낼 수 있는 문법적으로 완전한 메시지를 중심으로 인터페이스를 구성하세요. 서식 있는 템플릿에 ICU 복수형 구문을 그대로 넣어도, 중괄호가 있다는 이유만으로 복수형 처리가 적용되지는 않습니다.