De CSS Modules a un Pequeño Sistema de Diseño: Botones Tematizables en React

Guía para crear un Button reutilizable con CSS Modules y variables CSS, con temas claro/oscuro, estados loading y disabled, y foco accesible en React. Ideal para equipos pequeños y software a medida.

17 ago 2025 • 4 min read • Q2BSTUDIO Team

Inteligencia-Artificial-

Resumen

En esta segunda parte de la serie iniciada con Styling Your First React Component — A Gentle Introduction transformamos un botón simple en un primitivo de sistema de diseño pequeño y configurable usando CSS Modules, variables CSS y patrones ergonómicos de React. La aproximación es ligera, accesible y fácil de mantener para equipos pequeños o proyectos a medida.

Qué vas a construir

Un componente Button con soporte para size, variant y estados loading y disabled; soporte de temas claro y oscuro mediante variables CSS; semántica accesible y foco por teclado; y una API mínima reutilizable en aplicaciones a medida y software a medida.

Configuración del proyecto

Usa Vite con plantilla React y activa CSS Modules nombrando los estilos como nombre.module.css. Mantén componentes coubicados para facilitar la escalabilidad. Estructura sugerida: src components Button Button.jsx Button.module.css App.jsx main.jsx theme.css. Esta organización facilita la reutilización en servicios cloud aws y azure donde desplegarás tus aplicaciones a medida.

Tokens de tema con variables CSS

Define variables globales en un archivo de tema e improrta desde la entrada de la app. Declara espaciados, radios, colores base como --bg --panel --text --brand y valores alternativos para el tema claro. Con estas variables puedes cambiar visualmente toda la interfaz aplicando una sola clase a un contenedor principal, lo que acelera la creación de temas para clientes que requieren software a medida y branding personalizado.

Estilos del botón

Crea un archivo Button.module.css que exponga una clase base con variables locales para background, foreground y border. Añade estilos para hover, active y focus-visible y variantes para primary, outline y ghost. Define tamaños sm md lg y estados disabled y loading. Incorpora una animación de spinner con aria-hidden para que los lectores de pantalla no dupliquen el anuncio del estado de carga. Esta solución se integra fácilmente en workflows de inteligencia artificial y agentes IA que requieren componentes consistentes en múltiples vistas.

Componente Button en React

Diseña una API pequeña que acepte props como as, variant, size, loading, disabled, onClick y href. Calcula isDisabled como disabled o loading y añade aria-disabled cuando corresponda. Cuando se pasa href y el componente por defecto es button, renderiza un enlace con role botón para mantener consistencia semántica. Evita pasar onClick si el botón está deshabilitado. Esta ergonomía facilita la integración con aplicaciones empresariales que usan servicios inteligencia de negocio y Power BI en dashboards donde se requieren interacciones predecibles.

Uso del componente

Incluye el componente Button en tu App y muestra ejemplos de variantes, tamaños y estados. Para probar temas, alterna la clase del contenedor entre theme-dark y theme-light. Ajusta sin cambiar JavaScript las variables --brand y --panel para alinear el aspecto con la identidad de marca de cada cliente.

Lista de comprobación de accesibilidad

Usa focus-visible para anillos de enfoque con teclado, comunica estados deshabilitados con aria-disabled, asegura que spinner tenga aria-hidden y mantén roles correctos cuando un enlace se comporta como botón. Estas prácticas son esenciales para entregas de software a medida con requisitos de accesibilidad corporativa.

Theming en una línea

Gracias a que los tokens visuales viven en variables CSS, puedes cambiar todo el tema aplicando una sola clase al contenedor raíz. Esto acelera pruebas A B y personalizaciones para clientes que usan servicios cloud aws y azure y redunda en menos coste de mantenimiento cuando entregas software a medida.

Recomendaciones para avanzar

Extrae tokens a un archivo tokens.css y genera temas light dark y tema por sistema; añade una prop icon slot que acepte nodos React para integrar iconografía; crea componentes hermanos como Input Badge y Toast usando la misma estrategia para empezar un sistema de diseño. Si trabajas con inteligencia artificial o agentes IA, considera exponer puntos de extensión para controlar estados desde modelos y automatizaciones.

Sobre Q2BSTUDIO

Q2BSTUDIO es una empresa de desarrollo de software especializada en aplicaciones a medida y software a medida. Ofrecemos soluciones completas en inteligencia artificial, ia para empresas, agentes IA y servicios de integración con Power BI para visualización y análisis. Además garantizamos seguridad mediante servicios de ciberseguridad y operamos en infraestructuras cloud con servicios cloud aws y azure. Nuestros servicios de inteligencia de negocio permiten convertir datos en decisiones accionables, combinando experiencia en desarrollo con capacidades avanzadas de IA para empresas de cualquier tamaño.

Por qué elegirnos

Si necesitas componentes UI rápidos de integrar en proyectos de producción, o desarrollar un sistema de diseño que conviva con modelos de inteligencia artificial y requisitos estrictos de ciberseguridad, Q2BSTUDIO ofrece experiencia práctica en entregas ágiles, soluciones a medida y consultoría técnica. Nos especializamos en desarrollar software a medida, aplicaciones a medida y productos que se despliegan en servicios cloud aws y azure con atención a la seguridad y la gobernanza de datos.

Palabras clave y posicionamiento

Aplicaciones a medida software a medida inteligencia artificial ciberseguridad servicios cloud aws y azure servicios inteligencia de negocio ia para empresas agentes IA Power BI

Conclusión

No necesitas una biblioteca pesada para tener componentes ergonómicos y temables. CSS Modules y variables CSS mantienen todo portable y comprensible. Si te interesa que adaptemos este patrón a tu catálogo de componentes o quieres que Q2BSTUDIO desarrolle una plataforma con integración de inteligencia artificial y servicios de ciberseguridad, contacta con nuestro equipo para una consultoría inicial y un plan de trabajo personalizado.

A BREAK?

Play for a moment before you go

OUR SERVICES

How we can help you

Artificial intelligence

AI agents, chatbots, and intelligent assistants that automate tasks and serve your customers 24/7 to improve the efficiency of your business.

More info

Software Development

Web, mobile, and desktop applications, intranets, e-commerce, SaaS, and management platforms designed for your company's specific needs.

More info

Cloud services

Migration, infrastructure, managed hosting, high availability, and security on Microsoft Azure and Amazon Web Services to help your business scale without limits.

More info

Cybersecurity and pentesting

Security audits, penetration testing and protection of applications, data and infrastructure on-premise and cloud, with ethical hacking and regulatory compliance.

More info

Business Intelligence

Dashboards and data analysis with Power BI: we integrate your sources, design dashboards and KPIs and turn your data into decisions.

More info

Process automation

We automate repetitive tasks and connect your applications with n8n, Power Automate, Make, and RPA, eliminating manual work and increasing productivity.

More info

Training for Companies

We train your teams in technology with criteria: web development, databases, Git, best practices and security, automation with n8n, artificial intelligence for companies and creation of AI solutions with Azure AI Foundry.

More info

Code Auditing

We audit the code that you, your team or an AI create: we tell you what is good and what to improve, we secure it and make it ready for production, web or app.

More info

AI Image Generation

We create for you the images that your business needs with artificial intelligence: product, networks, advertising, illustration and avatars. You tell us what you want and we deliver it ready to use.

More info

AI Video Generation

We create videos with artificial intelligence for you: promotional, networking, virtual presenters, dubbing and animations. You tell us the idea and we will deliver it assembled and ready to publish.

More info

AI Conversational Avatars

We create conversational avatars with AI – digital humans with a face and voice – that serve your customers and teams with the knowledge of your company, on your website, interactive monitors, WhatsApp or Teams.

More info

Online Marketing and AI

Google Ads, Meta Ads, LinkedIn Ads and AI Engine Positioning (GEO/AEO): we attract customers and make your brand appear where they search for you, also on ChatGPT, Gemini and Perplexity.

More info

Do you have a project in mind?

Tell us your vision and we'll turn it into a software solution. Whatever the scope, we make your idea real.

Live Chat