solid — 仮想DOMを使わず高効率なUIを構築する宣言型JavaScriptライブラリ
solidjs/solid
★ 36,611 ・ TypeScript ・ MIT
概要
Solid(リポジトリ名: solidjs/solid)は、ユーザーインターフェースを構築するための宣言型JavaScriptライブラリです。
一般的なモダンUIライブラリと異なり、仮想DOM(Virtual DOM)による差分検出(diffing)を行いません。JSXテンプレートをビルド時に直接実DOMの生成・操作コードへとコンパイルし、「ファイングレインド・リアクティビティ(Fine-grained reactivity)」と呼ばれるきめ細かな変更追跡によって画面を更新します。状態が変化した際には、その状態に直接依存しているDOM位置のコードのみがピンポイントで再実行される仕組みです。
Reactなどの仮想DOMベースのフレームワークで頻繁に発生する「コンポーネント関数全体の再レンダリング」や、不要な再描画の抑制処理に課題を感じている開発者、あるいは最適化されたバニラJavaScriptに近い実行効率を求める開発者に向いています。
主な特徴
READMEに挙げられている主な特徴は以下のとおりです。
- 実DOMへのきめ細かなピンポイント更新: 仮想DOMのdiffを行わず、テンプレートからコンパイルされた実DOMに対して、変更が必要な部分のみ直接更新を適用します。
- 宣言的なリアクティブ・プリミティブ: 状態管理の基本要素として
createSignal、計算プロパティのためのcreateMemo、ネストしたオブジェクトを扱うcreateStoreなどを提供します。 - 1回だけ実行されるコンポーネント設計: コンポーネント関数はマウント時に1度だけ実行される通常の関数です。状態が変化してもコンポーネント関数全体が再実行されることはありません。
- 自動的な依存関係の追跡: リアクティブな状態の値を読み取るだけで、そのコンテキストが自動的にサブスクライブ(依存登録)されます。
- ファーストクラスの非同期処理: 計算処理の中で
PromiseやAsyncIterableを返すことができ、非同期境界を `` タグで表現できます。 - 楽観的UI更新と構造化ミューテーション:
createOptimisticやcreateOptimisticStoreといった楽観的UIプリミティブ、およびaction(...)による構造化された変更処理をサポートしています。 - サーバーサイドレンダリング(SSR)とユニバーサル展開: ストリーミングSSRやプログレッシブハイドレーションに対応しています。また
@solidjs/universalを利用してDOM以外のプラットフォーム向けのカスタムレンダラーを構築することも可能です。
使い方
新規プロジェクトを開始する場合は、公式テンプレートを使用する方法と、既存のViteプロジェクトに追加する方法の2通りがREADMEで紹介されています。
テンプレートから開始する場合
degit を使用して公式テンプレートを展開します。
npx degit solidjs/templates/solid-v2/basic my-app
cd my-app
npm install
npm run dev
既存のViteプロジェクトへ追加する場合
必要なパッケージとViteプラグインをインストールします。
npm i solid-js @solidjs/web
npm i -D vite @solidjs/vite-plugin
vite.config.ts でプラグインを登録します。
// vite.config.ts
import { defineConfig } from "vite";
import solid from "@solidjs/vite-plugin";
export default defineConfig({
plugins: [solid()]
});
続いて tsconfig.json でTypeScriptのJSX型定義をWeb向けに設定します。
{
"compilerOptions": {
"jsx": "preserve",
"jsxImportSource": "@solidjs/web"
}
}
基本的なコード例
以下は、シグナルを用いたシンプルなカウンターコンポーネントの例です。
import { createSignal } from "solid-js";
import { render } from "@solidjs/web";
function Counter() {
const [count, setCount] = createSignal(0);
const doubled = () => count() * 2;
// コンポーネント本体は一度だけ実行されます。countが変化したとき、{doubled()} の部分だけが更新されます。
return <button onClick={() => setCount(c => c + 1)}>{doubled()}</button>;
}
render(() => <Counter />, document.getElementById("app")!);
技術的なポイント
JSXから実DOM操作へのビルド時コンパイル
Solidの最大の特徴は、JSXの解決をランタイムの仮想DOMツリー生成ではなく、ビルド時のDOM操作コード生成によって行う点です。上記のカウンターコンポーネントは、コンパイラによっておおむね次のようなJavaScriptコードへと変換されます。
import { template, delegateEvents, insert } from "@solidjs/web";
import { createSignal } from "solid-js";
const _tmpl$ = /*#__PURE__*/ template(`<button>`);
function Counter() {
const [count, setCount] = createSignal(0);
const doubled = () => count() * 2;
return (() => {
const _el$ = _tmpl$();
_el$._$$click = () => setCount(c => c + 1);
insert(_el$, doubled);
return _el$;
})();
}
delegateEvents(["click"]);
HTMLテンプレートからクローンされた要素に対して直接イベントリスナーの委譲設定やDOMの挿入処理(insert)が結びつけられます。これによって、リアクティビティがレンダリング単位ではなく「式単位(per-expression)」で動作します。
モノレポ構造と責務の分離
リポジトリはPNPMワークスペースを用いたモノレポ構成となっており、以下のようなパッケージに分割されています。
solid-js: コアランタイム(コンポーネント、制御フロー、Context、ハイドレーションなど)@solidjs/signals: シグナル、メモ、エフェクト、ストアなどのリアクティブプリミティブ@solidjs/web:renderやhydrate、SSR、PortalといったWebプラットフォーム向けランタイム@solidjs/universal: カスタムレンダラーを作成するためのユニバーサルランタイム@solidjs/compiler: ネイティブOxcベースのJSXコンパイラ@solidjs/babel-plugin: JSXコンパイル用のBabelプラグイン@solidjs/diagnostics: 開発時診断およびテスト・エージェント向けハーネス
コアランタイム(solid-js)はレンダラー非依存のコンポーネント型を管理し、Web固有のJSX名前空間は @solidjs/web などのレンダラーパッケージが受け持つ設計になっています。
更新モデルとエフェクトのフェーズ
状態の読み取り値の反映は次のマイクロタスクでバッチ処理されます(同期的な連携が必要な場合は flush() を呼び出すことも可能です)。また、エフェクトは依存関係の追跡を行う compute フェーズと、副作用を実行する apply フェーズに分離されています。
LLM・AI支援ツール向けの配慮
リポジトリ内にはLLMやAIアシスタント向けのリファレンス(SKILL.md や CHEATSHEET.md、/llms.txt)が用意されており、npmパッケージ内にも同梱されています。これにより、外部ツールが正確なAPI仕様を把握しやすい構成になっています。
注意点
- Solid 1.x からの移行: Solid 2.0では公開APIに変更が加えられています。1.x以前のコードや知識をそのまま適用できない場合があるため、移行の際はリポジトリ内のマイグレーションガイド(
documentation/solid-2.0/MIGRATION.md)の確認が推奨されています。なお、1.x系は1.xブランチで保守されています。 - 対応ブラウザ: 直近2年間のモダンブラウザ(デスクトップ・モバイルのFirefox、Safari、Chrome、Edge)をサポートしています。Internet Explorerなどのサポート終了済みブラウザには対応していません。
- サーバー実行環境: Node.jsのLTS版、最新のDeno、Cloudflare Workersのランタイムがサポート対象と明記されています。
- ライセンス: 本プロジェクトは MIT ライセンス のもとで公開されています。
まとめ
Solidは、ビルド時コンパイルとfine-grainedなリアクティビティを組み合わせることで、仮想DOMを使わずに高い実行効率を実現したUIライブラリです。コンポーネント関数が再実行されない設計や、TypeScript・JSXとの親和性の高さにより、明快で無駄のないアプリケーション開発を可能にしています。





