blocs/admin: 削除機能のカスタマイズ

blocs/admin: 削除機能のカスタマイズ

自動生成された管理画面の削除機能をカスタマイズする方法を説明します。確認画面の追加や処理前後の制御を調整できます。

前提条件: 自動生成ツールで管理画面を生成済みであること

テンプレートの一覧

処理フロー

初期状態では モーダル で削除確認・実行を行います（詳しくは No.1.2 / No.5.4）。confirmDestroy / confirmSelect ルートおよび専用確認画面テンプレートは自動生成に含まれません。専用確認画面を使う場合のみ、以下の「パターンB」のフローになります。セッションキー {viewPrefix}.confirm の共有や確定時の validate*() スキップについては No.4.2 を参照してください。

★ はオーバーライドによるカスタマイズポイントです。

単一削除フロー

パターンA: モーダル確認（デフォルト）

flowchart TD
    index[index]
    subgraph show["show — 削除対象の表示（UpdateTrait::show）"]
        direction TB
        s1["getCurrent ★ — データ取得"]
        s2["prepareShow ★ — 表示データ準備（UpdateTrait）"]
        s3["outputShow — 画面表示（UpdateTrait）"]
        s1 --> s2 --> s3
    end
    modal["（モーダルで確認）"]
    subgraph destroy["destroy — 削除処理"]
        direction TB
        d1["getCurrent ★ — データ取得"]
        d2["validateDestroy ★ — 削除データの検証"]
        d3["prepareDestroy ★ — 削除データ準備"]
        d4["executeDestroy ★ — データ削除"]
        d5["logDestroy ★ — ログ記録"]
        d6["outputDestroy — 完了処理 → 一覧画面へ"]
        d1 --> d2 --> d3 --> d4 --> d5 --> d6
    end

    index --> s1
    s3 --> modal
    modal --> d1

パターンB: 専用確認画面（任意・追加時）

flowchart TD
    index[index]
    subgraph show["show — 削除対象の表示"]
        direction TB
        s1["getCurrent ★ — データ取得"]
        s2["prepareShow ★ — 表示データ準備"]
        s3["outputShow — 画面表示"]
        s1 --> s2 --> s3
    end
    subgraph confirm["confirmDestroy — 削除確認画面表示"]
        direction TB
        c1["getCurrent ★ — データ取得"]
        c2["validateDestroy ★ — 削除データの検証"]
        c3["prepareConfirmDestroy ★ — 表示データ準備"]
        c4["outputConfirmDestroy — 確認画面表示"]
        c1 --> c2 --> c3 --> c4
    end
    subgraph destroy["destroy — 削除処理"]
        direction TB
        d1["getCurrent ★ — データ取得"]
        d2["validateDestroy ★ — 削除データの検証"]
        d3["prepareDestroy ★ — 削除データ準備"]
        d4["executeDestroy ★ — データ削除"]
        d5["logDestroy ★ — ログ記録"]
        d6["outputDestroy — 完了処理 → 一覧画面へ"]
        d1 --> d2 --> d3 --> d4 --> d5 --> d6
    end

    index --> s1
    s3 --> c1
    c4 --> d1

一括削除フロー（SelectTrait）

パターンA: モーダル確認（デフォルト）

flowchart TD
    index["index（チェックボックスで選択）"]
    modal["（モーダルで確認）"]
    subgraph select["select — 選択データ処理（一括削除）"]
        direction TB
        s1["validateSelect ★ — 選択データの検証"]
        s2["prepareSelect ★ — 選択データ準備"]
        s3["executeSelect ★ — 選択データ処理"]
        s4["logSelect ★ — ログ記録"]
        s5["outputSelect — 完了処理 → 一覧画面へ"]
        s1 --> s2 --> s3 --> s4 --> s5
    end

    index --> modal
    modal --> s1

パターンB: 専用確認画面（任意・追加時）

flowchart TD
    index["index（チェックボックスで選択）"]
    subgraph confirm["confirmSelect — 選択確認画面表示"]
        direction TB
        c1["validateSelect ★ — 選択データの検証"]
        c2["prepareConfirmSelect ★ — 表示データ準備"]
        c3["outputConfirmSelect — 確認画面表示"]
        c1 --> c2 --> c3
    end
    subgraph select["select — 選択データ処理（一括削除）"]
        direction TB
        s1["validateSelect ★ — 選択データの検証"]
        s2["prepareSelect ★ — 選択データ準備"]
        s3["executeSelect ★ — 選択データ処理"]
        s4["logSelect ★ — ログ記録"]
        s5["outputSelect — 完了処理 → 一覧画面へ"]
        s1 --> s2 --> s3 --> s4 --> s5
    end

    index --> c1
    c3 --> s1

ベースコントローラーのメソッド

単一削除

専用の確認画面（パターンB）を使う場合は confirmDestroy ルートと confirmDestroy.blocs.html を追加してください（POST で定義）。一括削除の専用確認画面は confirmSelect ルートを追加します。

Route::post('/{id}/confirmDestroy', [UserController::class, 'confirmDestroy'])->where('id', '[0-9]+')->name('confirmDestroy');
Route::post('/confirmSelect', [UserController::class, 'confirmSelect'])->name('confirmSelect');

confirmDestroy / confirmSelect ルートも自動生成されません。

ベースコントローラーの主な変数

一括削除機能（SelectTrait）

一覧画面で複数のレコードを選択して一括削除する機能です。

メソッド

主な変数