Skip to main content
Light Dark System

Data Table Columns

<zn-data-table-columns> | ZnDataTableColumns
Since 1.0 experimental

Column visibility and ordering control for data tables.

<zn-data-table-columns></zn-data-table-columns>

Overview

zn-data-table-columns is the column control used by zn-data-table. The table renders it automatically into its panel header, so you rarely place it yourself. It shows an icon button; clicking it opens a top-layer drawer (zn-slideout) listing every column with a checkbox and a drag handle. Toggling a checkbox shows or hides a column; dragging reorders them. The last visible column cannot be hidden.

Properties

  • columns — array of { key, label } describing every available column, in canonical order.
  • value — array of visible column keys, in display order. This is the source of truth for both visibility and order.
  • label — the drawer title (default "Columns").

Events

  • zn-columns-change — emitted on every change with detail.columns: the ordered array of visible column keys.

Usage with a data table

When used by zn-data-table, the table supplies columns and value, listens for zn-columns-change, and persists the result. See the Column Visibility & Order example on the data table page.

Importing

If you’re using the autoloader or the traditional loader, you can ignore this section. Otherwise, feel free to use any of the following snippets to cherry pick this component.

To import this component from the CDN using a script tag:

<script type="module" src="https://cdn.jsdelivr.net/npm/@kubex/zinc@1.1.15/dist/components/data-table-columns/data-table-columns.js"></script>

To import this component from the CDN using a JavaScript import:

import 'https://cdn.jsdelivr.net/npm/@kubex/zinc@1.1.15/dist/components/data-table-columns/data-table-columns.js';

To import this component using a bundler:

import '@kubex/zinc/dist/components/data-table-columns/data-table-columns.js';

Events

Name React Event Description Event Detail
zn-columns-change Emitted with the ordered list of visible column keys when the user changes columns. -

Learn more about events.

Parts

Name Description
base The component’s base wrapper.

Learn more about customizing CSS parts.

Dependencies

This component automatically imports the following dependencies.

  • <zn-button>
  • <zn-checkbox>
  • <zn-example>
  • <zn-icon>
  • <zn-slideout>
  • <zn-tooltip>