この HTML・CSS・JS プレイグラウンドは、ライブプレビュー付きのオンラインコードエディターです。3 つのエディターにマークアップ、スタイル、JavaScript を書くと、横のページが入力に合わせて更新されます。下のコンソールにはコードのログ出力やエラーが JavaScript の行番号付きで表示されるので、ブラウザの開発者ツールを開かずにデバッグできます。CSS レイアウトを試す、同僚にバグを再現して見せる、チュートリアルのコード片を試す、初めての Web ページづくりを教えるなど、プロジェクトを用意するほどでもない場面のためのツールです。
コードはブラウザに自動保存されるので、タブを閉じても失われません。「共有リンク」は 3 つのエディターの内容をリンク自体に圧縮して含めます。サーバーには何も保存されず、リンクを開いた人はまったく同じコピーを受け取ります。「ダウンロード」では CSS と JavaScript をインライン化した 1 つの .html ファイルが得られ、どのブラウザでも開けます。プレビューはサンドボックス化されたフレームで実行されるため、共有リンクを安全に開ける一方で、localStorage など一部の機能はその中で動作しません。詳しくは下記をご覧ください。
使い方
- HTML、CSS、JavaScript の各エディターに入力または貼り付けます。HTML はページの body 部分です。独自の <head> を含む文書全体を貼り付けることもできます。
- プレビューが更新されるのを確認します。ループを書いていて準備ができてから実行したい場合は「自動実行」をオフにし、「実行」または Ctrl+Enter(Mac では ⌘+Enter)を押します。
- プレビューの下の「コンソール」パネルで、console.log の出力、警告、エラーを確認します。エラーには発生元の JavaScript の行が表示されます。
- レイアウトを「エディターを上に」と「エディターを左に」で切り替えます。スマートフォンではエディターがタブになります。
- 「共有リンク」を押すとコードを含むリンクがコピーされ、「.html をダウンロード」を押すと自己完結した 1 つのファイルとして保存されます。
よくある質問
誰かから送られてきたプレイグラウンドのリンクを開いても安全ですか?
見知らぬ Web サイトを開くよりは安全で、勝手に実行されることもありません。共有リンクはまずコードを表示し、「実行」を押したときにだけ実行されます。実行時は allow-same-origin なしでサンドボックス化された iframe の中で動くため、ブラウザはそれを独立した匿名のオリジンとして扱います。このサイトの localStorage(ご自身の下書きが保存されている場所)、Cookie、周囲のページは読み取れません。ただし、コンテンツの表示や他サイトへのリクエスト送信など、フレーム内の Web ページにできることは引き続き可能なので、知らない人のコードは知らない人からのリンクと同じように扱ってください。
プレビューで localStorage や sessionStorage がエラーになるのはなぜですか?
サンドボックスのためです。プレビューのフレームは不透明なオリジンを持ち、ブラウザは不透明なオリジンに対してストレージ、Cookie、IndexedDB の利用を SecurityError で拒否します。これは共有コードを安全に開けるようにするための代償です。ストレージに依存するコードを試すには、.html ファイルをダウンロードしてローカルの Web サーバーから開くか、ストレージの呼び出しを try/catch で囲んで残りのコードが動くようにしてください。
共有リンクの仕組みは?サイズの上限はありますか?
3 つのエディターの内容を JSON にまとめ、ブラウザ組み込みの deflate(CompressionStream)で圧縮して、リンクの # 以降の部分に書き込みます。この部分はサーバーに送信されないため、コードはリンクの中にしか存在しません。実際のコードで測ると、リンクの長さはコードの長さに対して 1 KB のコード片で約 85%、8 KB で 60%、40 KB で 35% になります。コードが多いほど圧縮の効果が大きくなるためです。ブラウザは非常に長いリンクも受け付けますが、チャットアプリやメールソフト、一部の URL 短縮サービスでは途中で切れてしまいます。ツールは 8,000 文字を超えると警告を表示します。大きなプロジェクトの共有には .html のダウンロードが適しています。
npm パッケージ、React、ES モジュールは使えますか?
ビルド工程がないため、npm 経由では使えません。ブラウザ用スクリプトや ES モジュールとして CDN で公開されているライブラリなら読み込めます。HTML エディターに <script src="…"></script> を書くか、そこに <script type="module"> ブロックを書いて esm.sh や jsDelivr などの URL から import してください。JavaScript エディターはクラシックスクリプトとして実行されるため、そこに import 文を書くと構文エラーになります。モジュールのコードは HTML エディターに書いてください。JSX と TypeScript はコンパイルされません。
コードでページが固まりました。何が起きたのですか?
ほとんどの場合、条件がいつまでも false にならない while ループのような無限ループです。JavaScript は 1 つのスレッドで動くため、終わらないループがあるとプレビューが応答しなくなります。サンドボックスのフレームをページと同じプロセスで動かすブラウザでは、タブ全体が固まります。タブを閉じて開き直してください。プレイグラウンドは自動保存しているので、コードは残っています。ループを書く前に「自動実行」をオフにすれば、書きかけのコードがキー入力のたびに実行されることはありません。
このプレイグラウンドはコードをアップロードしたり保存したりしますか?
いいえ。エディター、プレビュー、コンソールはすべてブラウザ内で動作し、自動保存はブラウザのローカルストレージに、共有リンクはコードをリンクの中に含めます。入力した内容がこのサイトに送信されることはありません。ただしプレビュー自体は、フォント、画像、CDN のスクリプトなど、コードが要求するものを読み込むことがあります。
サンドボックスで許可されること、ブロックされること
プレビューは、srcdoc で内容を設定し、sandbox 属性を "allow-scripts allow-modals allow-forms" にした <iframe> です。各フラグは意図して選んでいます。
• allow-scripts:JavaScript が実行されます。
• allow-modals:初心者がよく使うため、alert()、confirm()、prompt() が動作します。
• allow-forms:<form> を送信できるので、フォームの検証を試せます。
• allow-same-origin なし:フレームには固有の不透明なオリジンが割り当てられます。このサイトのストレージや Cookie は読み取れず、ページ側からもフレームの中は読み取れません。コンソールは、フレームが外へメッセージを送信し、ページが現在のプレビューからのメッセージだけを受け付ける仕組みで動作しています。
• allow-popups と allow-top-navigation なし:共有コードがウィンドウを開いたり、ページから別の場所へ移動させたりすることはできません。
「実行」のたびにフレームを新しいものに置き換えるため、前回の実行のタイマー、イベントリスナー、グローバル変数が次の実行に持ち越されることはありません。
HTML、CSS、JavaScript の組み合わせ方
HTML エディターの内容が断片(<html>、<head>、doctype なし)の場合、プレイグラウンドはそれを UTF-8 の文字コードとモバイル用 viewport タグを持つ標準的な HTML5 文書で包み、CSS を head 内の <style> 要素に、JavaScript を body の末尾の <script> に入れます。スクリプトを最後に実行するので、querySelector で探す要素はすでに存在しています。初期コードに DOMContentLoaded リスナーが不要なのはこのためです。
完全な文書を貼り付けた場合は、その構造が保たれます。CSS は <head> の先頭に、JavaScript は </body> の直前に入ります。ダウンロードされる .html ファイルも、コンソール連携部分を除いて同じ方法で組み立てられるため、プレビューとまったく同じように動作します。
JavaScript 内の文字列などに "</script>" がそのまま含まれていると、script 要素がそこで終わってしまいます。プレイグラウンドはそれを JavaScript にとって同じ意味になる "<\/script>" として書き出すため、そうしたコードもそのまま動作します。
プレイグラウンドと CodePen、JSFiddle、ローカルエディターの比較
CodePen や JSFiddle などのサイトには、アカウント、保存したコレクション、プリプロセッサ(Sass、TypeScript、Babel)、npm 風のパッケージ検索、コミュニティのフィードがあります。それらが必要ならそちらを使ってください。このプレイグラウンドはあえて小さくしています。すぐに開け、アカウント不要で、作業内容はご自身のブラウザに保存され、共有リンクは誰かのサーバーが動き続けることに依存しません。
1 ページを超える規模のものには、VS Code などのローカルエディターと開発サーバー(Vite や Live Server 拡張機能)が適しています。複数ファイル、本物のモジュール、デバッガー、バージョン管理が使えます。「.html をダウンロード」はその 2 つをつなぐ橋渡しで、プロジェクトにそのまま入れられる動作するファイルが手に入ります。
