アイランド間で状態を共有する

Astroのウェブサイトをアイランドアーキテクチャ / パーシャルハイドレーションで構築する際に、 「コンポーネント間で状態を共有したい」 という問題に直面することがあります。

ReactやVueなどのUIフレームワークは、他のコンポーネントなどの「コンテキスト」プロバイダーの利用を奨励する場合があります。
ただし、AstroやMarkdown内でコンポーネントを部分的にハイドレートする場合、これらのコンテキストラッパーを使用することはできません。

Astroは、クライアント側の共有ストレージに別のソリューション (Nano Stores) を推奨しています。

関連レシピ： Share state between Astro components (EN)

なぜNano Storesなのか？

Nano Storesライブラリを使用すると、任意のコンポーネントが相互作用できるストアを作成できます。
Nano Storesを推奨する理由は次の通りです。

軽量です。 Nano Storesは必要最低限のJS（1KB未満）を依存関係なしで提供します。
フレームワークに依存しません。 これにより、フレームワーク間での状態共有がシームレスになります！Astroは柔軟性を重視しているため、どのフレームワークを使用しても同様の開発者体験を提供するソリューションが好きです。

それでも、あなたが探せる選択肢はいくつもあります。
選択肢はには次のものが含まれます。

Svelteの組み込みストア
コンポーネントコンテキスト外でのSolidシグナル
VueのリアクティビティAPI
コンポーネント間でのカスタムブラウザイベントの送信

🙋 Nano Storesを.astroファイルや他のサーバーサイドコンポーネントで使用できますか？

Nano Storesは <script> タグ内で .astro コンポーネント間での状態を共有する (EN) ことができます。
ただし、次の制限があるため、サーバーサイドコンポーネントのフロントマターでNano Storesを使用することは推奨されません。

.astroファイルやノンハイドレートコンポーネントからストアに書き込んでも、クライアントサイドコンポーネントが受け取る値には影響しません。
Nano Storeをクライアントサイドコンポーネントに “prop”として渡すことはできません。
Astroコンポーネントは再レンダリングされないため、.astroファイルからの変更を保存するようにサブスクライブすることはできません。

これらの制限を理解した上で使用する必要がある場合は、Nano Storesを試してみてください！
Nano Storesは クライアント の変更に反応するように構築されているので注意してください。

🙋 SvelteストアはNano Storesとどう比較されますか？

Nano StoresとSvelteストアは非常に似ています！ 実際、Nano StoresはSvelteストアで使用されるのと同じ$ショートカットをサブスクリプションに使用できます。

サードパーティのライブラリを避けたい場合は、Svelteストアが優れたアイランド間のコミュニケーションツールになります。

それでも、次のような理由であれば、Nano Storesの方がいいかもしれません。
a) “objects”やasync state用のアドオンが好きな場合
b) Svelteと他のUIフレームワーク（PreactやVueなど）間で通信したい場合

🙋 SolidシグナルはNano Storesとどう比較されますか？

Solidを使用した際に、signalsやstoresをコンポーネントの外に移動してみたことがあるかもしれません。これは、Solidのアイランド間で状態を共有する素晴らしい方法です！共有ファイルからシグナルをエクスポートしてみましょう。

import { createSignal } from 'solid-js';

export const sharedCount = createSignal(0);

…そして、このsharedCountをインポートするすべてのコンポーネントは同じ状態を共有します。この方法はうまく機能しますが、次のような理由であれば、Nano Storesの方がいいかもしれません。
a) “objects”やasync state用のアドオンが好きな場合
b) Solidと他のUIフレームワーク（PreactやVueなど）間で通信したい場合

Nano Storesのインストール

使い始めるには、Nano Storesと、お好みのUIフレームワーク用のヘルパーパッケージをインストールしてください。

npm install nanostores @nanostores/preact

npm install nanostores @nanostores/react

npm install nanostores @nanostores/solid

npm install nanostores

npm install nanostores @nanostores/vue

npm install nanostores @nanostores/lit

ここからNano Stores使用ガイドに遷移するか、以下の例に従って進めてください！

使用例 - eコマースのカートフライアウト

簡単なeコマースインターフェースを構築するとしましょう。
以下の3つのインタラクティブな要素があります。

「カートに追加」送信フォーム
カートに追加されたアイテムを表示するフライアウトメニュー
カートフライアウトメニューのトグル

完成した例 をあなたのマシンやオンラインでStackBlitzを介して試してみてください。

あなたの基本的なAstroファイルは次のようになります。

---
import CartFlyoutToggle from '../components/CartFlyoutToggle';
import CartFlyout from '../components/CartFlyout';
import AddToCartForm from '../components/AddToCartForm';
---

<!DOCTYPE html>
<html lang="en">
<head>...</head>
<body>
  <header>
    <nav>
      <a href="/">Astro storefront</a>
      <CartFlyoutToggle client:load />
    </nav>
  </header>
  <main>
    <AddToCartForm client:load>
    <!-- ... -->
    </AddToCartForm>
  </main>
  <CartFlyout client:load />
</body>
</html>

「atoms」を使用する

CartFlyoutToggleがクリックされたときにCartFlyoutを開くようにしましょう。

まず、新しいJSまたはTSファイルを作成して、ストアを含めます。
このために“atoms”を使用します。

import { atom } from 'nanostores';

export const isCartOpen = atom(false);

次に、このストアを読み取りや書き込みが必要なファイルにインポートします。
まず、CartFlyoutToggleを接続します。

import { useStore } from '@nanostores/preact';
import { isCartOpen } from '../cartStore';

export default function CartButton() {
  // `useStore`フックでストアの値を読み取る
  const $isCartOpen = useStore(isCartOpen);
  // インポートされたストアに`.set`を使って書き込む
  return (
    <button onClick={() => isCartOpen.set(!$isCartOpen)}>Cart</button>
  )
}

import { useStore } from '@nanostores/react';
import { isCartOpen } from '../cartStore';

export default function CartButton() {
  // `useStore`フックでストアの値を読み取る
  const $isCartOpen = useStore(isCartOpen);
  // インポートされたストアに`.set`を使って書き込む
  return (
    <button onClick={() => isCartOpen.set(!$isCartOpen)}>Cart</button>
  )
}

import { useStore } from '@nanostores/solid';
import { isCartOpen } from '../cartStore';

export default function CartButton() {
  // `useStore`フックでストアの値を読み取る
  const $isCartOpen = useStore(isCartOpen);
  // インポートされたストアに`.set`を使って書き込む
  return (
    <button onClick={() => isCartOpen.set(!$isCartOpen())}>Cart</button>
  )
}

<script>
  import { isCartOpen } from '../cartStore';
</script>

<!-- "$"を使用してストアの値を読み取る -->
<button on:click={() => isCartOpen.set(!$isCartOpen)}>Cart</button>

<template>
  <!-- インポートされたストアに`.set`を使って書き込む -->
  <button @click="isCartOpen.set(!$isCartOpen)">Cart</button>
</template>

<script setup>
  import { isCartOpen } from '../cartStore';
  import { useStore } from '@nanostores/vue';

  // `useStore`フックでストアの値を読み取る
  const $isCartOpen = useStore(isCartOpen);
</script>

import { LitElement, html } from 'lit';
import { isCartOpen } from '../cartStore';

export class CartFlyoutToggle extends LitElement {
  handleClick() {
    isCartOpen.set(!isCartOpen.get());
  }

  render() {
    return html`
      <button @click="${this.handleClick}">Cart</button>
    `;
  }
}

customElements.define('cart-flyout-toggle', CartFlyoutToggle);

次に、CartFlyoutコンポーネントからisCartOpenを読み取ります。

import { useStore } from '@nanostores/preact';
import { isCartOpen } from '../cartStore';

export default function CartFlyout() {
  const $isCartOpen = useStore(isCartOpen);

  return $isCartOpen ? <aside>...</aside> : null;
}

import { useStore } from '@nanostores/react';
import { isCartOpen } from '../cartStore';

export default function CartFlyout() {
  const $isCartOpen = useStore(isCartOpen);

  return $isCartOpen ? <aside>...</aside> : null;
}

import { useStore } from '@nanostores/solid';
import { isCartOpen } from '../cartStore';

export default function CartFlyout() {
  const $isCartOpen = useStore(isCartOpen);

  return $isCartOpen() ? <aside>...</aside> : null;
}

<script>
  import { isCartOpen } from '../cartStore';
</script>

{#if $isCartOpen}
<aside>...</aside>
{/if}

<template>
  <aside v-if="$isCartOpen">...</aside>
</template>

<script setup>
  import { isCartOpen } from '../cartStore';
  import { useStore } from '@nanostores/vue';

  const $isCartOpen = useStore(isCartOpen);
</script>

import { isCartOpen } from '../cartStore';
import { LitElement, html } from 'lit';
import { StoreController } from '@nanostores/lit';

export class CartFlyout extends LitElement {
  private cartOpen = new StoreController(this, isCartOpen);

  render() {
    return this.cartOpen.value ? html`<aside>...</aside>` : null;
  }
}

customElements.define('cart-flyout', CartFlyout);

「maps」を使用する

では、カート内のアイテムを追跡してみましょう。
重複を避け、「数量」を追跡するために、アイテムのIDをキーとしてカートをオブジェクトとして保存できます。
これにmapsを使用します。

先ほどのcartStore.jsにcartItemストアを追加しましょう。
型を定義したい場合はTypeScriptファイルに切り替えることもできます。

JavaScript
TypeScript

import { atom, map } from 'nanostores';

export const isCartOpen = atom(false);

/**
 * @typedef {Object} CartItem
 * @property {string} id
 * @property {string} name
 * @property {string} imageSrc
 * @property {number} quantity
 */

/** @type {import('nanostores').MapStore<Record<string, CartItem>>} */
export const cartItems = map({});

import { atom, map } from 'nanostores';

export const isCartOpen = atom(false);

export type CartItem = {
  id: string;
  name: string;
  imageSrc: string;
  quantity: number;
}

export const cartItems = map<Record<string, CartItem>>({});

次に、コンポーネントが使用できるようにaddCartItemヘルパーをエクスポートします。

アイテムがカートに存在しない場合、数量1でアイテムを追加します。
アイテムがカートに存在する場合、数量を1つ増やします。

JavaScript
TypeScript

...
export function addCartItem({ id, name, imageSrc }) {
  const existingEntry = cartItems.get()[id];
  if (existingEntry) {
    cartItems.setKey(id, {
      ...existingEntry,
      quantity: existingEntry.quantity + 1,
    })
  } else {
    cartItems.setKey(
      id,
      { id, name, imageSrc, quantity: 1 }
    );
  }
}

...
type ItemDisplayInfo = Pick<CartItem, 'id' | 'name' | 'imageSrc'>;
export function addCartItem({ id, name, imageSrc }: ItemDisplayInfo) {
  const existingEntry = cartItems.get()[id];
  if (existingEntry) {
    cartItems.setKey(id, {
      ...existingEntry,
      quantity: existingEntry.quantity + 1,
    });
  } else {
    cartItems.setKey(
      id,
      { id, name, imageSrc, quantity: 1 }
    );
  }
}

ストアを設置すれば、フォームが送信されるたびに AddToCartForm 内でこの関数を呼び出すことができます。
また、カートのフライアウトメニューを開き、カートの全体の概要を表示できるようにします。

import { addCartItem, isCartOpen } from '../cartStore';

export default function AddToCartForm({ children }) {
  // わかりやすくするためにアイテム情報をハードコーディングします！
  const hardcodedItemInfo = {
    id: 'astronaut-figurine',
    name: 'Astronaut Figurine',
    imageSrc: '/images/astronaut-figurine.png',
  }

  function addToCart(e) {
    e.preventDefault();
    isCartOpen.set(true);
    addCartItem(hardcodedItemInfo);
  }

  return (
    <form onSubmit={addToCart}>
      {children}
    </form>
  )
}

import { addCartItem, isCartOpen } from '../cartStore';

export default function AddToCartForm({ children }) {
  // わかりやすくするためにアイテム情報をハードコーディングします！
  const hardcodedItemInfo = {
    id: 'astronaut-figurine',
    name: 'Astronaut Figurine',
    imageSrc: '/images/astronaut-figurine.png',
  }

  function addToCart(e) {
    e.preventDefault();
    isCartOpen.set(true);
    addCartItem(hardcodedItemInfo);
  }

  return (
    <form onSubmit={addToCart}>
      {children}
    </form>
  )
}

import { addCartItem, isCartOpen } from '../cartStore';

export default function AddToCartForm({ children }) {
  // わかりやすくするためにアイテム情報をハードコーディングします！
  const hardcodedItemInfo = {
    id: 'astronaut-figurine',
    name: 'Astronaut Figurine',
    imageSrc: '/images/astronaut-figurine.png',
  }

  function addToCart(e) {
    e.preventDefault();
    isCartOpen.set(true);
    addCartItem(hardcodedItemInfo);
  }

  return (
    <form onSubmit={addToCart}>
      {children}
    </form>
  )
}

<form on:submit|preventDefault={addToCart}>
  <slot></slot>
</form>

<script>
  import { addCartItem, isCartOpen } from '../cartStore';

  // わかりやすくするためにアイテム情報をハードコーディングします！
  const hardcodedItemInfo = {
    id: 'astronaut-figurine',
    name: 'Astronaut Figurine',
    imageSrc: '/images/astronaut-figurine.png',
  }

  function addToCart() {
    isCartOpen.set(true);
    addCartItem(hardcodedItemInfo);
  }
</script>

<template>
  <form @submit="addToCart">
    <slot></slot>
  </form>
</template>

<script setup>
  import { addCartItem, isCartOpen } from '../cartStore';

  // わかりやすくするためにアイテム情報をハードコーディングします！
  const hardcodedItemInfo = {
    id: 'astronaut-figurine',
    name: 'Astronaut Figurine',
    imageSrc: '/images/astronaut-figurine.png',
  }

  function addToCart(e) {
    e.preventDefault();
    isCartOpen.set(true);
    addCartItem(hardcodedItemInfo);
  }
</script>

import { LitElement, html } from 'lit';
import { isCartOpen, addCartItem } from '../cartStore';

export class AddToCartForm extends LitElement {
  static get properties() {
    return {
      item: { type: Object },
    };
  }

  constructor() {
    super();
    this.item = {};
  }

  addToCart(e) {
    e.preventDefault();
    isCartOpen.set(true);
    addCartItem(this.item);
  }

  render() {
    return html`
      <form @submit="${this.addToCart}">


        <slot></slot>
      </form>
    `;
  }
}
customElements.define('add-to-cart-form', AddToCartForm);

最後に、カートアイテムを CartFlyout 内にレンダリングします。

import { useStore } from '@nanostores/preact';
import { isCartOpen, cartItems } from '../cartStore';

export default function CartFlyout() {
  const $isCartOpen = useStore(isCartOpen);
  const $cartItems = useStore(cartItems);

  return $isCartOpen ? (
    <aside>
      {Object.values($cartItems).length ? (
        <ul>
          {Object.values($cartItems).map(cartItem => (
            <li>
              <img src={cartItem.imageSrc} alt={cartItem.name} />
              <h3>{cartItem.name}</h3>
              <p>Quantity: {cartItem.quantity}</p>
            </li>
          ))}
        </ul>
      ) : <p>Your cart is empty!</p>}
    </aside>
  ) : null;
}

import { useStore } from '@nanostores/react';
import { isCartOpen, cartItems } from '../cartStore';

export default function CartFlyout() {
  const $isCartOpen = useStore(isCartOpen);
  const $cartItems = useStore(cartItems);

  return $isCartOpen ? (
    <aside>
      {Object.values($cartItems).length ? (
        <ul>
          {Object.values($cartItems).map(cartItem => (
            <li>
              <img src={cartItem.imageSrc} alt={cartItem.name} />
              <h3>{cartItem.name}</h3>
              <p>Quantity: {cartItem.quantity}</p>
            </li>
          ))}
        </ul>
      ) : <p>Your cart is empty!</p>}
    </aside>
  ) : null;
}

import { useStore } from '@nanostores/solid';
import { isCartOpen, cartItems } from '../cartStore';

export default function CartFlyout() {
  const $isCartOpen = useStore(isCartOpen);
  const $cartItems = useStore(cartItems);

  return $isCartOpen() ? (
    <aside>
      {Object.values($cartItems()).length ? (
        <ul>
          {Object.values($cartItems()).map(cartItem => (
            <li>
              <img src={cartItem.imageSrc} alt={cartItem.name} />
              <h3>{cartItem.name}</h3>
              <p>Quantity: {cartItem.quantity}</p>
            </li>
          ))}
        </ul>
      ) : <p>Your cart is empty!</p>}
    </aside>
  ) : null;
}

<script>
  import { isCartOpen, cartItems } from '../cartStore';
</script>

{#if $isCartOpen}
  {#if Object.values($cartItems).length}
    <aside>
      {#each Object.values($cartItems) as cartItem}
      <li>
        <img src={cartItem.imageSrc} alt={cartItem.name} />
        <h3>{cartItem.name}</h3>
        <p>Quantity: {cartItem.quantity}</p>
      </li>
      {/each}
    </aside>
  {:else}
    <p>Your cart is empty!</p>
  {/if}
{/if}

<template>
  <aside v-if="$isCartOpen">
    <ul v-if="Object.values($cartItems).length">
      <li v-for="cartItem in Object.values($cartItems)" v-bind:key="cartItem.name">
        <img :src=cartItem.imageSrc :alt=cartItem.name />
        <h3>{{cartItem.name}}</h3>
        <p>Quantity: {{cartItem.quantity}}</p>
      </li>
    </ul>
    <p v-else>Your cart is empty!</p>
  </aside>
</template>

<script setup>
  import { cartItems, isCartOpen } from '../cartStore';
  import { useStore } from '@nanostores/vue';

  const $isCartOpen = useStore(isCartOpen);
  const $cartItems = useStore(cartItems);
</script>

import { LitElement, html } from 'lit';
import { isCartOpen, cartItems } from '../cartStore';
import { StoreController } from '@nanostores/lit';

export class CartFlyoutLit extends LitElement {
  private cartOpen = new StoreController(this, isCartOpen);
  private getCartItems = new StoreController(this, cartItems);

  renderCartItem(cartItem) {
    return html`
      <li>
        <img src="${cartItem.imageSrc}" alt="${cartItem.name}" />
        <h3>${cartItem.name}</h3>
        <p>Quantity: ${cartItem.quantity}</p>
      </li>
    `;
  }

  render() {
    return this.cartOpen.value
      ? html`
          <aside>
            ${
              Object.values(this.getCartItems.value).length
                ? html`
                  <ul>
                    ${Object.values(this.getCartItems.value).map((cartItem) =>
                      this.renderCartItem(cartItem)
                    )}
                  </ul>
                `
                : html`<p>Your cart is empty!</p>`
            }
          </aside>
        `
      : null;
  }
}

customElements.define('cart-flyout', CartFlyoutLit);

これで、銀河系で最小のJSバンドルを持つ完全にインタラクティブなeコマースのサンプルが完成しました 🚀

完成した例を試してみてください 自分のマシンまたはStackBlitzでオンラインで試してみましょう！

貢献する

コミュニティ