HN 日本語サマリー

← 一覧へ戻る
Web開発

htmx を使用した段階的強化フォームの構築

Building progressively enhanced forms using Htmx (rafa.ee)

76 pointsby mpweiher12 コメント

要約

この記事では、htmx を用いて段階的強化(progressive enhancement)されたフォームを構築する方法について解説しています。JavaScript が無効な場合でも機能するフォームを基本とし、htmx を使ってインタラクティブ性を向上させるアプローチが紹介されています。サーバーとのやり取りにおける状態管理や、HTML の機能を活用した実装方法が詳述されています。

全文翻訳

htmx を使用した段階的強化フォームの構築

2026年6月25日; LLM生成テキストなし

最近、ties 用に、多くのインタラクティブ性を持つ新しいフォームを作成しました。これはブックマークを編集し、リストに接続するためのものです。

[動画: ブックマークを編集するフォームのスクリーンキャスト。ユーザーはボタンを押してブックマークの名前をブックマークされたウェブサイトから取得したタイトルに変更し、次にブックマークを追加するリストを検索します。]

この機能は段階的強化を使用しています。JS がなくても機能しますが、JS が有効な場合は HTMX を使用していくつかの利便性を追加します。

この記事では、私のアプローチを説明し、このスタイルの UI を構築する際に考慮すべきいくつかの点について説明します。

一時的な状態

JS がなくても機能するインターフェースは、シングルページアプリケーションとは根本的に異なります。ユーザーの操作に応じた UI の更新は、多くの場合サーバーへの往復(通常は a または form 要素によって開始される)を必要とします。

ユーザーがタスクを完了し、データベースに何かを保存する前には、「一時的な状態」があります。これは、ユーザーが入力した、まだ永続化されていない、この往復を乗り越える必要がある入力です。

上記フォームからの例としては、ブックマークの新しい名前が挙げられます。ユーザーが「名前変更」ボタンを押すと、名前がサーバーに送信され、バリデーションエラーがある場合、サーバーはエラーを示す応答を返します。応答にはユーザーの入力値が含まれているため、再度入力する必要はありません。

SPA では、一時的な状態は JS メモリに存在し、それを管理するために多くの依存関係を持つライブラリを使用することになります。JS なしで済ませるため、この状態を管理するには、それぞれにトレードオフがある古典的な HTML 機能を使用する必要があります。

この一時的な状態がシステムをどのように流れるかを考えることは、複雑なインタラクションを HTML にマッピングするのに役立ちます。

フォームの値

これは例の「名前変更」フィールドに使用され、最も一般的に使用されるものです。フォームが送信されると、サーバーはこれらの値を受け取り、応答に含めることができるため、ユーザーがサーバーとやり取りしても消えません。

これはシンプルで、おそらく多くのユーザー入力ですでに使用しているテクニックでしょう。

このテクニックの欠点は、ユーザーがページをリロードすると値が消えてしまうことです。もう 1 つの欠点は、値は 1 つのフォームに対してのみ送信されることです。ページ上に複数のフォームがある場合、他のフォームの値は送信時に消えてしまいます。たとえば、上記のブックマーク編集フォームは 2 つのフォームに分割されています。1 つはブックマークの名前を変更するためのもので、もう 1 つはリストを割り当てるためのものです(分割の理由は後で説明します)。HTMX を使用してこれを回避できます。これにより、JS を持たないユーザーは正常に機能低下を体験できます。

クエリパラメータとパス

状態をページのパスまたはクエリパラメータに入れることで、ページのリロードを乗り越えることができます。ブックマークやリンクの共有なども乗り越えることができます。

これは、たとえば検索クエリ、つまりフォーム内の「接続するリストを検索」入力に適したユースケースです。

パスとクエリパラメータを設定する最も一般的な方法は、リンクの href 属性とフォームの action 属性です。

method="GET" 属性を持つフォームを使用することもできます。これにより、そのフォームのすべての入力値がクエリ文字列に入力されます。

最後に、送信ボタンの formaction 属性 を使用して、特定の送信ボタンが押されたときにのみフォームのパスとクエリパラメータを変更できます。これは非常に便利です。この記事を書いている間に初めて知りました!

どのボタンが押されたかを検出する

ties の新しいフォームを作成したときに驚いたことの 1 つは、Enter キーが何をするか制御できないことです。それは単に関連付けられた入力の最初の送信ボタンを送信します。アクセス可能なフォームはキーボードで制御できるものでなければならないため、ブックマーク編集フォームを 2 つに分割しました。これにより、リスト検索入力で Enter キーを押してもブックマークの名前は変更されなくなります。

フォーム送信時にユーザーがどのボタンを押したかを知るには、ボタンの formaction 属性を使用してフォームが送信されるパスを変更できます。または、ボタンの name および value 属性を設定して、そのボタンが押されたときにサーバーに特定のフォーム値を送信することもできます。

段階的強化

JS を持たないユーザーをサポートするために、まず htmx なしで機能全体を作成するのが最も簡単だと考えています。これにより、JS なしでは不可能なことが判明した場合に、後でリファクタリングする必要が生じるような状況に陥るのを避けることができます。

それが完了したら、JS が利用可能な場所でのエクスペリエンスを向上させるために、htmx を少し追加します。上記の例では、ユーザーが検索結果を確認するために Enter を押す必要がない「アクティブ検索」や、サーバーからの応答を待っていることを示す小さなスピナーが含まれています。このアプローチに従うと、実際に必要な htmx の量がどれほど少ないかに驚くことがよくあります。

後で変更をテストするときは、ブラウザの開発者ツールを使用して JS を無効にするか、hx-disable 属性を追加します。

hx-target

htmx のスワップのスコープを正しく設定する方法をまだ模索中です。ページの非常に狭い部分が更新され、ページの他の部分に古いデータが表示されたままになるために、バグを見つけることがよくありました。帯域外スワップ をいじってこれを解決するのは、エラーが発生しやすく、維持が非常に困難だと感じます。

将来的に壊れる可能性が最も低いので、通常はページ全体をスワップすることになります。これの欠点は、スワップ中にユーザー入力が失われることがあることですが、これはまれで、通常は許容範囲内です。

さらに読む

以上です。この記事から何か役立つものを持って帰っていただけたなら幸いです!このアプローチが次のプロジェクトに適しているかどうかを確認したい場合、またはすでに html/htmx を使用していてさらに学びたい場合は、お気に入りのリソースをいくつか紹介します。

Alexander Petros のブログ「Unplanned Obsolescence」は宝の山です。Less htmx is more と Who’s Afraid of a Hard Page Load? が良い出発点です。

How I use HTMX with Go と Django + htmx patterns は、バックエンドで htmx を使用するためのパターンについて説明しています。これらは他の言語やエコシステムにもよく翻訳されます。

If not React, then what? は、サーバーレンダリングされた html や htmx が構築中のプロジェクトに適しているかどうかを判断するのに役立ちます。

Resilient Web Design は、堅牢なウェブサイトの設計に関する信じられないほどよく書かれた本です。これは視覚的な意味合いよりも、全体的な設計に関するものであり、私の多くの技術的な選択に影響を与えました。このリストから 1 つ読むとしたら、これにすべきです。

Plain Vanilla Web は、一般的なユースケースのクックブックとして提示された、あなたがまだ知らないかもしれないブラウザの最新機能のリファレンスです。