Quarto. Таблицы-списки
2026-04-11
·
2 мин. для прочтения
Quarto. Таблицы-списки.
Содержание
1 Общая информация
- Первоначально было реализовано в виде плагина.
- Репозиторий: https://github.com/pandoc-ext/list-table
- В quarto 1.9 интегрировано в основной код.
2 Синтаксис
- Таблицы-списки предоставляют альтернативный синтаксис для создания таблиц со сложным содержимым, таким как несколько абзацев, блоки кода или списки.
- Используют привычный синтаксис маркированных списков, что упрощает их написание и сопровождение.
- Таблица-список представляет собой div-элемент с классом
.list-table. - Содержит маркированный список.
- Каждый маркер верхнего уровня представляет собой строку, а вложенные маркеры представляют собой ячейки:
::: {.list-table}
- - Fruit
- Price
- - Apple
- 1.20
- - Orange
- 0.90
:::
| Фрукты | Цена |
|---|---|
| Яблоко | 1.20 |
| Апельсин | 0,90 |
- Таблицы-списки поддерживают блочные элементы внутри ячеек, включая блоки кода и списки:
::: {.list-table}
- - Function
- Description
- - `sum()`
- Add values:
```python
sum([1, 2, 3])
```
- - `len()`
- Count items:
- Works on lists
- Works on strings
:::
3 Заголовок
- По умолчанию первая строка рассматривается как заголовок.
- Чтобы изменить это, установите параметр
header-rows=0:
::: {.list-table header-rows=0}
- - Apple
- 1.20
- - Orange
- 0.90
:::
| Яблоко | 1.20 |
|---|---|
| Апельсин | 0,90 |
4 Выравнивание в колонках
- Выравнивание столбцов задаётся с помощью атрибута
alignsс вариантами:d(по умолчанию),l(на лево),r(на право),c(центрировать):
::: {.list-table aligns="l,r"}
- - Fruit
- Price
- - Apple
- 1.20
- - Orange
- 0.90
:::
5 Ширина столбцов
- Можно указать относительную ширину столбцов, добавив соответствующий атрибут
tbl-colwidths:
::: {.list-table tbl-colwidths="[75,25]"}
- - Fruit
- Price
- - Apple
- 1.20
- - Orange
- 0.90
:::
6 Подписи и перекрестные ссылки
- Добавьте подпись, включив абзац в начало элемента
div:
::: {.list-table}
Fruit prices
- - Fruit
- Price
- - Apple
- 1.20
:::
- Чтобы сделать таблицу-список перекрестно связанной, добавьте идентификатор с указанием префикса
tbl-:
::: {#tbl-fruits .list-table}
Fruit prices
- - Fruit
- Price
- - Apple
- 1.20
:::
See @tbl-fruits.
7 Атрибуты ячейки
- Чтобы добавить атрибуты к ячейке, начните ячейку с пустого тега
<span>, содержащего эти атрибуты. - Например, используйте:
rowspanиcolspanдля переноса ячеек на несколько строк или столбцов:
::: {.list-table}
- - []{colspan=2} Item
- Price
- - []{rowspan=2} Citrus
- Orange
- 0.90
- - Lemon
- 0.80
- - []{rowspan=2} Stone Fruit
- Peach
- 1.20
- - Plum
- 1.00
:::
