Vueless Docs
ComponentsGitHubWebsite
  • Getting Started
  • Installation
    • Quick start (Vue)
    • Quick start (Nuxt)
    • Class autocompletion
    • Minimal requirements
    • Storybook docs
  • Global customization
    • General
    • Colors
    • Design system
    • Rounding
    • Focus Outline
    • Font Size
    • Disabled Opacity
    • Dark mode
    • Custom tailwind classes
  • Component customization
    • General
    • Styling
    • Unstyled mode
    • Conditional styling
    • Extends styling from keys
    • Nested components styling
    • Props defaults
    • Redefining props
    • Defining custom props
    • Internationalization (i18n)
  • Creating own components
    • Vueless file structure
    • Create new component
    • Copy existing component
  • Svg Icons
    • General usage
    • Custom icons
    • Dynamic import
    • Advanced settings
  • Helpers
    • Change settings in runtime
  • Other
    • Vueless Vite Plugins
Powered by GitBook
On this page
  1. Global customization

Rounding

Last updated 22 days ago

You can set three sizes of border radiuses globally for all Vueless components.

vueless.config.{js,ts}
export default {
  rounding: 6, /* default -> 8 (pixels) */
}

You can set any border-radius value in pixels, but we highly recommend adhering to values for consistency.

If you define only the rounding (medium) value, small and large sizes will be automatically calculated. The expected values are listed in the table below:

small (rounding.sm)
medium (rounding / rounding.md)
large (rounding.lg)

0

0

2

0

2

8

2

4

10

4

6

12

4

8

14

6

10

16

8

12

18

10

14

20

12

16

22

In the config, values are specified in pixels for simplicity, but they are automatically converted into rem under the hood.

If you want to use custom values for small and large roundings, you can define them manually.

vueless.config.{js,ts}
export default {
  rounding: {
    sm: 5,
    md: 6,
    lg: 7,
  }
}

Custom tailwind class

To implement global border radius stylings, Vueless provides custom Tailwind CSS classes and corresponding CSS variables. Feel free to use these classes in your components whenever you need consistent rounding across your project.

You can also use the corresponding CSS variables directly:

Custom classes
CSS variables in a utility class

rounded-small

rounded-(--vl-rounding-sm)

rounded-medium

rounded-(--vl-rounding)

rounded-large

rounded-(--vl-rounding-lg)

Tailwind CSS’s predefined border-radius