Back to Vuetify

Border radius

packages/docs/src/pages/en/styles/border-radius.md

4.1.77.7 KB
Original Source

Border radius

Use border utilities to quickly style the border-radius of any element.

<PageFeatures />
ClassProperties
roundedborder-radius: 4px;
rounded-0border-radius: 0;
rounded-smborder-radius: 2px;
rounded-mdborder-radius: 4px;
rounded-lgborder-radius: 8px;
rounded-xlborder-radius: 24px;
rounded-pillborder-radius: 9999px;
rounded-circleborder-radius: 50%;
rounded-shapedborder-radius: 24px 0
rounded-tborder-top-left-radius: 4px;
border-top-right-radius: 4px;
rounded-t-0border-top-left-radius: 0;
border-top-right-radius: 0;
rounded-t-smborder-top-left-radius: 2px;
border-top-right-radius: 2px;
rounded-t-mdborder-top-left-radius: 4px;
border-top-right-radius: 4px;
rounded-t-lgborder-top-left-radius: 8px;
border-top-right-radius: 8px;
rounded-t-xlborder-top-left-radius: 24px;
border-top-right-radius: 24px;
rounded-t-pillborder-top-left-radius: 9999px;
border-top-right-radius: 9999px;
rounded-t-circleborder-top-left-radius: 50%;
border-top-right-radius: 50%;
rounded-t-shapedborder-top-left-radius: 24px; border-top-right-radius: 0;
rounded-teborder-top-right-radius: 4px;
rounded-te-0border-top-right-radius: 0;
rounded-te-smborder-top-right-radius: 2px;
rounded-te-mdborder-top-right-radius: 4px;
rounded-te-lgborder-top-right-radius: 8px;
rounded-te-xlborder-top-right-radius: 24px;
rounded-te-pillborder-top-right-radius: 9999px;
rounded-te-circleborder-top-right-radius: 50%;
rounded-te-shapedborder-top-right-radius: 24px
border-top-left-radius: 0;
rounded-tsborder-top-left-radius: 4px;
rounded-ts-0border-top-left-radius: 0;
rounded-ts-smborder-top-left-radius: 2px;
rounded-ts-mdborder-top-left-radius: 4px;
rounded-ts-lgborder-top-left-radius: 8px;
rounded-ts-xlborder-top-left-radius: 24px;
rounded-ts-pillborder-top-left-radius: 9999px;
rounded-ts-circleborder-top-left-radius: 50%;
rounded-ts-shapedborder-top-left-radius: 24px; border-top-right-radius: 0;
rounded-eborder-inline-end-radius: 4px;
rounded-e-0border-inline-end-radius: 0;
rounded-e-smborder-inline-end-radius: 2px;
rounded-e-mdborder-inline-end-radius: 4px;
rounded-e-lgborder-inline-end-radius: 8px;
rounded-e-xlborder-inline-end-radius: 24px;
rounded-e-pillborder-inline-end-radius: 9999px;
rounded-e-circleborder-inline-end-radius: 50%;
rounded-e-shapedborder-inline-end-radius: 0; border-inline-start-radius: 24px;
rounded-bborder-bottom-left-radius: 4px;
border-bottom-right-radius: 4px;
rounded-b-0border-bottom-left-radius: 0;
border-bottom-right-radius: 0;
rounded-b-smborder-bottom-left-radius: 2px;
border-bottom-right-radius: 2px;
rounded-b-mdborder-bottom-left-radius: 4px;
border-bottom-right-radius: 4px;
rounded-b-lgborder-bottom-left-radius: 8px;
border-bottom-right-radius: 8px;
rounded-b-xlborder-bottom-left-radius: 24px;
border-bottom-right-radius: 24px;
rounded-b-pillborder-bottom-left-radius: 9999px;
border-bottom-right-radius: 9999px;
rounded-b-circleborder-bottom-left-radius: 50%;
border-bottom-right-radius: 50%;
rounded-b-shapedborder-bottom-left-radius: 0; border-bottom-right-radius: 24px;
rounded-beborder-bottom-right-radius: 4px;
rounded-be-0border-bottom-right-radius: 0;
rounded-be-smborder-bottom-right-radius: 2px;
rounded-be-mdborder-bottom-right-radius: 4px;
rounded-be-lgborder-bottom-right-radius: 8px;
rounded-be-xlborder-bottom-right-radius: 24px;
rounded-be-pillborder-bottom-right-radius: 9999px;
rounded-be-circleborder-bottom-right-radius: 50%;
rounded-be-shapedborder-bottom-right-radius: 24px; border-bottom-left-radius: 0;
rounded-bsborder-inline-start-radius: 4px;
rounded-bs-0border-inline-start-radius: 0;
rounded-bs-smborder-inline-start-radius: 2px;
rounded-bs-mdborder-inline-start-radius: 4px;
rounded-bs-lgborder-inline-start-radius: 8px;
rounded-bs-xlborder-inline-start-radius: 24px;
rounded-bs-pillborder-inline-start-radius: 9999px;
rounded-bs-circleborder-inline-start-radius: 50%;
rounded-bs-shapedborder-inline-start-radius: 24px; border-inline-end-radius: 0;
rounded-sborder-inline-start-radius: 4px;
rounded-s-0border-inline-start-radius: 0;
rounded-s-smborder-inline-start-radius: 2px;
rounded-s-mdborder-inline-start-radius: 4px;
rounded-s-lgborder-inline-start-radius: 8px;
rounded-s-xlborder-inline-start-radius: 24px;
rounded-s-pillborder-inline-start-radius: 9999px;
rounded-s-circleborder-inline-start-radius: 50%;
rounded-s-shapedborder-inline-start-radius: 24px; border-inline-end-radius: 0; { style="max-height: 420px;" fixed-header }
<PromotedEntry />

Usage

The border-radius utilities allow you to quickly style the border-radius of any element.

Rounded corners

Use the rounded, rounded-0, rounded-sm, rounded-md, rounded-lg, and rounded-xl classes to set the border-radius of an element.

<ExamplesExample file="border-radius/misc-rounded-corners" />

Pill and circle

Use the rounded-pill and rounded-circle classes to create pill and circle shapes.

<ExamplesExample file="border-radius/misc-pill-and-circle" />

Rounding by side

Use the rounded-t-*, rounded-b-*, rounded-s-*, and rounded-e-* classes to set the border-radius of an element on a specific side.

<ExamplesExample file="border-radius/misc-rounding-by-side" />

Rounding by corner

Use the rounded-te-*, rounded-ts-*, rounded-be-*, and rounded-bs-* classes to set the border-radius of an element on a specific corner.

<ExamplesExample file="border-radius/misc-rounding-by-corner" />

No rounding

Use the rounded-0 class to remove the border-radius from an element.

<ExamplesExample file="border-radius/misc-removing-border-radius" />

Components

::: info

When using the rounded property on components, omit the rounded- prefix. For example, use rounded="sm" instead of rounded-sm.

:::

Setting the rounded property applies a component specific border-radius class, such as v-sheet--rounded. This is to ensure that basic rounded usage persists even if the utility classes are disabled.

<ExamplesExample file="border-radius/misc-components" />

Arbitrary border radius

<DocIntroduced version="4.1.0" />

In addition to the named sizes, the rounded prop accepts any valid CSS value or a plain number (converted to px):

html
<v-sheet rounded="8" />       <!-- border-radius: 8px -->
<v-sheet rounded="1.5rem" />  <!-- border-radius: 1.5rem -->
<v-sheet rounded="50%" />     <!-- border-radius: 50% -->

SASS variables

You can also use the following SASS variables to customize the border radius:

scss
$rounded: (
  0: 0,
  'sm': $border-radius-root / 2,
  null: $border-radius-root,
  'md': $border-radius-root,
  'lg': $border-radius-root * 2,
  'xl': $border-radius-root * 6,
  'pill': 9999px,
  'circle': 50%
);

Disable border-radius class generation by setting the $rounded variable to false.

sass
@use 'vuetify/settings' with (
  $rounded: false
);