Skip to content

Utility Classes ​

This page describes the built-in utility classes provided by @vueland/utils-jit and the values they support. Built-in rules are framework-agnostic arbitrary-value utilities; project-specific static and parameterized utilities can be added through defineRule.

Built-in utility classes ​

Utility
CSS properties
Example
w-[value]
width
w-[320px]
h-[value]
height
h-[200px]
min-w-[value]
min-width
min-w-[240px]
max-w-[value]
max-width
max-w-[1200px]
min-h-[value]
min-height
min-h-[100vh]
max-h-[value]
max-height
max-h-[600px]
ma-[value]
margin
ma-[16px]
mx-[value]
margin-left, margin-right
mx-[auto]
my-[value]
margin-top, margin-bottom
my-[24px]
mt-[value]
margin-top
mt-[16px]
mr-[value]
margin-right
mr-[12px]
mb-[value]
margin-bottom
mb-[24px]
ml-[value]
margin-left
ml-[12px]
pa-[value]
padding
pa-[20px]
px-[value]
padding-left, padding-right
px-[16px]
py-[value]
padding-top, padding-bottom
py-[12px]
pt-[value]
padding-top
pt-[10px]
pr-[value]
padding-right
pr-[8px]
pb-[value]
padding-bottom
pb-[20px]
pl-[value]
padding-left
pl-[16px]
left-[value]
left
left-[12px]
right-[value]
right
right-[12px]
top-[value]
top
top-[12px]
bottom-[value]
bottom
bottom-[12px]
inset-[value]
inset
inset-[0px]
radius-[value]
border-radius
radius-[12px]
radius-tl-[value]
border-top-left-radius
radius-tl-[8px]
radius-tr-[value]
border-top-right-radius
radius-tr-[8px]
radius-bl-[value]
border-bottom-left-radius
radius-bl-[8px]
radius-br-[value]
border-bottom-right-radius
radius-br-[8px]
z-[value]
z-index
z-[100]
opacity-[value]
opacity
opacity-[0.64]
text-[value]
color
text-[#111]
bg-[value]
background-color
bg-[#fff]

All built-in rules generate declarations with !important.

Classes like flex-center, surface-[#fff], or grid-cols-3 are not part of the default set unless you define them in rules. See Custom Rules for arbitrary, static, and parameterized utility examples.

Supported values ​

Values are validated before CSS is generated. If a value does not pass validation, the CSS rule is not created.

Size, padding, radius, and position ​

For w, h, min-w, max-w, min-h, max-h, pa, px, py, pt, pr, pb, pl, radius, left, right, top, bottom, and inset, CSS length-like values are supported:

html
<div class="w-[320px]"></div>
<div class="h-[50%]"></div>
<div class="px-[1rem]"></div>
<div class="radius-[12px]"></div>
<div class="left-[10vw]"></div>
<div class="w-[calc(100%-32px)]"></div>
<div class="max-w-[clamp(320px,50vw,960px)]"></div>
<div class="h-[var(--panel-height)]"></div>

Supported units:

txt
px, em, rem, %, vw, vh, svw, svh, lvw, lvh, dvw, dvh, vmin, vmax, ch, ex, cm, mm, in, pt, pc

Supported functions:

txt
calc(), min(), max(), clamp(), var()

Margin ​

Margin utilities support length-like values and auto:

html
<div class="ma-[16px]"></div>
<div class="mx-[auto]"></div>
<div class="mt-[2rem]"></div>
<div class="mb-[calc(100%-20px)]"></div>
<div class="ma-[10px 20px]"></div>

Padding ​

Padding utilities support length-like values:

html
<div class="pa-[16px]"></div>
<div class="px-[12px]"></div>
<div class="py-[8px 12px]"></div>

Radius ​

Radius utilities support length-like values:

html
<div class="radius-[8px]"></div>
<div class="radius-[8px 12px]"></div>
<div class="radius-tl-[16px]"></div>

Z-index ​

z-[value] supports numbers, auto, and CSS variables:

html
<div class="z-[1]"></div>
<div class="z-[999]"></div>
<div class="z-[auto]"></div>
<div class="z-[var(--z-modal)]"></div>

Opacity ​

opacity-[value] supports values from 0 to 1:

html
<div class="opacity-[0]"></div>
<div class="opacity-[0.64]"></div>
<div class="opacity-[1]"></div>
<div class="opacity-[var(--opacity)]"></div>

Color and background-color ​

text-[value] and bg-[value] support hex colors, CSS color functions, CSS variables, and selected keyword values:

html
<div class="text-[#111]"></div>
<div class="bg-[#fff]"></div>
<div class="bg-[rgb(255,255,255)]"></div>
<div class="text-[oklch(60% 0.2 20)]"></div>
<div class="bg-[var(--vl-surface)]"></div>
<div class="text-[currentColor]"></div>

Invalid values are ignored:

html
<div class="w-[;]"></div>
<div class="radius-[.]"></div>
<div class="px-[auto]"></div>
<div class="z-[10px]"></div>
<div class="opacity-[2]"></div>