テーブルのアドレスバー

Bootstrap Tableのアドレスバー拡張機能。テーブル状態とURLの同期を実現します。

アドレスバー拡張機能は、テーブルのページネーション、並べ替え、検索などの状態情報をブラウザのアドレスバーに同期することができます。ユーザーがページをめくったり、並べ替えたり、検索したりすると、アドレスバーのクエリパラメータが自動的に更新されます。ページが読み込まれると、プラグインはアドレスバーのクエリパラメータを自動的に読み取り、テーブルの状態を復元します。

使用方法

<script src="extensions/addrbar/bootstrap-table-addrbar.js"></script>

例

Addrbar

オプション

addrbar

• 属性: data-addrbar

• 型: Boolean

• 詳細:

  アドレスバー機能を有効にするかどうか。true に設定すると、テーブルの状態がアドレスバーに同期されます。

• デフォルト値: false

addrCustomParams

• 属性: data-addr-custom-params

• 型: Function|Object

• 詳細:

  カスタムパラメータオブジェクトを定義します。その中のキーと値のペアは、追加のGETパラメータとしてURLに追加されます（例：カスタムフィルタ条件）。 key はGETパラメータ名を表し、value は対応するパラメータ値を表します。

• デフォルト値: {}

addrPrefix

• 属性: data-addr-prefix

• 型: String

• 詳細:

  クエリパラメータのプレフィックス。主に同じページに複数のテーブルが存在する場合のパラメータの競合問題を解決するために使用されます。

  ページに複数のテーブルが含まれ、すべてがアドレスバー拡張機能を有効にしている場合、パラメータが互いに干渉しないように、各テーブルに異なるプレフィックスを設定する必要があります。

  デフォルトでは、以下の5つのパラメータが使用されます：

  • page：現在のページ番号
  • size：1ページあたりの表示件数
  • order：並べ替え方法（昇順/降順）
  • sort：並べ替えフィールド名
  • search：検索キーワード

  複数のテーブルが同じプレフィックスを使用すると、これらのパラメータは互いに上書きされます。各テーブルに一意の addrPrefix 値を設定することで、競合を効果的に回避できます。

• デフォルト値: ''

注意事項

• 現在、サーバー側ページネーションモードのみをサポートしています。
• クライアント側ページネーションモードでは、この拡張機能を正常に使用できません。