A sortable, paginated data table with custom cell/header templates, size variants, sticky headers, loading and empty states, and built-in row numbers. Since 21.4.0 it also reports what the user did (gogSortChange, gogPageChange, gogRowClick), hands sorting and paging to a server (lazy), and selects rows — so it is no longer a display-only grid.
Overview
Import TableComponent and GogColumn from @guildofgleks/ui/table, then declare one <gog-column> per field as content — the columns live in your template, not a config array. The entry point carries the column template directives and the table's event types too, and lets a table used only behind a lazy route keep its own code out of the initial bundle; what it imports from the root package (paginator, select, checkbox, scroll, spinner) loads wherever the root package already does.
Basic usage — sortable columns cycle asc → desc → unsorted on click. A sortable header holds a real <button>21.15.0, so it is one tab stop that Enter and Space sort, and the order is stated by aria-sort on the header cell.
loading replaces the body with a spinner and marks the host aria-busy. An empty value renders one row saying "No data" 21.15.0; emptyMessage sets it per table, because "No orders yet" and "Nothing matches these filters" are different sentences, and GOG_CONFIG.labels.tableEmpty sets it app-wide.
#
Owner
1
Buttons
Design
2
Checkbox
Forms
3
Table
Data
#
Component
Owner
No components match these filters
<div><gog-togglelabel="loading" [(checked)]="loading" /><gog-togglelabel="empty" [(checked)]="empty" /></div><gog-tableariaLabel="Components"
[value]="empty() ? [] : rows"
[loading]="loading()"size="sm"
[pageSize]="3"
><gog-columnfield="component"header="Component"sortable /><gog-columnfield="owner"header="Owner" /></gog-table><!-- emptyMessage: what this table's emptiness means, in its own words. --><gog-tableariaLabel="Components"
[value]="[]"size="sm"emptyMessage="No components match these filters"
><gog-columnfield="component"header="Component" /><gog-columnfield="owner"header="Owner" /></gog-table>
An empty state of your own — gogTableEmpty21.19.0
An <ng-template gogTableEmpty> inside the table replaces emptyMessage when there are no rows. Put a gog-empty-state in it and a table emptied by a filter is announced: the plain message is text in a cell, which changes on screen without a word to a screen reader. Clear the search, then type something that matches nothing.
A column swaps its default text for a gogColumnBody or gogColumnHeader template declared inside that column. The body context carries the row, its index and the resolved cell value. [gogColumnBodyTypeOf]="rows"21.15.0 types let-row against the same array, so a typo in row.status fails the build under strictTemplates; it is never read at runtime. In a sortable column a header template renders inside the sort button and becomes its name — keep it to text and decorative marks.
Status
Owner
Buttons
Ready
Design
Checkbox
Ready
Forms
Table
In review
Data
Accordion
Planned
-
Spinner
Ready
Feedback
Toast
Ready
Feedback
<gog-tableariaLabel="Components" [value]="rows" [showRowNumbers]="false"><gog-columnfield="component"header="Component"sortable /><gog-columnfield="status"header="Status"><ng-templategogColumnHeaderlet-header><gog-iconname="info" /> {{ header }} </ng-template><!-- [gogColumnBodyTypeOf] types let-row as Row under strictTemplates. --><ng-templategogColumnBody [gogColumnBodyTypeOf]="rows"let-rowlet-value="value"><gog-tag [variant]="variants[row.status] ?? 'info'"size="sm">{{ value }}</gog-tag></ng-template></gog-column><gog-columnfield="owner"header="Owner" /></gog-table>
Columns and missing values
showRowNumbers is on by default; showColumnBorders draws the vertical rules. A null or undefined cell renders emptyPlaceholder — "-" unless set; "Accordion" has no owner. width, minWidth and maxWidth size a column.
defaults — row numbers on, "-" for a missing value
<p>defaults — row numbers on, "-" for a missing value</p><gog-tableariaLabel="Components" [value]="rows"size="sm"><gog-columnfield="component"header="Component" /><gog-columnfield="owner"header="Owner" /></gog-table><p>showColumnBorders, emptyPlaceholder="n/a", column widths</p><gog-tableariaLabel="Components"
[value]="rows"size="sm"showColumnBordersemptyPlaceholder="n/a"
[showRowNumbers]="false"
><gog-columnfield="component"header="Component"width="12rem" /><gog-columnfield="owner"header="Owner" /><gog-columnfield="updated"header="Updated"minWidth="8rem" /></gog-table>
Full width
Full width of its container by default. [fullWidth]="false" sizes the table to its columns, measured against their content — for a narrow two-column table that should not stretch across a wide page.
pageSize above 0 pages the rows with the same gog-paginator documented separately. showTotal adds a row count; totalPosition places it (opposite the paginator by default) and paginatorPosition places the pages.
stickyHeader puts position: sticky on the header cells, and maxHeight gives them something to stick to: it caps the table's own scroll viewport. The two go together — without the cap the viewport is as tall as its content and the header rides away with it. It has to be the table's own viewport: the table wraps its markup in a horizontal gog-scroll, and a scroller moving on one axis is a scroll container on both, so nothing outside the table can be the header's scrollport. Scroll this one down and sideways. The frame stays put while rows scroll, and the vertical scrollbar starts below the header 21.15.0.
#
Component
Status
Owner
Updated
1
Buttons
Ready
Design
Today
2
Checkbox
Ready
Forms
Yesterday
3
Table
In review
Data
2 days ago
4
Accordion
Planned
-
This week
5
Spinner
Ready
Feedback
This month
6
Toast
Ready
Feedback
This month
<!-- maxHeight gives the table its own scroll viewport; stickyHeader pins the header to it. --><gog-tableariaLabel="Components" [value]="rows"maxHeight="200px"stickyHeader><gog-columnfield="component"header="Component"width="24rem" /><gog-columnfield="status"header="Status"width="20rem" /><gog-columnfield="owner"header="Owner"width="20rem" /><gog-columnfield="updated"header="Updated"width="20rem" /></gog-table>
App-wide labels — GOG_CONFIG
The total's word, the empty message and the names of the pagination and the selection checkboxes come from GOG_CONFIG.labels; the rows-per-page select from GOG_CONFIG.paginator. In an app the provider goes in app.config.ts — see Global Configuration.
Komponente
Buttons
Checkbox
Table
Komponente
Keine Daten
<!-- The total's word, the empty message and the checkbox names all come from the config. --><gog-tableariaLabel="Komponenten"
[value]="rows"size="sm"selectionMode="multiple"
[pageSize]="3"showTotal
[showRowNumbers]="false"
><gog-columnfield="component"header="Komponente" /></gog-table><gog-tableariaLabel="Komponenten" [value]="[]"size="sm" [showRowNumbers]="false"><gog-columnfield="component"header="Komponente" /></gog-table>
Reacting to the user
The table had no outputs at all before 21.4.0, which is what made it display-only. It now reports the three things a consumer needs to know about: a new sort, a new page, and a click on a row.
Sort a column, page through, click a row — newest event first:
#
1
Buttons
Ready
2
Checkbox
Ready
3
Table
In review
Sort a column, page through, click a row — newest event first.
gogPageChange is deliberately quiet twice. It does not fire on the first render, and it does not fire for the reset to page 1 that a new sort causes — that reset belongs to the sort. Without both rules a consumer refetching from each event would issue two requests for one user action.
gogRowClick alone is a mouse-only affordance: a <tr> is not focusable. interactiveRows makes rows focusable and styles them as clickable, so Enter and Space activate the focused one. If the action really is "open this one thing", a link or button inside a cell beats a whole-row target.
Selection
selectionMode turns it on; [(selection)] is always a T[], including in 'single' mode where it holds zero or one row. One shape to read beats a T | T[] | null union to narrow on every access.
#
Component
Status
Owner
1
Buttons
Ready
Design
2
Checkbox
Ready
Forms
3
Table
In review
Data
4
Accordion
Planned
-
5
Spinner
Ready
Feedback
6
Toast
Ready
Feedback
selection: nothing
<!-- dataKey: rows are matched by key, so a refetch keeps the selection. --><gog-tableariaLabel="Components"
[value]="rows"selectionMode="multiple"
[(selection)]="selection"dataKey="component"size="sm"
><gog-columnfield="component"header="Component" /><gog-columnfield="status"header="Status" /><gog-columnfield="owner"header="Owner" /></gog-table><p>selection: {{ names() }}</p>
Two rules worth stating outright, because both are silent when you get them wrong:
Set dataKey. Without it rows are matched by object identity, so any refetch that produces new objects drops the selection with nothing to show for it. It is also the @for track key, which is what lets the rendered DOM survive a refetch instead of being rebuilt.
Select-all covers the current page, not the whole data set. In lazy mode the table has never seen the other pages, and a control that meant different things in the two modes would be worse than either behaviour on its own.
The checkbox column appears on its own, and showSelectionColumn turns it off. The header select-all renders only in 'multiple' mode.
Selecting by row — selectOnRowClick21.15.0
[selectOnRowClick]="true" toggles a row's selection when the row itself is pressed, so the checkbox column can go. Click a row to select it and again to deselect it; the Open button stands in for an action in a cell.
#
Component
Owner
Action
1
Buttons
Design
2
Checkbox
Forms
3
Table
Data
4
Accordion
-
5
Spinner
Feedback
6
Toast
Feedback
selection: nothing · gogRowClick: — · opened: —
<gog-tableariaLabel="Components"
[value]="rows"selectionMode="multiple"
[(selection)]="selection"dataKey="component"
[showSelectionColumn]="false"selectOnRowClicksize="sm"
(gogRowClick)="lastClick.set($event.row.component)"
><gog-columnfield="component"header="Component" /><gog-columnfield="owner"header="Owner" /><gog-columnfield="status"header="Action"width="120px"><!-- A press on a control in a cell keeps its own meaning: Open does not select. --><ng-templategogColumnBody [gogColumnBodyTypeOf]="rows"let-row><gog-buttonvariant="ghost"size="xsm" (gogClick)="opened.set(row.component)"
>Open</gog-button
>
</ng-template></gog-column></gog-table><p>selection: {{ names() }} · gogRowClick: {{ lastClick() }} · opened: {{ opened() }}</p>
It makes the rows interactive on its own — focusable, styled as pressable, and toggled by Enter or Space on the focused row — so there is no interactiveRows to pair it with.
Two presses do not toggle. One that lands on a control inside a cell — a link, a button, a form field, the row's own checkbox — keeps its own meaning, which is why Open above does not select its row. And a drag that selects text in the row selects the text, so a value can still be copied.
gogRowClick still fires for every press. A table whose rows navigate — open a detail page — should leave selectOnRowClick off, or one press would select and navigate at once.
With the checkboxes off, the selection still reaches a screen reader. A selected row's first cell starts with visually hidden text, "Selected", set app-wide through GOG_CONFIG.labels.tableRowSelected. aria-selected on the row is not enough on its own: ARIA supports it on a row only inside a grid, and a plain table is not one. With the checkbox column shown, the checkbox states it and nothing is added.
Rows per page
pageSize is a model, not a plain input: [pageSize]="20" works exactly as before, and [(pageSize)]="size" became possible. That is the whole reason the rows-per-page select needs no wiring — the table binds its own model straight to the paginator's, and the select writes back through it with no intermediate signal to keep in sync in either direction.
#
Component
Owner
1
Buttons
Design
2
Checkbox
Forms
pageSize: 2
<!-- pageSize is a model: the select writes straight back through it. --><gog-tableariaLabel="Components"
[value]="rows"
[(pageSize)]="pageSize"showPageSizeSelect
[pageSizeOptions]="[2, 3, 6]"size="sm"
><gog-columnfield="component"header="Component" /><gog-columnfield="owner"header="Owner" /></gog-table><p>pageSize: {{ pageSize() }}</p>
The select is off by default, per table or app-wide through GOG_CONFIG.paginator — see Global Configuration. Changing the size returns to page 1 and does not emit gogPageChange: you already know from pageSizeChange, and firing both would make a lazy table fetch twice. The footer stays visible at a single page whenever the select is on, so the user is never stranded on a size with no control left to change it.
Server-driven tables — lazy
By default the table owns the whole data set: it sorts value and slices the page itself. With [lazy]="true" it does neither — valueis the current page, already sorted, rendered exactly as handed over. Give it totalRecords so it knows how many pages exist (without it, pagination stays hidden and it warns in dev mode), then refetch from the outputs.
137 rows that only ever leave the "server" one page at a time, with a 350 ms delay so the loading state is visible. Sorting and slicing happen in the fake endpoint — which is the point: the table must not re-order or re-slice what it is given.
#
Name
Team
Score
last request: —
<!-- lazy: value IS the current page, already sorted — the table does neither. --><gog-tableariaLabel="Records"
[value]="rows()"lazy
[sort]="sort()"
[totalRecords]="total()"
[pageSize]="pageSize()"
[loading]="loading()"showTotalshowPageSizeSelect
[pageSizeOptions]="[10, 20, 50]"dataKey="id"size="sm"
(gogSortChange)="onSort($event)"
(gogPageChange)="onPage($event)"
(pageSizeChange)="onPageSize($event)"
><gog-columnfield="name"header="Name"sortable /><gog-columnfield="team"header="Team"sortable /><gog-columnfield="score"header="Score"sortable /></gog-table><p>last request: {{ lastRequest() }}</p>
Row numbers still count from the current page ((page - 1) * pageSize + i + 1), and showTotal reports totalRecords rather than value.length. Do not sort or slice value yourself as well — that is exactly what the flag turns off.
Set sort when the server already orders the data.21.15.0 This endpoint answers by score, highest first, until told otherwise; [sort]="serverSort()" makes the Score header say so on the first render, where an unbound table would show every header unsorted. Setting sort does not fire gogSortChange, so binding the two — [sort]="sort()" (gogSortChange)="sort.set($event)" — is a two-way binding, not a loop.
In lazy mode pageSizeChange is the refetch signal for a new page size, so bind [pageSize] + (pageSizeChange) rather than the banana-box when you need to act on it.
Virtualized rows — virtualize
[virtualize]="true" renders only the rows in view. The table below holds 10 000, and every seventh carries a note long enough to wrap — so the rows genuinely differ in height, which is the case a table has and a dropdown does not. A row's height cannot be pinned: height on a <tr> or <td> is a minimum in table layout. So the window measures each row as it renders, and the scroll height sharpens as you scroll rather than being exact from the first frame.
#
Component
Status
Owner
1
Component 1 — with a long note attached, the kind that wraps across several lines
Ready
Design
2
Component 2
In review
Forms
3
Component 3
Planned
Data
4
Component 4
Ready
Navigation
5
Component 5
In review
Feedback
6
Component 6
Planned
Design
7
Component 7
Ready
Forms
8
Component 8 — with a long note attached, the kind that wraps across several lines
In review
Data
9
Component 9
Planned
Navigation
10
Component 10
Ready
Feedback
11
Component 11
In review
Design
12
Component 12
Planned
Forms
13
Component 13
Ready
Data
14
Component 14
In review
Navigation
15
Component 15 — with a long note attached, the kind that wraps across several lines
Planned
Feedback
<div><gog-checkboxlabel="virtualize" [(checked)]="virtualize" /></div><!-- Needs maxHeight (a viewport to window against) and fullWidth (fixed column layout). --><gog-tableariaLabel="Components"
[value]="rows"
[virtualize]="virtualize()"maxHeight="420px"stickyHeadersize="sm"
><gog-columnfield="component"header="Component"width="320px" /><gog-columnfield="status"header="Status"width="120px" /><gog-columnfield="owner"header="Owner"width="140px" /></gog-table>
It requires maxHeight and fullWidth, and both are measured constraints rather than preferences. Without maxHeight the table never scrolls on its own, so there is no viewport to window against; [fullWidth]="false" lays out with table-layout: auto, which sizes columns from whichever rows happen to be rendered. Switch either off and windowing turns itself off, with a warning in dev mode.
aria-rowcount and aria-rowindex keep the announced size and position honest, and gogRowClick's index still counts from the top. It is off by default and never switches itself on at a row count, because a windowed table behaves differently in ways a page can notice — the browser's find only sees rendered rows, and a :last-child selector matches the last rendered one.
lazy is not a substitute, and the two compose. The lazy flag keeps the fetch small and still stamps every row of the page it was handed; virtualize keeps the rows the browser builds small, whatever was fetched. One ceiling worth knowing: Chrome clamps an element's height at 33 554 426px, roughly 745 000 rows.
The window starts on the server.21.15.0 A server-rendered page carries a screenful of rows rather than all 10 000, and hydration takes over from there. maxHeight takes any CSS length for this: rem, vh or calc() window from the first frame as px does.
Where it stops
Stated here so you find out now rather than halfway into a project. gog-table has no column resizing or reordering by the reader — a column's width, minWidth and maxWidth are yours to set, not theirs to drag — no frozen columns, no expandable rows and no row grouping.
stickyHeader is not the missing feature in disguise: it pins the header while rows scroll under it, which is the vertical axis. Freezing a column against horizontal scroll is the other axis, and that one is absent. For a full data grid, use a dedicated one.
Accessibility
A native table: headers are <th scope="col">, sorting is aria-sort on the header, and each selection checkbox is named.
Name — ariaLabel21.19.0 names the table ("Orders") and, whenever its columns overflow, the scrolling region around it. An overflowing table is a Tab stop, so it needs a name to be told apart from the page; without one it warns in dev mode, once per page.
Sorting — a sortable header holds a real <button>, named by the header text; aria-sort on the cell states the order.
Rows — a <tr> is not focusable, so gogRowClick alone is mouse-only. interactiveRows (or selectOnRowClick) makes rows focusable, and Enter or Space activates the focused one.
Selection — the checkboxes are named by GOG_CONFIG.labels.selectRow / selectAllRows; with the column off, a selected row's first cell starts with visually hidden "Selected" (labels.tableRowSelected).
State — aria-busy while loading; an empty table says so in a row of its own, which a screen reader is not told about — a gogTableEmpty holding a gog-empty-state is. A virtualized table keeps aria-rowcount and aria-rowindex honest about the rows it is not rendering.
API Reference
gog-table — Inputs
Name
Type
Default
Description
value
readonly T[]
[]
The row data array. In lazy mode this is the current page, already sorted.
fullWidth
boolean
true
Fills its container by default. Set false to shrink to fit its columns instead.
pageSize
model<number>
0
Rows per page. 0 disables pagination. A model since 21.4.0, so [(pageSize)] binds two-way — which is what lets the rows-per-page select write back with no wiring in between.
showPageSizeSelect
boolean | undefined
false
Shows the paginator's rows-per-page select. Also settable app-wide via GOG_CONFIG.paginator.
pageSizeOptions
readonly number[] | undefined
[10, 20, 30, 40, 50]
The choices that select offers. Also settable app-wide via GOG_CONFIG.paginator.
lazy
boolean
false
Hands sorting and paging to you: value is rendered exactly as given and treated as the current page. Needs totalRecords.
totalRecords
number | null
null
How many rows exist in total, for lazy mode. Without it pagination stays hidden and the table warns in dev. showTotal reports this rather than value.length.
sort21.15.0
GogTableSortEvent | null
null
Seeds the sort, and replaces it whenever it changes — for data that arrives already ordered, so the header says what the server did. A header press still moves it in between. Setting it does not emit gogSortChange, so [sort]="sort()" (gogSortChange)="sort.set($event)" is a two-way binding.
selectionMode
'none' | 'single' | 'multiple'
'none'
Turns row selection on, and whether more than one row can be held at a time.
selection
model<T[]>
[]
Two-way bindable selected rows — always an array, including in 'single' mode where it holds zero or one row.
dataKey
string
''
The field (or dot-path) identifying a row. Selection matches on it instead of object identity, and it becomes the @for track key. Set it whenever the data can be refetched.
showSelectionColumn
boolean
true
The checkbox column that appears once selection is on. For a table that selects by clicking the row itself, turn it off and set selectOnRowClick. With it off, a selected row carries visually hidden "Selected" text (GOG_CONFIG.labels.tableRowSelected).
selectOnRowClick21.15.0
boolean
false
Toggles a row's selection when the row itself is pressed, and makes rows interactive on its own (focusable, Enter/Space toggle) — no interactiveRows needed. A press on a control inside a cell, or a drag that selects text, does not toggle. gogRowClick still fires, so leave it off where rows navigate. A no-op without selectionMode.
interactiveRows
boolean
false
Makes rows focusable and styled as clickable, so Enter/Space activate the focused row. Without it gogRowClick is a mouse-only affordance.
showRowNumbers
boolean
true
Shows a leading row-number column.
showTotal
boolean
false
Shows a row-count label.
emptyPlaceholder
string
'-'
Fallback text for a cell whose field is null or undefined.
emptyMessage21.15.0
string | undefined
'No data'
The text of the one row an empty table renders. Falls back to GOG_CONFIG.labels.tableEmpty, then to 'No data'. Before 21.15.0 that row was a dash.
ariaLabel21.19.0
string | undefined
undefined
Names the table ("Orders"), and its scrolling region whenever the columns overflow — an overflowing table is a Tab stop, and one without a name warns in dev mode.
paginatorPosition
'left' | 'center' | 'right'
'center'
Alignment of the pagination controls.
totalPosition
'left' | 'right' | 'opposite'
'opposite'
Alignment of the total-count label (only with showTotal). 'opposite' picks whichever side paginatorPosition isn't on.
loading
boolean
false
Shows a spinner in place of rows.
showColumnBorders
boolean
false
Vertical borders between columns.
stickyHeader
boolean
false
Holds the header row at the top of the table's own scroll viewport. Needs maxHeight — without it the viewport is content-height and never scrolls, so there is nothing to hold against.
maxHeight
string | null
null
Any CSS length ('420px', '60vh'). Caps the table's own scroll viewport, so the table owns its vertical scrolling instead of growing to its content and letting an ancestor scroll it. This is what makes stickyHeader work.
virtualize
boolean
false
Renders only the rows in view, measuring each one as it renders since a table row cannot be given a fixed height. Requires maxHeight and fullWidth — without either it turns itself off and warns in dev mode. Composes with lazy rather than replacing it. Since 21.15.0 the server renders a window too, not every row.
size
'xsm' | 'sm' | 'md' | 'lg' | 'slg'
'lg'
Row density — cell padding and font size scale with it.
gog-table — Outputs
Name
Payload
Description
gogSortChange
GogTableSortEvent
{ field, direction } — including the third click that clears the sort, which arrives as { field: '', direction: null }.
gogPageChange
number
The new 1-based page. Deliberately silent in two cases: the first render, and the reset to page 1 that a new sort causes.
gogRowClick
GogTableRowClickEvent<T>
{ row, index, originalEvent }. index is the position within the rendered page, not the whole data set.
pageSizeChange
number
The model's own change event. In lazy mode this is the refetch signal for a new page size — it does not also emit gogPageChange.
selectionChange
T[]
The selection model's change event, for when you don't want the banana-box.
gog-table — Templates
Directive
Context
Description
gogTableEmpty21.19.0
none
What the table shows when it has no rows, in place of emptyMessage. A gog-empty-state here is announced when a filter empties the table; the plain text cell is not. Import GogTableEmptyDirective from @guildofgleks/ui/table.
gog-column — Inputs
Name
Type
Default
Description
field
string
required
Field name, or a dot-path into a nested property (e.g. "address.city").
header
string
''
Header text.
sortable
boolean
false
Enables click-to-sort on the header: asc → desc → unsorted.
width
string
''
Fixed width, e.g. "120px" or "20%".
minWidth
string
''
Minimum width, e.g. "80px".
maxWidth
string
''
Maximum width, e.g. "300px".
comparator
((a: unknown, b: unknown) => number) | null
null
Custom sort comparator for this column. Defaults to a locale-aware string compare, </> otherwise.
gog-column — Templates
Directive
Context
Description
gogColumnBody
$implicit / row (the row object), index, value
Custom cell markup for this column. value is the already-resolved cell value for the column's field, so a custom cell can decorate it rather than re-derive it. index is the position within the rendered page, not the whole data set.
[gogColumnBodyTypeOf]
readonly T[] — an input on gogColumnBody
Since 21.15.0. Bind the same array the table renders and let-row is typed as its element instead of unknown. Never read at runtime; left unbound, the template compiles exactly as before. value stays unknown either way, since it is read from a field string.
gogColumnHeader
$implicit (the column's own header text), field
Custom header markup for this column. The header text is handed in so a custom header can decorate it rather than restate it. In a sortable column it renders inside the sort button and names it, so keep links, buttons and form controls out of it.
Global Configuration
Set any of these once with provideGogConfig() instead of repeating them on every instance — an instance's own input still wins when it sets one itself. See Global Configuration for the full reference.
GOG_CONFIG.paginator.showPageSizeSelect — through the built-in pagination
GOG_CONFIG.paginator.pageSizeOptions — through the built-in pagination
GOG_CONFIG.labels.total
GOG_CONFIG.labels.tablePagination
GOG_CONFIG.labels.selectRow
GOG_CONFIG.labels.selectAllRows
GOG_CONFIG.labels.tableRowSelected — hidden text on a selected row, when the checkbox column is off
GOG_CONFIG.labels.tableEmpty — the row an empty table renders; emptyMessage wins
GOG_CONFIG.spinner.component — the spinner shown in place of rows while loading
GOG_CONFIG.spinner.variant — the same spinner, when no component is set
Styling Tokens
Every CSS custom property the table paints with. Override any of them — on a single instance, a subtree, or a theme — to restyle it. See the Theming guide for the full token-layering model, or the Theme Generator to tweak these live.
Token
Description
--gog-table-border-color / -border-width
Outer border.
--gog-table-surface / -text-color / -accent-color
Surface, body text and header accent.
--gog-table-hover-bg
Row hover background.
--gog-table-row-press-bg
An interactiveRows row under the finger, since 21.13.0 — a colour rather than a ripple, so it survives prefers-reduced-motion. A plain row does not use it.