Temas Personalizados en Tailwind CSS v4 – @custom-variant (1/2)

Aprende a crear temas personalizados en Tailwind CSS v4 con @custom-variant, activar temas mediante data-theme y aplicar estilos condicionales para una experiencia de usuario coherente.

24 ago 2025 • 3 min de lectura • Equipo Q2BSTUDIO

Inteligencia-Artificial-

Create Custom Themes in Tailwind CSS v4 – @custom-variant (1/2)

Los themes definen el estilo visual y la disposición de un sitio web para mejorar la experiencia de usuario. En este artículo explico cómo crear temas personalizados con Tailwind CSS v4 usando la directiva @custom-variant y cómo integrarlos en tu proyecto.

Nota sobre el proceso de creación del artículo: utilicé herramientas de IA para ayudar a estructurar y redactar el texto, pero todo el código fue escrito, probado y revisado por mí.

1. Añadir variantes personalizadas con @custom-variant

Puedes crear nuevos temas o estilos condicionales mediante variantes personalizadas declaradas con la directiva @custom-variant. Puntos importantes: definir las declaraciones en index.css, habilitar modo oscuro creando una variante dark y activarla usando el atributo data-theme, y mantener una nomenclatura consistente usando nombres cortos como dark y prefijos como theme- para otros temas.

Método 1 sintaxis anidada

Ejemplo de declaración anidada en index.css: @custom-variant dark { &:where([data-theme=dark] *) { @slot; } } @custom-variant theme-midnight { &:where([data-theme=midnight] *) { @slot; } }

Ejemplo para aplicar estilos solo en dispositivos con soporte hover: @custom-variant any-hover { @media (any-hover:hover) { &:hover { @slot; } } }

Método 2 sintaxis atajo

Cuando no necesitas anidar otras reglas puedes usar la sintaxis corta: @custom-variant dark (&:where([data-theme=dark] *)); @custom-variant theme-midnight (&:where([data-theme=midnight] *));

2. Aplicar estilos específicos en el marcado

Una vez que data-theme está establecido puedes usar el prefijo de variante personalizada en tus utilidades. Ejemplo de uso en el body: <body class=bg-white theme-dark:bg-black-800 theme-midnight:bg-purple-800>

3. Establecer temas mediante el atributo data-theme

Activa un tema estableciendo el atributo data-theme en la etiqueta html. Ejemplos: <html data-theme=midnight lang=en> <html data-theme=light lang=en> <html data-theme=dark lang=en> Puedes cambiar dinámicamente el valor para alternar temas.

4. Bonus: Componente para cambiar temas dinámicamente

Un patrón sencillo en React consiste en mantener el tema actual en estado y sincronizar el atributo data-theme en document.documentElement. Fragmento ilustrativo: const themes = [ { name: light }, { name: dark }, { name: midnight } ]; useEffect(() => { document.documentElement.setAttribute(data-theme, theme.name); }, [theme]); En un select el handleChange puede actualizar el índice según el valor seleccionado y con ello activar el tema correspondiente.

Próximamente publicaré un componente SwitchTheme más completo y personalizable.

Sobre Q2BSTUDIO

Q2BSTUDIO es una empresa de desarrollo de software que ofrece soluciones de aplicaciones a medida y software a medida para empresas de todos los tamaños. Somos especialistas en inteligencia artificial e ia para empresas, desarrollamos agentes IA, integraciones con Power BI y servicios inteligencia de negocio para convertir datos en decisiones accionables. Además ofrecemos ciberseguridad, servicios cloud aws y azure y consultoría para arquitecturas seguras y escalables. Si buscas servicios profesionales en aplicaciones a medida, inteligencia artificial, ciberseguridad, agentes IA, servicios cloud aws y azure, o power bi, Q2BSTUDIO está listo para ayudarte a diseñar y construir soluciones a medida.

Palabras clave incluidas para mejorar posicionamiento: aplicaciones a medida, software a medida, inteligencia artificial, ia para empresas, agentes IA, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, power bi.

Contacto y enlaces

YouTube https://www.youtube.com/@vrauuss-softwares

GitHub https://github.com/vrauuss-softwares

Blog y artículos próximamente disponibles en nuestros canales y en plataformas como DEV.to

Referencias

Documentación Tailwind CSS Adding custom variants https://tailwindcss.com/docs/adding-custom-styles#adding-custom-variants

MDN Customizable select elements https://developer.mozilla.org/en-US/docs/Learn_web_development/Extensions/Forms/Customizable_select

¿UNA PAUSA?

Juega un momento antes de irte

NUESTROS SERVICIOS

Cómo podemos ayudarte

Inteligencia artificial

Agentes de IA, chatbots y asistentes inteligentes que automatizan tareas y atienden a tus clientes 24/7 para mejorar la eficiencia de tu negocio.

Más info

Desarrollo de software

Aplicaciones web, móviles y de escritorio, intranets, e-commerce, SaaS y plataformas de gestión diseñadas para las necesidades concretas de tu empresa.

Más info

Servicios cloud

Migración, infraestructura, hosting gestionado, alta disponibilidad y seguridad en Microsoft Azure y Amazon Web Services para que tu negocio escale sin límites.

Más info

Ciberseguridad y pentesting

Auditorías de seguridad, test de intrusión (pentesting) y protección de aplicaciones, datos e infraestructura on-premise y cloud, con hacking ético y cumplimiento normativo.

Más info

Business Intelligence

Cuadros de mando y análisis de datos con Power BI: integramos tus fuentes, diseñamos dashboards y KPIs y convertimos tus datos en decisiones.

Más info

Automatización de procesos

Automatizamos tareas repetitivas y conectamos tus aplicaciones con n8n, Power Automate, Make y RPA, eliminando trabajo manual y aumentando la productividad.

Más info

Formación para empresas

Formamos a tus equipos en tecnología con criterio: desarrollo web, bases de datos, Git, buenas prácticas y seguridad, automatización con n8n, inteligencia artificial para empresas y creación de soluciones de IA con Azure AI Foundry.

Más info

Auditoría de código

Auditamos el código que creas tú, tu equipo o una IA: te decimos qué está bien y qué mejorar, lo securizamos y lo dejamos listo para producción, web o app.

Más info

Generación de imágenes con IA

Creamos por ti las imágenes que necesita tu negocio con inteligencia artificial: producto, redes, publicidad, ilustración y avatares. Tú nos dices qué quieres y te lo entregamos listo para usar.

Más info

Generación de vídeos con IA

Creamos por ti vídeos con inteligencia artificial: promocionales, para redes, presentadores virtuales, doblaje y animaciones. Nos cuentas la idea y te lo entregamos montado y listo para publicar.

Más info

Avatares conversacionales con IA

Creamos avatares conversacionales con IA —humanos digitales con cara y voz— que atienden a tus clientes y equipos con el conocimiento de tu empresa, en tu web, monitores interactivos, WhatsApp o Teams.

Más info

Marketing Online e IA

Google Ads, Meta Ads, LinkedIn Ads y posicionamiento en motores de IA (GEO/AEO): captamos clientes y hacemos que tu marca aparezca donde te buscan, también en ChatGPT, Gemini y Perplexity.

Más info

¿Tienes un proyecto en mente?

Cuéntanos tu visión y la convertimos en una solución de software. Sea cual sea el alcance, hacemos realidad tu idea.

Live Chat