= Table Category Keys
:description: Reference list of the available table category keys and their value types.
:navtitle: Table
:source-language: yaml

[#table]
== table

The keys in the `table` category control the arrangement and style of tables and their cells.

[cols="3,4,6a"]
|===
|Key |Value Type |Example

|align
|xref:blocks.adoc#align[Block alignment] +
(default: `left`)
|[source]
table:
  align: right

|background-color
|xref:color.adoc[Color] +
(default: `transparent`)
|[source]
table:
  background-color: #FFFFFF

|border-color
|xref:tables.adoc#border-color[Color] {vbar} xref:tables.adoc#border-color[Color[\]] +
(default: `'000000'`)
|[source]
table:
  border-color: #DDDDDD

|border-style
|xref:tables.adoc#border-style[Border style] {vbar} xref:tables.adoc#border-style[Border style[\]] +
(default: `solid`)
|[source]
table:
  border-style: [solid, ~, solid, dotted]

|border-width
|xref:blocks.adoc#border-width[Measurement] {vbar} xref:blocks.adoc#border-width[Measurement[\]] +
(default: `0.5`)
|[source]
table:
  border-width: 0.5

|font-color
|xref:color.adoc[Color] +
(default: _inherit_)
|[source]
table:
  font-color: #333333

|font-family
|xref:font-support.adoc[Font family name] +
(default: _inherit_)
|[source]
table:
  font-family: Helvetica

|font-kerning
|`none` {vbar} `normal` +
(default: _inherit_)
|[source]
table:
  font-kerning: none

|font-size
|xref:text.adoc#font-size[Font size] +
(default: _inherit_)
|[source]
table:
  font-size: 9.5

|font-style
|xref:text.adoc#font-style[Font style] +
(default: _inherit_)
|[source]
table:
  font-style: italic

|grid-color
|xref:tables.adoc#grid-color[Color] {vbar} xref:tables.adoc#grid-color[Color[\]] +
(default: `$table-border-color`)
|[source]
table:
  grid-color: #EEEEEE

|grid-style
|xref:tables.adoc#grid-style[Grid style] {vbar} xref:tables.adoc#grid-style[Grid style[\]] +
(default: `$table-border-style`)
|[source]
table:
  grid-style: dashed

|grid-width
|xref:tables.adoc#grid-width[Measurement] {vbar} xref:tables.adoc#grid-width[Measurement[\]] +
(default: `$table-border-width`)
|[source]
table:
  grid-width: 1
|===

[#head]
== table-head

The keys in the `table-head` category control the arrangement and style of the table header.
See <<header>> for the theme keys that apply to individual header cells.

[cols="3,4,6a"]
|===
|Key |Value Type |Example

|background-color
|xref:color.adoc[Color] +
(default: `$table-background-color`)
|[source]
table:
  head:
    background-color: #F0F0F0

|xref:tables.adoc#head-bottom-border[border-bottom-color]
|xref:blocks.adoc#border-color[Color] +
(default: `$table-border-color`)
|[source]
table:
  head:
    border-bottom-color: #DDDDDD

|xref:tables.adoc#head-bottom-border[border-bottom-style]
|xref:blocks.adoc#border-style[Border style] +
(default: `solid`)
|[source]
table:
  head:
    border-bottom-style: dashed

|xref:tables.adoc#head-bottom-border[border-bottom-width]
|xref:blocks.adoc#border-width[Measurement] +
(default: `1.25`)
|[source]
table:
  head:
    border-bottom-width: 1

|cell-padding
|xref:blocks.adoc#padding[Measurement] {vbar} xref:blocks.adoc#padding[Measurement[\]] +
(default: `$table-cell-padding`)
|[source]
table:
  head:
    cell-padding: [4, 2]

|font-color
|xref:color.adoc[Color] +
(default: `$table-font-color`)
|[source]
table:
  head:
    font-color: #333333

|font-family
|xref:font-support.adoc[Font family name] +
(default: `$table-font-family`)
|[source]
table:
  head:
    font-family: Noto Serif

|font-kerning
|`none` {vbar} `normal` +
(default: _inherit_)
|[source]
table:
  head:
    font-kerning: none

|font-size
|xref:text.adoc#font-size[Font size] +
(default: `$table-font-size`)
|[source]
table:
  head:
    font-size: 10

|font-style
|xref:text.adoc#font-style[Font style] +
(default: `bold`)
|[source]
table:
  head:
    font-style: normal

|line-height
|xref:language.adoc#values[Number] +
(default: _inherit_)
|[source]
table:
  head:
    line-height: 1.15

|text-transform
|xref:text.adoc#transform[Text transform] +
(default: _inherit_)
|[source]
table:
  head:
    text-transform: uppercase
|===

[#body]
== table-body

The keys in the `table-body` category control the background of the table body.

[cols="3,4,6a"]
|===
|Key |Value Type |Example

|background-color
|xref:color.adoc[Color] +
(default: `$table-background-color`)
|[source]
table:
  body:
    background-color: #FDFDFD

|xref:tables.adoc#stripes[stripe-background-color]
|xref:tables.adoc#stripes[Color] +
(default: `'EEEEEE'`)
|[source]
table:
  body:
    stripe-background-color: #EFEFEF
|===

[#foot]
== table-foot

The keys in the `table-foot` category control the arrangement and style of the table footer.

[cols="3,4,6a"]
|===
|Key |Value Type |Example

|background-color
|xref:color.adoc[Color] +
(default: `$table-background-color`)
|[source]
table:
  foot:
    background-color: #F0F0F0

|font-color
|xref:color.adoc[Color] +
(default: `$table-font-color`)
|[source]
table:
  foot:
    font-color: #333333

|font-family
|xref:font-support.adoc[Font family name] +
(default: `$table-font-family`)
|[source]
table:
  foot:
    font-family: Noto Serif

|font-size
|xref:text.adoc#font-size[Font size] +
(default: `$table-font-size`)
|[source]
table:
  foot:
    font-size: 10

|font-style
|xref:text.adoc#font-style[Font style] +
(default: `$table-font-style`)
|[source]
table:
  foot:
    font-style: italic
|===

[#cell]
== table-cell

The keys in the `table-cell` category control the arrangement and style of table cells.

[cols="2,4,6a"]
|===
|Key |Value Type |Example

|line-height
|xref:language.adoc#values[Number] +
(default: _inherit_)
|[source]
table:
  cell:
    line-height: 1.5

|padding
|xref:blocks.adoc#padding[Measurement] {vbar} xref:blocks.adoc#padding[Measurement[\]] +
(default: `2`)
|[source]
table:
  cell:
    padding: 3
|===

[#asciidoc]
== table-asciidoc-cell

The key in the `table-asciidoc-cell` category controls the style of AsciiDoc table cells.

[cols="2,4,6a"]
|===
|Key |Value Type |Example

|style
|`inherit` {vbar} `initial`
(default: `inherit`)
|[source]
table:
  asciidoc-cell:
    style: initial
|===

[#header]
== table-header-cell

The keys in the `table-header-cell` category control the style and arrangement of header cells.
See <<head>> for the theme keys that apply to the table header row.

[cols="3,4,6a"]
|===
|Key |Value Type |Example

|background-color
|xref:color.adoc[Color] +
(default: `$table-head-background-color`)
|[source]
table:
  header-cell:
    background-color: #F0F0F0

|font-color
|xref:color.adoc[Color] +
(default: `$table-head-font-color`)
|[source]
table:
  header-cell:
    font-color: #1A1A1A

|font-family
|xref:font-support.adoc[Font family name] +
(default: `$table-head-font-family`)
|[source]
table:
  header-cell:
    font-family: Noto Sans

|font-size
|xref:text.adoc#font-size[font-size] +
(default: `$table-head-font-size`)
|[source]
table:
  header-cell:
    font-size: 12

|font-style
|xref:text.adoc#font-style[Font style] +
(default: `$table-head-font-style`)
|[source]
table:
  header-cell:
    font-style: italic

|text-transform
|xref:text.adoc#transform[Text transform] +
(default: `$table-head-text-transform`)
|[source]
table:
  header-cell:
    text-transform: uppercase
|===

[#caption]
== table-caption

The keys in the `table-caption` category control the style and arrangement of the table captions.
The keys listed on xref:caption.adoc[] can also be nested under the `table-caption` category to further customize the table captions.

[cols="3,4,6a"]
|===
|Key |Value Type |Example

|xref:tables.adoc#caption-align[align]
|xref:tables.adoc#caption-align[Block alignment] {vbar} xref:tables.adoc#caption-align[inherit] +
(default: `$caption-align`)
|[source]
table:
  caption:
    align: center

|xref:tables.adoc#end[end]
|xref:tables.adoc#end[End placement] +
(default: `top`)
|[source]
table:
  caption:
    end: bottom

|max-width
|`fit-content` {vbar} `fit-content`(percentage) {vbar} `none` {vbar} xref:measurement-units.adoc[Measurement] +
(default: `fit-content`)
|[source]
table:
  caption:
    max-width: none

|xref:tables.adoc#caption-text-align[text-align]
|xref:tables.adoc#caption-text-align[Text alignment] {vbar} xref:tables.adoc#caption-text-align[inherit] +
(default: `$table-caption-align`)
|[source]
table:
  caption:
    text-align: center
|===

For more information about styling tables using the theming language, see xref:tables.adoc[].
