Vuetable-2 - data table simplify!
Vuetable-2 works with Vue 2.x, vuetable is for Vue 1.x
If you're looking for the version that's working with Vue 1.x, please go to vuetable
repo.
Documentation and Tutorial
Documentation is still under development, but you can view it at https://ratiw.github.io/vuetable-2. Thanks to @cristijora for the help.
Meanwhile, check out
If you've been using Vuetable for Vue 1.x before, checkout what's changed for info on changes from Vuetable for Vue 1.x and the upgrade guide on how you could upgrade from Vuetable for Vue 1.x.
You can now make use of Vue's scoped slot using the new __slot
special field, thanks to @sjmarve. That means you are able to define action buttons per instance of a data table without depending on a globally defined component.
Use scoped slot in parent when defining the actions Vue Doc for scopped Slots
e.g.
<template slot="actions" scope="props">
<div class="table-button-container">
<button class="btn btn-default" @click="onClick('edit-item', props.rowData)"><i class="fa fa-edit"></i> View</button>
<button class="btn btn-danger" @click="onClick('delete-item', props.rowData)"><i class="fa fa-remove"></i> Edit</button>
</div>
</template>
the onClick function can now be defined in the parent and the parent has Access to rowData and rowIndex via props. :)
The original functionality still works
Breaking Changes
v1.6.0
- The
icons
prop of VuetablePagination is now moved into the css
prop object. See this codepen.
Example Code
- Clone the project
- Go into the cloned directory
npm install
npm run dev
- Open browser to
http://localhost:8080
Usage
NPM
npm install vuetable-2 --save-dev
Javascript via CDN
Thanks to @cristijora for providing helps on this.
// vuetable-2 dependencies
<script src="https://cdnjs.cloudflare.com/ajax/libs/vue/2.2.6/vue.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/axios/0.16.1/axios.min.js"></script>
// vuetable-2
<script src="https://unpkg.com/vuetable-2@1.6.0"></script>
Vue.use(Vuetable)
This is demonstrated in this jsfiddle.
The .use
from above will register all the components globally.
function install(Vue){
Vue.component("vuetable", Vuetable);
Vue.component("vuetable-pagination", VueTablePaginationInfo);
Vue.component("vuetable-pagination-dropdown", VueTablePaginationDropDown);
Vue.component("vuetable-pagination-info", VueTablePaginationInfo);
}
Also you have the ability to access certain components if you need them:
VueTable: VueTable.default/VueTable.VueTable,
VueTablePagination: VueTable.VueTablePagination,
VueTablePaginationInfo: VueTable.VueTablePaginationInfo,
VueTablePaginationDropdown: VueTable.VueTablePaginationDropdown
Contributions
Any contribution to the code (via pull request would be nice) or any part of the documentation and any idea and/or suggestion are very welcome.
Note
For any bug fix, the PR should be forked from the master
branch. And for any suggestion or additional feature, the PR should be forked from the develop
branch, where it can be integrated and rolled out in the next release.
If you are not sure, please ask by openning a new issue.
However, please do not feel bad if your pull requests or contributions do not get merged or implemented into Vuetable.
Your contributions can, not only help make Vuetable better, but also push it away from what I intend to use it for. I just hope that you find it useful for your use or learn something useful from its source code. But remember, you can always fork it to make it work the way you want.
License
Vuetable is open-sourced software licensed under the MIT license.