Docs: Actualizar THEME_SYSTEM.md con nuevas variables
All checks were successful
build-and-deploy / build-and-deploy (push) Successful in 48s
All checks were successful
build-and-deploy / build-and-deploy (push) Successful in 48s
Cambios: - Agregar sección de Variables de Tipos de Café (--coffee-*) - Agregar sección de Variables de Estados (--status-*) - Agregar Ejemplo 7: Usar Colores de Tipos de Café - Agregar Ejemplo 8: Usar Colores de Estados - Actualizar Ejemplo 6 con todas las propiedades del tema - Actualizar Resumen de Comandos Rápidos con nuevas variables - Documentación completa para las 15 variables CSS del sistema La documentación ahora refleja el sistema extendido de temas.
This commit is contained in:
@@ -60,9 +60,9 @@ Usuario modifica tema en /settings
|
||||
|
||||
## Variables CSS Disponibles
|
||||
|
||||
### Variables de Tema (`--brand-*`)
|
||||
### Variables Base (`--brand-*`)
|
||||
|
||||
Estas son las **ÚNICAS** variables que debes usar en tu código:
|
||||
Estas variables controlan la apariencia general de la aplicación:
|
||||
|
||||
| Variable | Uso | Ejemplo de valor |
|
||||
|----------|-----|------------------|
|
||||
@@ -75,6 +75,27 @@ Estas son las **ÚNICAS** variables que debes usar en tu código:
|
||||
| `--brand-text` | Texto principal (alta legibilidad) | `#fef9f0` |
|
||||
| `--brand-text-muted` | Texto secundario, descripciones | `#d8c7a6` |
|
||||
|
||||
### Variables de Tipos de Café (`--coffee-*`)
|
||||
|
||||
Estas variables se usan para identificar visualmente los tipos de café en gráficas y tablas:
|
||||
|
||||
| Variable | Uso | Ejemplo de valor |
|
||||
|----------|-----|------------------|
|
||||
| `--coffee-uva` | Color de identificación para Café Uva | `#a855f7` (Purple) |
|
||||
| `--coffee-oreado` | Color de identificación para Café Oreado | `#f97316` (Orange) |
|
||||
| `--coffee-mojado` | Color de identificación para Café Mojado | `#06b6d4` (Cyan) |
|
||||
| `--coffee-verde` | Color de identificación para Café Verde | `#22c55e` (Green) |
|
||||
|
||||
### Variables de Estados (`--status-*`)
|
||||
|
||||
Estas variables se usan para indicar estados de pago en tablas y badges:
|
||||
|
||||
| Variable | Uso | Ejemplo de valor |
|
||||
|----------|-----|------------------|
|
||||
| `--status-pendiente` | Estado de pago pendiente | `#f59e0b` (Amber) |
|
||||
| `--status-pagado` | Estado pagado completamente | `#10b981` (Emerald) |
|
||||
| `--status-anulado` | Estado anulado o cancelado | `#6b7280` (Gray) |
|
||||
|
||||
### Variables de Nuxt UI (`--ui-color-neutral-*`)
|
||||
|
||||
⚠️ **NO uses estas variables directamente**. Están mapeadas automáticamente a `--brand-*` en `main.css`.
|
||||
@@ -395,7 +416,16 @@ const aplicarTemaAzul = () => {
|
||||
primaryStrong: '#3b82f6',
|
||||
accent: '#93c5fd',
|
||||
text: '#f0f4f8',
|
||||
textMuted: '#cbd5e1'
|
||||
textMuted: '#cbd5e1',
|
||||
// Colores de café (mantener consistentes)
|
||||
coffeeUva: '#a855f7',
|
||||
coffeeOreado: '#f97316',
|
||||
coffeeMojado: '#06b6d4',
|
||||
coffeeVerde: '#22c55e',
|
||||
// Colores de estados (mantener consistentes)
|
||||
statusPendiente: '#f59e0b',
|
||||
statusPagado: '#10b981',
|
||||
statusAnulado: '#6b7280'
|
||||
}
|
||||
applyTheme()
|
||||
saveTheme()
|
||||
@@ -410,6 +440,79 @@ const aplicarTemaAzul = () => {
|
||||
</template>
|
||||
```
|
||||
|
||||
### Ejemplo 7: Usar Colores de Tipos de Café
|
||||
|
||||
```vue
|
||||
<template>
|
||||
<!-- Badge para tipo de café -->
|
||||
<UBadge
|
||||
:style="{ backgroundColor: 'var(--coffee-uva)', color: 'white' }"
|
||||
size="sm"
|
||||
>
|
||||
Café Uva
|
||||
</UBadge>
|
||||
|
||||
<!-- Indicador visual de tipo -->
|
||||
<div class="flex items-center gap-2">
|
||||
<div class="w-3 h-3 rounded-full" style="background: var(--coffee-oreado)"></div>
|
||||
<span>Café Oreado</span>
|
||||
</div>
|
||||
|
||||
<!-- En gráficas (ejemplo con Chart.js) -->
|
||||
<script setup>
|
||||
const chartData = {
|
||||
datasets: [{
|
||||
label: 'Uva',
|
||||
backgroundColor: 'var(--coffee-uva)',
|
||||
data: [10, 20, 30]
|
||||
}, {
|
||||
label: 'Oreado',
|
||||
backgroundColor: 'var(--coffee-oreado)',
|
||||
data: [15, 25, 35]
|
||||
}]
|
||||
}
|
||||
</script>
|
||||
</template>
|
||||
```
|
||||
|
||||
### Ejemplo 8: Usar Colores de Estados
|
||||
|
||||
```vue
|
||||
<template>
|
||||
<!-- Badge de estado pendiente -->
|
||||
<UBadge
|
||||
class="text-[var(--status-pendiente)] bg-[var(--status-pendiente)]/10 border border-[var(--status-pendiente)]/30"
|
||||
size="sm"
|
||||
>
|
||||
Pendiente
|
||||
</UBadge>
|
||||
|
||||
<!-- Badge de estado pagado -->
|
||||
<UBadge
|
||||
class="text-[var(--status-pagado)] bg-[var(--status-pagado)]/10 border border-[var(--status-pagado)]/30"
|
||||
size="sm"
|
||||
>
|
||||
Pagado
|
||||
</UBadge>
|
||||
|
||||
<!-- Badge de estado anulado -->
|
||||
<UBadge
|
||||
class="text-[var(--status-anulado)] bg-[var(--status-anulado)]/10 border border-[var(--status-anulado)]/30"
|
||||
size="sm"
|
||||
>
|
||||
Anulado
|
||||
</UBadge>
|
||||
|
||||
<!-- Indicador en tabla -->
|
||||
<td>
|
||||
<div class="flex items-center gap-2">
|
||||
<div class="w-2 h-2 rounded-full" :style="{ backgroundColor: 'var(--status-pagado)' }"></div>
|
||||
<span>Pagado</span>
|
||||
</div>
|
||||
</td>
|
||||
</template>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Integración con Nuxt UI
|
||||
@@ -616,6 +719,8 @@ Antes de hacer commit, verifica:
|
||||
## Resumen de Comandos Rápidos
|
||||
|
||||
```vue
|
||||
<!-- VARIABLES BASE -->
|
||||
|
||||
<!-- Fondos -->
|
||||
bg-[var(--brand-bg)] <!-- Fondo principal -->
|
||||
bg-[var(--brand-surface)] <!-- Cards, modales -->
|
||||
@@ -636,6 +741,31 @@ bg-[var(--brand-primary-strong)] <!-- Backgrounds intensos -->
|
||||
hover:bg-[var(--brand-primary)]/10
|
||||
hover:border-[var(--brand-primary)]
|
||||
hover:text-[var(--brand-accent)]
|
||||
|
||||
<!-- VARIABLES DE TIPOS DE CAFÉ -->
|
||||
|
||||
<!-- Colores de café -->
|
||||
bg-[var(--coffee-uva)] <!-- Purple - Café Uva -->
|
||||
bg-[var(--coffee-oreado)] <!-- Orange - Café Oreado -->
|
||||
bg-[var(--coffee-mojado)] <!-- Cyan - Café Mojado -->
|
||||
bg-[var(--coffee-verde)] <!-- Green - Café Verde -->
|
||||
|
||||
<!-- Ejemplo en badges -->
|
||||
<UBadge :style="{ backgroundColor: 'var(--coffee-uva)', color: 'white' }">
|
||||
Café Uva
|
||||
</UBadge>
|
||||
|
||||
<!-- VARIABLES DE ESTADOS -->
|
||||
|
||||
<!-- Colores de estados -->
|
||||
text-[var(--status-pendiente)] <!-- Amber - Pendiente -->
|
||||
text-[var(--status-pagado)] <!-- Green - Pagado -->
|
||||
text-[var(--status-anulado)] <!-- Gray - Anulado -->
|
||||
|
||||
<!-- Ejemplo en badges con fondo suave -->
|
||||
<UBadge class="text-[var(--status-pagado)] bg-[var(--status-pagado)]/10">
|
||||
Pagado
|
||||
</UBadge>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user