Класс MinimalHTMLWriter

java.lang.Object

javax.swing.text.AbstractWriter

javax.swing.text.html.MinimalHTMLWriter

public class MinimalHTMLWriter extends AbstractWriter

MinimalHTMLWriter — это резервный writer, используемый HTMLEditorKit для записи HTML для документа, который не создаётся EditorKit. Формат документа:

 <html>
   <head>
     <style>
        <!-- list of named styles
         p.normal {
            font-family: SansSerif;
            margin-height: 0;
            font-size: 14
         }
        -->
      </style>
   </head>
   <body>
    <p style=normal>
        Bold, italic, and underline attributes
        of the run are emitted as HTML tags.
        The remaining attributes are emitted as
        part of the style attribute of a <span> tag.
        The syntax is similar to inline styles.
    </p>
   </body>
 </html>

Краткое описание полей

Поля, объявленные в классе javax.swing.text.AbstractWriter

NEWLINE

Краткое описание конструкторов

Конструктор	Описание
`MinimalHTMLWriter(Writer w, StyledDocument doc)`	Создаёт новый MinimalHTMLWriter.
`MinimalHTMLWriter(Writer w, StyledDocument doc, int pos, int len)`	Создаёт новый MinimalHTMLWriter.

Краткое описание методов

Модификатор и тип	Метод	Описание
`protected void`	`endFontTag()`	Этот метод больше не используется, вместо него будет выведено <span>.
`protected boolean`	`inFontTag()`	Возвращает true, если мы находимся внутри тега <font>.
`protected boolean`	`isText(Element elem)`	Возвращает true, если элемент является текстовым элементом.
`protected void`	`startFontTag(String style)`	Этот метод больше не используется, вместо него будет выведено <span>.
`protected void`	`text(Element elem)`	Выводит текст.
`void`	`write()`	Генерирует HTML-вывод из StyledDocument.
`protected void`	`writeAttributes(AttributeSet attr)`	Выводит все атрибуты для следующих типов: StyleConstants.ParagraphConstants, StyleConstants.CharacterConstants, StyleConstants.FontConstants, StyleConstants.ColorConstants.
`protected void`	`writeBody()`	Итерируется по элементам документа и обрабатывает элементы в зависимости от того, являются ли они элементами ветви или листа.
`protected void`	`writeComponent(Element elem)`	Ответственен за обработку элементов Component; преднамеренно не реализован.
`protected void`	`writeContent(Element elem, boolean needsIndenting)`	Выводит набор атрибутов в соответствии со стандартами HTML.
`protected void`	`writeEndParagraph()`	Выводит закрывающий тег для тега <p>.
`protected void`	`writeEndTag(String endTag)`	Выводит закрывающий тег с соответствующим отступом.
`protected void`	`writeHeader()`	Выводит теги <head> и <style>, а затем вызывает writeStyles() для вывода всех именованных стилей в качестве содержимого тега <style>.
`protected void`	`writeHTMLTags(AttributeSet attr)`	Генерирует теги <b>, <i> и <u> для текста на основе настроек его атрибутов.
`protected void`	`writeImage(Element elem)`	Ответственен за обработку элементов Icon; преднамеренно не реализован.
`protected void`	`writeLeaf(Element elem)`	Ответственен за вывод других нетекстовых листовых элементов.
`protected void`	`writeNonHTMLAttributes(AttributeSet attr)`	Выводит оставшиеся атрибуты уровня символов (атрибуты, отличные от bold, italic и underline) в соответствии со стандартами HTML.
`protected void`	`writeStartParagraph(Element elem)`	Выводит открывающий тег для абзаца.
`protected void`	`writeStartTag(String tag)`	Выводит открывающий тег с соответствующим отступом.
`protected void`	`writeStyles()`	Выводит все именованные стили в качестве содержимого тега <style>.

Методы, объявленные в классе javax.swing.text.AbstractWriter

decrIndent, getCanWrapLines, getCurrentLineLength, getDocument, getElementIterator, getEndOffset, getIndentLevel, getIndentSpace, getLineLength, getLineSeparator, getStartOffset, getText, getWriter, incrIndent, indent, inRange, isLineEmpty, output, setCanWrapLines, setCurrentLineLength, setIndentSpace, setLineLength, setLineSeparator, write, write, write, writeLineSeparator

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

MinimalHTMLWriter

public MinimalHTMLWriter(Writer w, StyledDocument doc)

Создаёт новый MinimalHTMLWriter.

Параметры:: w - Поток записи; doc - StyledDocument

MinimalHTMLWriter

public MinimalHTMLWriter(Writer w, StyledDocument doc, int pos, int len)

Создаёт новый MinimalHTMLWriter.

Параметры:: w - Поток записи; doc - StyledDocument; pos - Позиция в документе для извлечения содержимого.; len - Количество для записи.

Подробное описание методов

write

public void write() throws IOException, BadLocationException

Генерирует HTML-вывод из StyledDocument.

Указано в:: write в классе AbstractWriter
Исключения:: IOException - при любой ошибке ввода-вывода; BadLocationException - если pos представляет недействительное местоположение в документе.

writeAttributes

protected void writeAttributes(AttributeSet attr) throws IOException

Записывает все атрибуты для следующих типов: StyleConstants.ParagraphConstants, StyleConstants.CharacterConstants, StyleConstants.FontConstants, StyleConstants.ColorConstants. Имя и значение атрибута разделяются двоеточием. Каждая пара разделена точкой с запятой.

Переопределяет:: writeAttributes в классе AbstractWriter
Параметры:: attr - AttributeSet.
Исключения:: IOException - при любой ошибке ввода-вывода

text

protected void text(Element elem) throws IOException, BadLocationException

Записывает текст.

Переопределяет:: text в классе AbstractWriter
Параметры:: elem - Element.
Исключения:: IOException - при любой ошибке ввода-вывода; BadLocationException - если pos представляет недействительное местоположение в документе.

writeStartTag

protected void writeStartTag(String tag) throws IOException

Записывает открывающий тег с правильным отступом. Также увеличивает уровень отступа.

Параметры:: tag - открывающий тег
Исключения:: IOException - при любой ошибке ввода-вывода

writeEndTag

protected void writeEndTag(String endTag) throws IOException

Записывает закрывающий тег с правильным отступом. Также уменьшает уровень отступа.

Параметры:: endTag - закрывающий тег
Исключения:: IOException - при любой ошибке ввода-вывода

writeHeader

protected void writeHeader() throws IOException

Записывает теги <head> и <style>, а затем вызывает writeStyles() для записи всех именованных стилей как содержимого тега <style>. Содержимое окружено допустимыми маркерами HTML-комментариев для обеспечения отображения документа в приложениях/браузерах, которые не поддерживают тег.

Исключения:: IOException - при любой ошибке ввода-вывода

writeStyles

protected void writeStyles() throws IOException

Записывает все именованные стили как содержимое тега <style>.

Исключения:: IOException - при любой ошибке ввода-вывода

writeBody

protected void writeBody() throws IOException, BadLocationException

Итерируется по элементам в документе и обрабатывает элементы в зависимости от того, являются ли они элементами ветвления или листовыми элементами. Этот метод специально обрабатывает листовые элементы, которые являются текстом.

Исключения:: IOException - при любой ошибке ввода-вывода; BadLocationException - если мы находимся в недопустимом местоположении в документе.

writeEndParagraph

protected void writeEndParagraph() throws IOException

Выводит закрывающий тег для тега <p>. Перед записью тега этот метод гарантирует, что все другие открытые теги корректно закрываются.

Исключения:: IOException - при любой ошибке ввода-вывода

writeStartParagraph

protected void writeStartParagraph(Element elem) throws IOException

Выводит открывающий тег для абзаца. Если у абзаца связан именованный стиль, то этот метод также генерирует атрибут класса для тега <p> и устанавливает его значение в имя стиля.

Параметры:: elem - элемент
Исключения:: IOException - при любой ошибке ввода-вывода

writeLeaf

protected void writeLeaf(Element elem) throws IOException

Ответственный за запись других листовых элементов, не являющихся текстом.

Параметры:: elem - элемент
Исключения:: IOException - при любой ошибке ввода-вывода

writeImage

protected void writeImage(Element elem) throws IOException

Ответственный за обработку элементов Icon; намеренно не реализован. Как реализовать этот метод - вопрос политики. Например, если вы генерируете тег <img>, как вы должны представить атрибут src (местоположение изображения)? В некоторых случаях это может быть URL, в других - он может считываться из потока.

Параметры:: elem - элемент типа StyleConstants.IconElementName
Исключения:: IOException - если произошла ошибка ввода-вывода.

writeComponent

protected void writeComponent(Element elem) throws IOException

Ответственный за обработку элементов Component; намеренно не реализован. Как реализовать этот метод - вопрос политики.

Параметры:: elem - элемент типа StyleConstants.ComponentElementName
Исключения:: IOException - если произошла ошибка ввода-вывода.

isText

protected boolean isText(Element elem)

Возвращает true, если элемент является текстовым элементом.

Параметры:: elem - элемент
Возвращает:: true true, если элемент является текстовым элементом.

writeContent

protected void writeContent(Element elem, boolean needsIndenting) throws IOException, BadLocationException

Записывает набор атрибутов в соответствии с HTML.

Параметры:: elem - элемент; needsIndenting - отступ будет добавлен, если needsIndenting является true
Исключения:: IOException - при любой ошибке ввода-вывода; BadLocationException - если pos представляет недействительное местоположение в документе.

writeHTMLTags

protected void writeHTMLTags(AttributeSet attr) throws IOException

Генерирует теги <b>, <i> и <u> для текста на основе настроек атрибута.

Параметры:: attr - набор атрибутов
Исключения:: IOException - при любой ошибке ввода-вывода

writeNonHTMLAttributes

protected void writeNonHTMLAttributes(AttributeSet attr) throws IOException

Записывает оставшиеся атрибуты уровня символов (атрибуты, кроме bold, italic и underline) в соответствии с HTML. Учитывая, что такие атрибуты, как семейство шрифтов и размер шрифта, не имеют прямого соответствия HTML-тегам, генерируется тег <span>, атрибут style которого содержит список оставшихся атрибутов, как и встроенные стили.

Параметры:: attr - набор атрибутов
Исключения:: IOException - при любой ошибке ввода-вывода

inFontTag

protected boolean inFontTag()

Возвращает true, если мы находимся внутри тега <font>.

Возвращает:: true true, если мы находимся внутри тега <font>.

endFontTag

protected void endFontTag() throws IOException

Этот метод больше не используется, вместо него будет выводиться <span>.

Выводит закрывающий тег для тега <font>.

Исключения:: IOException - при любой ошибке ввода-вывода

startFontTag

protected void startFontTag(String style) throws IOException

Этот метод больше не используется, вместо него будет выводиться <span>.

Выводит открывающий тег для тега <font>. Поскольку теги font не могут быть вложены, этот метод закрывает любой окружающий тег font перед записью нового открывающего тега.

Параметры:: style - стиль шрифта
Исключения:: IOException - при любой ошибке ввода-вывода

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/javax/swing/text/html/MinimalHTMLWriter.html