14. Gestión de Estado Global con Pinia: State, Getters y Actions sin Boilerplate
Integra el gestor de estado oficial moderno de Vue 3: define stores con defineStore (Option Store o Setup Store), accede al estado reactivo y ejecuta acciones síncronas o asíncronas con soporte TypeScript nativo.
El Estándar Oficial de Estado Global: Pinia
Para aplicaciones complejas donde múltiples vistas y componentes desconectados necesitan leer y mutar los mismos datos (sesión de usuario, carrito de compras, notificaciones globales), Vue adoptó oficialmente a Pinia como el reemplazo definitivo y moderno de Vuex.
1. ¿Por qué Pinia Jubiló a Vuex?
| Característica | Vuex 3/4 (Legado) | Pinia (Estándar Moderno Oficial) |
|---|---|---|
| Mutations | Obligatorias. Requería separar la mutación síncrona de las acciones. | Eliminadas por completo. Las Actions mutan el estado directamente. |
| Tipado con TypeScript | Pobre, requería wrappers complejos y cadenas mágicas (strings). | 100% nativo: Autocompletado e inferencia perfecta de tipos. |
| Estructura | Un único Store monolítico con módulos anidados. | Multi-Store plano: Creas múltiples stores independientes según el dominio. |
| Boilerplate | Extremadamente verboso. | Mínimo y natural; código limpio que se siente como JavaScript puro. |
2. Anatomía de un Store con defineStore()
Pinia permite dos sintaxis: Option Stores (similar a Options API) y Setup Stores (idéntico a Composition API con ref y computed):
// Option Store:
import { defineStore } from 'pinia';
export const useCarritoStore = defineStore('carrito', {
// 1. Estado reactivo fuente
state: () => ({
articulos: [],
cupon: null
}),
// 2. Cálculos derivados con caché automática (Getters)
getters: {
totalItems: (state) => state.articulos.length,
precioFinal(state) {
const subtotal = state.articulos.reduce((acc, a) => acc + a.precio, 0);
return state.cupon ? subtotal * 0.9 : subtotal;
}
},
// 3. Métodos síncronos o asíncronos que modifican el estado (Actions)
actions: {
agregar(producto) {
this.articulos.push(producto);
},
async procesarPago() {
await fetch('/api/checkout', { method: 'POST', body: JSON.stringify(this.articulos) });
this.articulos = [];
}
}
});
3. Destructuración Segura con storeToRefs()
Al igual que con reactive, si destructuras un store de Pinia directamente perderás la reactividad. Pinia provee el helper storeToRefs():
import { storeToRefs } from 'pinia';
const store = useCarritoStore();
// Las propiedades reactivas (state y getters) usan storeToRefs:
const { articulos, totalItems } = storeToRefs(store);
// Las acciones (funciones) se destructuran directamente:
const { agregar, procesarPago } = store;
⚡ Gestión de Estado Centralizada con Pinia
Store reactivo con state, getters computados y acciones síncronas/asíncronas.
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="utf-8">
<title>Pinia State Management en Vue 3</title>
<link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" rel="stylesheet">
</head>
<body class="p-4 bg-light">
<div id="app" class="card shadow-sm p-4 mx-auto" style="max-width: 520px;">
<!-- Barra superior de la tienda -->
<div class="d-flex justify-content-between align-items-center mb-3">
<h5 class="fw-bold text-success mb-0">Tienda con Pinia</h5>
<span class="badge bg-warning text-dark fs-6">
🛒 {{ carritoStore.totalArticulos }} items (\${{ carritoStore.totalPrecio }})
</span>
</div>
<!-- Catálogo -->
<h6 class="small text-secondary fw-bold">Catálogo de Cursos:</h6>
<div class="vstack gap-2 mb-3">
<div v-for="curso in catalogo" :key="curso.id" class="p-2 bg-white border rounded d-flex justify-content-between align-items-center">
<div>
<span class="fw-bold">{{ curso.titulo }}</span>
<span class="text-muted small ms-2">\${{ curso.precio }}</span>
</div>
<button @click="carritoStore.agregarAlCarrito(curso)" class="btn btn-sm btn-outline-success">
+ Agregar
</button>
</div>
</div>
<!-- Vista del Carrito Global -->
<div class="p-3 bg-white border rounded">
<div class="d-flex justify-content-between align-items-center mb-2">
<h6 class="fw-bold mb-0">Carrito Global:</h6>
<button @click="carritoStore.vaciar" :disabled="carritoStore.articulos.length === 0" class="btn btn-sm btn-outline-danger py-0">
Vaciar
</button>
</div>
<ul v-if="carritoStore.articulos.length > 0" class="list-group list-group-flush small mb-2">
<li v-for="(item, idx) in carritoStore.articulos" :key="idx" class="list-group-item d-flex justify-content-between py-1 px-0">
<span>{{ item.titulo }}</span>
<span class="fw-bold">\${{ item.precio }}</span>
</li>
</ul>
<div v-else class="text-muted small py-2">El carrito está vacío.</div>
<div class="border-top pt-2 d-flex justify-content-between fw-bold text-success">
<span>Total Acumulado:</span>
<span>\${{ carritoStore.totalPrecio }}</span>
</div>
</div>
</div>
<script src="/assets/vendor/vue/vue.global.prod.js"></script>
<script src="/assets/vendor/vue/vue-demi.iife.js"></script>
<script src="/assets/vendor/vue/pinia.iife.prod.js"></script>
<script>
if (!window.Vue) {
document.write('<script src="https://cdn.jsdelivr.net/npm/vue@3/dist/vue.global.prod.js"><\/script>');
}
if (!window.Pinia) {
document.write('<script src="https://cdn.jsdelivr.net/npm/[email protected]/lib/index.iife.js"><\/script><script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/pinia.iife.prod.js"><\/script>');
}
</script>
<script>
const { createApp, ref } = Vue;
const { createPinia, defineStore } = Pinia;
// 1. DEFINICIÓN DEL STORE GLOBAL DE PINIA:
const useCarritoStore = defineStore('carrito', {
state: () => ({
articulos: []
}),
getters: {
totalArticulos: (state) => state.articulos.length,
totalPrecio: (state) => state.articulos.reduce((total, a) => total + a.precio, 0)
},
actions: {
agregarAlCarrito(producto) {
this.articulos.push({ ...producto });
},
vaciar() {
this.articulos = [];
}
}
});
const app = createApp({
setup() {
const carritoStore = useCarritoStore();
const catalogo = ref([
{ id: 1, titulo: 'Vue 3 Avanzado', precio: 35 },
{ id: 2, titulo: 'TypeScript para Frontend', precio: 40 },
{ id: 3, titulo: 'Arquitectura con Pinia', precio: 25 }
]);
return {
carritoStore,
catalogo
};
}
});
// 2. INSTALAR PINIA EN LA APLICACIÓN:
app.use(createPinia());
app.mount('#app');
</script>
</body>
</html>
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Por qué Pinia eliminó el concepto de "Mutations" que existía en su predecesor Vuex?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar Vue.js 3 Profesional: Composition API, Script Setup, Pinia & Vite y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.