View on GitHub

Table Options

The table options API of Bootstrap Table.

The table options are defined in jQuery.fn.bootstrapTable.defaults.

-

  • Attribute: data-toggle

  • Type: String

  • Detail:

    Activate bootstrap table without writing JavaScript.

  • Default: 'table'

  • Example: From HTML

ajax

  • Attribute: data-ajax

  • Type: Function

  • Detail:

    A method to replace ajax call. Should implement the same API as jQuery ajax method.

  • Default: undefined

  • Example: Table AJAX

ajaxOptions

  • Attribute: data-ajax-options

  • Type: Object

  • Detail:

    Additional options for submit ajax request. List of values: jQuery.ajax.

  • Default: {}

  • Example: AJAX Options

buttons

  • Attribute: data-buttons

  • Type: Function

  • Detail:

    This option allows creating/adding custom button(s) to “buttonbar” (top right of the table).
    This buttons can be sorted with the table option buttonsOrder, the used key/name for the event should be used for that!

    The custom button is highly configurable, the following options exists:

    • text
      • Description: This options is used for the showButtonText table option.
      • Type: String
    • icon
      • Description: This option is used for the showButtonIcons table option.
      • Type: String - Only needs the icon class e.g. fa-users
    • render
      • Description: Set this option to false to hide the button by default, the button is visible again when you add the data attribute data-show-BUTTONNAME="true".
    • attributes
      • Description: This option allows adding additional html attributes e.g. title
      • Type: Object
      • Example: {title: 'Button title'}
    • html
      • Description: If you don’t want to autogenerate the html, you can use this option to insert your custom html.
        The event option is only working if you custom html contains name="BUTTONNAME".
        If this option is used the following options will be ignored:
        • text
        • icon
        • attributes
      • Type: Function|String
    • event
      • Description: Should be used if you want to add an event to the button
      • Type: Function|Object|String

    The event option can be configured in three ways.
    One event with click event:

     {
       'event': () => { }
     }
    

    One event with a self defined event type:

       {
         'event': {
           'mouseenter': () => { }
         }
       }
    

    Multiple events with self defined event types:

         {
           'event': {
             'click': () => { },
             'mouseenter': () => { },
             'mouseleave': () => { }
           }
         }
    

    Hint: Instead of inline functions you also can use function names.

    A configured custom button could look like this:

    {
      btnRemoveEvenRows: {
        'text': 'Remove even Rows',
        'icon': 'fa-trash',
        'event': () => {
          //DO STUFF TO REMOVE EVEN ROWS
        },
        'attributes': {
          'title': 'Remove all rows which has a even id'
        }
      }
    }
    
  • Default: {}

  • Example: Buttons

buttonsAlign

  • Attribute: data-buttons-align

  • Type: String

  • Detail:

    Indicate how to align the toolbar buttons. 'left', 'right' can be used.

  • Default: 'right'

  • Example: Buttons Align

buttonsClass

  • Attribute: data-buttons-class

  • Type: String

  • Detail:

    Defines the class (added after 'btn-') of table buttons.

  • Default: 'secondary'

  • Example: Buttons Class

buttonsOrder

  • Attribute: data-buttons-order

  • Type: Array

  • Detail:

    Indicate how to custom order of the toolbar buttons.

  • Default: ['paginationSwitch', 'refresh', 'toggle', 'fullscreen', 'columns']

  • Example: Buttons Order

buttonsPrefix

  • Attribute: data-buttons-prefix

  • Type: String

  • Detail:

    Defines prefix of table buttons.

  • Default: 'btn'

  • Example: Buttons Prefix

buttonsToolbar

  • Attribute: data-buttons-toolbar

  • Type: String/Node

  • Detail:

    A jQuery selector that indicates the custom buttons toolbar, for example: #buttons-toolbar, .buttons-toolbar, or a DOM node.

  • Default: undefined

  • Example: Buttons Toolbar

cache

  • Attribute: data-cache

  • Type: Boolean

  • Detail:

    Set false to disable caching of AJAX requests.

  • Default: true

  • Example: Table Cache

cardView

  • Attribute: data-card-view

  • Type: Boolean

  • Detail:

    Set true to show card view table, for example mobile view.

  • Default: false

  • Example: Card View

checkboxHeader

  • Attribute: data-checkbox-header

  • Type: Boolean

  • Detail:

    Set false to hide check-all checkbox in header row.

  • Default: true

  • Example: Checkbox Header

classes

  • Attribute: data-classes

  • Type: String

  • Detail:

    The class name of table. 'table', 'table-bordered', 'table-hover', 'table-striped', 'table-dark', 'table-sm' and 'table-borderless' can be used. By default, the table is bordered.

  • Default: 'table table-bordered table-hover'

  • Example: Table Classes

clickToSelect

  • Attribute: data-click-to-select

  • Type: Boolean

  • Detail:

    Set true to select checkbox or radiobox when clicking rows.

  • Default: false

  • Example: Click To Select

columns

  • Attribute: -

  • Type: Array

  • Detail:

    The table columns config object, see column properties for more details.

  • Default: []

  • Example: Table Columns

contentType

  • Attribute: data-content-type

  • Type: String

  • Detail:

    The contentType of request remote data, for example: application/x-www-form-urlencoded.

  • Default: 'application/json'

  • Example: Content Type

customSearch

  • Attribute: data-custom-search

  • Type: Function

  • Detail:

    The custom search function is executed instead of built-in search function, takes three parameters:

    • data: the table data.
    • text: the search text.
    • filter: the filter object from filterBy method.

    Example usage:

  function customSearch(data, text) {
    return data.filter(function (row) {
      return row.field.indexOf(text) > -1
    })
  }
  

customSort

  • Attribute: data-custom-sort

  • Type: Function

  • Detail:

    The custom sort function is executed instead of the built-in sort function, takes three parameters:

    • sortName: the sort name.
    • sortOrder: the sort order.
    • data: the rows data.
  • Default: undefined

  • Example: Custom Order

data

  • Attribute: data-data

  • Type: Array | Object

  • Detail:

    The data to be loaded.

    If in the data has _<field>_rowspan or _<field>_colspan property, then will merge cells auto, for example:

    $table.bootstrapTable({
      data: [
        {
          id: 1,
          name: 'Item 1',
          _name_rowspan: 2,
          price: '$1'
        },
        {
          id: 2,
          price: '$2'
        }
      ]
    })
    

    If use this feature, the data is required to ensure that the format is correct.

  • Default: []

  • Example: From Data

dataField

  • Attribute: data-data-field

  • Type: String

  • Detail:

    Key in incoming json containing 'rows' data list.

  • Default: 'rows'

  • Example: Total/Data Field

dataType

  • Attribute: data-data-type

  • Type: String

  • Detail:

    The type of data that you are expecting back from the server.

  • Default: 'json'

  • Example: Data Type

detailFilter

  • Attribute: data-detail-filter

  • Type: Function

  • Detail:

    Enable expansion per row when detailView is set to true. Return true and the row will be enabled for expansion, return false and expansion for the row will be disabled. Default function returns true to enable expansion for all rows.

  • Default: function(index, row) { return true }

  • Example: Detail Filter

detailFormatter

  • Attribute: data-detail-formatter

  • Type: Function

  • Detail:

    Format your detail view when detailView is set to true. Return a String and it will be appended into the detail view cell, optionally render the element directly using the third parameter which is a jQuery element of the target cell.

  • Default: function(index, row, element) { return '' }

  • Example: Detail View

detailView

  • Attribute: data-detail-view

  • Type: Boolean

  • Detail:

    Set true to show detail view table.

  • Default: false

  • Example: Detail View

detailViewAlign

  • Attribute: data-detail-view-align

  • Type: String

  • Detail:

    Indicate how to align the detail view icon. 'left', 'right' can be used.

  • Default: 'left'

  • Example: Detail view Align

detailViewByClick

  • Attribute: data-detail-view-by-click

  • Type: Boolean

  • Detail:

    Set true to toggle the detail view, when a cell is clicked.

  • Default: false

  • Example: Detail View Icon

detailViewIcon

  • Attribute: data-detail-view-icon

  • Type: Boolean

  • Detail:

    Set true to show the detail view column (plus/minus icon).

  • Default: true

  • Example: Detail View Icon

escape

  • Attribute: data-escape

  • Type: Boolean

  • Detail:

    Escapes a string for insertion into HTML, replacing &, <, >, “, `, and ‘ characters.

  • Default: false

  • Example: Table Escape

filterOptions

  • Attribute: data-filter-options

  • Type: Boolean

  • Detail:

    Define the default filter options of algorithm, filterAlgorithm: 'and' means all given filter must match, filterAlgorithm: 'or' means one of the given filter must match.

  • Default: { filterAlgorithm: 'and' }

  • Example: Filter Options

footerField

  • Attribute: data-footer-field

  • Type: String

  • Detail:

    Defines the key of the footer Object (From data array or server response json). The footer Object can be used to set/define footer colspans and/or the value of the footer. Only triggered when data-pagination is true and data-side-pagination is server.

    {
      "rows": [
        {
          "id": 0,
          "name": "Item 0",
          "price": "$0",
          "amount": 3
        }
      ],
      "footer": {
        "id": "footer id",
        "_id_colspan": 2,
        "name": "footer name"
      }
    }
    

footerStyle

  • Attribute: data-footer-style

  • Type: Function

  • Detail:

    The footer style formatter function, takes one parameter:

    • column: the column object.

    Support classes or css. Example usage:

  function footerStyle(column) {
    return {
      css: { 'font-weight': 'normal' },
      classes: 'my-class'
    }
  }
  

headerStyle

  • Attribute: data-header-style

  • Type: Function

  • Detail:

    The header style formatter function, takes one parameter:

    • column: the column object.

    Support classes or css. Example usage:

  function headerStyle(column) {
    return {
      css: { 'font-weight': 'normal' },
      classes: 'my-class'
    }
  }
  

height

  • Attribute: data-height

  • Type: Number

  • Detail:

    The height of table, enable fixed header of table.

  • Default: undefined

  • Example: Table Height

icons

  • Attribute: data-icons

  • Type: Object

  • Detail:

    Defines icons used in the toolbar, pagination, and details view.

  • Default:

  {
    paginationSwitchDown: 'fa-caret-square-down',
    paginationSwitchUp: 'fa-caret-square-up',
    refresh: 'fa-sync',
    toggleOff: 'fa-toggle-off',
    toggleOn: 'fa-toggle-on',
    columns: 'fa-th-list',
    fullscreen: 'fa-arrows-alt',
    detailOpen: 'fa-plus',
    detailClose: 'fa-minus'
  }
  

iconSize

  • Attribute: data-icon-size

  • Type: String

  • Detail:

    Defines icon size, undefined, 'lg', 'sm' can be used.

  • Default: undefined

  • Example: Icon Size

iconsPrefix

  • Attribute: data-icons-prefix

  • Type: String

  • Detail:

    Defines icon set name ('glyphicon' or 'fa' for FontAwesome). By default 'fa' is used for Bootstrap v4.

  • Default: 'fa'

  • Example: Icons Prefix

    idField

  • Attribute: data-id-field

  • Type: String

  • Detail:

    Indicate which field will be used as checkbox/radiobox value, its the counterpart to selectItemName.

  • Default: undefined

  • Example: Id Field

ignoreClickToSelectOn

  • Attribute: data-ignore-click-to-select-on

  • Type: Function

  • Detail:

    Set the ignore elements clickToSelect on. Takes one parameter:

    • element: the element clicked on.

    Return true if the click should be ignored, false if the click should cause the row to be selected. This option is only relevant if clickToSelect is true.

  • Default: { return ['A', 'BUTTON'].includes(tagName) }

  • Example: Ignore Click To Select On

loadingFontSize

  • Attribute: data-loading-font-size

  • Type: String

  • Detail:

    To define the font size of the loading text, the default value is 'auto', it will be calculated automatically according to the table width, between 12px and 32px.

  • Default: 'auto'

  • Example: Loading Font Size

loadingTemplate

  • Attribute: data-loading-template

  • Type: Function

  • Detail:

    To custom the loading type by yourself. The parameters object contain:

    • loadingMessage: the formatLoadingMessage locale.
  • Default:
    function (loadingMessage) {
      return '<span class="loading-wrap">' +
        '<span class="loading-text">' +
        loadingMessage +
        '</span>' +
        '<span class="animation-wrap"><span class="animation-dot"></span></span>' +
        '</span>'
    }
    
  • Example: Loading Template

locale

  • Attribute: data-locale

  • Type: String

  • Detail:

    Sets the locale to use (i.e. 'zh-CN'). Locale files must be pre-loaded. Allows for fallback locales, if loaded, in the following order:

    • First tries for the locale as specified,
    • Then tries the locale with ‘_’ translated to ‘-‘ and the region code upper cased,
    • Then tries the short locale code (i.e. 'zh' instead of 'zh-CN'),
    • And finally will use the last locale file loaded (or the default locale if no locales loaded).

    If left undefined or an empty string, use the last locale loaded (or 'en-US' if no locale files loaded).

  • Default: undefined

  • Example: Table Locale

maintainMetaData

  • Attribute: data-maintain-meta-data

  • Type: Boolean

  • Detail:

    Set true to maintain the following meta data on change page and search:

    • selected rows
    • hidden rows
  • Default: false

  • Example: Maintain Meta Data

method

  • Attribute: data-method

  • Type: String

  • Detail:

    The method type to request remote data.

  • Default: 'get'

  • Example: Table Method

minimumCountColumns

  • Attribute: data-minimum-count-columns

  • Type: Number

  • Detail:

    The minimum number of columns to hide from the columns drop down list.

  • Default: 1

  • Example: Minimum Count Columns

multipleSelectRow

  • Attribute: data-multiple-select-row

  • Type: Boolean

  • Detail:

    Set true to enable the multiple selection row. Can use the ctrl+click to select one row or use shift+click to select a range of rows.

  • Default: false

  • Example: Multiple Select Row

pageList

  • Attribute: data-page-list

  • Type: Array

  • Detail:

    When set pagination property, initialize the page size selecting list. If you include the 'all' or 'unlimited' option, all the records will be shown in your table.

    Hint: If the table has lesser rows as the option(s), the options will be hidden automatically, to disable that feature you can set smartDisplay to false

  • Default: [10, 25, 50, 100]

  • Example: Page List

pageNumber

  • Attribute: data-page-number

  • Type: Number

  • Detail:

    When set pagination property, initialize the page number.

  • Default: 1

  • Example: Page Number

pageSize

  • Attribute: data-page-size

  • Type: Number

  • Detail:

    When set pagination property, initialize the page size.

  • Default: 10

  • Example: Page Size

pagination

  • Attribute: data-pagination

  • Type: Boolean

  • Detail:

    Set true to show a pagination toolbar on table bottom.

  • Default: false

  • Example: Table Pagination

paginationDetailHAlign

  • Attribute: data-pagination-detail-h-align

  • Type: String

  • Detail:

    Indicate how to align the pagination detail. 'left', 'right' can be used.

  • Default: 'left'

  • Example: Pagination H Align

paginationHAlign

  • Attribute: data-pagination-h-align

  • Type: String

  • Detail:

    Indicate how to align the pagination. 'left', 'right' can be used.

  • Default: 'right'

  • Example: Pagination H Align

paginationLoop

  • Attribute: data-pagination-loop

  • Type: Boolean

  • Detail:

    Set true to enable pagination continuous loop mode.

  • Default: true

  • Example: Pagination Loop

paginationNextText

  • Attribute: data-pagination-next-text

  • Type: String

  • Detail:

    Indicate the icon or text to be shown in the pagination detail, the next button.

  • Default: '›'

  • Example: Pagination Text

paginationPagesBySide

  • Attribute: data-pagination-pages-by-side

  • Type: Number

  • Detail:

    The number of pages on each side (right, left) of the current page.

  • Default: 1

  • Example: Pagination Index Number

paginationParts

  • Attribute: data-pagination-parts

  • Type: Array

  • Detail:

    These options define which parts of the pagination should be visible.

    • pageInfo Shows which dataset will be displayed on the current page (e.g. Showing 1 to 10 of 54 rows).
    • pageInfoShort Similar to pageInfo, but it only displays how much rows the table has (e.g. Showing 54 rows).
    • pageSize Shows the dropdown which defines how many rows should be displayed on the page.
    • pageList Shows the main part of the pagination (The list of the pages).
  • Default: ['pageInfo', 'pageSize', 'pageList']

  • Example: Pagination Parts

paginationPreText

  • Attribute: data-pagination-pre-text

  • Type: String

  • Detail:

    Indicate the icon or text to be shown in the pagination detail, the previous button.

  • Default: '‹'

  • Example: Pagination Text

paginationSuccessivelySize

  • Attribute: data-pagination-successively-size

  • Type: Number

  • Detail:

    Maximum successive number of pages in a row.

  • Default: 5

  • Example: Pagination Index Number

paginationUseIntermediate

  • Attribute: data-pagination-use-intermediate

  • Type: Boolean

  • Detail:

    Calculate and show intermediate pages for quick access.

  • Default: false

  • Example: Pagination Index Number

paginationVAlign

  • Attribute: data-pagination-v-align

  • Type: String

  • Detail:

    Indicate how to vertical align the pagination. 'top', 'bottom', 'both' (put the pagination on top and bottom) can be used.

  • Default: 'bottom'

  • Example: Pagination V Align

queryParams

  • Attribute: data-query-params

  • Type: Function

  • Detail:

    When requesting remote data, you can send additional parameters by modifying queryParams.

    If queryParamsType = 'limit', the params object contains: limit, offset, search, sort, order.

    Else, it contains: pageSize, pageNumber, searchText, sortName, sortOrder.

    Return false to stop request.

  • Default: function(params) { return params }

  • Example: Query Params

queryParamsType

  • Attribute: data-query-params-type

  • Type: String

  • Detail:

    Set 'limit' to send query params with RESTFul type.

  • Default: 'limit'

  • Example: Query Params Type

regexSearch

  • Attribute: data-regex-search

  • Type: Boolean

  • Detail:

    Set true to enable the regex search. Is this option enabled, you can search with regex e.g. [47a]$ for all items which ends with a 4, 7 or a.
    The regex can be entered with /[47a]$/gim or without [47a]$ flags, the default flags are gim.

  • Default: false

  • Example: Regex Search

rememberOrder

  • Attribute: data-remember-order

  • Type: Boolean

  • Detail:

    Set true to remember the order for each column.

  • Default: false

  • Example: Remember Order

responseHandler

  • Attribute: data-response-handler

  • Type: Function

  • Detail:

    Before load remote data, handler the response data format, the parameters object contains:

    • res: the response data.
    • jqXHR: jqXHR object, which is a super set of the XMLHTTPRequest object. For more information, see the jqXHR Type.
  • Default: function(res) { return res }

  • Example: Response Handler

rowAttributes

  • Attribute: data-row-attributes

  • Type: Function

  • Detail:

    The row attribute formatter function, takes two parameters:

    • row: the row record data.
    • index: the row index.

    Support all custom attributes.

  • Default: {}

  • Example: Row Attributes

rowStyle

  • Attribute: data-row-style

  • Type: Function

  • Detail:

    The row style formatter function, takes two parameters:

    • row: the row record data.
    • index: the row index.

    Support classes or css.

  • Default: {}

  • Example: Row Style

  • Attribute: data-search

  • Type: Boolean

  • Detail:

    Enable the search input.

    There are 3 ways to search:

    • The value contains the search query (Default). Example: Github contains git.
    • The value must be identical to the search query. Example: Github (value) and Github (search query).
    • Comparisons (<, >, <=, =<, >=, =>). Example: 4 is larger than 3.

    Notes:

    • If you want to use a custom search input use the searchSelector.
    • You can also search via regex using the regexSearch option.
  • Default: false

  • Example: Table Search

searchAccentNeutralise

  • Attribute: data-search-accent-neutralise

  • Type: Boolean

  • Detail:

    Set to true if you want to use accent neutralise feature.

  • Default: false

  • Example: Search Accent Neutralise

searchAlign

  • Attribute: data-search-align

  • Type: String

  • Detail:

    Indicate how to align the search input. 'left', 'right' can be used.

  • Default: 'right'

  • Example: Search Align

searchHighlight

  • Attribute: data-search-highlight

  • Type: Boolean

  • Detail:

    Set to true to highlight the searched text (using the <mark> html tag). You can also define a custom highlight formatter e.g. for values with html or to use a custom highlight color.

  • Default: 'false'

  • Example: Search Highlight

searchOnEnterKey

  • Attribute: data-search-on-enter-key

  • Type: Boolean

  • Detail:

    The search method will be executed until the Enter key is pressed.

  • Default: false

  • Example: Search On Enter Key

searchSelector

  • Attribute: data-search-selector

  • Type: Boolean|String

  • Detail:

    If this option is set (must be a valid dom selector e.g. #customSearch), the found dom element (should be an input element) will be used as table search instead of the built-in search input.

  • Default: false

  • Example: Search Selector

searchText

  • Attribute: data-search-text

  • Type: String

  • Detail:

    When set search property, initialize the search text.

  • Default: ''

  • Example: Search Text

searchTimeOut

  • Attribute: data-search-time-out

  • Type: Number

  • Detail:

    Set timeout for search fire.

  • Default: 500

  • Example: Search Time Out

selectItemName

  • Attribute: data-select-item-name

  • Type: String

  • Detail:

    The name of radio or checkbox input.

  • Default: 'btSelectItem'

  • Example: Id Field

serverSort

  • Attribute: data-server-sort

  • Type: Boolean

  • Detail:

    Set false to sort the data in the client side, only works when the sidePagination is server.

  • Default: true

  • Example: Server Sort

showButtonIcons

  • Attribute: data-show-button-icons

  • Type: Boolean

  • Detail:

    All buttons will show icons on it

  • Default: true

  • Example: show button icons

showButtonText

  • Attribute: data-show-button-text

  • Type: Boolean

  • Detail:

    All buttons will show an text on it

  • Default: false

  • Example: show button text

showColumns

  • Attribute: data-show-columns

  • Type: Boolean

  • Detail:

    Set true to show the columns drop down list. We can set the switchable column option to false to hide the columns item in the drop down list.

  • Default: false

  • Example: Basic Columns and Large Columns

showColumnsSearch

  • Attribute: data-show-columns-search

  • Type: Boolean

  • Detail:

    Set true to show a search for the columns filter.

  • Default: false

  • Example: Columns Search

showColumnsToggleAll

  • Attribute: data-show-columns-toggle-all

  • Type: Boolean

  • Detail:

    Set true to show a toggle all checkbox within the columns option/dropdown.

  • Default: false

  • Example: Columns Toggle All

showExtendedPagination

  • Attribute: data-show-extended-pagination

  • Type: Boolean

  • Detail:

    Set true to show a extended version of pagination (including the count of all rows with out filters). If you use pagination on the server side pls use totalNotFilteredField to define the count.

  • Default: false

  • Example: Show Extended Pagination

showFooter

  • Attribute: data-show-footer

  • Type: Boolean

  • Detail:

    Set true to show the summary footer row.

  • Default: false

  • Example: Show Footer

showFullscreen

  • Attribute: data-show-fullscreen

  • Type: Boolean

  • Detail:

    Set true to show the fullscreen button.

  • Default: false

  • Example: Show Fullscreen

showHeader

  • Attribute: data-show-header

  • Type: Boolean

  • Detail:

    Set false to hide the table header.

  • Default: true

  • Example: Show Header

showPaginationSwitch

  • Attribute: data-show-pagination-switch

  • Type: Boolean

  • Detail:

    Set true to show the pagination switch button.

  • Default: false

  • Example: Show Pagination Switch

showRefresh

  • Attribute: data-show-refresh

  • Type: Boolean

  • Detail:

    Set true to show the refresh button.

  • Default: false

  • Example: Show Refresh

showSearchButton

  • Attribute: data-show-search-button

  • Type: Boolean

  • Detail:

    Set true to show a search Button behind the search input. The Search will only be executed if the button is pressed (e.g. to prevent traffic or loading time).

  • Default: false

  • Example: Show Search Button

showSearchClearButton

  • Attribute: data-show-search-clear-button

  • Type: Boolean

  • Detail:

    Set true to show a clear Button behind the search input which will clear the search input (also all filter from filter-control (if enabled)).

  • Default: false

  • Example: Show Search Clear Button

showToggle

  • Attribute: data-show-toggle

  • Type: Boolean

  • Detail:

    Set true to show the toggle button to toggle table / card view.

  • Default: false

  • Example: Show Toggle

sidePagination

  • Attribute: data-side-pagination

  • Type: String

  • Detail:

    Defines the side pagination of the table, can only be 'client' or 'server'. Using 'server' side requires either setting the 'url' or 'ajax' option.

    Note that the required server response format is different depending on whether the 'sidePagination' option is set to 'client' or 'server'. See the following examples:

  • Default: 'client'

  • Example: Client Side Pagination and Server Side Pagination

silentSort

  • Attribute: data-silent-sort

  • Type: Boolean

  • Detail:

    Set false to sort the data with the loading message. This options works when the sidePagination option is set to 'server'.

  • Default: true

  • Example: Silent Sort

singleSelect

  • Attribute: data-single-select

  • Type: Boolean

  • Detail:

    Set true to allow checkbox selecting only one row.

  • Default: false

  • Example: Single Select

smartDisplay

  • Attribute: data-smart-display

  • Type: Boolean

  • Detail:

    Set true to display pagination or card view smartly.

  • Default: true

  • Example: Smart Display

sortable

  • Attribute: data-sortable

  • Type: Boolean

  • Detail:

    Set false to disable sortable of all columns.

  • Default: true

  • Example: Table Sortable

sortClass

  • Attribute: data-sort-class

  • Type: String

  • Detail:

    The class name of the td elements which are sorted.

  • Default: undefined

  • Example: Sort Class

sortName

  • Attribute: data-sort-name

  • Type: String

  • Detail:

    Defines which column will be sorted.

  • Default: undefined

  • Example: Sort Name Order

sortOrder

  • Attribute: data-sort-order

  • Type: String

  • Detail:

    Defines the column sort order, can only be undefined, 'asc' or 'desc'.

  • Default: undefined

  • Example: Sort Name Order

sortReset

  • Attribute: data-sort-reset

  • Type: Boolean

  • Detail:

    Set true to reset the sort on third click.

  • Default: false

  • Example: Sort Reset

sortStable

  • Attribute: data-sort-stable

  • Type: Boolean

  • Detail:

    Set true to get a stable sorting. We will add '_position' property to the row.

  • Default: false

  • Example: Sort Stable

strictSearch

  • Attribute: data-strict-search

  • Type: Boolean

  • Detail:

    Enable the strict search. Disables the comparison checks.

  • Default: false

  • Example: Strict Search

theadClasses

  • Attribute: data-thead-classes

  • Type: String

  • Detail:

    The class name of table thead. Bootstrap v4, use the modifier classes .thead-light or .thead-dark to make theads appear light or dark gray.

  • Default: ''

  • Example: Thead Classes

toolbar

  • Attribute: data-toolbar

  • Type: String/Node

  • Detail:

    A jQuery selector that indicates the toolbar, for example: #toolbar, .toolbar, or a DOM node.

  • Default: undefined

  • Example: Custom Toolbar

toolbarAlign

  • Attribute: data-toolbar-align

  • Type: String

  • Detail:

    Indicate how to align the custom toolbar. 'left', 'right' can be used.

  • Default: 'left'

  • Example: Toolbar Align

totalField

  • Attribute: data-total-field

  • Type: String

  • Detail:

    Key in incoming json containing 'total' data.

  • Default: 'total'

  • Example: Total/Data Field

totalNotFiltered

  • Attribute: data-total-not-filtered

  • Type: Number

  • Detail:

    This property is mainly passed in by pagination server, which is easy to use.

  • Default: 0

totalNotFilteredField

  • Attribute: data-total-not-filtered-field

  • Type: string

  • Detail:

    The field from the json response which will used for showExtendedPagination.

  • Default: totalNotFiltered

  • Example: Total Not Filtered Field

totalRows

  • Attribute: data-total-rows

  • Type: Number

  • Detail:

    This property is mainly passed in by pagination server, which is easy to use.

  • Default: 0

trimOnSearch

  • Attribute: data-trim-on-search

  • Type: Boolean

  • Detail:

    Set true to trim spaces in search field.

  • Default: true

  • Example: Trim On Search

undefinedText

  • Attribute: data-undefined-text

  • Type: String

  • Detail:

    Defines the default undefined text.

  • Default: '-'

  • Example: Undefined Text

uniqueId

  • Attribute: data-unique-id

  • Type: String

  • Detail:

    Indicate an unique identifier for each row.

  • Default: undefined

  • Example: getRowByUniqueId

url

  • Attribute: data-url

  • Type: String

  • Detail:

    A URL to request data from remote site.

    Note that the required server response format is different depending on whether the 'sidePagination' option is specified. See the following examples:

  • Default: undefined

  • Example: From URL

  • Error handling

    To get loading errors please use onLoadError

virtualScroll

  • Attribute: data-virtual-scroll

  • Type: Boolean

  • Detail:

    Set true to enable virtual scroll to displays a virtual, “infinite” list.

  • Default: false

  • Example: Large Data

virtualScrollItemHeight

  • Attribute: data-virtual-scroll-item-height

  • Type: Number

  • Detail:

    If this option is not define, we will use the height of the first item by default.

    It is important to provide this if virtual item height will be significantly larger than the default height. This dimension is used to help determine how many cells should be created when initialized, and to help calculate the height of the scrollable area. This height value can only use px units.

  • Default: undefined

visibleSearch

  • Attribute: data-visible-search

  • Type: Boolean

  • Detail:

    set true to search only in visible column/data, if the data contains other values which are not displayed they will be ignored while searching.

  • Default: false

  • Example: visible search