Exponenta Banner
exponenta event banner

mlreportgen.utils.html2dom.prepHTMLString

Подготовка HTML-строки для преобразования в DOM

свернуть все на странице

Синтаксис

preppedHTMLStr = mlreportgen.utils.html2dom.prepHTMLString (startStr)
preppedHTMLStr = mlreportgen.utils.html2dom.prepHTMLString (startStr, «Tidy», false)

Описание

пример

preppedHTMLStr = mlreportgen.utils.html2dom.prepHTMLString(htmlStr) подготавливает HTML в строке, указанной htmlStr для преобразования во внутреннюю объектную модель документа (DOM) MATLAB ® Report Generator™. Подготовленный HTML вpreppedHTMLStr может быть преобразовано в представление DOM API с помощью mlreportgen.dom.HTML объект. mlreportgen.utils.html2dom.prepHTMLString функция:

  • Исправление недопустимой разметки путем вызова mlreportgen.utils.tidy с настройками для вывода HTML.

  • Использует веб-браузер MATLAB для преобразования пометки в документ HTML DOM. Смотрите https://www.w3.org/TR/WD-DOM/introduction.html.

    Веб-браузер MATLAB вычисляет свойства CSS элементов во входном HTML-коде на основе внутренних и внешних таблиц стилей, заданных входным HTML, а также на основе атрибута стиля элемента. Вычисление свойств CSS поддерживает все допустимые селекторы таблиц стилей CSS, включая селекторы, не поддерживаемые непосредственно mlreportgen.dom.HTML объекты.

  • Преобразует документ HTML DOM в разметку HTML, поддерживаемую mlreportgen.dom.HTML объекты. Атрибут style для каждого элемента определяет свойства CSS элемента, вычисленные веб-браузером MATLAB.

  • Возвращает подготовленный HTML в виде строкового скаляра.

preppedHTMLStr = mlreportgen.utils.html2dom.prepHTMLString(htmlStr,"Tidy",false) подготавливает входной HTML-код, не приводя его в порядок. Используйте этот синтаксис, если требуется самостоятельно привести в порядок разметку HTML. Например, может потребоваться позвонить mlreportgen.utils.tidy с опциями, отличными от тех, которые используются mlreportgen.utils.html2dom.prepHTMLString, затем передать приведенный HTML в качестве входных данных mlreportgen.utils.html2dom.prepHTMLString.

Примеры

свернуть все

Использовать mlreportgen.utils.html2dom.prepHTML для подготовки HTML-строки для преобразования в объект DOM, который можно добавить в отчет.

Создать строку с именем myHTMLStr с этим HTML-содержимым:

myHTMLStr = "<html><body><p>This is the first paragraph.<p>This is the second paragraph.<p></body></html>";

В абзаце отсутствует / в конечном теге </p>.

Попробуйте преобразовать HTML в объект DOM и добавить объект в отчет.

import mlreportgen.dom.*; 
rpt = Document("MyReport","docx"); 
htmlObj = mlreportgen.dom.HTML(myHTMLStr);
append(rpt,htmlObj); 
close(rpt); 
rptview(rpt);
Error using mlreportgen.dom.HTML
HTML error: expected end of tag 'p'

mlreportgen.dom.HTML заканчивается ошибкой из-за отсутствующего конечного тега.

Подготовка HTML-кода с помощью mlreportgen.utils.html2dom.prepHTMLString. Создание mlreportgen.dom.HTML из подготовленного HTML и добавить объект в отчет.

import mlreportgen.dom.*; 
rpt = Document("MyReport","docx");
%prepare the HTML 
myPreppedHTML = mlreportgen.utils.html2dom.prepHTMLString(myHTMLStr);
htmlObj = mlreportgen.dom.HTML(myPreppedHTML);
append(rpt,htmlObj); 
close(rpt); 
rptview(rpt);

Входные аргументы

свернуть все

HTML-содержимое, которое должно быть подготовлено для преобразования в DOM, указанное как вектор символов или скаляр строки.

Выходные аргументы

свернуть все

Подготовленный HTML, возвращенный как строковый скаляр.

Совет

  • Генератор отчетов MATLAB 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 для удаления допустимых, но нежелательных объектов, таких как каналы строк, которые находились в необработанном содержимом.

См. также

| | |

Темы

Представлен в R2020a

Документация по генератору отчетов MATLAB

Поддержка