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>