Hàm getHTMLTextDir xác định hướng văn bản (ltr, rtl, hoặc auto) dựa trên locale được cung cấp. Hàm này được thiết kế để giúp các nhà phát triển thiết lập thuộc tính dir trong HTML nhằm hiển thị văn bản đúng cách.

Tham số

locale?: Locales
- Mô tả: Chuỗi locale (ví dụ: Locales.ENGLISH, Locales.ARABIC) được sử dụng để xác định hướng văn bản.
- Kiểu: Locales (tùy chọn)

Giá trị trả về

Kiểu: Dir ('ltr' | 'rtl' | 'auto')
Mô tả: Hướng văn bản tương ứng với locale:
- 'ltr' cho các ngôn ngữ viết từ trái sang phải.
- 'rtl' cho các ngôn ngữ viết từ phải sang trái.
- 'auto' nếu locale không được nhận diện.

Ví dụ sử dụng

Xác định hướng văn bản

typescript

Sao chép mã

Sao chép mã vào clipboard

import { getHTMLTextDir } from "intlayer";

getHTMLTextDir(Locales.ENGLISH); // Kết quả: "ltr"
getHTMLTextDir(Locales.FRENCH); // Kết quả: "ltr"
getHTMLTextDir(Locales.ARABIC); // Kết quả: "rtl"

Các trường hợp đặc biệt

Không cung cấp Locale:
- Hàm trả về 'auto' khi locale là undefined.
Locale không được nhận diện:
- Với các locale không được nhận diện, hàm mặc định trả về 'auto'.

Sử dụng trong Components:

Hàm getHTMLTextDir có thể được sử dụng để thiết lập thuộc tính dir trong tài liệu HTML một cách động nhằm hiển thị văn bản đúng hướng dựa trên locale.

tsx

Sao chép mã

Sao chép mã vào clipboard

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>
);

Trong ví dụ trên, thuộc tính dir được thiết lập động dựa trên locale.

Tại sao Intlayer?

Lịch sử phiên bản

Tài liệu: Hàm getHTMLTextDir trong intlayer

Mô tả