mlreportgen.dom.HTMLFile class

Пакет: mlreportgen.dom

Преобразуйте HTML файла в документ DOM

Описание

Преобразует содержимое HTML файла в mlreportgen.dom.HTMLFile объект, содержащий объекты DOM, имеющие одинаковое содержимое и формат. Можно добавить HTMLFile объект для документа DOM любого типа, включая документы Word и PDF.

Конструкция

htmlFileObj = HTMLFile(htmlFile) преобразует HTML файла в HTMLFile объект, содержащий объекты DOM, имеющие одинаковое содержимое и формат.

Система координат HTMLFile объект поддерживает эти элементы и атрибуты HTML. В сложение, HTMLFile объекты принимают HTML, содержащий пользовательские свойства CSS, которые начинаются с дефиса. Пользовательские свойства CSS поддерживаются в HTML, Microsoft^® Word, и PDF вывод.

Элемент HTML	Признаки
`a`	`class`, `style`, `href`, `name`
`address`	`class`, `style`
`b`	`class`, `style`
`big`	`class`, `style`
`blockquote`	`class`, `style`
`body`	`class`, `style`
`br`	n/a
`center`	`class`, `style`
`cite`	`class`, `style`
`code`	`class`, `style`
`dd`	`class`, `style`
`del`	`class`, `style`
`dfn`	`class`, `style`
`div`	`class`, `style`
`dl`	`class`, `style`
`dt`	`class`, `style`
`em`	`class`, `style`
`font`	`class`, `style`, `color`, `face`, `size`
`h1, h2, h3, h4, h5, h6`	`class`, `style`, `align`
`hr`	`class`, `style`, `align`
`i`	`class`, `style`
`ins`	`class`, `style`
`img`	`class`, `style`, `src`, `height`, `width`
`kbd`	`class`, `style`
`li`	`class`, `style`
`mark`	`class`, `style`
`nobr`	`class`, `style`
`ol`	`class`, `style`
`p`	`class`, `style`, `align`
`pre`	`class`, `style`
`s`	`class`, `style`
`samp`	`class`, `style`
`small`	`class`, `style`
`span`	`class`, `style`
`strike`	`class`, `style`
`strong`	`class`, `style`
`sub`	`class`, `style`
`sup`	`class`, `style`
`table`	`class`, `style`, `align`, `bgcolor`, `border`, `cellspacing`, `cellpadding`, `frame`, `rules`, `width`
`tbody`	`class`, `style`, `align`, `valign`
`tfoot`	`class`, `style`, `align`, `valign`
`thead`	`class`, `style`, `align`, `valign`
`td`	`class`, `style`, `bgcolor`, `height`, `width`, `colspan`, `rowspan`, `align`, `valign`, `nowrap`
`th`	`class`, `style`, `bgcolor`, `height`, `width`, `colspan`, `rowspan`, `align`, `valign`, `nowrap`
`tr`	`class`, `style`, `align`, `bgcolor`, `valign`
`tt`	`class`, `style`
`u`	`class`, `style`
`ul`	`class`, `style`
`var`	`class`, `style`

Для получения информации об этих элементах смотрите https://developer.mozilla.org/en-US/docs/Web/HTML/Element.

Поддерживаются следующие форматы CSS:

background-color
border
border-bottom
border-bottom-color
border-bottom-style
boder-bottom-width
border-color
border-left
border-left-color
border-left-style
boder-left-width
border-right
border-right-color
border-rigtht-style
border-right-width
border-style
border-top
border-top-color
border-top-style
border-top-width
border-width
color
counter-increment
counter-reset
display
font-family
font-size
font-style
font-weight
height
line-height
list-style-type
margin
margin-bottom
margin-left
margin-right
margin-top
padding
padding-bottom
padding-left
padding-right
padding-top
text-align
text-decoration
text-indent
vertical-align
white-space
width

Для получения информации об этих форматах https://developer.mozilla.org/en-US/docs/Web/CSS/Reference.

Входные параметры

расширить все

`htmlFile` - HTML к файл
вектор символов

HTML к файл, заданный как вектор символов.

Свойства

расширить все

Примечание

Чтобы HTML разметки правильно отображались в отчете, необходимо включить конечные теги для пустых элементов и заключить значения атрибутов в кавычки. Если необходимо показать зарезервированную разметку XML символа в виде текста, необходимо использовать эквивалентную ей именованный или числовой символ XML.

Зарезервированный символ	Описание	Эквивалентный символ
`>`	Больше, чем	`>`
`<`	Меньше, чем	`<`
`&`	Амперсанд	`&`
`"`	Двойной кавычки	`"`
`'`	Одинарная кавычка	`'`
`%`	Процент	`%`

`Id` - идентификатор для `HTMLFile` объект
вектор символов

Уникальный для сеанса идентификатор генерируется как часть HTMLFile создание объектов. Можно задать идентификатор для замены сгенерированного идентификатора.

`HTMLTag` - Имя HTML-тега элемента контейнера HTML
`'div'` (по умолчанию) | вектор символов

Имя тега элемента контейнера HTML, заданное как вектор символов, например 'div', 'section', или 'article' соответствующий этому HTMLFile объект. Это свойство применяется только к HTML выхода.

`Children` - Дети этого `HTMLFile` объект
массив ячеек `mlreportgen.dom.Element` объекты

Это свойство только для чтения приводит список дочерних элементов, которые HTMLFile объект содержит.

`Parent` - Родительский элемент этого `HTMLFile` объект
объект DOM

В этом свойстве только для чтения перечислен родительский элемент этого HTMLFile объект.

`Style` - Форматирование для применения к `HTMLFile` объект
массив ячеек объектов формата

Форматирование для применения к HTMLFile объект, заданный как массив ячеек объектов формата DOM. Дети этого HTMLFile объект наследует любой из этих форматов, которые они не переопределяют.

`StyleName` - Имя стиля `HTMLFile` объект
вектор символов

Имя стиля этого HTMLFile объект, заданный как вектор символов. Используйте имя стиля, заданное в таблице стилей документа, которому HTMLFile объект добавлен. Заданный стиль определяет внешний вид HTMLFile объект в выход документе, где не переопределен форматами, заданными этим StyleName свойство HTMLFile объект.

`Tag` - Тег для `HTMLFile` объект
вектор символов

Тег для HTMLFile объект, заданный как вектор символов.

Уникальный для сеанса идентификатор генерируется как часть HTMLFile создание объектов. Сгенерированный тег имеет форму CLASS:ID, где CLASS - класс элемента и ID - значение Id свойство объекта. Можно задать тег для замены сгенерированного тега.

Например, задайте собственное значение тега, чтобы упростить определение места возникновения проблемы во время генерации документа.

Примечание

HTMLFile игнорирует KeepInterElementWhiteSpace свойство. Если вы хотите сохранить пустое пространство, используйте fileread чтобы считать файл HTML текстом, а затем следовать процедуре, описанной для mlreportgen.dom.HTMLKeepInterElementWhiteSpace свойство.

Методы

приложить

Добавление HTML к объекту HTMLFile

Примеры

свернуть все

Преобразуйте HTML Файла в отчет Word

Создайте текстовый файл с именем myHTML.html и сохраните его в текущей папке. Добавить этот текст в файл:

<html>
<head>
<style>p {font-size:14pt;}</style>
</head>
<body>
<p style='white-space:pre'><b>Hello</b><i style='color:green'> World</i></p>
<p>This is <u>me</u> speaking</p>
</body>
</html>

Для преобразования myHTML.html файл в отчет Word, выполните следующие команды:

import mlreportgen.dom.*; 
rpt = Document('MyReport','docx'); 
htmlFile = HTMLFile('myHTML.html'); 
append(rpt,htmlFile); 
close(rpt); 
rptview(rpt.OutputPath);

Полученный отчет Word содержит текст, указанный в HTML файла.

Совет

MATLAB^® Report Generator™ mlreportgen.dom.HTML или mlreportgen.dom.HTMLFile объекты обычно не могут принимать необработанный HTML выхода сторонних приложений, таких как Microsoft Word, которые экспорт собственные документы как HTML разметки. В этих случаях программа генерации отчетов Report API может использовать mlreportgen.utils.html2dom.prepHTMLString и mlreportgen.utils.html2dom.prepHTMLFile функции для подготовки необработанного HTML для использования со mlreportgen.dom.HTML или mlreportgen.dom.HTMLFile объекты. Как правило, ваша программа должна будет продолжить обработку подготовленного HTML для удаления допустимых, но нежелательных объектов, таких как каналы линий, которые находились в необработанном содержимом.
Документы Word и PDF требуют, чтобы встроенные элементы, такие как текст и ссылки, содержались в абзаце. Чтобы удовлетворить этому требованию, HTML создает оберточные абзацы, содержащие встроенные элементы, которые еще не указаны в абзаце. Если вы создаете mlreportgen.dom.HTML или mlreportgen.dom.HTMLFile объект из HTML, который содержит встроенные элементы, не входящие в абзацы и добавляющие объект в HTML-документ, сгенерированный HTML может отличаться от входного HTML. Чтобы сгенерировать встроенные элементы без добавленных абзацев оболочки, вставьте HTML разметки в HTML документ с помощью mlreportgen.dom.RawText объект.
По умолчанию DOM API использует базовый шрифт размером 12 точек для преобразования em модулей по фактическим размерам шрифта. Для примера размер шрифта задается как 2em преобразует в 24 точки. Чтобы задать другой размер базового шрифта, добавьте содержимое в отчет с помощью mlreportgen.dom.HTML объект. Установите EMBaseFontSize свойство объекта к размеру базового шрифта. Для примера, если вы задаете EMBaseFontSize свойство для 14, размер шрифта 2em преобразует в 28 точек.

См. также

addHTMLFile | mlreportgen.dom.HTML | mlreportgen.utils.html2dom.prepHTMLFile | mlreportgen.utils.html2dom.prepHTMLString

Документация

mlreportgen.dom.HTMLFile class

Описание

Конструкция

Входные параметры

`htmlFile` - HTML к файл
вектор символов

Свойства

`Id` - идентификатор для `HTMLFile` объект
вектор символов

`HTMLTag` - Имя HTML-тега элемента контейнера HTML
`'div'` (по умолчанию) | вектор символов

`Children` - Дети этого `HTMLFile` объект
массив ячеек `mlreportgen.dom.Element` объекты

`Parent` - Родительский элемент этого `HTMLFile` объект
объект DOM

`Style` - Форматирование для применения к `HTMLFile` объект
массив ячеек объектов формата

`StyleName` - Имя стиля `HTMLFile` объект
вектор символов

`Tag` - Тег для `HTMLFile` объект
вектор символов

Методы

Примеры

Преобразуйте HTML Файла в отчет Word

Совет

См. также

Темы

Внешние веб-сайты

MATLAB Report Generator

Поддержка

Документация

mlreportgen.dom.HTMLFile class

Описание

Конструкция

Входные параметры

htmlFile - HTML к файл вектор символов

Свойства

Id - идентификатор для HTMLFile объект вектор символов

HTMLTag - Имя HTML-тега элемента контейнера HTML 'div' (по умолчанию) | вектор символов

Children - Дети этого HTMLFile объект массив ячеек mlreportgen.dom.Element объекты

Parent - Родительский элемент этого HTMLFile объект объект DOM

Style - Форматирование для применения к HTMLFile объект массив ячеек объектов формата

StyleName - Имя стиля HTMLFile объект вектор символов

Tag - Тег для HTMLFile объект вектор символов

Методы

Примеры

Преобразуйте HTML Файла в отчет Word

Совет

См. также

Темы

Внешние веб-сайты

MATLAB Report Generator

Поддержка

`htmlFile` - HTML к файл
вектор символов

`Id` - идентификатор для `HTMLFile` объект
вектор символов

`HTMLTag` - Имя HTML-тега элемента контейнера HTML
`'div'` (по умолчанию) | вектор символов

`Children` - Дети этого `HTMLFile` объект
массив ячеек `mlreportgen.dom.Element` объекты

`Parent` - Родительский элемент этого `HTMLFile` объект
объект DOM

`Style` - Форматирование для применения к `HTMLFile` объект
массив ячеек объектов формата

`StyleName` - Имя стиля `HTMLFile` объект
вектор символов

`Tag` - Тег для `HTMLFile` объект
вектор символов