情報アイコン
情報 / Info
当サイトは、Typst GmbHの許諾を得て、日本語コミュニティ「Typst Japan Community」がTypst v0.13.1の公式ドキュメントを翻訳したものです。誤訳や古い情報が含まれている可能性があるため、公式ドキュメントとの併用を推奨します。翻訳の改善やサイトの機能向上について、GitHubでのIssueやPull Requestを歓迎します。コミュニティにご興味のある方はDiscordサーバー「くみはんクラブ」にぜひご参加ください。
This site provides a Japanese translation of the Typst v0.13.1 documentation maintained by the "Typst Japan Community" with permission from Typst GmbH. We recommend using this alongside the official documentation. We welcome contributions through Issues and Pull Requests on our GitHub repository for both translation improvements and website enhancements. Feel free to join our Discord server "Kumihan Club".
言語アイコン
翻訳率
21%
言語アイコン
未翻訳

このページはまだ翻訳されていません。原文の内容が表示されています。

table
Element
Element
Element functions can be customized with set and show rules.

A table of items.

Tables are used to arrange content in cells. Cells can contain arbitrary content, including multiple paragraphs and are specified in row-major order. For a hands-on explanation of all the ways you can use and customize tables in Typst, check out the table guide.

Because tables are just grids with different defaults for some cell properties (notably stroke and inset), refer to the grid documentation for more information on how to size the table tracks and specify the cell appearance properties.

If you are unsure whether you should be using a table or a grid, consider whether the content you are arranging semantically belongs together as a set of related data points or similar or whether you are just want to enhance your presentation by arranging unrelated content in a grid. In the former case, a table is the right choice, while in the latter case, a grid is more appropriate. Furthermore, Typst will annotate its output in the future such that screenreaders will announce content in table as tabular while a grid's content will be announced no different than multiple content blocks in the document flow.

Note that, to override a particular cell's properties or apply show rules on table cells, you can use the table.cell element. See its documentation for more information.

Although the table and the grid share most properties, set and show rules on one of them do not affect the other.

To give a table a caption and make it referenceable, put it into a figure.

Example

The example below demonstrates some of the most common table options.

#table(
  columns: (1fr, auto, auto),
  inset: 10pt,
  align: horizon,
  table.header(
    [], [*Volume*], [*Parameters*],
  ),
  image("cylinder.svg"),
  $ pi h (D^2 - d^2) / 4 $,
  [
    $h$: height \
    $D$: outer radius \
    $d$: inner radius
  ],
  image("tetrahedron.svg"),
  $ sqrt(2) / 12 a^3 $,
  [$a$: edge length]
)
Preview

Much like with grids, you can use table.cell to customize the appearance and the position of each cell.

#set table(
  stroke: none,
  gutter: 0.2em,
  fill: (x, y) =>
    if x == 0 or y == 0 { gray },
  inset: (right: 1.5em),
)

#show table.cell: it => {
  if it.x == 0 or it.y == 0 {
    set text(white)
    strong(it)
  } else if it.body == [] {
    // Replace empty cells with 'N/A'
    pad(..it.inset)[_N/A_]
  } else {
    it
  }
}

#let a = table.cell(
  fill: green.lighten(60%),
)[A]
#let b = table.cell(
  fill: aqua.lighten(60%),
)[B]

#table(
  columns: 4,
  [], [Exam 1], [Exam 2], [Exam 3],

  [John], [], a, [],
  [Mary], [], a, a,
  [Robert], b, a, b,
)
Preview

引数
Parameters
Parameters are the inputs to a function. They are specified in parentheses after the function name.

columns
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The column sizes. See the grid documentation for more information on track sizing.

デフォルト値:

()

rows
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The row sizes. See the grid documentation for more information on track sizing.

デフォルト値:

()

gutter
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The gaps between rows and columns. This is a shorthand for setting column-gutter and row-gutter to the same value. See the grid documentation for more information on gutters.

デフォルト値:

()

column-gutter
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The gaps between columns. Takes precedence over gutter. See the grid documentation for more information on gutters.

デフォルト値:

()

row-gutter
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The gaps between rows. Takes precedence over gutter. See the grid documentation for more information on gutters.

デフォルト値:

()

fill
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

How to fill the cells.

This can be a color or a function that returns a color. The function receives the cells' column and row indices, starting from zero. This can be used to implement striped tables.

デフォルト値:

none

右矢印アイコン
例を表示
#table(
  fill: (x, _) =>
    if calc.odd(x) { luma(240) }
    else { white },
  align: (x, y) =>
    if y == 0 { center }
    else if x == 0 { left }
    else { right },
  columns: 4,
  [], [*Q1*], [*Q2*], [*Q3*],
  [Revenue:], [1000 €], [2000 €], [3000 €],
  [Expenses:], [500 €], [1000 €], [1500 €],
  [Profit:], [500 €], [1000 €], [1500 €],
)
Preview

align
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

How to align the cells' content.

This can either be a single alignment, an array of alignments (corresponding to each column) or a function that returns an alignment. The function receives the cells' column and row indices, starting from zero. If set to auto, the outer alignment is used.

デフォルト値:

auto

右矢印アイコン
例を表示
#table(
  columns: 3,
  align: (left, center, right),
  [Hello], [Hello], [Hello],
  [A], [B], [C],
)
Preview

stroke
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

How to stroke the cells.

Strokes can be disabled by setting this to none.

If it is necessary to place lines which can cross spacing between cells produced by the gutter option, or to override the stroke between multiple specific cells, consider specifying one or more of table.hline and table.vline alongside your table cells.

See the grid documentation for more information on strokes.

デフォルト値:

1pt + black

inset
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

How much to pad the cells' content.

デフォルト値:

0% + 5pt

右矢印アイコン
例を表示
#table(
  inset: 10pt,
  [Hello],
  [World],
)

#table(
  columns: 2,
  inset: (
    x: 20pt,
    y: 10pt,
  ),
  [Hello],
  [World],
)
Preview

children
Required
Required
Required parameters must be specified when calling the function.
Positional
Positional
Positional parameters are specified in order, without names.
Variadic
Variadic
Variadic parameters can be specified multiple times.

The contents of the table cells, plus any extra table lines specified with the table.hline and table.vline elements.

定義
Definitions
Functions and types and can have associated definitions. These are accessed by specifying the function or type, followed by a period, and then the definition's name.

cell
Element
Element
Element functions can be customized with set and show rules.

A cell in the table. Use this to position a cell manually or to apply styling. To do the latter, you can either use the function to override the properties for a particular cell, or use it in show rules to apply certain styles to multiple cells at once.

Perhaps the most important use case of table.cell is to make a cell span multiple columns and/or rows with the colspan and rowspan fields.

右矢印アイコン
例を表示
#show table.cell.where(y: 0): strong
#set table(
  stroke: (x, y) => if y == 0 {
    (bottom: 0.7pt + black)
  },
  align: (x, y) => (
    if x > 0 { center }
    else { left }
  )
)

#table(
  columns: 3,
  table.header(
    [Substance],
    [Subcritical °C],
    [Supercritical °C],
  ),
  [Hydrochloric Acid],
  [12.0], [92.1],
  [Sodium Myreth Sulfate],
  [16.6], [104],
  [Potassium Hydroxide],
  table.cell(colspan: 2)[24.7],
)
Preview

For example, you can override the fill, alignment or inset for a single cell:

// You can also import those.
#import table: cell, header

#table(
  columns: 2,
  align: center,
  header(
    [*Trip progress*],
    [*Itinerary*],
  ),
  cell(
    align: right,
    fill: fuchsia.lighten(80%),
    [🚗],
  ),
  [Get in, folks!],
  [🚗], [Eat curbside hotdog],
  cell(align: left)[🌴🚗],
  cell(
    inset: 0.06em,
    text(1.62em)[🛖🌅🌊],
  ),
)
Preview

You may also apply a show rule on table.cell to style all cells at once. Combined with selectors, this allows you to apply styles based on a cell's position:

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

#table(
  columns: 3,
  gutter: 3pt,
  [Name], [Age], [Strength],
  [Hannes], [36], [Grace],
  [Irma], [50], [Resourcefulness],
  [Vikram], [49], [Perseverance],
)
Preview

body
Required
Required
Required parameters must be specified when calling the function.
Positional
Positional
Positional parameters are specified in order, without names.

The cell's body.

x
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The cell's column (zero-indexed). Functions identically to the x field in grid.cell.

デフォルト値:

auto

y
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The cell's row (zero-indexed). Functions identically to the y field in grid.cell.

デフォルト値:

auto

colspan
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The amount of columns spanned by this cell.

デフォルト値:

1

rowspan
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The amount of rows spanned by this cell.

デフォルト値:

1

fill
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The cell's fill override.

デフォルト値:

auto

align
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The cell's alignment override.

デフォルト値:

auto

inset
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The cell's inset override.

デフォルト値:

auto

stroke
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The cell's stroke override.

デフォルト値:

(:)

breakable
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

Whether rows spanned by this cell can be placed in different pages. When equal to auto, a cell spanning only fixed-size rows is unbreakable, while a cell spanning at least one auto-sized row is breakable.

デフォルト値:

auto

hline
Element
Element
Element functions can be customized with set and show rules.

A horizontal line in the table.

Overrides any per-cell stroke, including stroke specified through the table's stroke field. Can cross spacing between cells created through the table's column-gutter option.

Use this function instead of the table's stroke field if you want to manually place a horizontal line at a specific position in a single table. Consider using table's stroke field or table.cell's stroke field instead if the line you want to place is part of all your tables' designs.

右矢印アイコン
例を表示
#set table.hline(stroke: .6pt)

#table(
  stroke: none,
  columns: (auto, 1fr),
  [09:00], [Badge pick up],
  [09:45], [Opening Keynote],
  [10:30], [Talk: Typst's Future],
  [11:15], [Session: Good PRs],
  table.hline(start: 1),
  [Noon], [_Lunch break_],
  table.hline(start: 1),
  [14:00], [Talk: Tracked Layout],
  [15:00], [Talk: Automations],
  [16:00], [Workshop: Tables],
  table.hline(),
  [19:00], [Day 1 Attendee Mixer],
)
Preview

y
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The row above which the horizontal line is placed (zero-indexed). Functions identically to the y field in grid.hline.

デフォルト値:

auto

start
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The column at which the horizontal line starts (zero-indexed, inclusive).

デフォルト値:

0

end
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The column before which the horizontal line ends (zero-indexed, exclusive).

デフォルト値:

none

stroke
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The line's stroke.

Specifying none removes any lines previously placed across this line's range, including hlines or per-cell stroke below it.

デフォルト値:

1pt + black

position
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The position at which the line is placed, given its row (y) - either top to draw above it or bottom to draw below it.

This setting is only relevant when row gutter is enabled (and shouldn't be used otherwise - prefer just increasing the y field by one instead), since then the position below a row becomes different from the position above the next row due to the spacing between both.

デフォルト値:

top

vline
Element
Element
Element functions can be customized with set and show rules.

A vertical line in the table. See the docs for grid.vline for more information regarding how to use this element's fields.

Overrides any per-cell stroke, including stroke specified through the table's stroke field. Can cross spacing between cells created through the table's row-gutter option.

Similar to table.hline, use this function if you want to manually place a vertical line at a specific position in a single table and use the table's stroke field or table.cell's stroke field instead if the line you want to place is part of all your tables' designs.

x
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The column before which the horizontal line is placed (zero-indexed). Functions identically to the x field in grid.vline.

デフォルト値:

auto

start
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The row at which the vertical line starts (zero-indexed, inclusive).

デフォルト値:

0

end
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The row on top of which the vertical line ends (zero-indexed, exclusive).

デフォルト値:

none

stroke
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The line's stroke.

Specifying none removes any lines previously placed across this line's range, including vlines or per-cell stroke below it.

デフォルト値:

1pt + black

position
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

The position at which the line is placed, given its column (x) - either start to draw before it or end to draw after it.

The values left and right are also accepted, but discouraged as they cause your table to be inconsistent between left-to-right and right-to-left documents.

This setting is only relevant when column gutter is enabled (and shouldn't be used otherwise - prefer just increasing the x field by one instead), since then the position after a column becomes different from the position before the next column due to the spacing between both.

デフォルト値:

start

header
Element
Element
Element functions can be customized with set and show rules.

A repeatable table header.

You should wrap your tables' heading rows in this function even if you do not plan to wrap your table across pages because Typst will use this function to attach accessibility metadata to tables in the future and ensure universal access to your document.

You can use the repeat parameter to control whether your table's header will be repeated across pages.

table.header()->
右矢印アイコン
例を表示
#set page(height: 11.5em)
#set table(
  fill: (x, y) =>
    if x == 0 or y == 0 {
      gray.lighten(40%)
    },
  align: right,
)

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

#table(
  columns: 4,
  table.header(
    [], [Blue chip],
    [Fresh IPO], [Penny st'k],
  ),
  table.cell(
    rowspan: 6,
    align: horizon,
    rotate(-90deg, reflow: true)[
      *USD / day*
    ],
  ),
  [0.20], [104], [5],
  [3.17], [108], [4],
  [1.59], [84],  [1],
  [0.26], [98],  [15],
  [0.01], [195], [4],
  [7.34], [57],  [2],
)
Preview

repeat
Settable
Settable
Settable parameters can be customized for all following uses of the function with a set rule.

Whether this header should be repeated across pages.

デフォルト値:

true

children
Required
Required
Required parameters must be specified when calling the function.
Positional
Positional
Positional parameters are specified in order, without names.
Variadic
Variadic
Variadic parameters can be specified multiple times.

The cells and lines within the header.

A repeatable table footer.

Just like the table.header element, the footer can repeat itself on every page of the table. This is useful for improving legibility by adding the column labels in both the header and footer of a large table, totals, or other information that should be visible on every page.

No other table cells may be placed after the footer.

table.footer()->

Whether this footer should be repeated across pages.

デフォルト値:

true

The cells and lines within the footer.

検索