Пакет: mlreportgen.dom
Преобразование HTML-файла в документ DOM
Преобразует содержимое HTML-файла в mlreportgen.dom.HTMLFile объект, содержащий объекты DOM, имеющие одинаковое содержимое и формат. Вы можете добавить HTMLFile объект для DOM-документа любого типа, включая документы Word и PDF.
htmlFileObj = HTMLFile(htmlFile)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.
| приложить | Добавление HTML к объекту HTMLFile |
Создание текстового файла с именем 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 ® 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