Divider

The <nys-divider> component visually separates content or sections within an interface.

Sample content above
Sample content below
Copy Code
<div>Sample content above</div>
<nys-divider></nys-divider>
<div>Sample content below</div>

Can't use NYS Design System web components in your project? Try using the CSS Variables instead.

Accessibility

The <nys-divider> component includes the following accessibility-focused features:

  • The native <hr> element is used to ensure ARIA compliance

    Additional accessibility test and build content is coming soon, in a new format.

Options

Subtle

Add the subtle property to make the <nys-divider> less visually prominent.

Sample content above
Sample content below
Copy Code
<div>Sample content above</div>
<nys-divider subtle></nys-divider>
<div>Sample content below</div>

Inverse

On dark background, add the inverted property to ensure the <nys-divider> is visible.

Sample content above
Sample content below
Copy Code
<div>Sample content above</div>
<nys-divider inverted></nys-divider>
<div>Sample content below</div>

Usage

Do

  • Ensure consistent padding/margin above and below dividers to avoid crowding.

  • Use the inverted option on dark backgrounds.

Don't

  • Don't overuse dividers and clutter the interface, reducing scannability.

  • Don't use the divider to separate content appearing side by side.

  • Don't use the inverted option on light backgrounds.

  • Properties

    Property Type
    inverted Boolean
    subtle Boolean

    Style Overrides

    There are no existing CSS variables for this component. Explore existing options, or propose a new one with a Component Proposal.

    Events

    The <nys-divider> is a visual component that does not emit any events.

    Suggest a New Component

    Do you have an idea for a new NYS Design System web component? Look through the existing proposals in our GitHub discussions board to see if someone already proposed something similar. If not, feel free to submit one.