Skip to content

🗂️ Create a HTML table that can be sorted, selected, and post-processed.

License

Notifications You must be signed in to change notification settings

nuxy/tidy-table

Repository files navigation

Tidy Table

npm version Build Status Install size

Create a HTML table that can be sorted, selected, and post-processed.

Preview

Features

  • Extensible HTML/CSS interface.
  • Compatible with all modern desktop and mobile web browsers.
  • Fully responsive layout with touch event support.
  • Easy to set-up and customize. No dependencies.
  • Customizable callback functions for post-processing selected results.
  • Post-process options for manipulating table/column/menu elements.

Checkout the demo for examples of use.

Dependencies

Installation

Install the package into your project using NPM, or download the sources.

$ npm install tidy-table

Alternative

To add to an existing React or Vue project you can install this package using YARN.

React

$ yarn add react-tidy-table

Vue

$ yarn add vue-tidy-table

Usage

There are two ways you can use this package. One is by including the JavaScript/CSS sources directly. The other is by importing the module into your component.

Script include

After you build the distribution sources the set-up is fairly simple..

<script type="text/javascript" src="path/to/tidy-table.min.js"></script>
<link rel="stylesheet" href="path/to/tidy-table.min.css" media="all" />

<script type="text/javascript">
  tidyTable(container, settings, options);
</script>

Module import

If your using a modern framework like Aurelia, Angular, React, or Vue

import TidyTable from 'tidy-table';
import 'tidy-table/dist/tidy-table.css';

const tidyTable = new TidyTable(container, settings, options);

HTML markup

<div id="tidy-table"></div>

Example

const options = {
  enableCheckbox: true,
  enableMenu:     true,
  reverseSortDir: true,
  responsive:     true
};

const settings = {
  columnTitles: ['Rank', 'Programming Language', 'Ratings Jan 2012', 'Delta Jan 2012', 'Status'],
  columnValues: [
    ['1', 'Java', '17.479%', '-0.29%', 'A'],
    ['2', 'C', '16.976%', '+1.15%', 'A'],
    ['3', 'C#', '8.781%', '+2.55%', 'A'],
    ['4', 'C++', '8.063%', '-0.72%', 'A'],
    ['5', 'Objective-C', '6.919%', '+3.91%','A']
  ],

  // Add menu options to bind result events.
  menuOptions: [
    ['- Action -', null],
    ['Callback 1', {callback: (rows) => {}}],
    ['Callback 2', {callback: (rows) => {}}]
  ],

  // Post-process rendered HTML output.
  postProcess: {
    table:  (HTMLTableElement)     => {},
    column: (HTMLTableCellElement) => {},
    menu:   (HTMLTableElement)     => {}
  },

  // Pre-process column values before sort.
  sortByPattern: function(colNum, val) {
    if (colNum !== 1) return val;

    return val?.replace(/\$|%|#/g, '');
  }
};

const container = document.getElementById('tidy-table');

const tidyTable = new TidyTable(container, settings, options);

Table options

Overriding defaults can be done using the following options:

Option Description Default
enableCheckbox Add checkbox functionality to table output. false
enableMenu Add select menu options to alter table output. false
reverseSortDir Change the sorting arrow image direction. false
responsive Enable/disable responsive layout support. false

Post-processing examples

There are times where you may need to customize the table result behavior. This can be achieved using postProcess hooks.

Hide the second column of table results

function callback(table) {
  const cols = table.querySelectorAll('th:nth-child(2), td:nth-child(2)');

  for (let i = 0; i < cols.length; i++) {
    cols[i].style.display = 'none';
  }
}

Create text field on column click event

function callback(col) {
  col.addEventListener('click', function() {
    if (!this.querySelector('form')) {
      const form = document.createElement('form');
      form.addEventListener('submit', function() {
        const xhr = new XMLHttpRequest();
        xhr.open('POST', '/path/to/script');
        xhr.send(null);
      });

      const field = document.createElement('input');
      field.setAttribute('type', 'text');
      field.setAttribute('value', this.textContent);

      const button = document.createElement('input');
      button.setAttribute('type', 'submit');

      form.appendChild(field).appendChild(button);

      this.removeChild(this.firstChild);
      this.appendChild(form);
    });
  }
}

Hide select menu when cookie doesn't exist

function callback(menu) {
  if (!getCookie('session')) {
    menu.style.display = 'none';
  }
}

Design template

The Illustrator template used to create the sort arrows has been provided with this package for reference.

Developers

CLI options

Run ESLint on project sources:

$ npm run lint

Transpile ES6 sources (using Babel) and minify to a distribution:

$ npm run build

Run WebdriverIO E2E tests:

$ npm run test

Contributions

If you fix a bug, or have a code you want to contribute, please send a pull-request with your changes. (Note: Before committing your code please ensure that you are following the Node.js style guide)

Versioning

This package is maintained under the Semantic Versioning guidelines.

License and Warranty

This package is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.

tidy-table is provided under the terms of the MIT license

Author

Marc S. Brooks