Choosing the right radius setting in your theme.
Theme radius
setting manages the radius factor applied to the components:
The resulting border-radius
is contextual and differs depending on the component. For example, when set to full
, a Button becomes pill-shaped, while a Checkbox will never become fully rounded to prevent any confusion between it and a Radio.
Certain components allow you to override the radius factor using their own radius
prop.
Components that render panels, like Card, Dialog, and Popover, among others, won’t have the radius
prop, but will inherit the radius setting from the theme. The radius
prop is also unavailable on most text-based components.
Radius values used in the components are derived from a 6-step scale.
While you can’t use a specific step on a particular component directly—the radius
prop is used to set just the radius factor—you can use the radius scale to style your own components.
Radius tokens are accessed using CSS variables. You can use these tokens to style your custom components, ensuring they are consistent with the rest of your theme.