Формальная таблица DOM API содержит разделы заголовка, тела и нижнего колонтитула. Формальная таблица полезна, если колонтитул имеет несколько строк. Отдельные разделы верхнего и нижнего колонтитулов облегчают добавление строк и форматирование верхнего и нижнего колонтитулов независимо от других разделов. Сведения о других типах таблиц, которые можно создавать в отчетах, см. в разделе Выбор типа создаваемой таблицы. Сведения о форматировании таблиц см. в разделе Форматирование таблиц.
Формальная таблица представлена mlreportgen.dom.FormalTable объект. Разделы верхнего и нижнего колонтитулов представлены mlreportgen.dom.TableHeader, mlreportgen.dom.TableBody, и mlreportgen.dom.TableFooter соответственно. Каждый раздел содержит строки и записи таблицы. Строки представлены mlreportgen.dom.TableRow объекты. Записи в разделах «Тело» и «Нижний колонтитул» представлены mlreportgen.dom.TableEntry объекты. Записи в заголовке представлены mlreportgen.dom.TableHeaderEntry или mlreportgen.dom.TableEntry объекты.
Разделы формальной таблицы можно создавать из массива MATLAB ®. Этот подход является самым простым, потому что вам не нужно создаватьTableRow и TableEntry или TableHeaderEntry объекты. Можно также создать сечения, построив таблицу из TableRow и TableEntry или TableHeaderEntry объекты. Этот подход полезен для сложных требований к форматированию, например, когда запись охватывает несколько столбцов или строк. Можно комбинировать подходы. Например, можно создать тело таблицы из массива и построить заголовок из строк и записей.
Создание формальной таблицы с помощью mlreportgen.dom.FormalTable конструктор. Конструктор дополнительно принимает двумерный массив или массив ячеек данных MATLAB для разделов тела, заголовка и нижнего колонтитула. См. раздел header, body, и footer аргументы на mlreportgen.dom.FormalTable справочная страница. Пример создания формального заголовка таблицы из массива строк и формального тела таблицы из массива ячеек см. в разделе Создание таблицы из массива ячеек.
Можно создать разделы заголовка, тела или нижнего колонтитула формальной таблицы путем добавления записей таблицы к строкам таблицы и добавления строк к разделам.
Для создания записи заголовка можно использовать mlreportgen.dom.TableHeaderEntry или mlreportgen.dom.TableEntry объект. При создании заголовка из массива DOM API создает записи как TableHeaderEntry объекты. В HTML-отчете DOM API визуализирует TableHeaderEntry объект как th(ячейка заголовка таблицы). Этот рендеринг основан на браузере для форматирования записи таблицы. Для отчетов Word и PDF по умолчанию DOM API визуализирует TableHeaderEntry в качестве неформатированного элемента записи таблицы Word или PDF. Вы можете использовать TableHeaderEntry свойства объекта для форматирования записей таблицы, созданных для всех типов вывода. Например, эти свойства можно использовать для переопределения форматирования браузера в отчетах HTML.
Для построения раздела формальной таблицы из строк и записей таблицы можно использовать FormalTable
appendHeaderRow, append, и appendFooterRow для добавления строк к разделам заголовка, тела или нижнего колонтитула таблицы. Кроме того, можно получить доступ к разделу с помощью Header, Body, или Footer свойства FormalTable и затем присоединить строки к разделу с помощью append способ.
Пример построения заголовка из записей и строк см. в разделе Формальная таблица в разделе Охват записи таблицы по строкам и столбцам.
appendFooterRow | appendHeaderRow | mlreportgen.dom.FormalTable | mlreportgen.dom.TableBody | mlreportgen.dom.TableEntry | mlreportgen.dom.TableFooter | mlreportgen.dom.TableHeader | mlreportgen.dom.TableHeaderEntry