Paketdetailsv1.0.0+1

html_character_entities

Eine Hilfsklasse, die Karten aller HTML-4.01-Zeichenentitäten enthält, einschließlich ASCII- und Hex-Codes, sowie Methoden zum Codieren/Decodieren von Zeichenfolgen mit diesen Zeichenentitäten.

AndroidiOSWebmacOSWindowsLinux

pub.dev API-Dokumentation Quellcode

30-Tage-Downloads: 43
Likes: 21
Pub-Punkte: 150

Paket installieren

flutter pub add html_character_entities

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Ein Flutter/Dart-Utility-Paket, das umfassende Zuordnungen von HTML-4.01-Zeichenentitäten, einschließlich ASCII- und Hexadezimalcodes, bereitstellt. Es bietet Methoden zum Codieren und Dekodieren von Zeichenfolgen unter Verwendung dieser Entitäten, um eine genaue Handhabung von Sonderzeichen in Webinhalten sicherzustellen. Ideal für Entwickler, die mit der Verarbeitung, Darstellung oder Datenaustausch von HTML-Text arbeiten, bei denen die Genauigkeit der Zeichencodierung entscheidend ist. Das Paket unterstützt alle wichtigen Plattformen und wird mit klarem Zugriff auf den Quellcode gepflegt.

Anwendungsfälle

HTML-Inhalt mit Sonderzeichen rendern
Konvertieren von Text zwischen einfachen und codierten Formaten
Umgang mit veralteten HTML-Daten
Säuberung von Benutzereingaben für Web-Ausgabe
Formatierung bei Textexporten beibehalten

Hauptmerkmale

Vollständige HTML-4.01-Entitätszuordnung
Unterstützung für ASCII- und Hex-Codes
String-Encoding/Decoding-Hilfsmittel
Plattformübergreifende Kompatibilität
Open Source und gut dokumentiert
Einfache Integration über pub

Geeignet für

Webentwickler, die Flutter verwenden
Inhaltsrenderungsanwendungen
Textverarbeitungswerkzeuge
Veraltete Systemintegrationen
Bildungprojekte zu HTML-Codierung

Hinweise

Beschränkt auf HTML-4.01-Standards
Keine Unterstützung für HTML5-spezifische Entitäten
Benötigt manuelle Behandlung fehlerhafter Eingaben
Nicht für Hochfrequenz-Encoding-Szenarien optimiert
Abhängig von der externen Wartung von Entitätenlisten

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

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 &amp; and &#38;.';

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 ¥ is in the map as ¥. 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;).