Класс mlreportgen.dom.HTML

Пакет: mlreportgen.dom
Суперклассы:

Используйте разметку HTML, чтобы создать документ DOM

Описание

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

Конструкция

htmlObj = HTML() создает пустой объект HTML.

htmlObj = HTML(htmlText) преобразовывает текст HTML в объект HTML, содержащий Объекты DOM, имеющие то же содержимое и формат.

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

Элемент HTMLАтрибуты
aclass, style, href, name
bclass, style
bodyclass, style
brнет данных
codeclass, style
delclass, style
divclass, 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, alt
liclass, style
olclass, style
pclass, style, align
preclass, style
sclass, style
spanclass, style
strikeclass, 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, valign, nowrap
trclass, style, bgcolor, valign
ttclass, style
uclass, style
ulclass, style

Для получения информации об этих элементах смотрите, что W3Schools помечает документацию по www.w3schools.com/tags.

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

развернуть все

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

Пример: html = HTML('<p><b>Hello</b> <i style="color:green">World</i></p>');

Свойства

развернуть все

Примечание

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

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

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

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

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

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

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

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

Пометьте для объекта HTML, заданного как вектор символов.

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

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

Преобразовать ли пробел между элементами, указанными как логическое. Если KeepInterElementWhiteSpace является true, DOM преобразовывает пробел между элементами во входной разметке HTML к объектам Text DOM. Если false, DOM игнорирует пробел между элементами.

Примечание

Это свойство KeepInterElementWhiteSpace преобразовывает, но не сохраняет пробел. Чтобы сохранить пробел, выполните эти шаги:

  • Создайте пустой объект DOM HTML.

  • Установите свойство KeepInterElementWhiteSpace объекта к true.

  • Установите свойство Style на {WhiteSpace('preserve')}.

  • Добавьте входной текст HTML к объекту HTML.

Например,

htmlObj = mlreportgen.dom.HTML();
htmlObj.KeepInterElementWhiteSpace = true;
htmlObj.Style = ...
   {mlreportgen.dom.WhiteSpace('preserve')};
append(htmlObj,htmlText);

Методы

добавлениеДобавьте строку HTML к объекту HTML
клонСкопируйте объект HTML

Примеры

Преобразуйте файл HTML в Word Report

Создайте текстовый файл под названием myHTMLReport.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>
Запустите эти команды, чтобы преобразовать файл myHTMLReport.html в отчет Word.
import mlreportgen.dom.*; 
rpt = Document('MyReport','docx'); 
htmlFile = HTMLFile('myHTMLReport.html'); 
append(rpt,htmlFile); 
close(rpt); 
rptview(rpt.OutputPath);
Получившийся отчет Word содержит текст, который вы задали в файле HTML.

Представленный в R2015a