Divider
The <nys-divider> component visually separates content or sections within an interface.
<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 complianceAdditional 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.
<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.
<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
invertedoption 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.
Edit this page on GitHub (Permissions required)
Last updated: November 12, 2026