Browse Source

Merge pull request #6036 from wenzhixin/feature/improve-english

Improve english
Dustin Utecht 3 years ago
parent
commit
6894ae5eae

+ 1 - 1
site/docs/about/license.md

@@ -28,7 +28,7 @@ Bootstrap Table is released under the MIT license and is copyright {{ site.time
 
 #### It does not require you to:
 
-- Include the source of Bootstrap Table itself, or of any modifications you may have made to it, in any redistribution you may assemble that includes it
+- Include the source of Bootstrap Table itself or of any modifications, you may have made to it in any redistribution you may assemble that includes it
 - Submit changes that you make to Bootstrap Table back to the Bootstrap Table project (though such feedback is encouraged)
 
 The full Bootstrap Table license is located [in the project repository]({{ site.repo }}/blob/{{ site.current_version }}/LICENSE) for more information.

+ 2 - 2
site/docs/about/overview.md

@@ -1,7 +1,7 @@
 ---
 layout: docs
 title: About
-description: Learn more about the team maintaining Bootstrap Table, how and why the project started, and how to get involved.
+description: Learn more about the Bootstrap Table team, how and why the project started, and how to get involved.
 redirect_from:
   - "/docs/about/"
 group: about
@@ -9,7 +9,7 @@ group: about
 
 ## Team
 
-Bootstrap Table is maintained by [wenzhixin](https://github.com/wenzhixin), [djhvscf](https://github.com/djhvscf) and [UtechtDustin](https://github.com/UtechtDustin) on GitHub. We're actively looking to grow this team and would love to hear from you if you're excited about CSS at scale, writing and maintaining vanilla JavaScript plugins, and improving build tooling processes for frontend code.
+Bootstrap Table is maintained by [wenzhixin](https://github.com/wenzhixin), [djhvscf](https://github.com/djhvscf) and [UtechtDustin](https://github.com/UtechtDustin) on GitHub. We're actively looking to grow this team. We would love to hear from you if you're excited about CSS at scale, writing and maintaining vanilla JavaScript plugins, and improving build tooling processes for frontend code.
 
 ## Get involved
 

+ 1 - 1
site/docs/about/team.md

@@ -5,7 +5,7 @@ description: An overview of the founding team and core contributors to Bootstrap
 group: about
 ---
 
-Bootstrap Table is maintained by the founding team and a small group of invaluable core contributors, with the massive support and involvement of our community.
+Bootstrap Table is maintained by the founding team and a small group of invaluable core contributors, with our community's massive support and involvement.
 
 <div class="list-group mb-3">
   {% for member in site.data.core-team %}

+ 17 - 17
site/docs/api/column-options.md

@@ -30,7 +30,7 @@ The column options is defined in `jQuery.fn.bootstrapTable.columnDefaults`.
 
 - **Detail:**
 
-  Set `false` to hide the columns item in card view state.
+  Set `false` to hide the columns item in the card view state.
 
 - **Default:** `true`
 
@@ -65,10 +65,10 @@ The column options is defined in `jQuery.fn.bootstrapTable.columnDefaults`.
 
 - **Detail:**
 
-  Set `true` to show a checkbox. The checkbox column has fixed width.
+  Set `true` to show a checkbox. The checkbox column has a fixed width.
 
-  If a value is given the Checkbox is automatically checked.
-  Its also possible to check/uncheck the checkbox by use an formatter (return `true` to check, return `false` to uncheck).
+  If a value is given, the checkbox is automatically checked.
+  Its also possible to check/uncheck the checkbox by using a formatter (return `true` to check, return `false` to uncheck).
 
 - **Default:** `false`
 
@@ -82,7 +82,7 @@ The column options is defined in `jQuery.fn.bootstrapTable.columnDefaults`.
 
 - **Detail:**
 
-  Set `false` to disable the the checkboxes/radioboxes.
+  Set `false` to disable the checkboxes/radio boxes.
 
 - **Default:** `true`
 
@@ -110,7 +110,7 @@ The column options is defined in `jQuery.fn.bootstrapTable.columnDefaults`.
 
 - **Detail:**
 
-  Set `true` to select checkbox or radiobox when clicking rows.
+  Set `true` to select the checkbox or radio box when clicking rows.
 
 - **Default:** `true`
 
@@ -138,7 +138,7 @@ The column options is defined in `jQuery.fn.bootstrapTable.columnDefaults`.
 
 - **Detail:**
 
-  Format your detail view when `detailView` and `detailViewByClick` 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.
+  Format your detail view when `detailView` and `detailViewByClick` 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.
 
   Fallback is the detail-formatter of the table.
 
@@ -168,7 +168,7 @@ The column options is defined in `jQuery.fn.bootstrapTable.columnDefaults`.
 
 - **Detail:**
 
-  The cell events listener when you use formatter function, take four parameters:
+  The cell events listener, when you use formatter function, take four parameters:
 
   * `event`: the jQuery event.
   * `value`: the field value.
@@ -230,9 +230,9 @@ The column options is defined in `jQuery.fn.bootstrapTable.columnDefaults`.
   * `data`: Array of all the data rows.
   * `value`: If footer data is set, the value of the footer column.
 
-  the function should return a string with the text to show in the footer cell.
+  The function should return a string with the text to show in the footer cell.
 
-  If you fetch data from a server and tries to set the footer value from the server response, please use the `footerField` Option.
+  If you fetch data from a server and set the footer value from the server response, please use the `footerField` Option.
 
 - **Default:** `undefined`
 
@@ -295,10 +295,10 @@ The column options is defined in `jQuery.fn.bootstrapTable.columnDefaults`.
 
 - **Detail:**
 
-  Set `true` to show a radio. The radio column has fixed width.
+  Set `true` to show a radio. The radio column has a fixed width.
 
-  If a value is given the Checkbox is automatically checked.
-  Its also possible to check/uncheck the radio by use an formatter (return `true` to check, return `false` to uncheck).
+  If a value is given, the checkbox is automatically checked.
+  Its also possible to check/uncheck the radio by using a formatter (return `true` to check, return `false` to uncheck).
 
 - **Default:** `false`
 
@@ -340,7 +340,7 @@ The column options is defined in `jQuery.fn.bootstrapTable.columnDefaults`.
 
 - **Detail:**
 
-  Set `true` to search use formatted data.
+  Set `true` to search using formatted data.
 
 - **Default:** `true`
 
@@ -396,7 +396,7 @@ The column options is defined in `jQuery.fn.bootstrapTable.columnDefaults`.
 
 - **Detail:**
 
-  The custom field sort function that used to do local sorting, take four parameters:
+  The custom field sort function that is used to do local sorting, take four parameters:
 
   * `fieldA`: the first field value.
   * `fieldB`: the second field value.
@@ -459,7 +459,7 @@ The column options is defined in `jQuery.fn.bootstrapTable.columnDefaults`.
 
 - **Detail:**
 
-  The column title tooltip text. This option also support the title HTML attribute.
+  The column title tooltip text. This option also supports the title HTML attribute.
 
 - **Default:** `undefined`
 
@@ -502,7 +502,7 @@ The column options is defined in `jQuery.fn.bootstrapTable.columnDefaults`.
 
 - **Detail:**
 
-  The width of column. If not defined, the width will auto expand to fit its contents. Though if the table is left responsive and sized too small this `'width'` might be ignored (use min/max-width via class or such then). The default used Unit is 'px', use `widthUnit` to change it!
+  The width of the column. If not defined, the width will auto expand to fit its contents. Though if the table is left responsive and sized too small, this `'width'` might be ignored (use min/max-width via class or such then). The default used unit is 'px'. Use `widthUnit` to change it!
 
 - **Default:** `undefined`
 

+ 36 - 36
site/docs/api/events.md

@@ -6,13 +6,13 @@ group: api
 toc: true
 ---
 
-Events can be binded in two ways:
+Events can be bound in two ways:
 - via the option object
 - via jquery event handler
 
-Binding via the option object:
+Binding via the options object:
 {% highlight html %}
-// Here you can expect to have as last parameter the boostrap-table object
+// Here, you can expect to have as the last parameter the boostrap-table object
 
 $('#table').bootstrapTable({
   onEventName: function (arg1, arg2, ...) {
@@ -23,14 +23,14 @@ $('#table').bootstrapTable({
 
 Binding via the jquery event handler:
 {% highlight html %}
-// Here you can expect to have in the 'e' variable the sender property which is the boostrap-table object
+// Here, you can expect to have in the 'e' variable the sender property, which is the boostrap-table object
 
 $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
   // ...
 })
 {% endhighlight %}
 
-*Hint: if you use the jquery event handler, make sure to bind the event listener before the event was executed!*
+*Hint: if you use the jquery event handler, make sure to bind the event listener before the event is executed!*
 
 ## onAll
 
@@ -40,7 +40,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when all events trigger, the parameters contain:
+  It fires when all events trigger. The parameters contain:
 
   * `name`: the event name,
   * `args`: the event data.
@@ -53,7 +53,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when user check a row, the parameters contain:
+  It fires when the user checks a row. The parameters contain:
 
   * `row`: the record corresponding to the clicked row.
   * `$element`: the DOM element checked.
@@ -66,7 +66,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when user check all rows, the parameters contain:
+  It fires when the user checks all rows. The parameters contain:
 
   * `rowsAfter`: array of records of the now checked rows.
   * `rowsBefore`: array of records of the checked rows before.
@@ -79,7 +79,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when user check some rows, the parameters contain:
+  It fires when the user checks some rows. The parameters contain:
 
   * `rows`: array of records corresponding to newly checked rows.
 
@@ -91,7 +91,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when user click a cell, the parameters contain:
+  It fires when the user clicks a cell. The parameters contain:
 
   * `field`: the field name corresponding to the clicked cell.
   * `value`: the data value corresponding to the clicked cell.
@@ -106,7 +106,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when user click a row, the parameters contain:
+  It fires when the user clicks a row. The parameters contain:
 
   * `row`: the record corresponding to the clicked row.
   * `$element`: the tr element.
@@ -120,7 +120,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when click the detail icon to collapse the detail view, the parameters contain:
+  It fires when you click the detail icon to collapse the detail view. The parameters contain:
 
   * `index`: the index of the collapsed row.
   * `row`: the record corresponding to the collapsed row.
@@ -134,7 +134,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when switch the column visible ([showColumns](/docs/api/table-options/#showcolumns)), the parameters contain:
+  It fires when switch the column visible ([showColumns](/docs/api/table-options/#showcolumns)). The parameters contain:
 
   * `field`: the field name corresponding to the switch column.
   * `checked`: the checked state of the column.
@@ -147,7 +147,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when user double click a cell, the parameters contain:
+  It fires when the user double click a cell. The parameters contain:
 
   * `field`: the field name corresponding to the clicked cell.
   * `value`: the data value corresponding to the clicked cell.
@@ -162,7 +162,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when user double click a row, the parameters contain:
+  It fires when the user doubles click a row. The parameters contain:
 
   * `row`: the record corresponding to the clicked row.
   * `$element`: the tr element.
@@ -176,11 +176,11 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when click the detail icon to expand the detail view, the parameters contain:
+  It fires when you click the detail icon to expand the detail view. The parameters contain:
 
   * `index`: the index of the expanded row.
   * `row`: the record corresponding to the expanded row.
-  * `$detail`: the DOM element of the detail `div` after current `tr` element, you can use jQuery methods to custom the detail views.
+  * `$detail`: the DOM element of the detail `div` after the current `tr` element, you can use jQuery methods to custom the detail views.
 
 ## onLoadError
 
@@ -190,7 +190,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when some errors occur to load remote data, the parameters contain:
+  It fires when some errors occur to load remote data. The parameters contain:
 
   * `status`: the status code of `jqXHR`.
   * `jqXHR`: jqXHR object, which is a super set of the XMLHTTPRequest object. For more information, see the [jqXHR Type](http://api.jquery.com/Types/#jqXHR).
@@ -203,7 +203,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when remote data is loaded successfully, the parameters contain:
+  It fires when remote data is loaded successfully. The parameters contain:
 
   * `data`: the remote data.
   * `status`: the status code of `jqXHR`.
@@ -217,7 +217,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when change the page number or page size, the parameters contain:
+  It fires when changing the page number or page size. The parameters contain:
 
   * `number`: the page number.
   * `size`: the page size.
@@ -230,7 +230,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires after the table body is rendered and available in the DOM, the parameters contain:
+  It fires after the table body are rendered and available in the DOM. The parameters contain:
 
   * `data`: the rendered data.
 
@@ -242,7 +242,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires after the footer is rendered and available in the DOM, the parameters contain:
+  It fires after the footer are rendered and available in the DOM. The parameters contain:
 
   * `$tableFooter`: the DOM element of the footer.
 
@@ -254,7 +254,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires after the table header is rendered and available in the DOM.
+  It fires after the table header is rendered and available in the DOM.
 
 ## onPreBody
 
@@ -264,7 +264,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires before the table body is rendered, the parameters contain:
+  It fires before the table body are rendered. The parameters contain:
 
   * `data`: the rendered data.
 
@@ -276,7 +276,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires after the click the refresh button, the parameters contain:
+  It fires after the click of the refresh button. The parameters contain:
 
   * `params`: the additional parameters request to the server.
 
@@ -288,7 +288,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires after refresh the options and before destroy and init the table, the parameters contain:
+  It fires after refreshing the options, and before destroying and init the table. The parameters contain:
 
   * `options`: the table options object.
 
@@ -300,7 +300,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when reset view of the table.
+  It fires when resetting the view of the table.
 
 ## onScrollBody
 
@@ -310,7 +310,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when table body scroll.
+  It fires when the table body scroll.
 ## onSearch
 
 - **jQuery Event:** `search.bs.table`
@@ -319,7 +319,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when search the table, the parameters contain:
+  It fires when searching the table. The parameters contain:
 
   * `text`: the text of the search input.
 
@@ -331,7 +331,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when user sort a column, the parameters contain:
+  It fires when the user sort a column. The parameters contain:
 
   * `name`: the sort column field name.
   * `order`: the sort column order.
@@ -344,7 +344,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when toggle the view of table, the parameters contain:
+  It fires when toggling the view of the table. The parameters contain:
 
   * `cardView`: the cardView state of the table.
 
@@ -356,7 +356,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when the pagination was toggled:
+  It fires when the pagination is toggled:
 
   * `state`: the new pagination state (`true`-> Pagination is enabled, `false` -> Pagination is disabled )
 
@@ -368,7 +368,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when user uncheck a row, the parameters contain:
+  It fires when the user unchecks a row. The parameters contain:
 
   * `row`: the record corresponding to the clicked row.
   * `$element`: the DOM element unchecked.
@@ -381,7 +381,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when user uncheck all rows, the parameters contain:
+  It fires when the user unchecks all rows. The parameters contain:
 
   * `rowsAfter`: array of records of the now checked rows.
   * `rowsBefore`: array of records of the checked rows before.
@@ -394,7 +394,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when user uncheck some rows, the parameters contain:
+  It fires when the user unchecks some rows. The parameters contain:
 
   * `rows`: array of records corresponding to previously checked rows.
 
@@ -406,7 +406,7 @@ $('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
 
 - **Detail:**
 
-  Fires when user scroll the virtual scroll, the parameters contain:
+  It fires when the user scrolls the virtual scroll. The parameters contain:
 
   * `startIndex`: the start row index of the virtual scroll.
   * `endIndex`: the end row index of the virtual scroll.

+ 1 - 2
site/docs/api/localizations.md

@@ -45,7 +45,7 @@ $('#table').bootstrapTable({
 })
 {% endhighlight %}
 
-List of all existing translations with their short codes is on [Github](https://github.com/wenzhixin/bootstrap-table/tree/develop/src/locale)
+List of all existing translations with their shortcodes is on [Github](https://github.com/wenzhixin/bootstrap-table/tree/develop/src/locale)
 
 You can custom the format localizations, the calling syntax:
 
@@ -181,4 +181,3 @@ $('#table').bootstrapTable({
 - **Parameter:** `undefined`
 
 - **Default:** `'Show card view'`
-

+ 41 - 41
site/docs/api/methods.md

@@ -14,7 +14,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Append the `data` to table.
+  Append the `data` to the table.
 
 - **Example:** [Append](https://examples.bootstrap-table.com/#methods/append.html)
 
@@ -24,7 +24,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Check a row, the row `index` start with 0.
+  Check a row. The row `index` starts with 0.
 
 - **Example:** [Check/Uncheck](https://examples.bootstrap-table.com/#methods/check-uncheck.html)
 
@@ -44,11 +44,11 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Check a row by array of values, the params contain:
+  Check a row by an array of values, the params contain:
 
   * `field`: name of the field used to find records.
   * `values`: array of values for rows to check.
-  * `onlyCurrentPage (default false)`: If `true` only the visible dataset will be checked. If pagination is used the other pages will be ignored.
+  * `onlyCurrentPage (default false)`: If `true`, only the visible dataset will be checked. If pagination is used, the other pages will be ignored.
 
 - **Example:** [Check/Uncheck By](https://examples.bootstrap-table.com/#methods/check-uncheck-by.html)
 
@@ -78,7 +78,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Collapse the row that has the `index` passed by parameter if the detail view option is set to `true`.
+  Collapse the row with the `index` passed by parameter if the detail view option is set to `true`.
 
 - **Example:** [Expand/Collapse Row](https://examples.bootstrap-table.com/#methods/expand-collapse-row.html)
 
@@ -88,7 +88,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Collapse the row that has the `uniqueId` passed by parameter if the detail view option is set to `true`.
+  Collapse the row with the `uniqueId` passed by parameter if the detail view option is set to `true`.
 
 - **Example:** [Expand/Collapse Row by uniqueId](https://examples.bootstrap-table.com/#methods/expand-collapse-row-by-uniqueid.html)
 
@@ -128,7 +128,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Expand the row that has the `uniqueId` passed by parameter if the detail view option is set to `true`.
+  Expand the row with the `uniqueId` passed by parameter if the detail view option is set to `true`.
 
 - **Example:** [Expand/Collapse Row by uniqueId](https://examples.bootstrap-table.com/#methods/expand-collapse-row-by-uniqueid.html)
 
@@ -147,7 +147,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  (Can use only in client-side) Filter data in table.
+  (Can used only in client-side) Filter data in the table.
   There are multiple ways to filter:
   - Leave the options blank to use the `and` filter.
   - Set the `filterAlgorithm` (see at parameter) to `or` to use the `or` filter.
@@ -174,11 +174,11 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Get the loaded data of table at the moment that this method is called
+  Get the loaded data of the table at the moment that this method is called
 
-  * `useCurrentPage`: if set to true the method will return the data only in the current page.
-  * `includeHiddenRows`: if set to true the method will include the hidden rows.
-  * `unfiltered`: if set to true the method will include all data (unfiltered).
+  * `useCurrentPage`: if set to true, the method will return the data only on the current page.
+  * `includeHiddenRows`: if set to true, the method will include the hidden rows.
+  * `unfiltered`: if set to true, the method will include all data (unfiltered).
   * `formatted`: get the formatted value from the defined [formatter](https://bootstrap-table.com/docs/api/column-options/#formatter).
 
 - **Example:** [Get Data](https://examples.bootstrap-table.com/#methods/get-data.html)
@@ -199,7 +199,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Get all rows hidden and if you pass the `show` parameter `true` the rows will be shown again, otherwise, the method only will return the rows hidden.
+  Get all rows hidden, and if you pass the `show` parameter `true`, the rows will be shown again. Otherwise, the method only will return the rows hidden.
 
 - **Example:** [Get Hidden Rows](https://examples.bootstrap-table.com/#methods/get-hidden-rows.html)
 
@@ -219,7 +219,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Get data from table, the row that contains the `id` passed by parameter.
+  Get data from the table, the row that contains the `id` passed by parameter.
 
 - **Example:** [Get Row By Unique Id](https://examples.bootstrap-table.com/#methods/get-row-by-unique-id.html)
 
@@ -229,7 +229,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Get the current scroll position, the unit is `'px'`.
+  Get the current scroll position. The unit is `'px'`.
 
 - **Example:** [Get Scroll Position](https://examples.bootstrap-table.com/#methods/get-scroll-position.html)
 
@@ -239,8 +239,8 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Return selected rows, when no record selected, an empty array will return.
-  The selected rows will be unselected while some actions happens e.g. searching or page change, if you want to maintain the selections please use [maintainMetaData](https://bootstrap-table.com/docs/api/table-options/#maintainmetadata). 
+  Return selected rows. When no record is selected, an empty array will return.
+  The selected rows will be unselected while some actions, e.g., searching or page change. If you want to maintain the selections, please use [maintainMetaData](https://bootstrap-table.com/docs/api/table-options/#maintainmetadata).
 
 - **Example:** [Get Selections](https://examples.bootstrap-table.com/#methods/get-selections.html)
 
@@ -271,7 +271,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 - **Detail:**
 
   Hide the specified `field` column.
-  The parameter can be a string or a array of fields.
+  The parameter can be a string or an array of fields.
 
 - **Example:** [Show/Hide Column](https://examples.bootstrap-table.com/#methods/show-hide-column.html)
 
@@ -304,7 +304,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Insert a new row, the params contain following properties:
+  Insert a new row. The params contain the following properties:
 
   * `index`: the row index to insert into.
   * `row`: the row data.
@@ -317,7 +317,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Load the `data` to table, the old rows will be removed.
+  Load the `data` to the table. The old rows will be removed.
 
 - **Example:** [Load](https://examples.bootstrap-table.com/#methods/load.html)
 
@@ -327,7 +327,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Merge some cells to one cell, the params contain following properties:
+  Merge some cells into one cell. The params contain the following properties:
 
   * `index`: the row index.
   * `field`: the field name.
@@ -342,7 +342,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Go to next page.
+  Go to the next page.
 
 - **Example:** [Select/Prev/Next Page](https://examples.bootstrap-table.com/#methods/select-prev-next-page.html)
 
@@ -352,7 +352,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Prepend the `data` to table.
+  Prepend the `data` to the table.
 
 - **Example:** [Prepend](https://examples.bootstrap-table.com/#methods/prepend.html)
 
@@ -362,7 +362,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Go to previous page.
+  Go to the previous page.
 
 - **Example:** [Select/Prev/Next Page](https://examples.bootstrap-table.com/#methods/select-prev-next-page.html)
 
@@ -392,10 +392,10 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Remove data from table, the params contain two properties:
+  Remove data from the table. The params contain two properties:
 
   * `field`: the field name of remove rows. If `$index` is not in your fields, you can use this special field `$index` to remove rows by row index.
-  * `values`: the array of values for rows which should be removed. If you use the special field `$index`, you can pass an array of indexes.
+  * `values`: the array of values for rows that should be removed. If you use the special field `$index`, you can pass an array of indexes.
 
 - **Example:** [Remove](https://examples.bootstrap-table.com/#methods/remove.html)
 
@@ -405,7 +405,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Remove all data from table.
+  Remove all data from the table.
 
 - **Example:** [Remove All](https://examples.bootstrap-table.com/#methods/remove-all.html)
 
@@ -415,7 +415,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Remove data from table, the row that contains the `id` passed by parameter.
+  Remove data from the table, the row that contains the `id` passed by parameter.
 
 - **Example:** [Remove By Unique Id](https://examples.bootstrap-table.com/#methods/remove-by-unique-id.html)
 
@@ -435,7 +435,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Reset the Bootstrap Table view, for example reset the table height, the params contain:
+  Reset the Bootstrap Table view. For example, reset the table height, the params contain:
 
   * `height`: the height of the table.
 
@@ -461,7 +461,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Go to the a specified `page`.
+  Go to the specified `page`.
 
 - **Example:** [Select/Prev/Next Page](https://examples.bootstrap-table.com/#methods/select-prev-next-page.html)
 
@@ -482,7 +482,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 - **Detail:**
 
   Show the specified `field` column.
-  The parameter can be a string or a array of fields.
+  The parameter can be a string or an array of fields.
 
 - **Example:** [Show/Hide Column](https://examples.bootstrap-table.com/#methods/show-hide-column.html)
 
@@ -555,7 +555,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Uncheck a row, the row `index` start with 0.
+  Uncheck a row. The row `index` starts with 0.
 
 - **Example:** [Check/Uncheck](https://examples.bootstrap-table.com/#methods/check-uncheck.html)
 
@@ -575,11 +575,11 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Uncheck a row by array of values, the params contain:
+  Uncheck a row by an array of values. The params contain:
 
   * `field`: name of the field used to find records.
   * `values`: array of values for rows to uncheck.
-  * `onlyCurrentPage (default false)`: If `true` only the visible dataset will be unchecked. If pagination is used the other pages will be ignored.
+  * `onlyCurrentPage (default false)`: If `true`, only the visible dataset will be unchecked. If pagination is used, the other pages will be ignored.
 
 - **Example:** [Check/Uncheck By](https://examples.bootstrap-table.com/#methods/check-uncheck-by.html)
 
@@ -589,7 +589,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Update the specified row(s), each params contain following properties:
+  Update the specified row(s). Each param contains the following properties:
 
   * `id`: a row id where the id should be the `uniqueId` field assigned to the table.
   * `row`: the new row data.
@@ -603,13 +603,13 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Update one cell, the params contain following properties:
+  Update one cell. The params contain the following properties:
 
   * `index`: the row index.
   * `field`: the field name.
   * `value`: the new field value.
 
-  To disable table re-initialization you can set `{reinit: false}`.
+  To disable table re-initialization, you can set `{reinit: false}`.
 
 - **Example:** [Update Cell](https://examples.bootstrap-table.com/#methods/update-cell.html)
 
@@ -619,11 +619,11 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Update the specified cell(s), each params contain following properties:
+  Update the specified cell(s). Each param contains the following properties:
 
   * `id`: row id where the id should be the `uniqueId` field assigned to the table.
   * `field`: field name of the cell to be updated.
-  * `value`: new value of the cell.
+  * `value`: the new value of the cell.
 
 - **Example:** [Update Cell By Unique Id](https://examples.bootstrap-table.com/#methods/update-cell-by-unique-id.html)
 
@@ -633,7 +633,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Update the field title of column, the params contain following properties:
+  Update the field title of the column. The params contain the following properties:
 
   * `field`: the field name.
   * `title`: the field title.
@@ -655,7 +655,7 @@ The calling method syntax: `$('#table').bootstrapTable('method', parameter)`.
 
 - **Detail:**
 
-  Update the specified row(s), each params contain following properties:
+  Update the specified row(s). Each param contains the following properties:
 
   * `index`: the row index to be updated.
   * `row`: the new row data.

+ 81 - 81
site/docs/api/table-options.md

@@ -63,9 +63,9 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **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](https://bootstrap-table.com/docs/api/table-options/#buttonsorder), the used key/name for the event should be used for that!
-  
+  This option allows creating/adding custom button(s) to the "buttons bar" (top right of the table).
+  These buttons can be sorted with the table option [buttonsOrder](https://bootstrap-table.com/docs/api/table-options/#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](https://bootstrap-table.com/docs/api/table-options/#showbuttontext) table option.
@@ -74,32 +74,32 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
     - Description: This option is used for the [showButtonIcons](https://bootstrap-table.com/docs/api/table-options/#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"`.    
+    - 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"`.   
+    - Description: If you don't want to autogenerate the html, you can use this option to insert your custom html.
+      The `event` option only works if you custom HTML contains `name="BUTTONNAME"`.
       If this option is used the following options will be ignored:
       - `text`
       - `icon`
-      - `attributes`   
+      - `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:  
+   The `event` option can be configured in three ways.
+   One event with `click` event:
    ```javascript
    {
      'event': () => { }
    }
    ```
-  
-  One event with a self defined event type:   
+
+  One event with a self-defined event type:
   ```javascript
      {
        'event': {
@@ -107,8 +107,8 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
        }
      }
   ```
-  
-  Multiple events with self defined event types:   
+
+  Multiple events with self-defined event types:
     ```javascript
        {
          'event': {
@@ -118,11 +118,11 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
          }
        }
     ```
-  
-  **Hint:** Instead of inline functions you also can use function names.
-  
+
+  **Hint:** Instead of inline functions, you also can use function names.
+
   A configured custom button could look like this:
-  ``` javascript 
+  ``` javascript
   {
     btnRemoveEvenRows: {
       'text': 'Remove even Rows',
@@ -177,7 +177,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Indicate how to custom order of the toolbar buttons.
+  Indicate how to custom order the toolbar buttons.
 
 - **Default:** `['paginationSwitch', 'refresh', 'toggle', 'fullscreen', 'columns']`
 
@@ -233,7 +233,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Set `true` to show card view table, for example mobile view.
+  Set `true` to show card view table, for example, mobile view.
 
 - **Default:** `false`
 
@@ -247,7 +247,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Set `false` to hide check-all checkbox in header row.
+  Set `false` to hide the check-all checkbox in the header row.
 
 - **Default:** `true`
 
@@ -275,7 +275,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Set `true` to select checkbox or radiobox when clicking rows.
+  Set `true` to select the checkbox or radio box when clicking rows.
 
 - **Default:** `false`
 
@@ -289,7 +289,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  The table columns config object, see column properties for more details.
+  The table columns config object. See column properties for more details.
 
 - **Default:** `[]`
 
@@ -317,7 +317,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  The custom search function is executed instead of built-in search function, takes three parameters:
+  The custom search function is executed instead of the built-in search function, takes three parameters:
 
   * `data`: the table data.
   * `text`: the search text.
@@ -382,7 +382,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
     ]
   })
   ```
-  If use this feature, the `data` is required to ensure that the format is correct.
+  If using this feature, the `data` is required to ensure that the format is correct.
 
 - **Default:** `[]`
 
@@ -396,7 +396,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Key in incoming json containing `'rows'` data list.
+  Key in incoming JSON containing `'rows'` data list.
 
 - **Default:** `'rows'`
 
@@ -424,7 +424,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **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.
+  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 allow expansion for all rows.
 
 - **Default:** `function(index, row) { return true }`
 
@@ -438,7 +438,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **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.
+  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 '' }`
 
@@ -452,7 +452,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Set `true` to show detail view table.
+  Set `true` to show a detailed view table.
 
 - **Default:** `false`
 
@@ -480,7 +480,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Set `true` to toggle the detail view, when a cell is clicked.
+  Set `true` to toggle the detail view when a cell is clicked.
 
 - **Default:** `false`
 
@@ -522,7 +522,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **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.
+  Define the default filter options of the algorithm, `filterAlgorithm: 'and'` means all given filters must match, `filterAlgorithm: 'or'` means one of the given filters must match.
 
 - **Default:** `{ filterAlgorithm: 'and' }`
 
@@ -536,7 +536,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Defines the key of the footer Object (From data array or server response json).
+  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`.
 
@@ -625,7 +625,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  The height of table, enable fixed header of table.
+  The height of the table, enables a fixed header of the table.
 
 - **Default:** `undefined`
 
@@ -681,7 +681,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Defines icon set name (`'glyphicon'` or `'fa'` for FontAwesome). By default `'fa'` is used for Bootstrap v4.
+  Defines icon set name (`'glyphicon'` or `'fa'` for FontAwesome). By default, `'fa'` is used for Bootstrap v4.
 
 - **Default:** `'fa'`
 
@@ -726,7 +726,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **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.
+  To define the font size of the loading text, the default value is `'auto'`, calculated automatically according to the table width, between 12px and 32px.
 
 - **Default:** `'auto'`
 
@@ -770,7 +770,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
   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 locale with '_' translated to '-' and the region code uppercased,
   * 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).
 
@@ -788,7 +788,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Set `true` to maintain the following meta data on change page and search:
+  Set `true` to maintain the following metadata on the change page and search:
    * selected rows
    * hidden rows
 
@@ -818,7 +818,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  The minimum number of columns to hide from the columns drop down list.
+  The minimum number of columns to hide from the columns dropdown list.
 
 - **Default:** `1`
 
@@ -832,7 +832,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **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.
+  Set `true` to enable the multiple selection row. Can use the ctrl+click to select one row or shift+click to select a range of rows.
 
 - **Default:** `false`
 
@@ -846,9 +846,9 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **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.
+  When setting the pagination property, initialize the page size by selecting the 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](https://bootstrap-table.com/docs/api/table-options/#smartdisplay) to `false`*
+  *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](https://bootstrap-table.com/docs/api/table-options/#smartdisplay) to `false`*
 
 - **Default:** `[10, 25, 50, 100]`
 
@@ -862,7 +862,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  When set pagination property, initialize the page number.
+  When setting the pagination property, initialize the page number.
 
 - **Default:** `1`
 
@@ -876,7 +876,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  When set pagination property, initialize the page size.
+  When setting the pagination property, initialize the page size.
 
 - **Default:** `10`
 
@@ -890,7 +890,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Set `true` to show a pagination toolbar on table bottom.
+  Set `true` to show a pagination toolbar on the table bottom.
 
 - **Default:** `false`
 
@@ -976,7 +976,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
   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`).
+  * `pageInfoShort` Similar to `pageInfo`, it only displays how many 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).
 
@@ -992,7 +992,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Indicate the icon or text to be shown in the pagination detail, the previous button.
+  Indicate the icon or text shown in the pagination detail, the previous button.
 
 - **Default:** `'‹'`
 
@@ -1034,7 +1034,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Indicate how to vertical align the pagination. `'top'`, `'bottom'`, `'both'` (put the pagination on top and bottom)  can be used.
+  Indicate how to vertical-align the pagination. `'top'`, `'bottom'`, `'both'` (put the pagination on top and bottom)  can be used.
 
 - **Default:** `'bottom'`
 
@@ -1083,8 +1083,8 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 - **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`.
+  If this option is enabled, you can search with regex, e.g. `[47a]$` for all items which end 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`
@@ -1113,7 +1113,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Before load remote data, handler the response data format, the parameters object contains:
+  Before loading remote data, handle 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](http://api.jquery.com/Types/#jqXHR).
@@ -1170,7 +1170,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
   Enable the search input.
 
-  There are 3 ways to search:
+  There are three ways to search:
   - The value contains the search query (Default).
     Example: Github contains git.
   - The value must be identical to the search query.
@@ -1179,7 +1179,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
     Example: 4 is larger than 3.
 
   Notes:
-  - If you want to use a custom search input use the [searchSelector](https://bootstrap-table.com/docs/api/table-options/#searchSelector).
+  - If you want to use a custom search input, use the [searchSelector](https://bootstrap-table.com/docs/api/table-options/#searchSelector).
   - You can also search via regex using the [regexSearch](https://bootstrap-table.com/docs/api/table-options/#regexSearch) option.
 
 - **Default:** `false`
@@ -1194,7 +1194,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Set to `true` if you want to use accent neutralise feature.
+  Set to `true` if you want to use the accent neutralize feature.
 
 - **Default:** `false`
 
@@ -1222,8 +1222,8 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Set to `true` to highlight the searched text (using the `<mark>` html tag).
-  You can also define a [custom highlight formatter](https://bootstrap-table.com/docs/api/column-options/#searchhighlightformatter) e.g. for values with html or to use a custom highlight color.
+  Set to `true` to highlight the searched text (using the `<mark>` HTML tag).
+  You can also define a [custom highlight formatter](https://bootstrap-table.com/docs/api/column-options/#searchhighlightformatter), e.g., for values with HTML or to use a custom highlight color.
 
 - **Default:** `'false'`
 
@@ -1251,7 +1251,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **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.
+  If this option is set (must be a valid dom selector, e.g. `#customSearch`), the found dom element (an `input` element) will be used as table search instead of the built-in search input.
 
 - **Default:** `false`
 
@@ -1265,7 +1265,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  When set search property, initialize the search text.
+  When setting search property, initialize the search text.
 
 - **Default:** `''`
 
@@ -1293,7 +1293,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  The name of radio or checkbox input.
+  The name of the radio or checkbox input.
 
 - **Default:** `'btSelectItem'`
 
@@ -1307,7 +1307,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Set `false` to sort the data in the client side, only works when the `sidePagination` is `server`.
+  Set `false` to sort the data on the client-side, only works when the `sidePagination` is `server`.
 
 - **Default:** `true`
 
@@ -1321,7 +1321,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  All buttons will show icons on it
+  All buttons will show icons on them.
 
 - **Default:** `true`
 
@@ -1335,7 +1335,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  All buttons will show an text on it
+  All buttons will show text on them.
 
 - **Default:** `false`
 
@@ -1363,7 +1363,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Set `true` to show a search for the columns filter.
+  Set `true` to show a search for the column's filter.
 
 - **Default:** `false`
 
@@ -1391,8 +1391,8 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **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.
+  Set `true` to show an extended version of pagination (including the count of all rows without filters).
+  If you use pagination on the server side, please use `totalNotFilteredField` to define the count.
 
 - **Default:** `false`
 
@@ -1477,7 +1477,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 - **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).
+  The Search will only be executed if the button is pressed (e.g., to prevent traffic or loading time).
 
 - **Default:** `false`
 
@@ -1491,7 +1491,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **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)).
+  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`
 
@@ -1505,7 +1505,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Set `true` to show the toggle button to toggle table / card view.
+  Set `true` to show the toggle button to toggle table/card view.
 
 - **Default:** `false`
 
@@ -1520,7 +1520,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 - **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.
+  Using the `'server'` side requires 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:
 
@@ -1553,7 +1553,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Set `true` to allow checkbox selecting only one row.
+  Set `true` to allow a checkbox selecting only one row.
 
 - **Default:** `false`
 
@@ -1595,7 +1595,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  The class name of the `td` elements which are sorted.
+  The class name of the `td` elements are sorted.
 
 - **Default:** `undefined`
 
@@ -1637,7 +1637,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Set `true` to reset the sort on third click.
+  Set `true` to reset the sort on the third click.
 
 - **Default:** `false`
 
@@ -1680,7 +1680,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  The class name of table thead. Bootstrap v4, use the modifier classes `.thead-light` or `.thead-dark` to make `thead`s appear light or dark gray.
+  The class name of table thead. Bootstrap v4, use the modifier classes `.thead-light` or `.thead-dark` to make `thead` appear light or dark gray.
 
 - **Default:** `''`
 
@@ -1722,7 +1722,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Key in incoming json containing `'total'` data.
+  Key in incoming JSON containing `'total'` data.
 
 - **Default:** `'total'`
 
@@ -1736,7 +1736,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  This property is mainly passed in by pagination server, which is easy to use.
+  This property is mainly passed in by the pagination server, which is easy to use.
 
 - **Default:** `0`
 
@@ -1748,7 +1748,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  The field from the json response which will used for `showExtendedPagination`.
+  The field from the JSON response will be used for `showExtendedPagination`.
 
 - **Default:** `totalNotFiltered`
 
@@ -1762,7 +1762,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  This property is mainly passed in by pagination server, which is easy to use.
+  This property is mainly passed in by the pagination server, which is easy to use.
 
 - **Default:** `0`
 
@@ -1774,7 +1774,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Set `true` to trim spaces in search field.
+  Set `true` to trim spaces in the search field.
 
 - **Default:** `true`
 
@@ -1802,7 +1802,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Indicate an unique identifier for each row.
+  Indicate a unique identifier for each row.
 
 - **Default:** `undefined`
 
@@ -1839,7 +1839,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  Set `true` to enable virtual scroll to displays a virtual, "infinite" list.
+  Set `true` to enable virtual scroll to display a virtual, "infinite" list.
 
 - **Default:** `false`
 
@@ -1853,9 +1853,9 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **Detail:**
 
-  If this option is not define, we will use the height of the first item by default.
+  If this option is not defined, 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.
+  It is **important** to provide this if the virtual item height is 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`
 
@@ -1867,7 +1867,7 @@ The table options are defined in `jQuery.fn.bootstrapTable.defaults`.
 
 - **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.
+  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`
 

+ 2 - 2
site/docs/getting-started/browsers-devices.md

@@ -10,7 +10,7 @@ toc: true
 
 Bootstrap Table supports the **latest, stable releases** of all major browsers and platforms. On Windows, **we support Internet Explorer 10-11 / Microsoft Edge**.
 
-Alternative browsers which use the latest version of WebKit, Blink, or Gecko, whether directly or via the platform's web view API, are not explicitly supported. However, Bootstrap Table should (in most cases) display and function correctly in these browsers as well. More specific support information is provided below.
+Alternative browsers which use the latest version of WebKit, Blink, or Gecko, whether directly or via the platform's web view API, are not explicitly supported. However, Bootstrap Table should (in most cases) display and function correctly in these browsers. More specific support information is provided below.
 
 You can find our supported range of browsers and their versions [in our `.browserslistrc file`]({{ site.repo }}/blob/{{ site.current_version }}/.browserslistrc):
 
@@ -30,4 +30,4 @@ Android >= 4.4
 Opera >= 30
 ```
 
-Because Bootstrap Table is designed for Bootstrap, we will try to be consistent with Bootstrap in browsers and devices compatibility, for more detail, you can checkout the [browsers-devices of Bootstrap](https://getbootstrap.com/docs/4.2/getting-started/browsers-devices/).
+Because Bootstrap Table is designed for Bootstrap, we will try to be consistent with Bootstrap in browsers and devices compatibility. You can check out the [browsers-devices of Bootstrap](https://getbootstrap.com/docs/4.2/getting-started/browsers-devices/) for more detail.

+ 3 - 3
site/docs/getting-started/build-tools.md

@@ -10,11 +10,11 @@ toc: true
 
 Bootstrap Table uses [NPM scripts](https://docs.npmjs.com/misc/scripts) for its build system. Our [package.json]({{ site.repo }}/blob/{{ site.current_version }}/package.json) includes convenient methods for working with the framework, including linting code, compiling code, and more.
 
-To use our build system and run our documentation locally, you'll need a copy of Bootstrap Table's source files and Node. Follow these steps and you should be ready to rock:
+To use our build system and run our documentation locally, you'll need a copy of Bootstrap Table's source files and Node. Follow these steps, and you should be ready to rock:
 
 1. [Download and install Node.js](https://nodejs.org/en/download/), which we use to manage our dependencies.
 2. Navigate to the root `/bootstrap-table` directory and run `npm install` to install our local dependencies listed in [package.json]({{ site.repo }}/blob/{{ site.current_version }}/package.json).
-3. [Install Ruby][install-ruby], install [Bundler][gembundler] with `gem install bundler`, and finally run `bundle install`. This will install all Ruby dependencies, such as Jekyll and plugins.
+3. [Install Ruby][install-ruby], install [Bundler][gembundler] with `gem install bundler`, and finally run `bundle install`. It will install all Ruby dependencies, such as Jekyll and plugins.
   - **Windows users:** Read [this guide](https://jekyllrb.com/docs/windows/) to get Jekyll up and running without problems.
 
 When completed, you'll be able to run the various commands provided from the command line.
@@ -46,4 +46,4 @@ Learn more about using Jekyll by reading its [documentation](https://jekyllrb.co
 
 ## Troubleshooting
 
-Should you encounter problems with installing dependencies, uninstall all previous dependency versions (global and local). Then, rerun `npm install`.
+If you encounter installing dependencies, uninstall all previous dependency versions (global and local). Then, rerun `npm install`.

+ 2 - 2
site/docs/getting-started/contents.md

@@ -1,7 +1,7 @@
 ---
 layout: docs
 title: Contents
-description: The Bootstrap Table source code download includes the pre-compiled CSS, JavaScript, locales, extensions, and provides both compiled and minified variations, along with documentation.
+description: The Bootstrap Table source code download includes the precompiled CSS, JavaScript, locales, extensions and provides both compiled and minified variations, along with documentation.
 group: getting-started
 toc: true
 ---
@@ -37,4 +37,4 @@ bootstrap-table/
     └── bootstrap-table.js
 {% endhighlight %}
 
-The `src/`, `locale/`, and `extensions/` are the source code for our CSS, JS. The `site/` folder includes the source code for our documentation. Beyond that, any other included file provides support for packages, license information, and development.
+The `src/`, `locale/`, and `extensions/` are the source code for our CSS, JS. The `site/` folder includes the source code for our documentation. Beyond that, any other included file supports packages, license information, and development.

+ 4 - 4
site/docs/getting-started/introduction.md

@@ -10,7 +10,7 @@ redirect_from:
 toc: true
 ---
 
-## Quick start
+## Quickstart
 
 Looking to quickly add Bootstrap Table to your <a href="https://getbootstrap.com/" target="_blank">Bootstrap v5</a> project? Use CDN, provided for free by the folks at UNPKG. Using a package manager or need to download the source files? [Head to the downloads page]({{ site.baseurl }}/docs/getting-started/download/).
 
@@ -32,11 +32,11 @@ Place the following `<script>`s near the end of your pages, right before the clo
 
 ## Starter template
 
-Be sure to have your pages set up with the latest design and development standards. That means using an HTML5 doctype and including a viewport meta tag for proper responsive behaviors.
+Be sure to have your pages set up with the latest design and development standards. That means using an HTML5 doctype and a viewport meta tag for proper responsive behaviors.
 
-For Bootstrap v5, we use [Bootstrap Icons](https://icons.getbootstrap.com/) as the default icons, so need to import Bootstrap Icons link.
+For Bootstrap v5, we use [Bootstrap Icons](https://icons.getbootstrap.com/) as the default icons, so we need to import the Bootstrap Icons link.
 
-Put it all together and your pages should look like this:
+Put it all together, and your pages should look like this:
 
 {% highlight html %}
 <!doctype html>