localized_rich_text

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Um plugin do Flutter projetado para simplificar a localização de widgets RichText, permitindo conteúdo de texto localizado dinâmico com suporte a espaços reservados e strings formatadas. Permite que os desenvolvedores gerenciem eficientemente textos ricos multilíngues, garantindo traduções consistentes entre plataformas. O pacote se integra perfeitamente ao sistema de localização do Flutter e oferece suporte a Android, iOS e Web. É particularmente útil para aplicativos que exigem textos complexos e estilizados em múltiplos idiomas.

Casos de uso

Localizando texto rico com espaços reservados
Apoiar conteúdo multilíngue do aplicativo
Formatação dinâmica de texto em diferentes idiomas
Integração com o sistema de localização do Flutter
Exibindo texto formatado em vários locais

Principais recursos

Suporte a espaços reservados em texto rico localizado
Integração perfeita com localização do Flutter
Manipula texto formatado entre idiomas
Compatibilidade multiplataforma (Android, iOS, Web)
API simples para localização de texto rico

Indicado para

Aplicativos com conteúdo rico em texto multilíngue
Desenvolvedores usando o framework de localização do Flutter
Projetos que exigem formatação de texto dinâmica
Equipes gerenciando traduções em grande escala
Aplicações web e móveis que precisam de localização de interface consistente

Considerações

Requer um setup adequado da localização do Flutter
Limitado a cenários de texto rico
Depende da estrutura correta do arquivo de tradução
Pode ser necessário tratamento adicional para widgets aninhados complexos
Não adequado para conteúdo não rico em texto

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

A flutter plugin to facilitate the localization of a RichText.

Getting started

Install the library in your pubspec.yaml.

dependencies:
  localized_rich_text: ^0.0.7

Usage

final textToLocalize = "Hi #name, how are you?";
final userName = "Jhon";

final textSpanProperties = TextSpanProperties(
    recognizer: TapGestureRecognizer()
      ..onTap = () {
        //Do something
      },
  );
...
LocalizedRichText(
  text: textToLocalize,
  defaultTextStyle: Theme.of(context).textTheme.bodyText1!,
  keys: [
    LocalizedRichTextKey(
      key: '#name',
      value: userName,
      textStyle: Theme.of(context).textTheme.subtitle1!,
      textSpanProperties: textSpanProperties,
    ),
  ],
)

Parameters explanation

text

This must be the String to localize.
The dynamic values inside the text have to be unique, you can mark them with a special character, or you can use a unique value.

The string could be:

final textToLocalize = "Hi #name, how are you?";

AppLocalizations.of(context)!.title,

For more info about internationalization you can check the flutter documentation.

defaultTextStyle

This is the TextStyle used for the static words.

keys

This is the List that has to contain the dynamic values.
Each dynamic value has to be passed like an LocalizedRichTextKey object.
This list cannot be empty.

The keys will be ordered by the order in which they are been inserted in the String to localize.
This means that the order in which you pass the keys inside the keys array isn't important.

LocalizedRichText(
  ...,
  keys: [
    LocalizedRichTextKey(
      key: '#name',
      value: userName,
      textStyle: Theme.of(context).textTheme.subtitle1!,
    ),
  ],
)

Buscar pacotes, repositórios e categorias de apps

Instalar pacote