B3S
menu close

HTML/CSS

HTMXためしてみた


うどん

公開日:2025/02/28


どうもこんにちは。

もう3月になることが信じられません。うどんです。

会社のシステムを構築する際に、Aのセレクターに連動してBのoptionの内容をかえる、といったことを定期的にしているんですが、この実装をするたびに
「jsonデータを別に用意するの、面倒だな~。DBの取得はほかでもしてるのに、このためだけにjsonデータにするの、なんかヤダ。」
とか思ってたんです。

そんなことをよく考えてる私に、「HTMX」といったものがあるということを知りました。
今回はこのHTMXを試してみます。

HTMXとは

HTMXはHTMLを拡張したJavaScriptライブラリ。
HTMLの属性を通じて、AJAX、CSS Transitions、WebSocketとServer Sent Eventsへのアクセスを提供してくれます。
つまりはデータ通信やページ更新をHTML属性で簡単に定義できるよってことです。

と、公式の記述だけだとわかりにくいのですが、ざっくりいうとHTMXではパーツごとにURLを叩いてくれて、返り値にはHTMLを記載しておくことで表示内容を切り替えるよといったものです。

HTMLで処理を実行し、JavaScriptの記述を少なくするために生まれたようなのですが、実際はどんな感じなのでしょうか。

実装する方法

公式サイト_インストールページ
https://htmx.org/docs/#installing

HTMXはCDNが用意されているので、CDNコードを設置するだけで利用することができます。

ローカルにインポートすることももちろん可能で、その場合はnpmでインストールすることができます。

実際に書いてみた

今回はバックエンドがLaravel(8)、フロントはBootstrap(5)の簡易的な環境にHTMXを追加してみました。
実際のソースを貼っていきます。

routeはこんな感じの内容にしていました。

// HTMXテスト用のビュー
Route::get('/htmx', [HtmxController::class, 'getHtmx']);

Route::get('/message', [HtmxController::class, 'getMessage']);
Route::get('/submit', [HtmxController::class, 'submitForm']);
Route::post('/submit', [HtmxController::class, 'submitForm']);
Route::get('/time', [HtmxController::class, 'getTime']);

Controller

class HtmxController extends Controller
{
    // ページ表示
    public function getHtmx()
    {
        return view('htmx');
    }

    // メッセージを返す
    public function getMessage()
    {
        $quotes = [
            "成功は最終的なものではなく、失敗は致命的なものでもない。大切なのは続ける勇気である。 - ウィンストン・チャーチル",
            "変化を恐れるな。過去の失敗を恐れるな。 - コリン・パウエル",
            "何事も達成するための唯一の方法は、まず始めることである。 - マーク・トウェイン",
            "成功は準備と機会が出会うところにある。 - ボビー・アンセルム",
            "あなたの時間は限られています。他人の人生を生きて浪費してはいけません。 - スティーブ・ジョブズ",
        ];
        
        // 配列からランダムに名言を選択
        $message = $quotes[array_rand($quotes)];        
        
        return response($message);
    }

    // フォームデータを受け取り、応答する
    public function submitForm(TestRequest $request)
    {
        if($request->name) {
            $name = $request->name;
            return view('response', compact('name'));
        }
        return view('submit');
    }

    // 現在時刻を返す
    public function getTime()
    {
        $now = Carbon::now()->format('Y-m-d H:i:s');
        return response($now);
    }
}

Views

ベースになるhtmx.blade.php
※今回はCDNでインストールしてみました。




    
    
    HTMX x Laravel x Bootstrap
    
    
    
    


    

HTMX x Laravel x Bootstrap

1. ボタンでサーバーからメッセージを取得

ここにメッセージが表示されます。

@include('submit')

3. タイマーでリアルタイム更新

現在の時刻:

読み込み中...

submit.blade.php


2. 簡単なフォーム送信

@include('response')

response.blade.php

@if($errors->has('name'))
    
{{ $errors->first('name') }}
@elseif(isset($name))
{{ $name ?? '' }} さん、こんにちは!送信ありがとうございます✨
@else
ここに結果が表示されます。
@endif

HTMLを触ってみて思った使えそうな場面

フォーム入力時に部分的に表示を変えたくても、サーバー側で処理を行うと基本は全画面描写をし直すことになっていたかと思うのですが、HTMXの場合は部分的な要素を差し替えられるため、今までjsonレスポンスを返していた部分では使うこともできるのではないかと思いました。
jsonと違っていいことは、バリデーションを通してから検索できることかと思います。

ただこのバリデーションをしようとした際に、ちょっとした苦労がありました。

HTMLのちょっぴり苦労した点

基本的には指定されたアクションをトリガーにHTMLを更新するのがHTMXの機能であるため、バリデーションを使った場合にエラー表示があってもLaravel側にリダイレクト「しない」という設計にする必要があったことでした。
また、バリデーションを通過できたあともviewファイルを返却するのではない場合は記述を変える必要があります。

そうしておかないとHTMLを入れ替えて表示させるHTMXでは無限おなじ内容を入れ子に表示させてしまうのです・・・。
そのため、リダイレクトさせないようにするために、TestRequest.phpを作りました。

 'required|max:5',
        ];
    }

    public function messages()
    {
        return [
            '*.required' => ':attributeは必須項目です',
            '*.max' => ':max桁以下で入力してください',
        ];
    }

    // バリデーションに失敗した場合は、リダイレクトせず view を返す
    protected function failedValidation(Validator $validator)
    {
        $view = '';
        $data = [];

        if($this->isMethod('post')) {

            $view = 'response';
            $data = [
                'name' => $this->name,
                'errors' => $validator->errors(),
            ];

        } else if($this->isMethod('put')) {

            $view = 'response';
            $data = [
                'name' => $this->name,
                'errors' => $validator->errors(),
            ];

        }

        $response = response()->view($view, $data);

        throw new HttpResponseException($response);
    }

    public function attributes()
    {
        return [
            'name' => 'お名前',
        ];
    }

}

このfailedValidationの中で、エラー時はどのviewファイルに返すかということを設定しています。

HTMXを使ってみた感想まとめ

新しいものは調べてみてもわからないことだらけでしたが、HTMXは「HTMLのレスポンスを返却する」という機能であることを想定すると、ほかのライブラリなどと比べると原因もわかりやすい気がしました。

また、トリガーフックも細かく設定できるので、もっとちゃんと調査すれば、さらに使える場面が増えそうなライブラリだとも感じました。
もう少し調査を進めて、実際のシステムにも取り入れようと思います。