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:每頁顯示條數
    • order:排序方式(升序/降序)
    • sort:排序字段名
    • search:搜索關鍵詞

    如果多個表格使用相同的前綴,這些參數會互相覆蓋。通過為每個表格設置唯一的 addrPrefix 值,可以有效避免沖突。

  • 默認值: ''

注意事項

  • 當前僅支持服務端分頁模式。
  • 客戶端分頁模式下無法正常使用此擴展。