Git Product home page Git Product logo

angular-minimal-grid's Introduction

angular-minimal-grid

Implementation of data grid using bootstrap (^3.x.x) for angular applications (^1.x.x).

Uses custom style of dataTable.

Installation

Bower

$ bower install angular-minimal-grid

Embed it in your HTML:

<link href="./bower_components/angular-minimal-grid/css/minimal-grid.css" rel="stylesheet">
<script src="./bower_components/angular-minimal-grid/js/minimal-grid.js"></script>

NPM

$ npm install angular-minimal-grid

Embed it in your HTML:

<link href="./node_modules/angular-minimal-grid/css/minimal-grid.css" rel="stylesheet">
<script src="./node_modules/angular-minimal-grid/js/minimal-grid.js"></script>

Dependency injection

Inject angular-minimal-grid module as a dependency into your app:

var app = angular.module('app', [
  'ngMinimalGrid'
])

Usage

Example of minimum usage:

<minimal-grid columns="myColumns" rows="myRows"></minimal-grid>

In controller:

$scope.myColumns = [
  { key: 'name', title: 'Name' },
  { key: 'lastName', title: 'Last Name' },
  { key: 'age', title: 'Age' }
]
$scope.myRows = [
  { name: 'John ', lastName: 'Doe', age: 30 },
  { name: 'Marie ', lastName: 'Doe', age: 28 }
]

image

That's all.

Customization

Custom labels

It's suportted custom labels by Provider methods:

method property default value
setStatsMessage(String) statsMessage     'Showing %1 to %2 of %3 results'
setFirstLabel(String) firstButtonLabel First                          
setLastLabel(String) lastButtonLabel Last                            
app.config(function(minimalGridConfigProvider){
  minimalGridConfigProvider
    .setStatsMessage('Mostrando %1 à %2 de %3 resultados')
    .setFirstLabel('Primeiro')
    .setLastLabel('Último')
})

Custom rendering

It's suportted custom rendering of cell value: uses onRender

$scope.myColumns = [
  { key: 'name', title: 'Name' },
  { key: 'lastName', title: 'Last Name' },
  { key: 'age', title: 'Age', onRender: function(val){
    if (val%2 == 0)
      return '<b>'+val+'</b>' // HTML allowed
    else
      return val
  } }
]
$scope.myRows = [
  { name: 'John ', lastName: 'Doe', age: 30 },
  { name: 'Marie ', lastName: 'Doe', age: 28 }
]

Max limit per page

Set the max rows peer page. Default is 10.

<minimal-grid columns="myColumns" rows="myRows"
  pagination-max="15"
  ></minimal-grid>
Max limit of pagination

Set the range of number's page to show. Default is 5.

<minimal-grid columns="myColumns" rows="myRows"
  pagination-range="3"
  ></minimal-grid>

Nested objects

It's suportted nested objects: uses angular's parse.

$scope.myColumns = [
  { key: 'person.user.name', title: 'Name' },
  { key: 'lastName', title: 'Last Name' },
  { key: 'age', title: 'Age' }
]
$scope.myRows = [
  { person: { user: { name: 'John ' } }, lastName: 'Doe', age: 30 },
  { person: { user: { name: 'Marie ' } }, lastName: 'Doe', age: 28 }
]

Getting the control

Keep in mind: this implementation uses the power of callbacks to do anything by out of the grid directive.

The isolated scope binding:

property type required
columns array yes
rows array yes
fake bool
totalRows integer
pagination-max integer
pagination-range integer
on-change-order-by function
on-change-paginate function
on-click-row function
on-click-row

If you want to do somenthing when the user clicks on a row just add a binding on a click:

<minimal-grid columns="myColumns" rows="myRows"
  on-click-row="myCallbackClick(row)"
  ></minimal-grid>

row will be something like this:

{
  name: "John", 
  lastName: "Doe", 
  age: 30
}

It's important to pass "row" as parameter: Uses angular's parameter by reference.

on-change-paginate

If you want to do somenthing when the user clicks on a page number (previous or next) just add a binding on a paginate:

<minimal-grid columns="myColumns" rows="myRows"
  on-change-paginate="myCallbackPaginate(pages)"
  ></minimal-grid>

pages will be something like this:

{
  current: 2,
  first: 1, 
  last: 10, 
  max: 10, 
  next: 3, 
  pagination: 1, 
  previous: 1, 
  range: 5, 
  total: Array(10) 
}

It's important to pass "pages" as parameter: Uses angular's parameter by reference.

on-change-order-by

If you want to do somenthing when the user clicks on a header (to change the order by) just add a binding on a order by:

<minimal-grid columns="myColumns" rows="myRows"
  on-change-order-by="myCallbackOrderBy(orderBy)"
  ></minimal-grid>

orderBy will be something like this:

{
  orderdirection: "asc", 
  orderby: "name"
}

It's important to pass "orderby" as parameter: Uses angular's parameter by reference.

fake mode

Here's the trick! Setting fake="true" makes the grid perform ordernation and pagination just visualy. This way it's possible to perform yourself ordenation or pagination or whatever you want. Perfect to make async calls and server things.

<minimal-grid columns="myColumns" rows="myRows"
  fake="true"
  ></minimal-grid>

Using this mode you will need to set the row's length by setting totalRows

<minimal-grid columns="myColumns" rows="myRows"
  fake="true"
  total-rows="myRowsLenght"
  ></minimal-grid>

Combine with callbacks and feel the power.

Tests

To run the package's test, first install the dependencies, then run npm test:

$ npm install --only=dev
$ bower install

or

$ npm install

License

MIT License

angular-minimal-grid's People

Contributors

saulsluz avatar

Watchers

 avatar  avatar  avatar  avatar

angular-minimal-grid's Issues

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.