Add documentation for table pagination

Signed-off-by: Yoshie Muranaka <yoshiemuranaka@gmail.com>
Change-Id: Ic40d7b4580417590b2d465fe359198c92354c242

2 files changed, 96 insertions, 1 deletions

diff --git a/docs/guide/components/table/index.md b/docs/guide/components/table/index.md
index 3d13a2b8..cd1ba202 100644
--- a/docs/guide/components/table/index.md
+++ b/docs/guide/components/table/index.md
@@ -506,4 +506,99 @@ export default {
 </script>
 ```
 
-<!-- ## Pagination -->
+
+## Pagination
+
+To add table pagination:
+1. Import the BVPaginationMixin
+1. Add the `per-page` and `current-page` props to the `<table>` component.
+1. Add the below HTML snippet to the template. Make sure to update the `total-rows` prop.
+
+```vue{21}
+<b-row>
+  <b-col sm="6">
+    <b-form-group
+      class="table-pagination-select"
+      :label="$t('global.table.itemsPerPage')"
+      label-for="pagination-items-per-page"
+    >
+      <b-form-select
+        id="pagination-items-per-page"
+        v-model="perPage"
+        :options="itemsPerPageOptions"
+      />
+    </b-form-group>
+  </b-col>
+  <b-col sm="6">
+    <b-pagination
+      v-model="currentPage"
+      first-number
+      last-number
+      :per-page="perPage"
+      :total-rows="getTotalRowCount(items.length)"
+      aria-controls="table-event-logs"
+    />
+  </b-col>
+</b-row>
+```
+![Table pagination example](./table-pagination.png)
+
+```vue
+<template>
+  <b-container>
+    <b-table
+      hover
+      responsive="md"
+      :items="filteredItems"
+      :fields="fields"
+      :per-page="perPage"
+      :current-page="currentPage"
+    />
+    <b-row>
+      <b-col sm="6">
+        <b-form-group
+          class="table-pagination-select"
+          :label="$t('global.table.itemsPerPage')"
+          label-for="pagination-items-per-page"
+        >
+          <b-form-select
+            id="pagination-items-per-page"
+            v-model="perPage"
+            :options="itemsPerPageOptions"
+          />
+        </b-form-group>
+      </b-col>
+      <b-col sm="6">
+        <b-pagination
+          v-model="currentPage"
+          first-number
+          last-number
+          :per-page="perPage"
+          :total-rows="getTotalRowCount(items.length)"
+          aria-controls="table-event-logs"
+        />
+      </b-col>
+    </b-row>
+  </b-container>
+</template>
+<script>
+import BVPaginationMixin, {
+  currentPage,
+  perPage,
+  itemsPerPageOptions
+} from '@/components/Mixins/BVPaginationMixin';
+
+export default {
+  mixins: [ BVPaginationMixin ],
+  data() {
+    return {
+      items: [...],
+      fields: [..],
+      currentPage,
+      perPage,
+      itemsPerPageOptions
+    },
+  }
+}
+</script>
+```
\ No newline at end of file
diff --git a/docs/guide/components/table/table-pagination.png b/docs/guide/components/table/table-pagination.png
new file mode 100644
index 00000000..88134d8f
--- /dev/null
+++ b/docs/guide/components/table/table-pagination.png