Skip to content

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:

Image

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:

Image