Документация

Создайте неупорядоченный список из массива

Чтобы создать неупорядоченный список из массива, добавьте массив непосредственно к элементу документа или документа. append метод:

Для примера этот код создает неупорядоченный список из строковых массивов:

import mlreportgen.dom.*
d = Document("fruit","html");

ul = append(d,["apples","oranges","bananas"]);

close(d);
rptview(d);

Вот список в сгенерированном отчете:

Кроме того, создайте неупорядоченный список путем предоставления массива в качестве входов mlreportegen.dom.UnorderedList конструктор. Для примера:

import mlreportgen.dom.*
d = Document("fruit","html");

ul = UnorderedList(["apples","oranges","bananas"]);
ul = append(d,ul);

close(d);
rptview(d);

Конструктор создает mlreportgen.dom.ListItem объект для каждого элемента массива и добавляет ListItem объекты к UnorderedList объект.

Создайте упорядоченный список из массива

Чтобы создать упорядоченный список из массива, укажите массив как вход в mlreportegen.dom.OrderedList конструктор. Конструктор создает mlreportgen.dom.ListItem объект для каждого элемента массива и добавляет ListItem объекты к OrderedList объект. Для примера этот код создает упорядоченный список из строковых массивов.

import mlreportgen.dom.*
d = Document("weekdays","html");

ol = OrderedList(["Monday","Tuesday","Wednesday","Thursday","Friday"]);
append(d,ol);

close(d);
rptview(d);

Вот список в сгенерированном отчете:

Составьте список из массива ячеек

Задайте элементы списка в массиве ячеек, когда элементы имеют различные типы. В массив ячеек можно включать векторы символов, строки, числа и некоторые объекты DOM, такие как mlreportgen.dom.Text объект. Список объектов DOM, которые можно включить, см. mlreportgen.dom.ListItem.

Например, этот код создает упорядоченный список из массива ячеек, который содержит векторы символов и mlreportgen.dom.ExternalLink объект.

import mlreportgen.dom.*
d = Document('myreport','html');

ol = UnorderedList({...
    'apples',...
    'oranges',...
    ExternalLink('https://en.wikipedia.org/wiki/Mango',...
    'mango')});
append(d,ol);

close(d);
rptview(d);

Вот список в сгенерированном отчете:

Составьте многоуровневый список из массивов ячеек

Чтобы создать многоуровневый список из массивов ячеек, используйте один из следующих подходов:

В двух предыдущих примерах DOM API представляет подсписок как третий дочерний элемент списка верхнего уровня. Для доступа к подсписку используйте Children свойство списка верхнего уровня.

topList.Children(3)

Создание многоуровневого списка по одному списку за раз

Когда элементы подсписка содержат несколько абзацев, сочетание абзацев и таблиц или другие комбинации элементов документа, создайте mlreportgen.dom.ListItem объекты и добавить их в mlreportgen.dom.UnorderedList или mlreportgen.dom.OrderedList объект. Затем добавьте подсписок к списку или элементу списка.

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

import mlreportgen.dom.*;
d = Document('orderedListReport','html');

subList = UnorderedList;
subListItem1 = ListItem('>> magic(3)');
table = append(subListItem1,Table(magic(3)));
table.Width = '1in';
append(subList,subListItem1);
subListItem2 = ListItem('>> magic(4)');
table = append(subListItem2,Table(magic(4)));
table.Width = '1in';
append(subList,subListItem2);

topList = OrderedList();
append(topList,ListItem('Start MATLAB'));
append(topList,ListItem('Create a rank 3 or 4 magic square'));
append(topList,subList); % sublist is item 3 of topList
append(topList,ListItem('Close MATLAB'));
    
append(d,topList);

close(d);
rptview(d);

Вот список в сгенерированном отчете:

DOM API представляет подсписок как третий дочерний элемент списка верхнего уровня. Для доступа к подсписку используйте Children свойство списка верхнего уровня.

topList.Children(3)

Вместо добавления подсписка к списку можно добавить подсписк к элементу списка. В следующем примере подсписок добавляется ко второму элементу списка верхнего уровня. Сгенерированный список выглядит так же, как и в предыдущем примере.

import mlreportgen.dom.*;
d = Document('orderedListReport','html');

topList = OrderedList({ ...
    'Start MATLAB', ...
    'Create a rank 3 or 4 magic square:', ...
    'Close MATLAB'});

subList = UnorderedList;
subListItem1 = ListItem('>> magic(3)');
table = append(subListItem1,Table(magic(3)));
table.Width = '1in';
append(subList,subListItem1);
subListItem2 = ListItem('>> magic(4)');
table = append(subListItem2,Table(magic(4)));
table.Width = '1in';
append(subList,subListItem2);

% Append the sublist to the second list item
topListItem2 = topList.Children(2);
append(topListItem2, subList);

append(d, topList);

close(d);
rptview(d);

DOM API представляет подсписок как второй дочерний элемент второго элемента списка верхнего уровня. Для доступа к подсписку используйте этот код:

topList.Children(2).Children(2)

Создание стиля списка слов

Дополнительные сведения о создании шаблона Word см. в разделе Создание шаблона Microsoft Word.

Для определения стиля списка в шаблоне Word:

Пример, определяющий стиль списка Word, см. в разделе Пользовательский стилизованный список слов.

Создание стиля списка HTML или PDF

Для определения стиля списка в каскадной таблице стилей (CSS) для шаблона HTML или PDF используйте ul элемент для неупорядоченных стилей списка и ol элемент для упорядоченных стилей списка. Можно использовать дочерний селектор (>) для определения многоуровневых стилей списка. См. раздел «Изменение стилей в шаблонах HTML и изменение стилей в шаблонах PDF».

Например, этот код CSS определяет внешний вид двухуровневого неупорядоченного списка, который может содержать упорядоченные или неупорядоченные подсписки.

ul.MyUnorderedList {
	list-style-type:disc;
}

ul.MyUnorderedList > ul {
	list-style-type:circle;
}

ul.MyUnorderedList > ol {
	list-style-type:decimal;
}

Для получения информации об редактировании CSS см. документацию, такую как W3Schools.com руководство CSS.