Introduction

vue3-easy-data-table is a simple and easy-to-use data table component made with Vue.js 3.x. The data table component in Vuetify 3 hasn’t been released yet, so i made this component by referring to the API and UI of data table component in Vuetify 2.

Getting started

Install

npm install vue3-easy-data-table
// or
yarn add vue3-easy-data-table

Regist

import Vue3EasyDataTable from 'vue3-easy-data-table';
import 'vue3-easy-data-table/dist/style.css';

const app = createApp(App);
app.component('EasyDataTable', Vue3EasyDataTable);

Use

<template>
  <EasyDataTable
    :headers="headers"
    :items="items"
  />
</template>

<script lang="ts">
import type { Header, Item } from "vue3-easy-data-table";

export default defineComponent({
  setup() {
    const headers: Header[] = [
      { text: "Name", value: "name" },
      { text: "Height (cm)", value: "height", sortable: true },
      { text: "Weight (kg)", value: "weight", sortable: true },
      { text: "Age", value: "age", sortable: true }
    ];

    const items: Item[] = [
      { "name": "Curry", "height": 178, "weight": 77, "age": 20 },
      { "name": "James", "height": 180, "weight": 75, "age": 21 },
      { "name": "Jordan", "height": 181, "weight": 73, "age": 22 }
    ];

    return {
      headers,
      items
    };
  },
});
</script>

Modes

vue3-easy-data-table has two modes: client mode and server side mode. Client mode is for the case that all data has already been loaded, In other words, your initial call is asking for all the pages from a server. And In server side mode, you need to request limited data from a server everytime you navigate to a new page. Client mode is the default mode, you have to pass server-options and server-items-length props to switch to the server side mode.

Features

1. Buttons pagination
2. Dense
3. Item slot
4. Multiple selecting
5. Single field sorting
6. Searching
7. Server side paginate and sort
8. Theme color

Buttons pagination

Use buttons-pagination prop and seven visible page buttons will be generated automatically to help you navigate more easily.

Online preview

Dense

Use dense prop to provide an alternate dense style.

Online preview

Item slot

You can customize only certain columns like this:

  <EasyDataTable :headers="headers" :items="items">
    <template #address="{ address }">
      <EasyButton :address="address" />
    </template>
  </EasyDataTable>

Notice that the <name> of #<name> should be a value of header item.

Online preview

Multiple selecting

Using the v-model:items-selected will enable you to get data of specific items by toggling checkbox.

Online preview

Single field sorting

Add sortable property into the header items to make the corresponding columns sortable.

 const headers: Header[] = [
  { text: "Height", value: "height", sortable: true },
  ...
 ];

Use sort-by and sort-type to define the initial sorting field and sorting type (‘asc’ or ‘desc’).

Online preview

Searching

Use search-field and search-value props to search for information in a specific field. If you don’t pass the search-field prop, the component will search in all fields.

notice: Searching feature is only available in client mode.

Server side paginate and sort

Also called server-side mode, In this mode, you’re loading data already paginated and sorted from server. You should watch the serverOptions to know when to request new pages from server. Don’t forget to use the loading prop to display a loading bar while fetching data.

server-items-length and v-model:server-options are required in this mode.

Online preview

Theme color

Use theme-color prop to customize color of checkbox, active option of rows selector, loading bar and active button of buttons pagination.

Props

Common props

common props can be used both in client mode and server side mode.

Client mode Props

only available in client mode

Server side mode props

only available in server side mode

Todo

This component just satisfied my needs, if you find any bug or demand any other features, plese report an issue and making pull requests is very welcomed.

GitHub

View Github