機能
コードフォーマッターは、詰め込まれたコード、minify されたコード、インデントがばらばらなコードを、きれいで一貫したスタイルに整えて出力します。Web 開発でよく扱う言語に対応しています:HTML、CSS、SCSS、Less、JavaScript、TypeScript、JSON、XML、Markdown、YAML、GraphQL。
内部では数百万のプロジェクトで使われているフォーマッター Prettier を実行しているため、VS Code や pre-commit フックで整形したコードとまったく同じ見た目になります。各言語のパーサーは選択したときに初めて読み込まれるので、ページは軽快に動作します。
使い方
- コードの 言語 を選びます。
- コードを貼り付けるか、ファイルを開きます。
- インデント の種類(スペース 2 つ、スペース 4 つ、タブ)と 行幅 を選びます。行幅を超える行は、言語の許す範囲で折り返されます。
- JavaScript と TypeScript では、文末に セミコロン を付けるかどうかを選びます。スクリプトやスタイルシートでプロジェクトが好む場合は シングルクォート を選びます。
- 結果をコピーするか、ダウンロードします。
例
サンプルは、インラインの CSS と JavaScript を含む 1 行の HTML ページです。整形すると各要素がそれぞれの行に配置され、CSS ルールは 1 行に 1 宣言ずつ展開され、スクリプト内のアロー関数には括弧とセミコロンが付きます:
<script>
const items = [1, 2, 3];
items.forEach((i) => console.log(i));
</script>
ヒント
- 整形は手軽な構文チェックとしても使えます。Prettier が入力を解析できない場合、エラーメッセージに行と列が表示されるので、間違いの箇所にすぐ移動できます。
- XML は空白を意味のないものとして扱って整形するため、ネストしたタグがインデントされます。要素内の空白をそのまま保持する必要があるドキュメントでは、使う前に結果を確認してください。
- 逆の処理が必要なら、本番用にコードを縮小する JavaScript・CSS 圧縮ツールや、JSON の検証と圧縮ができる JSON フォーマッターを使ってください。
よくある質問
› このツールはどのフォーマッターを使っていますか?
Web プロジェクトで最も広く使われているコードフォーマッター Prettier を、すべてブラウザ内で実行しています。XML 対応は公式の Prettier XML プラグインによるものです。同じ設定ならエディターで Prettier を使ったときと同じ出力になります。
› コードの動作が変わることはありますか?
いいえ。Prettier が変更するのはインデント、改行、スペース、クォートの種類といったレイアウトだけです。構文エラーがある場合は推測で直さず、処理を止めてその行を示します。
› script タグや style タグ内のコードも整形されるのはなぜですか?
HTML フォーマッターは埋め込まれた CSS や JavaScript を対応する Prettier パーサーに渡すため、ページ全体が一貫したインデントで整形されます。
› コードはアップロードされますか?
いいえ。整形はローカルで実行され、サーバーには何も送信されません。