This Vue package offers an easy and intuitive way of displaying Bootstrap-styled grids with data coming either from the client or from the server.
Version 1.4.0 release note:
A breaking change has been introduced to this version.
Columns are no longer passed as an option to the options
prop.
They should now be passed to the component as a required columns
prop.
- Vue.js (>=1.0). Required.
- Bootstrap (CSS). Optional.
- vue-resource (server-side component only)
Compile the code using browserify
with the stringify
transform, or webpack
npm install vue-tables
Require the script:
var VueTables = require('vue-tables');
Import the compiled standalone file into your HTML, which will expose a global VueTables
variable.
Vue.use(VueTables.client, options);
Or/And
Vue.use(require('vue-resource'));
Vue.use(VueTables.server, options);
Add the following element to your page wherever you want it to render. Make sure to wrap it with a parent element you can latch your vue instance into.
<div id="people">
<v-client-table :data="tableData" :columns="columns" :options="options"></v-client-table>
</div>
Create a new Vue instance (You can also nest it within other components). An example works best to illustrate the syntax:
new Vue({
el:"#people",
data: {
columns:['id','name','age'],
tableData: [
{id:1, name:"John",age:"20"},
{id:2, name:"Jane",age:"24"},
{id:3, name:"Susan",age:"16"},
{id:4, name:"Chris",age:"55"},
{id:5, name:"Dan",age:"40"}
],
options: {
// see the options API
}
}
});
Important: when loading data asynchronously add a v-if
conditional to the component along with some loaded
flag, so it will only compile once the data is attached.
Check out the live client-side demo
<div id="people">
<v-server-table url="/people" :columns="columns" :options="options"></v-server-table>
</div>
Javascript:
new Vue({
el:"#people",
data: {
columns:['id','name','age'],
options: {
// see the options API
}
}
});
All the data is passed in the following GET parameters: query
,limit
,page
,orderBy
,ascending
,byColumn
.
You need to return a JSON object with two properties:
data
array
- An array of row objects with identical keys.
count
number
- Total count before limit.
vue-tables.loading
Fires off when a request is sent to the server. Sends through the request data.
vue-tables.loaded
Fires off after the response data has been attached to the table. Sends through the response.
You can listen to those complementary events on a parent component and use them to add and remove a loading indicator, respectively.
At times you might want to refresh the data as a reaction to data alteration on the server-side. To do so hunt down the component's instance using $parent
and $children
and call the refresh()
method on it.
I have included an Eloquent implementation for Laravel Users. If you happen to write other implementations for PHP or other languages, a pull request would be most welcome, under the following guidelines:
a. Include the class under ./server/{language}
.
b. Name it according to convention: {concrete}VueTables
.
c. if this is the first implementation in this language add an interface similar to the one found in the PHP folder.
d. Have it implement the interface.
e. TEST IT.
Custom filters allow you to integrate your own filters into the plugin using Vue's events system.
A. use the customFilters
option to declare your filters, following this syntax:
customFilters: [
{
name:'alphabet',
callback: function(row, query) {
return row.name[0] == query;
}
}
]
B. On your application broadcast an event when a filter was applied, and pass the query:
this.$broadcast('vue-tables.filter::alphabet', query);
A. use the customFilters
option to declare your filters, following this syntax:
customFilters: ['alphabet','age-range']
B. the same as in the client component.
The queries will be sent as part of the request in a customQueries
array, where the key is the filter name, and the value is the current query.
Options are set in three layers, where the more particular overrides the more general.
- Pre-defined component defaults.
- Applicable user-defined defaults for the global Vue Instance. Passed as the second paramter to the
Use
statement. - Options for a single table, passed through the
options
prop.
CSS Note: to center the pagination apply text-align:center
to the wrapping element