Docs Version 1

<zg-focus>

Interactive Storybook Playground

The <zg-focus> tag is a web component that is used as a container for the focus of cell(s) and used as a CSS target for styling by the developer. The <zg-focus> web component should not be accessed specifically beyond styling.

Image of the DOM relationship for the zg-focus web component tag

ZGFocus Relationships
Component Relationship Type Ancestor
ZingGrid Parent Generated n/a

Related Web Components

Usage

The <zg-focus> element is a generated element added to <zing-grid> when the selector attribute is defined.

<zing-grid selector
  src="https://cdn.zinggrid.com/datasets/user-roles.json">
</zing-grid>
Top

Attributes

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

Top

CSS Variables

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

:root {
--zg-focus-border-top: 1px solid red;
}

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

ZGFocus CSS Variables and Default Values
Name Default Description Demo CSS Ref
--zg-focus-border 2px solid var(--theme-color-primary) Styles the border of cells on focus
--zg-focus-border-bottom var(--zg-focus-border, 2px solid var(--theme-color-primary)) Sets the bottom border of cells on focus
--zg-focus-border-left var(--zg-focus-border, 2px solid var(--theme-color-primary)) Sets the left border of cells on focus
--zg-focus-border-right var(--zg-focus-border, 2px solid var(--theme-color-primary)) Sets the right border of cells on focus
--zg-focus-border-top var(--zg-focus-border, 2px solid var(--theme-color-primary)) Sets the top border of cells on focus
--zg-focus-bottom-transform none Sets the transform of bottom border of cells on focus
--zg-focus-left-transform none Sets the transform of left border of cells on focus
--zg-focus-right-transform none Sets the transform of right border of cells on focus
--zg-focus-top-transform none Sets the transform of top border of cells on focus
Top

CSS Selector

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

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

CSS Shadow Parts

<zg-focus> exposed elements within the shadow can be styled by CSS shadow parts, like so:

zg-focus::part(focus) {
  background-color: red;
}

Below is a list of all the associated ZGFocus shadow parts. Check out the full list of CSS shadow parts or our Styling Basics guide to learn more about styling the grid.

ZGFocus CSS Shadow Parts
Name Description
bottom The bottom edge of the focus
focus Focus container
left The left edge of the focus
right The right edge of the focus
top The top edge of the focus
Top

Slots

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

Top

[api: <zg-focus>]