BootstrapTable——Localizations

layout: docs
title: Localizations
description: The Localizations API of Bootstrap Table.
group: api

toc: true

We can import all locale files what you need:

{% highlight html %}
```html
<script src="bootstrap-table-en-US.js"></script>
<script src="bootstrap-table-zh-CN.js"></script>
...
{% endhighlight %}

And then use JavaScript to switch locale:

{% highlight javascript %}
$.extend($.fn.bootstrapTable.defaults, $.fn.bootstrapTable.locales['en-US'])
// $.extend($.fn.bootstrapTable.defaults, $.fn.bootstrapTable.locales['zh-CN'])
// ...
{% endhighlight %}

Or use data attributes to set locale for table:

Or use JavaScript to set locale for table:

{% highlight javascript %}
$('#table').bootstrapTable({
locale: 'en-US'
})
{% endhighlight %}

You can use short code for the locale:
{% highlight javascript %}
$('#table').bootstrapTable({
locale: 'en'
})
{% endhighlight %}

List of all existing translations with their short codes is on Github

You can custom the format localizations, the calling syntax:

{% highlight javascript %}
$('#table').bootstrapTable({
formatName: function () {
return 'Format message'
}
})
{% endhighlight %}

formatAllRows

• Parameter: undefined
  

• Default: 'All'

formatClearSearch

• Parameter: undefined
  

• Default: 'Clear Search'

formatColumns

• Parameter: undefined
  

• Default: 'Columns'

formatColumnsToggleAll

• Parameter: undefined
  

• Default: 'Toggle all'

formatDetailPagination

• Parameter: totalRows
  

• Default: 'Showing %s rows'

formatFullscreen

• Parameter: undefined
  

• Default: 'Fullscreen'

formatLoadingMessage

• Parameter: undefined
  

• Default: 'Loading, please wait…'

formatNoMatches

• Parameter: undefined
  

• Default: 'No matching records found'

formatPaginationSwitch

• Parameter: undefined
  

• Default: 'Hide/Show pagination'

formatPaginationSwitchDown

• Parameter: undefined
  

• Default: 'Show pagination'

formatPaginationSwitchUp

• Parameter: undefined
  

• Default: 'Hide pagination'

formatRecordsPerPage

• Parameter: pageNumber
  

• Default: '%s records per page'

formatRefresh

• Parameter: undefined
  

• Default: 'Refresh'

formatSearch

• Parameter: undefined
  

• Default: 'Search'

formatShowingRows

• Parameter: pageFrom, pageTo, totalRows
  

• Default: 'Showing %s to %s of %s rows'

formatSRPaginationNextText

• Parameter: undefined
  

• Default: 'next page'

formatSRPaginationPageText

• Parameter: page
  

• Default: 'to page %s

formatSRPaginationPreText

• Parameter: undefined
  

• Default: 'previous page'

formatToggleOff

• Parameter: undefined
  

• Default: 'Hide card view'

formatToggleOn

• Parameter: undefined
  

• Default: 'Show card view'