Arbitrary properties for unsupported CSS in Tailwind

Introduction

Sometimes Tailwind CSS does not have a built-in class for a specific CSS property you want to use. Arbitrary properties let you add any CSS style directly in your HTML using Tailwind's special syntax.

You want to use a CSS property that Tailwind does not support yet.

You need a quick custom style without writing separate CSS files.

You want to keep all styles inside your HTML for easier maintenance.

You want to try a new CSS feature that Tailwind hasn't added classes for.

You want to add a unique style for a single element without clutter.

Syntax

Tailwind

class="[property:value]"

Use square brackets [ ] around the CSS property and value.

No spaces inside the brackets; use quotes if value has spaces.

Examples

This adds a scroll margin top of 2rem, which Tailwind might not have a class for.

Tailwind

<div class="[scroll-margin-top:2rem]">Content</div>

Adds a blur effect to the background behind the button.

Tailwind

<button class="[backdrop-filter:blur(5px)]">Blurred Background</button>

Applies a text shadow that Tailwind does not support by default.

Tailwind

<p class="[text-shadow:2px_2px_4px_rgba(0,0,0,0.5)]">Shadowed Text</p>

Sample Program

This example shows three uses of arbitrary properties: scroll-margin-top on a div, backdrop-filter blur on a button, and text-shadow on a paragraph. These styles are not built-in Tailwind classes but work using the arbitrary property syntax.

Tailwind

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1" />
  <title>Arbitrary Properties Example</title>
  <script src="https://cdn.tailwindcss.com"></script>
</head>
<body class="p-6">
  <h1 class="text-2xl font-bold mb-4">Arbitrary Properties in Tailwind</h1>
  <div class="[scroll-margin-top:3rem] mb-6 border p-4">
    This box has a scroll margin top of 3rem.
  </div>
  <button class="bg-blue-500 text-white px-4 py-2 rounded [backdrop-filter:blur(4px)]">
    Blurred Background Button
  </button>
  <p class="mt-6 text-lg [text-shadow:2px_2px_3px_rgba(0,0,0,0.4)]">
    This text has a shadow using an arbitrary property.
  </p>
</body>
</html>

Important Notes

Use dashes (-) instead of spaces in property names inside brackets, for example: [scroll-margin-top:1rem].

If the value contains spaces or special characters, wrap it in quotes: [content:'"Hello"'].

Arbitrary properties keep your HTML clean and avoid writing extra CSS files for small custom styles.

Summary

Arbitrary properties let you add any CSS style directly in Tailwind classes.

Use square brackets with property and value, like [property:value].

This helps when Tailwind does not have a built-in class for the style you want.

Practice

1. What is the main purpose of using arbitrary properties in Tailwind CSS?

easy

A. To add custom CSS styles not available in Tailwind's default classes

B. To remove all default Tailwind styles from an element

C. To write JavaScript code inside Tailwind classes

D. To create animations automatically without extra code

Solution

1. Step 1: Understand Tailwind's default classes

   Tailwind provides many utility classes but may not cover every CSS property you need.

2. Step 2: Purpose of arbitrary properties

   Arbitrary properties let you write any CSS property and value inside square brackets to extend Tailwind easily.

3. Final Answer:

   To add custom CSS styles not available in Tailwind's default classes -> Option A

4. Quick Check:

   Arbitrary properties = custom CSS in Tailwind [OK]

Hint: Think: 'Add any CSS style directly' [OK]

Common Mistakes:

• Confusing arbitrary properties with removing styles
• Thinking it runs JavaScript
• Assuming it creates animations automatically

2. Which of the following is the correct syntax to set a CSS property scroll-margin-top to 2rem using Tailwind's arbitrary properties?

easy

A. scroll-margin-top-[2rem]

B. [scroll-margin-top=2rem]

C. scroll-margin-top:2rem

D. [scroll-margin-top:2rem]

Solution

1. Step 1: Recall Tailwind arbitrary property syntax

   It uses square brackets with property and value separated by a colon, like [property:value].

2. Step 2: Match syntax to options

   Only [scroll-margin-top:2rem] matches the correct format: [scroll-margin-top:2rem].

3. Final Answer:

   [scroll-margin-top:2rem] -> Option D

4. Quick Check:

   Syntax = [property:value] [OK]

Hint: Use square brackets and colon for property:value [OK]

Common Mistakes:

• Using equal sign instead of colon
• Placing brackets incorrectly
• Omitting brackets entirely

3. What will be the rendered style of this HTML element?

<div class="[border-radius:1rem] bg-blue-500 p-4 text-white">Hello</div>

medium

A. A box with default border radius and no background color

B. A blue box with white text but no rounded corners

C. A blue box with white text and rounded corners of 1rem radius

D. A box with red background and sharp corners

Solution

1. Step 1: Analyze the classes

   The class [border-radius:1rem] sets border radius to 1rem. bg-blue-500 sets blue background. p-4 adds padding. text-white sets text color white.

2. Step 2: Visualize the result

   The div will show a blue box with white text and rounded corners of 1rem radius.

3. Final Answer:

   A blue box with white text and rounded corners of 1rem radius -> Option C

4. Quick Check:

   Arbitrary border-radius + bg-blue-500 = blue rounded box [OK]

Hint: Look for arbitrary property inside brackets for custom style [OK]

Common Mistakes:

• Ignoring arbitrary property effect
• Confusing background color classes
• Assuming default border radius

4. Identify the error in this Tailwind class usage:

<div class="[padding-top=2rem] text-center">Content</div>

medium

A. Using equal sign (=) instead of colon (:) inside brackets

B. Missing quotes around the class attribute

C. Incorrect property name; should be paddingTop

D. Arbitrary properties cannot be used with padding

Solution

1. Step 1: Check arbitrary property syntax

   Tailwind requires a colon between property and value inside brackets, like [padding-top:2rem].

2. Step 2: Identify the error

   The code uses an equal sign = which is invalid syntax.

3. Final Answer:

   Using equal sign (=) instead of colon (:) inside brackets -> Option A

4. Quick Check:

   Arbitrary syntax = colon, not equal sign [OK]

Hint: Use colon, never equal sign, inside arbitrary brackets [OK]

Common Mistakes:

• Using = instead of :
• Thinking camelCase is required
• Believing arbitrary properties can't style padding

5. You want to add a custom CSS property scroll-padding-left with value 3rem to a div using Tailwind. Which class should you use, and why might this be necessary?

hard

A. scroll-padding-left-[3rem] because brackets go around the value only

B. [scroll-padding-left:3rem] because Tailwind does not have a built-in class for this property

C. scroll-padding-left-3rem because Tailwind supports all scroll-padding classes by default

D. scroll-padding-left:3rem because colons are allowed directly in class names

Solution

1. Step 1: Recognize unsupported CSS property

   Tailwind does not provide default classes for scroll-padding-left.

2. Step 2: Use arbitrary property syntax

   To add unsupported CSS, use square brackets with property and value separated by colon: [scroll-padding-left:3rem].

3. Final Answer:

   [scroll-padding-left:3rem] because Tailwind does not have a built-in class for this property -> Option B

4. Quick Check:

   Unsupported CSS = use arbitrary property [OK]

Hint: Use brackets with property:value for unsupported CSS [OK]

Common Mistakes:

• Assuming Tailwind has built-in class for all CSS
• Placing brackets only around value
• Using colon directly in class without brackets