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Признаки
aclass, style, href, name
addressclass, style
bclass, style
bigclass, style
blockquoteclass, style
bodyclass, style
brn/a
centerclass, style
citeclass, style
codeclass, style
ddclass, style
delclass, style
dfnclass, style
divclass, style
dlclass, style
dtclass, style
emclass, style
fontclass, style, color, face, size
h1, h2, h3, h4, h5, h6class, style, align
hrclass, style, align
iclass, style
insclass, style
imgclass, style, src, height, width
kbdclass, style
liclass, style
markclass, style
nobrclass, style
olclass, style
pclass, style, align
preclass, style
sclass, style
sampclass, style
smallclass, style
spanclass, style
strikeclass, style
strongclass, style
subclass, style
supclass, style
tableclass, style, align, bgcolor, border, cellspacing, cellpadding, frame, rules, width
tbodyclass, style, align, valign
tfootclass, style, align, valign
theadclass, style, align, valign
tdclass, style, bgcolor, height, width, colspan, rowspan, align, valign, nowrap
thclass, style, bgcolor, height, width, colspan, rowspan, align, valign, nowrap
trclass, style, align, bgcolor, valign
ttclass, style
uclass, style
ulclass, style
varclass, 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 к файл, заданный как вектор символов.

Свойства

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

Примечание

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

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

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

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

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

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

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

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

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

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

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

Примечание

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

Методы

приложитьДобавление 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® 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 точек.

Введенный в R2015a