dart:convert

Класс HtmlEscape

Преобразователь, экранирующий символы, имеющие специальное значение в HTML.

Преобразователь находит символы, значимые в исходном коде HTML, и заменяет их соответствующими HTML-сущностями.

В HTML необходимо экранировать следующие символы:

• & (амперсанд) всегда необходимо экранировать.
• < (знак «меньше») и > (знак «больше») внутри элемента.
• " (кавычка) внутри значения атрибута, заключённого в двойные кавычки.
• ' (апостроф) внутри значения атрибута, заключённого в одинарные кавычки. Апостроф экранируется как ', а не как ', поскольку не все браузеры понимают '.
• / (косая черта) рекомендуется экранировать, поскольку в некоторых диалектах HTML она может использоваться для завершения элемента.

Экранировать > (знак «больше») необязательно, но результат часто легче читать, если знак «больше» экранируется каждый раз, когда экранируется знак «меньше».

Пример:

const HtmlEscape htmlEscape = HtmlEscape();
String unescaped = 'Text & subject';
String escaped = htmlEscape.convert(unescaped);
print(escaped); // Text & subject

unescaped = '10 > 1 and 1 < 10';
escaped = htmlEscape.convert(unescaped);
print(escaped); // 10 &gt; 1 and 1 &lt; 10

unescaped = "Single-quoted: 'text'";
escaped = htmlEscape.convert(unescaped);
print(escaped); // Single-quoted: &#39;text&#39;

unescaped = 'Double-quoted: "text"';
escaped = htmlEscape.convert(unescaped);
print(escaped); // Double-quoted: &quot;text&quot;

unescaped = 'Path: /system/';
escaped = htmlEscape.convert(unescaped);
print(escaped); // Path: &#47;system&#47;

Наследование

• Object
• StreamTransformerBase<String, String>
• Converter<String, String>
• HtmlEscape

Конструкторы

HtmlEscape([HtmlEscapeMode mode = HtmlEscapeMode.unknown])

const

Создаёт преобразователь, экранирующий символы HTML.

Свойства

hashCode → int

только чтениеунаследовано

Хеш-код этого объекта.

mode → HtmlEscapeMode

final

HtmlEscapeMode, используемый преобразователем.

runtimeType → Type

только чтениеунаследовано

Представление типа объекта во время выполнения.

Методы

bind(Stream<String> stream) → Stream<String>

унаследовано

Преобразует переданный stream.

cast<RS, RT>() → Converter<RS, RT>

унаследовано

Предоставляет Converter<RS, RT> представление этого преобразователя потока.

convert(String text) → String

переопределение

Преобразует input и возвращает результат преобразования.

fuse<TT>(Converter<String, TT> other) → Converter<String, TT>

унаследовано

Объединяет this с other.

noSuchMethod(Invocation invocation) → dynamic

унаследовано

Вызывается при обращении к несуществующему методу или свойству.

startChunkedConversion(Sink<String> sink) → StringConversionSink

переопределение

Начинает порционное преобразование.

toString() → String

унаследовано

Строковое представление этого объекта.

Операторы

operator ==(Object other) → bool

унаследовано

Оператор равенства.