Configuration table
A configuration table, nol-configuration-table: the kit's pattern for a Settings page that lists items. An optional heading, which names the table, sits above it, with any content marked ConfigurationTableActionDirective at the end of the heading's row, then an optional explanation, then the owner's own native table, marked ConfigurationTableDirective, with its column headers and its row actions. A table with actions but no heading puts its explanation at the start of the actions' row instead: the explanation takes the rest of the row and wraps, its first line level with the actions' labels, and the actions wrap under it once it would be narrower than a text field. The heading's row, the explanation and the table stand 0.75rem apart, and a part that is missing leaves no gap. Cells line up on their first line's baseline and have 0.5rem padding, except on the outer side of each row's first and last cells, and a line runs under the header and every row. Every column keeps to one line except the one marked with ConfigurationTableFillDirective, which takes the rest of the width, stays at least a text field wide and wraps. Columns marked with ConfigurationTableShareDirective share the width instead, the free-text column taking its share with no minimum, and a column marked with ConfigurationTableRowActionsDirective holds each row's buttons at its end. Once it can shrink no further, the table runs past the component's end, keeping room at its edges for a focus outline and a hovered row's band, and the area that holds it scrolls sideways; the table has no scrollbar of its own. A table with shares scrolls sideways inside the component instead, with the same room, while the heading's row and the explanation stay in place. The row under the pointer shows a band in the hover color behind its cells, reaching 0.5rem past both ends of the table while the text stays on the heading's line, so the owner leaves at least 0.5rem beside the component; under forced colors a dashed Highlight line runs just inside the row's edges instead, with no band.
Examples
Loading…
States
Loading…
API
Selector nol-configuration-table
Import from @noldova/ui.components.angular
Inputs
| Name | Type | Default | Description |
|---|---|---|---|
heading | string | String.empty | The heading above the table, its |
label | string | String.empty | The table's accessible name when it has no heading, its |
level | number | ConfigurationTableComponentResources.configurationTableHeadingLevel | The heading level screen readers announce, its |
explanation | string | String.empty | The text between the heading's row and the table, or at the start of the actions' row when there is no heading, its |
Accessibility
It takes no keys of its own.
Its heading is a heading at level 3 unless its owner gives another level, and it names the table; without a heading, its label names the table.
The owner's table keeps its column headers; an actions column shows no heading but keeps its name, such as Actions, for screen readers.
The owner names each row's actions for their row, such as Remove Ada Park; the heading's actions, such as Add, sit at the end of the heading's row.
Under forced colors a hovered row shows a dashed Highlight line inside its edges instead of a band.
Specification
Loading…