experiment_id: web-retrieval-v1
fixture_id: /docs/api/tags/zg-calendar-selection
mode: provenance
representation: html
origin_response_id: 9202de4feca8467078da0f8282e0be29
version: 2026-10-21
version_created_at_utc: 2026-10-21T20:42:35.616Z
version_nonce: 955929f20c19728893294e49e60adf38
generated_at_utc: 2026-11-16T00:52:52.743Z
response_nonce: 6c06d9a323aa9bc4e431190552a21f02
Docs Version 1

<zg-calendar-selection>

Interactive Storybook Playground

The <zg-calendar-selection> tag is a web component that controls the functionality and styling for the date range picker overlay that appears when clicking the calendar selection button in a filter summary row. It allows users to select a "From" and "To" date range to filter date-type columns. This web component is dynamically inserted by the grid and can be styled by CSS variables or the zg-calendar-selection CSS selector.

Image of the DOM relationship for the zg-calendar-selection web component tag

Related Web Components

Usage

<zg-calendar-selection> is automatically inserted when a date-type column is using the calendar filter summary chart and the user clicks the calendar selection button in that column's filter summary row.

<zing-grid
  filter="summary"
  src="...">
  <zg-column index="name"></zg-column>
  <zg-column index="startDate" type="date" filter-summary-chart="calendar"></zg-column>
</zing-grid>

Check out the Filtering Summary Chart documentation to learn more about the calendar chart type.

Top

Attributes

There are no attributes available for the <zg-calendar-selection> web component.

Top

CSS Variables

<zg-calendar-selection> can be styled with CSS variables, like so:

:root {
  --zg-calendar-selection-background: red;
}

Below is a list of all the associated --zg-cal-sel CSS variables. Check out the full list of CSS variables or our Styling Basics guide to learn more about styling the grid.

ZGCalendarSelection CSS Variables and Default Values
Name Default Description Demo CSS Ref
Top

CSS Selector

<zg-calendar-selection> can be styled by common CSS selectors, like so:

zg-calendar-selection {
  border: 1px solid red;
}
Top

Slots

There are no slots available for the <zg-calendar-selection> web component.

Top

[api: <zg-calendar-selection>]