Styling

Radix Primitives are unstyled—and compatible with any styling solution—giving you complete control over styling.

You are in control of all aspects of styling, including functional styles. For example—by default—a Dialog Overlay won't cover the entire viewport. You're responsible for adding those styles, plus any presentation styles.

Data attributes

Each component has a data-radix-* attribute, matching its name. For example, the Separator component includes a data-radix-separator attribute.

When components are stateful, their state will be exposed in a data-state attribute. For example, when an Accordion Item is opened, it includes a data-state="open" attribute.

Classes

All components accept a className prop. This class will be passed through to the DOM element. You can use it in CSS as expected.

Styling with CSS

Styling a part

You can style a component part by targeting its data-radix-* attribute.

[data-radix-accordion-item] {
  border-bottom: 1px solid gainsboro;
}

[data-radix-accordion-panel] {
  padding: 10px;
}

[data-radix-accordion-item] {
  border-bottom: 1px solid gainsboro;
}
[data-radix-accordion-panel] {
  padding: 10px;
}

Styling a state

You can style a component state by targeting its data-state attribute.

[data-radix-accordion-item] {
  border-bottom: 1px solid gainsboro;
}

[data-radix-accordion-item][data-state='open'] {
  border-bottom-width: 2px;
}

[data-radix-accordion-item] {
  border-bottom: 1px solid gainsboro;
}
[data-radix-accordion-item][data-state='open'] {
  border-bottom-width: 2px;
}

Styling with CSS-in-JS

The examples below are using Stitches, but you an use any CSS-in-JS library of your choice.

Styling a part

You can style a component part by wrapping it in a styled function (or equivalent).

import { styled } from 'path-to/stitches.config';
import * as Accordion from '@radix-ui/react-accordion';

const StyledItem = styled(Accordion.Item, {
  borderBottom: '1px solid gainsboro',
});

const StyledPanel = styled(Accordion.Panel, {
  padding: 10,
});

import { styled } from 'path-to/stitches.config';
import * as Accordion from '@radix-ui/react-accordion';
const StyledItem = styled(Accordion.Item, {
  borderBottom: '1px solid gainsboro',
});
const StyledPanel = styled(Accordion.Panel, {
  padding: 10,
});

Styling a state

You can style a component state by targeting its data-state attribute.

import { styled } from 'path-to/stitches.config';
import * as Accordion from '@radix-ui/react-accordion';

const StyledItem = styled(Accordion.Item, {
  borderBottom: '1px solid gainsboro',

  '&[data-state=open]': {
    borderBottomWidth: '2px',
  },
});

import { styled } from 'path-to/stitches.config';
import * as Accordion from '@radix-ui/react-accordion';
const StyledItem = styled(Accordion.Item, {
  borderBottom: '1px solid gainsboro',
  '&[data-state=open]': {
    borderBottomWidth: '2px',
  },
});

Demo

Here's an example of how you can style the Accordion component with CSS-in-JS.

import { styled } from 'path-to/stitches.config';
import * as Accordion from '@radix-ui/react-accordion';

const StyledAccordion = styled(Accordion.Root, {
  borderTop: '1px solid hsl(210,15%,70%)',
});

const StyledItem = styled(Accordion.Item, {
  borderBottom: '1px solid hsl(210,15%,70%)',
});

const StyledHeader = styled(Accordion.Header, {
  margin: 0,
  display: 'flex',
});

const StyledButton = styled(Accordion.Button, {
  appearance: 'none',
  border: 'none',
  backgroundColor: 'transparent',
  color: 'hsl(210,10%,48%)',
  padding: '10px 15px',
  flex: 1,
  textAlign: 'left',

  '&:focus': {
    outline: 'none',
    boxShadow:
      '0 0 0 1px hsl(272,62%,44%), 0 0 0 3px hsl(272,100%,96%)',
  },
});

const StyledPanel = styled(Accordion.Panel, {
  padding: '10px 15px',
  color: 'hsl(272,62%,44%)',
});

export default () => (
  <StyledAccordion>
    <StyledItem value="item-1">
      <StyledHeader>
        <StyledButton>Item 1</StyledButton>
      </StyledHeader>
      <StyledPanel>
        Here goes the content for the accordion item 1.
      </StyledPanel>
    </StyledItem>

    <StyledItem value="item-2">
      <StyledHeader>
        <StyledButton>Item 2</StyledButton>
      </StyledHeader>
      <StyledPanel>
        Here goes the content for the accordion item 2.
      </StyledPanel>
    </StyledItem>

    <StyledItem value="item-3">
      <StyledHeader>
        <StyledButton>Item 3</StyledButton>
      </StyledHeader>
      <StyledPanel>
        Here goes the content for the accordion item 3.
      </StyledPanel>
    </StyledItem>
  </StyledAccordion>
);

import { styled } from 'path-to/stitches.config';
import * as Accordion from '@radix-ui/react-accordion';
const StyledAccordion = styled(Accordion.Root, {
  borderTop: '1px solid hsl(210,15%,70%)',
});
const StyledItem = styled(Accordion.Item, {
  borderBottom: '1px solid hsl(210,15%,70%)',
});
const StyledHeader = styled(Accordion.Header, {
  margin: 0,
  display: 'flex',
});
const StyledButton = styled(Accordion.Button, {
  appearance: 'none',
  border: 'none',
  backgroundColor: 'transparent',
  color: 'hsl(210,10%,48%)',
  padding: '10px 15px',
  flex: 1,
  textAlign: 'left',
  '&:focus': {
    outline: 'none',
    boxShadow:
      '0 0 0 1px hsl(272,62%,44%), 0 0 0 3px hsl(272,100%,96%)',
  },
});
const StyledPanel = styled(Accordion.Panel, {
  padding: '10px 15px',
  color: 'hsl(272,62%,44%)',
});
export default () => (
  <StyledAccordion>
    <StyledItem value="item-1">
      <StyledHeader>
        <StyledButton>Item 1</StyledButton>
      </StyledHeader>
      <StyledPanel>
        Here goes the content for the accordion item 1.
      </StyledPanel>
    </StyledItem>
    <StyledItem value="item-2">
      <StyledHeader>
        <StyledButton>Item 2</StyledButton>
      </StyledHeader>
      <StyledPanel>
        Here goes the content for the accordion item 2.
      </StyledPanel>
    </StyledItem>
    <StyledItem value="item-3">
      <StyledHeader>
        <StyledButton>Item 3</StyledButton>
      </StyledHeader>
      <StyledPanel>
        Here goes the content for the accordion item 3.
      </StyledPanel>
    </StyledItem>
  </StyledAccordion>
);

Summary

Radix Primitives were designed to encapsulate accessibility concerns and other complex functionalities, while ensuring you retain complete control over styling.

To ensure compatibility with global CSS solutions, components include a data-radix-* attribute. Stateful components include a data-state attribute.

Every component that renders an HTML element will contain these attributes, so feel free to inspect them and look around.

Styling

Styling overview

Functional styles

Data attributes

Classes

Styling with CSS

Styling a part

Styling a state

Styling with CSS-in-JS

Styling a part

Styling a state

Demo

Summary