ドキュメント: 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リンク