https://github.com/awerlang/angular-responsive-tables

Make your HTML tables look great on every device
https://github.com/awerlang/angular-responsive-tables

angularjs angularjs-directives css html-table mobile mobile-web responsive-design table

Last synced: 3 months ago
JSON representation

Make your HTML tables look great on every device

• Host: GitHub
• URL: https://github.com/awerlang/angular-responsive-tables
• Owner: awerlang
• License: mit
• Created: 2015-05-09T20:29:03.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2019-04-10T18:02:02.000Z (over 5 years ago)
• Last Synced: 2024-07-17T16:03:32.569Z (4 months ago)
• Topics: angularjs, angularjs-directives, css, html-table, mobile, mobile-web, responsive-design, table
• Language: JavaScript
• Homepage:
• Size: 295 KB
• Stars: 71
• Watchers: 11
• Forks: 19
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# angular-responsive-tables

Make your HTML tables look great on every device.

Compatible with **AngularJS 1.3.4+**.

[Live Demo](http://awerlang.github.io/angular-responsive-tables/examples/)

## Why?

Currently, browsers for mobile devices like smartphones doesn't do anything to have a proper presentation of tables,

 and then scrollbars will show up and ruin your design.

In the search of a solution to this problem I have found many different approaches. Some of them

 still rely on horizontal scrollbars. While I believe this layout could be useful for some use cases,

 I felt that a default solution should avoid horizontal scrollbars entirely. Then I came up with this

 highly reusable directive.

All this work is based on the following assumptions:

* If it is *flexible*, then it would solve most problems, even ones not aimed by the library author's;

* Focusing on the task of *adding responsiveness*, in order to accomplish a greater objective (*easy to use tabular data*);

* Do work with a *standard HTML table*, not requiring any extraneous markup;

* Do *not change default tabular layout* unless a smaller display is detected;

* Provide *convenience* without sacrificing flexibility;

* By keeping *code base simple*, it is easier to reason about and evolve;

* By fully covering with tests, it can *evolve without introducing bugs*.

## Features

* Angular native implementation compatible with 1.3.4+;

* Keep things DRY;

* Supports static and dynamic (ng-repeat) rows;

* Supports conditionally shown (ng-if) columns;

* Supports dynamic headers (ng-repeat);

* Supports nested tables (responsive or not in their own right);

* Easy to apply any style on top of it;

* Works with any base CSS framework;

* Should integrate seamlessly with any table component you might choose to use.

### Future Work

* Choose what columns to show/hide according to a given screen resolution;

* Choose when it would be best to hide columns or collapse all columns;

* Define a header and/or custom template for collapsed columns/row;

* Allow collapse/expand column details.

## Usage

    

        

            Column 1

            Column 2

            Column 3

            Column 4

        

        

            ...

            ...

            ...

            ...

        

        

            ...

            ...

            ...

            ...

        

        

            ...

            ...

            ...

            ...

        

    

### Directives

#### wt-responsive-table

 * table: wt-responsive-table

   * td: responsive-omit-title: title should be ommited

   * td: responsive-omit-if-empty: no row for empty cells

   * td: data-title: use to override the header for a given row/cell

## Installation

### npm

    npm install --save angular-responsive-tables

### Bower

    bower install angular-responsive-tables --save

### Application

#### HTML

    

    

#### JavaScript

    var app = angular.module('app', ['wt.responsive']);

## Special cases

### Header doesn't appear for a row / need to override header

It's possible to override a header with a `data-title` attribute:

    

        tom

        jerry

    

### Changes to header text doesn't reflect in responsive mode

This is by design. To avoid expensive digest cycles only the content from the first digest cycle is used.

There are no watchers being setup.

### Dynamic column names

When loading column names with an asynchronous task, that is, column names are not available when first compiling the table element, rows in responsive mode won't have headers even after the task completes.

To avoid this problem, use an `ng-if` to conditionally present the element on screen.

    

### IE9 responsive hack

Because IE9 doesn't handle correctly a `display` CSS rule for ``, if you need to support it, you can use the following style, only for IE9:

```css

```

## Credits

CSS based on original work by Chris Coyier (http://css-tricks.com/responsive-data-tables/). In this article, he covers approaches to responsive tables. I modified it to work around CSS specificity and to keep things DRY.

## License

MIT