Angular 2 Smart Table Component

ng2-smart-table component made with :heart: by Akveo team. Follow us on Twitter to get latest news about this component first!

Demo

Live Demo

Installation

The library is available as npm package, so all you need to do is to run the following command:

npm install --save ng2-smart-table

This command will create a record in your package.json file and install the package into the npm modules folder.

Minimal Setup Example

First thing you need to do is to import the ng2-smart-table directives into your component.

 // If you are already on angular rc.5 just import the Ng2SmartTableModule into the imports statement of a module where you need the table:

import { Ng2SmartTableModule } from 'ng2-smart-table';

// If you are still on angular rc.4, then simply import the derictives array:

import { NG2_SMART_TABLE_DIRECTIVES } from 'ng2-smart-table';

Then register it by adding to the list of directives:

// ...

// RC5:

@NgModule({
  imports: [
    // ...
    
    Ng2SmartTableModule,
    
    // ...
  ],
  declarations: [ ... ]
})

// RC4

@Component({
  directives: [NG2_SMART_TABLE_DIRECTIVES], // register the directive
})
// ...

Now, we need to configure the table and add it into the template. The only required setting for the component to start working is a columns configuration. Let's register settings property inside of the component where we want to have the table and configure some columns Settings documentation:

settings = {
  columns: {
    id: {
      title: 'ID'
    },
    name: {
      title: 'Full Name'
    },
    username: {
      title: 'User Name'
    },
    email: {
      title: 'Email'
    }
  }
};

Finally let's put the ng2-smart-table component inside of the template:

// ...

@Component({
  template: `
    <ng2-smart-table [settings]="settings"></ng2-smart-table>
  `
})
// ...

At this step you will have a minimally configured table. All functions are available by default and you don't need to configure them somehow, so you already able to add/edit/delete rows, sort or filter the table, etc.

But it feels like something is missing... Right, there is no data in the table by default. To add some, let's create an array property with a list of objects in the component. Please note that object keys are same as in the columns configuration.

data = [
  {
    id: 1,
    name: "Leanne Graham",
    username: "Bret",
    email: "[email protected]"
  },
  {
    id: 2,
    name: "Ervin Howell",
    username: "Antonette",
    email: "[email protected]"
  },
  
  // ... list of items
  
  {
    id: 11,
    name: "Nicholas DuBuque",
    username: "Nicholas.Stanton",
    email: "[email protected]"
  }
];

And pass the data to the table:

// ...

@Component({
  template: `
    <ng2-smart-table [settings]="settings" [source]="data"></ng2-smart-table>
  `
})
// ...

Now you have some data in the table.

Further Documentation

Installation, customization and other useful articles: https://akveo.github.io/ng2-smart-table/

How can I support developers?

• Star our GitHub repo :star:
• Create pull requests, submit bugs, suggest new features or documentation updates :wrench:
• Follow us on Twitter :feet:
• Like our page on Facebook :thumbsup:

Can I hire you guys?

Yes! Visit our homepage or simply leave us a note to [email protected]. We will be happy to work with you!

Features

• Local data source (Server/API DataSource is on its way)
• Filtering
• Sorting
• Pagination
• Inline Add/Edit/Delete
• Flexible event model

##License MIT license.

From akveo

Enjoy :metal: We're always happy to hear your feedback!