Typst表格指南：从基础到高级样式设计

原创于 2025-05-30 09:08:41 发布 · 475 阅读

8 ·

CC 4.0 BY-SA版权

Typst表格指南：从基础到高级样式设计

表格是文档排版中不可或缺的元素，它能以紧凑、有序的方式呈现数据。Typst作为现代化的排版系统，提供了强大而灵活的表格功能。本文将全面介绍Typst中表格的使用方法，从基础创建到高级样式定制。

基础表格创建

在Typst中创建表格非常简单，只需使用table函数并指定两个关键参数：

列数（columns）
每个单元格的内容

#table(
  columns: 2,
  [*用量*], [*原料*],
  [360g], [面粉],
  [250g], [黄油(室温)],
  [150g], [红糖],
)

表头处理

为了提高表格的可读性和可访问性，建议使用table.header函数标记表头行：

#table(
  columns: 2,
  table.header[*用量*][*原料*],
  [360g], [面粉],
  [250g], [黄油(室温)],
)

全局样式设置

可以通过show规则统一设置表头样式：

#show table.cell.where(y: 0): strong

#table(
  columns: 2,
  table.header[用量][原料],
  [360g], [面粉],
  [250g], [黄油(室温)],
)

列宽控制

Typst提供了多种方式来控制列宽：

auto：自动适应内容（默认）
固定长度：如6cm、0.7in等
百分比：如40%
弹性单位：fr（按比例分配剩余空间）

#table(
  columns: (auto, auto, 1fr),
  table.header[日期][编号][描述],
  [24/01/03], [813], [筛选参与者池],
  [24/01/03], [477], [转换到第二方案],
)

表格标题与引用

使用figure函数可以为表格添加标题，并通过标签实现交叉引用：

#figure(
  table(
    columns: 4,
    stroke: none,
    table.header[测试项][规格][结果][通过],
    [电压], [220V ± 5%], [218V], [是],
  ),
  caption: [设计A的测试结果],
) <test-a>

测试结果如@test-a所示...

斑马条纹表格

通过fill参数可以轻松实现斑马条纹效果：

列条纹

#set table(
  fill: (rgb("EAF2F5"), none),
)

#table(
  columns: 2,
  table.header[月份][书名],
  [一月], [了不起的盖茨比],
  [二月], [杀死一只知更鸟],
)

行条纹

#set table(
  fill: (_, y) => if calc.odd(y) { rgb("EAF2F5") },
)

#table(
  columns: 2,
  table.header[月份][书名],
  [一月], [了不起的盖茨比],
  [二月], [杀死一只知更鸟],
)

自定义条纹模式

#set table(
  fill: (_, y) => (none, rgb("EAF2F5"), rgb("DDEAEF")).at(calc.rem(y, 3)),
)

单元格样式覆盖

可以通过table.cell元素单独设置单元格样式：

#let highlight(text) = table.cell(fill: yellow, text)

#table(
  columns: 2,
  table.header[项目][值],
  [A], [100],
  [B], highlight[200],
  [C], [300],
)

边框样式定制

Typst提供了精细的边框控制能力：

#let custom-border = (x, y) => (
  left: if x > 0 { 0pt } else { 1pt },
  right: 1pt,
  top: if y < 2 { 1pt } else { 0pt },
  bottom: 1pt,
)

#table(
  columns: 2,
  stroke: custom-border,
  table.header[项目][值],
  [A], [100],
  [B], [200],
)