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 de lectura • Equipo Q2BSTUDIO

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.

¿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