Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev1.0.0+1

html_character_entities

Uma classe utilitária contendo mapas de todas as entidades de caracteres HTML 4.01, incluindo códigos ASCII e hexadecimais, e métodos para codificar/decodificar strings com essas entidades de caracteres.

AndroidiOSWebmacOSWindowsLinux
Downloads em 30 dias
82
Curtidas
21
Pontos Pub
150

Instalar pacote

flutter pub add html_character_entities

Visão geral do pacote

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

Um pacote de utilitários Flutter/Dart que fornece mapeamentos abrangentes de entidades de caracteres HTML 4.01, incluindo códigos ASCII e hexadecimais. Oferece métodos para codificar e decodificar strings usando essas entidades, garantindo um tratamento preciso de caracteres especiais em conteúdo web. Ideal para desenvolvedores trabalhando com processamento de texto HTML, renderização ou troca de dados onde a precisão na codificação de caracteres é crítica. O pacote suporta todas as principais plataformas e é mantido com acesso claro ao código-fonte.

Casos de uso

  • Renderização de conteúdo HTML com caracteres especiais
  • Convertendo texto entre formatos simples e codificados
  • Manipulação de dados HTML legados
  • Sanitização de entrada do usuário para saída da web
  • Preservando formatação em exportações de texto

Principais recursos

  • Mapeamento completo de entidades HTML 4.01
  • Suporte para códigos ASCII e hexadecimais
  • Ferramentas de codificação/descodificação de string
  • Compatibilidade multiplataforma
  • Open-source e bem documentado
  • Integração fácil por meio do pub

Indicado para

  • Desenvolvedores web usando Flutter
  • Aplicações de renderização de conteúdo
  • Ferramentas de processamento de texto
  • Integrações de sistema legado
  • Projetos educacionais sobre codificação HTML

Considerações

  • Limitado aos padrões HTML 4.01
  • Sem suporte para entidades específicas do HTML5
  • Requer manipulação manual de entradas malformadas
  • Não otimizado para cenários de codificação de alta frequência
  • Depende da manutenção externa das listas de entidades

README original

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

html_character_entities

A Dart utility class containing maps of key/value pairs for every HTML 4.01 character entity, including ASCII and hex codes, and methods to encode and decode strings to and from those character entities.

Usage

import 'package:html_character_entities/html_character_entities.dart';

Decoding Strings

The decode method accepts a string as an argument and returns it after replacing every character entity with their corresponding characters.

String string = 'An ampersand can be written as & and &.';

print(HtmlCharacterEntities.decode(string)); // An ampersand can be written as & and &.

Encoding Strings

The encode() method has an argument, [characters], that accepts a string of all characters that should be encoded. It defaults to the 5 reserved characters in both HTML and XML: less-than (<), greater-than (>), ampersand (&), apostrophe or single quote ('), and double-quote (").

String string = '<, >, &, \', and " aren\'t safe to use in HTML and XML.';

print(HtmlCharacterEntities.encode(string));
// &lt;, &gt;, &amp;, &apos;, and &quot; aren&apos;t safe to use in HTML and XML.

print(HtmlCharacterEntities.encode(string, characters: 'XHTML'));
// <, >, &, ', and " aren't safe to use in &#72;&#84;&#77;&#76; and &#88;&#77;&#76;.

If [characters] is null, every character in the HtmlCharacterEntities.characters map will be encoded.

Maps

A map of every HTML 4.01 character code, as well as their ASCII and hex code entities can be referenced from HtmlCharacterEntities.characters.

Note: The hex codes in the map don't have leading 0s. I.e. the hex code &#x0000a5; is in the map as &#xa5;. When decoding hex code entities, the leading 0s will be removed by the parser before being looked up.

Map<String, String> c = HtmlCharacterEntities.characters;

String string = 'There are 4 suites of cards: ${c['&spades;']} Spades, ${c['&clubs;']} Clubs, ${c['&hearts;']} Hearts, ${c['&diams;']} Diamonds';

print(string); // There are 4 suites of cards: ♠ Spades, ♣ Clubs, ♥ Hearts, ♦ Diamonds

Maps containing the characters with their respective character codes as values can also be referenced. They are used by the encode method.

// A map with only ASCII code character entities as values.
Map<String, String> ascii = HtmlCharacterEntities.asciiCodes;

// A map with all non-ASCII code character entities as values.
Map<String, String> entity = HtmlCharacterEntities.entities;

String string = '< and > exist as both ASCII codes (${ascii['<']} and ${ascii['>']}) and character entities (${entity['<']} and ${entity['>']}).';

print(string); // < and > exist as both ASCII codes (&#60; and &#62;) and character entities (&lt; and &gt;).

Categorias

Repositório-fonte

Projetos que usam este pacote