Класс 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 - набор атрибутов.
Исключения:: IOException - при любой ошибке ввода-вывода

text

protected void text(Element elem) throws IOException, BadLocationException

Выводит текст.

Переопределяет:: text в классе AbstractWriter
Параметры:: elem - элемент.
Исключения:: 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

Выводит оставшиеся атрибуты уровня символов (атрибуты, кроме жирный, курсив и подчеркнутый) в соответствии с 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, 2023, 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/21/docs/api/java.desktop/javax/swing/text/html/MinimalHTMLWriter.html