vue-bootstrap-pagination
v2.10.3
Published
Pagination for vuejs with combination with bootstrap and Laravel's pagination
Downloads
905
Maintainers
pogacharReadme
vue-pagination
Vue pagination component for use with Bootstrap and Laravel pagination.
- Vue.js (tested with 2.2.1).
- Bootstrap CSS (tested with 3.3.7)
To use with Vue.js 1 use the 1x version.
Laravel is not required as long as the pagination object contains the required attributes
- current_page,
- last_page,
- per_page,
Installation
npm install --save vue-bootstrap-paginationor
yarn add vue-bootstrap-paginationExample
import pagination from 'vue-bootstrap-pagination'
new Vue({
el: '#app',
data() {
return {
items: [],
pagination: {
total: 0,
per_page: 12, // required
current_page: 1, // required
last_page: 0, // required
from: 1,
to: 12
},
paginationOptions: {
offset: 4,
previousText: 'Prev',
nextText: 'Next',
alwaysShowPrevNext: true
}
}
},
methods: {
loadData() {
const options = {
params: {
paginate: this.pagination.per_page,
page: this.pagination.current_page,
/* additional parameters */
}
};
this.$http.get('/getData', options)
.then(response => {
this.items = response.data.data;
// Overwrite pagination object
this.pagination = response.data.pagination; // API response edited to have pagination data under pagination object
// Or overwrite only values
/*
this.pagination.current_page = response.data.current_page;
this.pagination.last_page = response.data.last_page;
...
*/
})
.catch(error => {
// handle error
});
}
},
components: {
pagination
}
})<body id="app">
<ul class="list-group">
<li class="list-group-item" v-for="item in items">{{ item.name }}</li>
</ul>
<pagination :pagination="pagination" :callback="loadData" :options="paginationOptions"></pagination>
</body>Props
| Name | Type | Default | Required | Description | :------------ | :--------| :-------| :--------| :----------- | pagination | Object | | true | Pagination object used to create pagination | callback | Function | | true | Callback function used to load data for selected page | options | Object | | | Configuration. Look below for available options | size | String | | | Change the default size of the pagination. Options: large, small.
Offset prop has ben removed with version 2.10.0. Use options.offset instead
Options
| Name | String | Default | Description | :-------------------| :-------| :-----------| :------- | offset | Number | 3 | Left and right offset of pagination numbers to display | ariaPrevious | String | Previous | Change default aria previous text | ariaNext | String | Next | Change default aria next text | previousText | String | « | Change default previous button text | nextText | String | » | Change default next button text | alwaysShowPrevNext | Boolean | false | Show prev/next button even if on first/last page
If you change this.pagination.per_page the callback function will be called
Contributing
Please see CONTRIBUTING for details.
License
The MIT License (MIT). Please see License File for more information.