TailwindCSS content-visibility Plugin

A lightweight Tailwind CSS plugin that adds utilities for managing content visibility (content-visibility) and intrinsic size hints (contain-intrinsic-size). Optimize rendering performance with flexible size hints using custom theme values.

Installation

npm install tailwindcss-visibility

Setup

Add the plugin to your tailwind.config.js:

module.exports = {
    plugins: [require('tailwindcss-visibility')],
    theme: {
        sizeHint: {
            // Optional: Customize default size hints
            sm: '300px',
            md: '500px',
            lg: '800px',
        },
    },
};

Or add your own size hints in your tailwind.config.js:

module.exports = {
    content: ['./src/**/*.{html,js}'],
    plugins: [require('tailwindcss-visibility')],
    theme: {
        extend: {
            sizeHint: {
                xs: '100px',
                '2xl': '1000px',
                custom: '250px',
            },
        },
    },
};

Usage

Content Visibility Classes

• content-auto: Enables content-visibility optimization
• content-hidden: Hides content while preserving size
• content-visible: Forces content to remain visible

<div class="content-auto">
    <!-- Content here will be optimized -->
</div>

Size Hint Classes

Predefined size hints:

• size-hint-sm: 300px (default)
• size-hint-md: 500px (default)
• size-hint-lg: 800px (default)

Arbitrary values:

• size-hint-[200px]
• size-hint-[20rem]
• size-hint-[50vh]

<div class="content-auto size-hint-md">
    <!-- Content with medium size hint -->
</div>

Use Cases

1. Long Scrolling Pages

   Optimize rendering performance for long pages with multiple sections:

<article class="content-auto size-hint-md">
    <h2>Section Title</h2>
    <p>Content...</p>
</article>

2. Image Galleries

   Prevent layout shifts in image galleries:

<div class="grid grid-cols-3 gap-4">
    <div class="content-auto size-hint-[200px]">
        <img src="image1.jpg" alt="Gallery image" />
    </div>
    <!-- More gallery items -->
</div>

3. Accordion Sections

   Optimize hidden content in accordions:

<div class="content-hidden">
    <p>Collapsed accordion content...</p>
</div>

Demo Pages

• Basic Examples

Browser Support

• Chrome 85+
• Edge 85+
• Firefox 90+
• Safari 15.4+

Performance Impact

Using content-visibility: auto can significantly improve initial page load and rendering performance:

• Reduces rendering time for off-screen content
• Improves paint and layout performance
• Optimizes browser resource usage

Configuration

Custom Size Hints

// tailwind.config.js
module.exports = {
    theme: {
        sizeHint: {
            xs: '100px',
            '2xl': '1000px',
            card: '250px',
        },
    },
};

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

MIT License - see the LICENSE file for details

Author

Peter Benoit - @peterbenoit

Related Projects

• Official Tailwind CSS Documentation
• MDN Content-Visibility Documentation
• MDN Contain-Intrinsic-Size Documentation
• CSS Tricks Content-Visibility
• CSS Tricks Contain-Intrinsic-Size
• Web.dev Content-Visibility
• Web.dev Contain-Intrinsic-Size