Documentation: getHTMLTextDir Função em intlayer
Descrição:
A função getHTMLTextDir determina a direção do texto (ltr, rtl ou auto) com base no local fornecido. Ela foi projetada para ajudar os desenvolvedores a definir o atributo dir em HTML para renderização adequada do texto.
Parâmetros:
locale?: Locales
- Descrição: A string de localidade (por exemplo, Locales.ENGLISH, Locales.ARABIC) usada para determinar a direção do texto.
- Tipo: Locales (opcional)
Retornos:
- Tipo: Dir ('ltr' | 'rtl' | 'auto')
- Descrição: A direção do texto correspondente à localidade:
- 'ltr' para idiomas da esquerda para a direita.
- 'rtl' para idiomas da direita para a esquerda.
- 'auto' se a localidade não for reconhecida.
Exemplo de Uso:
Determinando a Direção do Texto:
typescript
import { getHTMLTextDir } from "intlayer";
getHTMLTextDir(Locales.ENGLISH); // Saída: "ltr"
getHTMLTextDir(Locales.FRENCH); // Saída: "ltr"
getHTMLTextDir(Locales.ARABIC); // Saída: "rtl"
Casos Limite:
Nenhuma Localidade Fornecida:
- A função retorna 'auto' quando locale é undefined.
Localidade Não Reconhecida:
- Para localidades não reconhecidas, a função padrão é 'auto'.
Uso em Componentes:
A função getHTMLTextDir pode ser usada para definir dinamicamente o atributo dir em um documento HTML para renderização adequada do texto com base na localidade.
tsx
import { getHTMLTextDir } from "intlayer";
export const HTMLLayout = ({ children, locale }) => (
<html dir={getHTMLTextDir(locale)} locale={locale}>
<body>{children}</body>
</html>
);
No exemplo acima, o atributo dir é definido dinamicamente com base na localidade.
Se você tiver uma ideia para melhorar esta documentação, sinta-se à vontade para contribuir enviando uma pull request no GitHub.
Link do GitHub para a documentação