gridElementElement functions can be customized with set and show rules.
set and show rules.Arrange content in a grid.
The grid element allows you to arrange content in a grid. You can define the number of rows and columns, as well as the size of the gutters between them. There are multiple sizing modes for columns and rows that can be used to create complex layouts.
The sizing of the grid is determined by the track sizes specified in the arguments. Because each of the sizing parameters accepts the same values, we will explain them just once, here. Each sizing argument accepts an array of individual track sizes. A track size is either:
-
auto: The track will be sized to fit its contents. It will be at most as large as the remaining space. If there is more than oneautotrack which, and together they claim more than the available space, theautotracks will fairly distribute the available space among themselves. -
A fixed or relative length (e.g.
10ptor20% - 1cm): The track will be exactly of this size. -
A fractional length (e.g.
1fr): Once all other tracks have been sized, the remaining space will be divided among the fractional tracks according to their fractions. For example, if there are two fractional tracks, each with a fraction of1fr, they will each take up half of the remaining space.
To specify a single track, the array can be omitted in favor of a single
value. To specify multiple auto tracks, enter the number of tracks
instead of an array. For example, columns: 3 is equivalent to
columns: (auto, auto, auto).
Example
#set text(10pt, style: "italic")
#let cell = rect.with(
inset: 8pt,
fill: rgb("e4e5ea"),
width: 100%,
radius: 6pt
)
#grid(
columns: (60pt, 1fr, 60pt),
rows: (60pt, auto),
gutter: 3pt,
cell(height: 100%)[Easy to learn],
cell(height: 100%)[Great output],
cell(height: 100%)[Intuitive],
cell[Our best Typst yet],
cell[
Responsive design in print
for everyone
],
cell[One more thing...],
)
ParametersParameters are the inputs to a function. They are specified in parentheses after the function name.
columnsSettableSettable parameters can be customized for all following uses of the function with a set rule.
set rule.Defines the column sizes.
Either specify a track size array or provide an integer to create a grid
with that many auto-sized columns. Note that opposed to rows and
gutters, providing a single track size will only ever create a single
column.
Default: ()
rowsSettableSettable parameters can be customized for all following uses of the function with a set rule.
set rule.Defines the row sizes.
If there are more cells than fit the defined rows, the last row is repeated until there are no more cells.
Default: ()
gutterSettableSettable parameters can be customized for all following uses of the function with a set rule.
set rule.Defines the gaps between rows & columns.
If there are more gutters than defined sizes, the last gutter is repeated.
Default: ()
column-gutterSettableSettable parameters can be customized for all following uses of the function with a set rule.
set rule.Defines the gaps between columns. Takes precedence over gutter.
Default: ()
row-gutterSettableSettable parameters can be customized for all following uses of the function with a set rule.
set rule.Defines the gaps between rows. Takes precedence over gutter.
Default: ()
childrenRequiredPositionalPositional parameters are specified in order, without names.VariadicVariadic parameters can be specified multiple times.
The contents of the table cells.
The cells are populated in row-major order.