Documentation: getHTMLTextDir 함수 in intlayer

    설명:

    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 속성은 로케일에 따라 동적으로 설정됩니다.

    이 문서를 개선할 아이디어가 있으시면 GitHub에 풀 리퀘스트를 제출하여 자유롭게 기여해 주세요.

    문서에 대한 GitHub 링크