Intlayer의 향후 출시 예정에 대한 알림을 받으세요
    생성:2024-08-11마지막 업데이트:2025-06-29

    문서: intlayergetHTMLTextDir 함수

    설명

    getHTMLTextDir 함수는 제공된 로케일을 기반으로 텍스트 방향(ltr, rtl, 또는 auto)을 결정합니다. 이 함수는 개발자가 올바른 텍스트 렌더링을 위해 HTML의 dir 속성을 설정하는 데 도움을 주도록 설계되었습니다.

    매개변수

    • locale?: Locales

      • 설명: 텍스트 방향을 결정하는 데 사용되는 로케일 문자열(예: Locales.ENGLISH, Locales.ARABIC).
      • 타입: Locales (선택 사항)

    반환값

    • 타입: Dir ('ltr' | 'rtl' | 'auto')
    • 설명: 로케일에 해당하는 텍스트 방향:
      • 왼쪽에서 오른쪽으로 읽는 언어는 'ltr'.
      • 오른쪽에서 왼쪽으로 읽는 언어는 'rtl'.
      • 인식되지 않는 로케일의 경우 'auto'.

    사용 예시

    텍스트 방향 결정

    typescript
    import { getHTMLTextDir } from "intlayer";getHTMLTextDir(Locales.ENGLISH); // 출력: "ltr"getHTMLTextDir(Locales.FRENCH); // 출력: "ltr"getHTMLTextDir(Locales.ARABIC); // 출력: "rtl"

    예외 상황

    • 로케일이 제공되지 않은 경우:

      • localeundefined일 때 함수는 'auto'를 반환합니다.
    • 인식되지 않는 로케일:

      • 인식되지 않는 로케일의 경우, 함수는 기본값으로 'auto'를 반환합니다.

    컴포넌트에서의 사용법:

    getHTMLTextDir 함수는 로케일에 따라 올바른 텍스트 렌더링을 위해 HTML 문서의 dir 속성을 동적으로 설정하는 데 사용할 수 있습니다.

    tsx
    import type { FC } from "react";import { getHTMLTextDir, type Locales } from "intlayer";export const HTMLLayout: FC<PropsWithChildren<{ locale: Locales }>> = ({  children,  locale,}) => (  <html dir={getHTMLTextDir(locale)} locale={locale}>    <body>{children}</body>  </html>);

    위 예제에서 dir 속성은 로케일에 따라 동적으로 설정됩니다.

    문서 이력

    • 5.5.10 - 2025-06-29: 초기 이력
    Intlayer의 향후 출시 예정에 대한 알림을 받으세요