5. Estado compartido
5.1. Ejemplo 15: estado compartido con Pinia
En una aplicación, ciertos datos son relevantes para muchos componentes: el usuario con sesión iniciada, el carrito de compras, etc. El Ejemplo 11 compartía estos datos con [provide] / [inject], mientras que el Ejemplo 14 usaba un módulo [ref] . [Pinia], la biblioteca oficial de [Vue.js] para el estado compartido, organiza esto en stores y los hace visibles en la extensión [Vue.js devtools].
Se instala en [main.ts]:
| // =========================================================================
// 15-pinia/src/main.ts
// -------------------------------------------------------------------------
// app.use(createPinia()): Pinia queda instalado, la biblioteca oficial de Vue.js
// para la gestión del estado COMPARTIDO. Los "stores" definidos
// a continuación son accesibles desde cualquier componente.
// =========================================================================
import { createApp } from 'vue';
import { createPinia } from 'pinia';
import 'bootstrap/dist/css/bootstrap.min.css';
import App from './App.vue';
createApp(App).use(createPinia()).mount('#app');
|
El primer store, el carrito de compras:
| // =========================================================================
// 15-pinia/src/stores/cart.ts - un STORE de Pinia
// -------------------------------------------------------------------------
// defineStore('cart', () => { ... }): un store escrito como un composable
// (estilo "setup"):
// - los refs son el ESTADO del store;
// - los valores computed, sus GETTERS (valores calculados);
// - las funciones, sus ACCIONES (lo que modifica el estado).
// Diferencia con un composable (ejemplo 11): el store existe en UNA SOLA
// copia para toda la aplicación. Todos los componentes que llaman a
// useCartStore() reciben el MISMO carrito. Vive mientras vive la aplicación:
// sobrevive a la eliminación de un componente... pero no a la recarga de
// la página (F5), que reinicia la aplicación.
// =========================================================================
import { computed, ref } from 'vue';
import { defineStore } from 'pinia';
export interface Item {
label: string;
price: number;
}
export const useCartStore = defineStore('cart', () => {
const items = ref<Item[]>([]);
const count = computed(() => items.value.length);
const total = computed(() => items.value.reduce((s, a) => s + a.price, 0));
function add(item: Item): void {
items.value.push(item);
}
function clear(): void {
items.value = [];
}
// todo lo que se devuelve forma parte del store
return { items, count, total, add, clear };
});
|
- líneas 24–39: [defineStore(name, function)] define un store en el estilo “setup”, como un composable: los [ref] son su estado, los [computed] son sus getters, y las funciones son sus acciones; expone lo que devuelve la función;
- La diferencia con un composable: solo hay una instancia del store para toda la aplicación. Todos los componentes que llaman a [useCartStore()] reciben el MISMO carrito de compras. Vive mientras vive la aplicación: sobrevive a la eliminación de un componente... pero no a una recarga de la página (F5), que reinicia la aplicación.
Un segundo store, en cambio, sobrevive a la recarga de la página:
| // =========================================================================
// 15-pinia/src/stores/preferences.ts - un store que sobrevive a F5
// -------------------------------------------------------------------------
// Para que un dato sobreviva a la recarga de la página, o al cierre
// del navegador, debe almacenarse EN el navegador: localStorage (un
// pequeño diccionario clave -> cadena, propio de cada sitio).
// - al iniciar, el store vuelve a leer localStorage;
// - watch(..., { deep: true }) reescribe localStorage en cada cambio.
// NUNCA almacene datos sensibles allí (contraseña, token): cualquier script
// de la página puede leer localStorage.
// =========================================================================
import { ref, watch } from 'vue';
import { defineStore } from 'pinia';
const KEY = 'example15.preferences';
interface Preferences {
dark: boolean;
size: number; // tamaño del texto, en px
}
function read(): Preferences {
try {
return { dark: false, size: 16, ...JSON.parse(localStorage.getItem(KEY) ?? '{}') };
} catch {
return { dark: false, size: 16 }; // contenido ilegible: valores predeterminados
}
}
export const usePreferencesStore = defineStore('preferences', () => {
const preferences = ref<Preferences>(read());
watch(preferences, (p) => localStorage.setItem(KEY, JSON.stringify(p)), { deep: true });
return { preferences };
});
|
- Líneas 23–29: al iniciar, el navegador vuelve a leer [localStorage], un pequeño diccionario de clave/valor que el navegador almacena para cada sitio, incluso después de cerrar el navegador. Si el contenido no se puede leer, se usan los valores predeterminados;
- Línea 34: [{ deep: true }]: [watch] también reacciona a los cambios en las propiedades del objeto. Cada cambio se vuelve a escribir en [localStorage].
NUNCA almacene datos sensibles (contraseñas, tokens) en [localStorage]: cualquier script ejecutado en la página puede leer [localStorage].
Los componentes:
| <!-- 15-pinia/src/components/Shop.vue - AGREGA al carrito compartido -->
<script setup lang="ts">
import { useCartStore, type Item } from '../stores/cart';
const cart = useCartStore();
const products: Item[] = [
{ label: 'Consultation', price: 30 },
{ label: 'Vaccine', price: 12.5 },
];
</script>
<template>
<div class="card p-3 h-100">
<h2 class="h6">Shop</h2>
<button v-for="p in products" :key="p.label" class="btn btn-sm btn-outline-primary mb-2" @click="cart.add(p)">
+ {{ p.label }} (€{{ p.price }})
</button>
</div>
</template>
|
- Línea 5: el store se usa como un objeto reactivo: [cart.add(p)];
| <!--
15-pinia/src/components/CartSummary.vue - LEE el mismo carrito
storeToRefs: para DESESTRUCTURAR un store sin perder la reactividad
(const { count } = cart daría una copia simple, congelada).
-->
<script setup lang="ts">
import { storeToRefs } from 'pinia';
import { useCartStore } from '../stores/cart';
const cart = useCartStore();
const { count, total } = storeToRefs(cart);
</script>
<template>
<div class="card p-3 h-100">
<h2 class="h6">Cart</h2>
<p class="mb-2">{{ count }} item(s), €{{ total }}</p>
<!-- las acciones, por su parte, se pueden desestructurar o llamar directamente -->
<button class="btn btn-sm btn-outline-danger align-self-start" :disabled="count === 0" @click="cart.clear()">Clear</button>
</div>
</template>
|
- línea 11: para desestructurar un store sin perder la reactividad. [const { count } = cart] devolvería una simple copia, congelada en el valor actual; [storeToRefs] devuelve instancias de [ref] vinculadas al store. Las acciones, en cambio, se pueden desestructurar o llamar directamente.
| <!-- 15-pinia/src/components/LocalCounter.vue - un estado LOCAL, que desaparece con el componente -->
<script setup lang="ts">
import { ref } from 'vue';
const clicks = ref(0);
</script>
<template>
<div class="card p-3 h-100">
<h2 class="h6">Local state</h2>
<button class="btn btn-sm btn-outline-secondary align-self-start" @click="clicks++">{{ clicks }} click(s)</button>
</div>
</template>
|
| <!--
=========================================================================
15-pinia/src/App.vue - tres "ámbitos" de datos en el lado del cliente
-------------------------------------------------------------------------
La misma pregunta que el ejemplo 23 del curso de NestJS (ámbito de aplicación,
de solicitud y de cliente), transpuesta al navegador:
- el estado LOCAL de un componente (LocalCounter) desaparece con él;
- el estado de un STORE (el carrito) es compartido por todos los componentes y
sobrevive a su eliminación - pero no a F5;
- el estado almacenado en localStorage (las preferencias) sobrevive a F5 y al
cierre del navegador.
Desmarque y vuelva a marcar la casilla, luego recargue la página: compare.
=========================================================================
-->
<script setup lang="ts">
import { ref } from 'vue';
import { usePreferencesStore } from './stores/preferences';
import Shop from './components/Shop.vue';
import CartSummary from './components/CartSummary.vue';
import LocalCounter from './components/LocalCounter.vue';
const prefs = usePreferencesStore();
const areaVisible = ref(true);
</script>
<template>
<div :class="{ 'bg-dark text-light': prefs.preferences.dark }" :style="{ fontSize: prefs.preferences.size + 'px' }" class="min-vh-100">
<div class="container py-4">
<h1 class="h3 mb-3">Example 15 - a shared state with Pinia</h1>
<div class="d-flex flex-wrap gap-4 mb-3">
<label class="form-check-label"><input v-model="prefs.preferences.dark" type="checkbox" class="form-check-input"> dark theme</label>
<label>text size <input v-model.number="prefs.preferences.size" type="range" min="12" max="22"> {{ prefs.preferences.size }} px</label>
<label class="form-check-label"><input v-model="areaVisible" type="checkbox" class="form-check-input"> show the area</label>
</div>
<div v-if="areaVisible" class="row g-3 text-body">
<div class="col-md-4"><Shop /></div>
<div class="col-md-4"><CartSummary /></div>
<div class="col-md-4"><LocalCounter /></div>
</div>
<p class="mt-3 mb-2">Outside the area, a second summary of the SAME cart (it stays there when the area disappears):</p>
<div class="text-body"><CartSummary /></div>
</div>
</div>
</template>
|
- Línea 35: al desmarcar “mostrar el área”, los tres componentes se eliminan de la página;
- línea 41: un segundo resumen del mismo carrito de compras, fuera del área.
Es la misma pregunta que el Ejemplo 23 del curso [NestJS] (ámbitos de aplicación, de solicitud y de cliente), adaptada al navegador:
Dato | ¿Dónde? | Duración |
El contador de LocalCounter | el estado local del componente | desaparece junto con el componente |
el carrito de compras | un store de Pinia | toda la aplicación, hasta F5 |
las preferencias | un store de Pinia + localStorage | sobrevive a F5 y al cierre del navegador |
Dos artículos agregados y dos clics:

Se eliminó la sección y se seleccionó el tema oscuro: el carrito de compras sigue ahí; si la sección se muestra de nuevo, el contador local vuelve a cero:
