The Styles API is a set of props and techniques that allows you to customize the style of any element inside a Mantine component – inline or using the theme object . All Mantine components that have styles support the Styles API.
Every Mantine component that supports the Styles API has a set of element names that can be used to apply styles to inner elements inside the component. For simplicity, these element names are called selectors in the Mantine documentation. You can find selector information under the Styles API tab in a component's documentation.
Example of the Button component selectors:
You can use these selectors in classNames and styles in both component props and theme.components :
With the classNames prop you can add classes to inner elements of Mantine components. It accepts an object with element names as keys and classes as values:
You can also define classNames in theme.components to apply them to all components of a specific type:
Most of Mantine components use CSS variables to define colors, sizes, paddings and other properties. You can override these values using a custom CSS variables resolver function in theme.components or by passing it to the vars prop.
You can find CSS variables information under the Styles API tab in a component's documentation. Example of Button component CSS variables:
Example of a custom CSS variables resolver function used to add more sizes to the Button component:
The styles prop works the same way as classNames , but applies inline styles. Note that inline styles have higher specificity than classes, so you will not be able to override them with classes without using !important . You cannot use pseudo-classes (for example, :hover , :first-of-type ) and media queries inside the styles prop.
Some examples and demos in the documentation use the styles prop for convenience, but it is not recommended to use the styles prop as the primary means of styling components, as the classNames prop is more flexible and has better performance .
You can also pass a callback function to classNames and styles . This function will receive theme as first argument and component props as second. It should return an object of classes (for classNames ) or styles (for styles ).
You can use this feature to conditionally apply styles based on component props. For example, you can change the TextInput label color if the input is required or change the input background color if the input is wrong:
Every component that supports Styles API also includes static classes that can be used to style component without using classNames or styles props. By default, static classes have .mantine-{ComponentName}-{selector} format. For example, root selector of Button component will have .mantine-Button-root class.
You can use static classes to style a component with CSS or any other styling solution :
The prefix of static classes can be changed with classNamesPrefix of MantineProvider .
Classes of each component are available in the Component.classes object. For example, you can find the classes of Button in Button.classes :
You can use these classes to create components with the same styles as Mantine components:
You can pass attributes to inner elements of Mantine components using the attributes prop. For example, it can be used to add data attributes for testing purposes: