dnrsm.dev

  • Archives
  • About
  • Works
  • GitHub

SolidJSに入門してみる

2022-05-05

Table of Contents

概要

軽量かつ高速なライブラリを使ってみたいなと思い、最近ちょくちょく耳にするようになったSolidJSに入門してみる。 似たようなライブラリだとSvelteの方が有名かつ人気だと思うが、独自テンプレートなのが嫌で敬遠していた。 逆にいうと、Reactに似ているかJSXが使えればキャッチアップのモチベーションになりやすい。 まずは、基本機能を試すために小さなアプリを作ってみるだけなのですべての機能までは試さない。

The State of JS 2021の満足度と興味ではかなり高い方にある。 さすがに利用率と認知度は低め。 https://2021.stateofjs.com/ja-JP/libraries/front-end-frameworks/

今回作ったアプリのリポジトリはこちら https://github.com/dnrsm/solidjs-sample

セットアップ

playgroundや豊富なチュートリアルもあるが、まずはローカルで動かしてみる。

TypeScript版のテンプレートがあるようなので使ってみる。 Viteを使っているのでビルドとHMRがかなり速くて快適。

# テンプレートをclone
$ npx degit solidjs/templates/ts solidjs-sample
Need to install the following packages:
  degit
Ok to proceed? (y) y
> cloned solidjs/templates#HEAD to solidjs-sample

# install
$ yarn

# dev
$ yarn dev

createSignalとcreateEffectを使いカウンターを作ってみる

よくあるカウンターコンポーネントを作ってみる。

createSignal

適当にリアクティブな値を作ってみる。 createSignalはReactのuseStateの構文に似ているが、ゲッターとセッターの関数を返すので若干違う。

const [count, setCount] = createSignal(0);

値を読み取りたい場合は以下のようにする。

<div>{count()}</div>;

createEffect

createEffectは実行中に読み取ったSignalを自動的にサブスクライブして、変更されれば前回実行時に返された値で再実行する。

createEffect(() => {
  console.log("count is", count());
});

第二引数に値を入れると初期化されるとのこと。

createEffect((prev) => {
  console.log("count is", count());
  const sum = count() + 100;
  console.log("sum is", sum);
  return sum;
}, 0);

コンポーネントの全体像

import type { Component } from "solid-js";
import { createSignal, createEffect } from "solid-js";

const CounterPage: Component = () => {
  const [count, setCount] = createSignal(0);
  createEffect(() => {
    console.log("count is", count());
  });
  return (
    <>
      <div>{count()}</div>
      <button onClick={() => setCount((c) => c + 1)}>increment</button>
    </>
  );
};

export default CounterPage;

createStoreを使いTodoリストを作ってみる

Storeを利用したTodoリストを作ってみる。

制御フロー

Todoリストの表示部分には、<For>コンポーネントという制御フローコンポーネントがあるのでそれを使ってみる。 mapだと全体が再レンダリングされて非効率なので、こういう専用コンポーネントを用意されている。 <For>だと配列を変更してもそれに対応するノードのみ再レンダリングされる。

<For each={props.todos}>
  {(item) => (
    <TodoItem
      todo={item}
      toggleTodo={props.toggleTodo}
      removeTodo={props.removeTodo}
    />
  )}
</For>;

FAQでも説明されている。

https://github.com/solidjs/solid-docs/blob/main/langs/en/guides/faq.md#why-shouldnt-i-use-map-in-my-template-and-whats-the-difference-between-for-and-index

制御フローには他にもいろいろある。

https://www.solidjs.com/docs/latest/api#%E5%88%B6%E5%BE%A1%E3%83%95%E3%83%AD%E3%83%BC

コンポーネントの型付け

Component型が用意されていて、以下のように定義されている。

type Component<P = {}> = (props: PropsWithChildren<P>) => JSX.Element;

なので、ジェネリクスにPropsの型を渡せば良さそう。

const TodoList: Component<TodoListProps> = (props) => {
  ...
};

動的クラス

動的にクラスを当てたい場合、classListというJSXのカスタム属性があるのでそれを使う。 以下のように値がtrueであればkeyがクラスとして当たる。Vueっぽい。

<li classList={{ [styles.completed]: todo.completed }}>

カスタムJSX属性も他にいろいろある。

https://www.solidjs.com/docs/latest/api#%E7%89%B9%E5%88%A5%E3%81%AA-jsx-%E5%B1%9E%E6%80%A7

Props

Propsを使う際の注意点として、追跡スコープの外でpropsをdestructureするとリアクティブではなくなる。 JSXやエフェクトの中でプロパティにアクセスしないと再レンダリングされずリアクティブにはならない。

// リアクティブになる
const TodoItem = (props) => {
  return <li classList={{ [styles.completed]: props.todo.completed }}>todo</li>;
};

// リアクティブにならない
const TodoItem = (props) => {
  const completed = props.todo.completed;

  return <li classList={{ [styles.completed]: completed }}>todo</li>;
};

これもFAQで説明されている。

https://github.com/solidjs/solid-docs/blob/main/langs/en/guides/faq.md#why-shouldnt-i-use-map-in-my-template-and-whats-the-difference-between-for-and-index

ref

ReactのようにuseRefとか使わなくても変数を宣言しておけば要素を参照できる。

const Input: Component<Props> = (props) => {
  let input!: HTMLInputElement;

  const onSubmit = () => {
    if (!input.value.trim()) return;
    addTodo(input.value);
    input.value = "";
  };

  return (
    <>
      <input type="text" ref={input} />
      <button onClick={() => onSubmit()}>Add Todo</button>
    </>
  );
};
https://www.solidjs.com/docs/latest/api#ref

コンポーネントの全体像

TodoList.tsx
import type { Component } from "solid-js";
import { For } from "solid-js";
import styles from "./TodoList.module.css";
import TodoItem from "./TodoItem";
import { Todo } from "../store/todo";

type Props = {
  todos: Readonly<Todo[]>;
  toggleTodo: (id: number) => void;
  removeTodo: (id: number) => void;
};

const TodoList: Component<Props> = (props) => {
  return (
    <ul class={styles.list}>
      <For each={props.todos}>
        {(item) => (
          <TodoItem
            todo={item}
            toggleTodo={props.toggleTodo}
            removeTodo={props.removeTodo}
          />
        )}
      </For>
    </ul>
  );
};

export default TodoList;
TodoItem.tsx
import type { Component } from "solid-js";
import { Todo } from "../store/todo";
import styles from "./TodoItem.module.css";

type Props = {
  todo: Todo;
  toggleTodo: (id: string) => void;
  removeTodo: (id: string) => void;
};

const TodoItem: Component<Props> = (props) => {
  const { todo, toggleTodo, removeTodo } = props;

  return (
    <li classList={{ [styles.completed]: todo.completed }}>
      <input type="checkbox" onChange={() => toggleTodo(todo.id)} />
      <span>{todo.text}</span>
      <button onClick={() => removeTodo(todo.id)}>Remove</button>
    </li>
  );
};

export default TodoItem;
Input.tsx
import type { Component } from "solid-js";

type Props = {
  addTodo: (text: string) => void;
};

const Input: Component<Props> = (props) => {
  const { addTodo } = props;
  let input!: HTMLInputElement;

  const onSubmit = () => {
    if (!input.value.trim()) return;
    addTodo(input.value);
    input.value = "";
  };

  return (
    <>
      <input type="text" ref={input} />
      <button onClick={() => onSubmit()}>Add Todo</button>
    </>
  );
};

export default Input;

createStore

TodoリストのストアをcreateStoreで作ってみる。 createStoreはreadonlyなプロキシオブジェクトを返す。

import { createStore } from "solid-js/store";

const initialValue: Store = { todos: [] };

const [state, setState] = createStore(initialValue);

const addTodo = (text: string) => {
  setState("todos", (todos) => [
    ...todos,
    { id: ulid(), text, completed: false },
  ]);
};

ユーティリティもいくつかあるようだがまだ触ってない。

https://www.solidjs.com/docs/latest/api#%E3%82%B9%E3%83%88%E3%82%A2

ライフサイクル

ライフサイクル系のメソッドを使ってみたかったので、onMountで適当なデータを入れてみる。 Vueっぽい。

onMount(() => {
  addTodo("test");
});

他にonCleanuponErrorがある。

https://www.solidjs.com/docs/latest/api#%E3%83%A9%E3%82%A4%E3%83%95%E3%82%B5%E3%82%A4%E3%82%AF%E3%83%AB

Storeの全体像

todo.tsx
import { createStore } from "solid-js/store";
import { onMount } from "solid-js";
import { ulid } from "ulid";

export type Todo = {
  id: string;
  text: string;
  completed: boolean;
};

type Store = {
  todos: Todo[];
};

const initialValue: Store = { todos: [] };

export const useTodo = () => {
  const [state, setState] = createStore(initialValue);

  const addTodo = (text: string) => {
    setState("todos", (todos) => [
      ...todos,
      { id: ulid(), text, completed: false },
    ]);
  };

  const removeTodo = (id: string) => {
    setState("todos", (todos) => [...todos.filter((todo) => todo.id !== id)]);
  };

  const toggleTodo = (id: string) => {
    setState(
      "todos",
      (todo) => todo.id === id,
      "completed",
      (completed) => !completed
    );
  };

  // mount時に適当なデータを入れてみる
  onMount(() => {
    addTodo("test");
  });

  return {
    state,
    addTodo,
    removeTodo,
    toggleTodo,
  };
};

createResourceでAPIの非同期処理を試してみる

非同期リクエストを試してみる。 今回はパブリックAPIのhttps://cataas.com/ を使わせていただいた。

createResource

createResourceで非同期リソースを使える。 構文はSWRとかReact Queryと似ているので、使ったことがあればすぐに馴染みそう。

const fetchData = async (skip: number) =>
  (await fetch(`https://cataas.com/api/cats?skip=${skip}&limit=10`)).json();

const [skip, setSkip] = createSignal(0);
const [data, { refetch }] = createResource<Cat[], number>(skip, fetchData);

読み込み中の判定とかエラーは、返り値の一つ目の値にloadingerrorプロパティとして生えている。

// 読み込み中
<div>{data.loading && "Loading..."}</div>;

// エラー
<div>{data.error && "error"}</div>;

全体像

import type { Component } from "solid-js";
import { createResource, For, createSignal, Suspense } from "solid-js";
import { Cat } from "../types";

const fetchData = async (skip: number) =>
  (await fetch(`https://cataas.com/api/cats?skip=${skip}&limit=10`)).json();

const CatsPage: Component = () => {
  const [skip, setSkip] = createSignal(0);
  const [data, { refetch }] = createResource<Cat[], number>(skip, fetchData);

  let input!: HTMLInputElement;

  const onSetSkip = () => {
    if (!input.value.trim()) return;
    if (isNaN(Number(input.value))) return;
    setSkip(Number(input.value));
  };

  return (
    <>
      <h1>Cats Page</h1>
      <input type="number" placeholder="Enter Skip Number" ref={input} />
      <button onClick={() => onSetSkip()}>set skip</button>
      <button onClick={() => refetch()}>refetch</button>
      <Suspense fallback={<div>Loading...</div>}>
        <ul>
          <For each={data()}>
            {(cat) => (
              <li>
                <img
                  src={`https://cataas.com/cat/${cat.id}`}
                  alt={cat.tags.join("")}
                />
              </li>
            )}
          </For>
        </ul>
      </Suspense>
    </>
  );
};

export default CatsPage;

ルーティングできるようにしてみる

solid-app-routerというライブラリがあるので入れてみる。

$ yarn add solid-app-router
https://github.com/solidjs/solid-app-router

よくあるルーティングライブラリと似たような使い勝手。 react-routerとか使ったことあれば普通に使えそうな感じ。

App.tsx
import type { Component } from "solid-js";
import { lazy } from "solid-js";
import { Router, Routes, Route, Link } from "solid-app-router";
import styles from "./App.module.css";

const IndexPage = lazy(() => import("./pages/Index"));
const CatsPage = lazy(() => import("./pages/Cats"));
const CounterPage = lazy(() => import("./pages/Counter"));

const App: Component = () => {
  return (
    <Router>
      <div class={styles.App}>
        <div class={styles.nav}>
          <Link href="/">Todo Page</Link>
          <Link href="/cats">Cats Page </Link>
          <Link href="/counter">Counter Page </Link>
        </div>
        <Routes>
          <Route path="/" element={<IndexPage />} />
          <Route path="/cats" element={<CatsPage />} />
          <Route path="/counter" element={<CounterPage />} />
        </Routes>
      </div>
    </Router>
  );
};

export default App;

lazy

遅延ロード用の関数も用意されていて、lazyを使うと遅延ロードができる。

const IndexPage = lazy(() => import("./pages/Index"));
https://www.solidjs.com/docs/latest/api#lazy

まとめ

かなりパフォーマンスが良いUIライブラリなので結構期待している(なのでこの記事を書いている)。 ただ、小規模なアプリとかならいけそうな気はするが、そうでない場合、現時点ではコニュニティとエコシステムの豊富さからReactを選びそうではある。 SolidJSにNext.jsのようなフレームワークが出てくればより選択しやすくなりそう。

詳しくは日本語にも対応している公式ドキュメントを読むと良い。

https://www.solidjs.com/
Gatsbyのブログに目次を追加した
© 2022 dnrsm.dev