Updated readme
This commit is contained in:
parent
8d3c235758
commit
3e544ee2ef
101
README.md
101
README.md
@ -1,8 +1,53 @@
|
|||||||
# ng-datatable
|
<!-- Header -->
|
||||||
|
<div id="top" align="center">
|
||||||
|
<br />
|
||||||
|
|
||||||
[![CircleCI](https://circleci.com/gh/ztimson/ng-datatable/tree/master.svg?style=svg)](https://circleci.com/gh/ztimson/ng-datatable/tree/master)
|
<!-- Logo -->
|
||||||
|
<img src="https://git.zakscode.com/repo-avatars/2b4ee6ba1f2e2618bf7694e4a52fb56d1d0ea6abafa2dcbe496ab786b86d5a76" alt="Logo" width="200" height="200">
|
||||||
|
|
||||||
|
<!-- Title -->
|
||||||
|
### ng-datatable
|
||||||
|
|
||||||
|
<!-- Description -->
|
||||||
|
**Deprecated:** Angular Table Building Library
|
||||||
|
|
||||||
|
<!-- Repo badges -->
|
||||||
|
[![Version](https://img.shields.io/badge/dynamic/json.svg?label=Version&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/ztimson/ng-datatable/tags&query=$[0].name)](https://git.zakscode.com/ztimson/ng-datatable/tags)
|
||||||
|
[![Pull Requests](https://img.shields.io/badge/dynamic/json.svg?label=Pull%20Requests&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/ztimson/ng-datatable&query=open_pr_counter)](https://git.zakscode.com/ztimson/ng-datatable/pulls)
|
||||||
|
[![Issues](https://img.shields.io/badge/dynamic/json.svg?label=Issues&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/ztimson/ng-datatable&query=open_issues_count)](https://git.zakscode.com/ztimson/ng-datatable/issues)
|
||||||
|
|
||||||
|
<!-- Links -->
|
||||||
|
|
||||||
|
---
|
||||||
|
<div>
|
||||||
|
<a href="https://git.zakscode.com/ztimson/ng-datatable/releases" target="_blank">Release Notes</a>
|
||||||
|
• <a href="https://git.zakscode.com/ztimson/ng-datatable/issues/new?template=.github%2fissue_template%2fbug.md" target="_blank">Report a Bug</a>
|
||||||
|
• <a href="https://git.zakscode.com/ztimson/ng-datatable/issues/new?template=.github%2fissue_template%2fenhancement.md" target="_blank">Request a Feature</a>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
---
|
||||||
|
</div>
|
||||||
|
|
||||||
|
## Table of Contents
|
||||||
|
- [ng-datatable](#top)
|
||||||
|
- [About](#about)
|
||||||
|
- [Demo](#demo)
|
||||||
|
- [Built With](#built-with)
|
||||||
|
- [Setup](#setup)
|
||||||
|
- [Production](#production)
|
||||||
|
- [Development](#development)
|
||||||
|
- [Documentation](#documentation)
|
||||||
|
- [NgDatatableComponent](#ngdatatablecomponent)
|
||||||
|
- [Column](#column)
|
||||||
|
- [License](#license)
|
||||||
|
|
||||||
|
## About
|
||||||
|
|
||||||
|
**Deprecated**
|
||||||
|
|
||||||
|
|
||||||
|
A lightweight, feature rich table to display data. It is built with twitter bootstrap in mind so it will be automatically styled if you have the css included but its simple table structure makes it easy to style.
|
||||||
|
|
||||||
A lightweight, feature rich table to display data. It is built with twitter bootstrap in mind so it will be automatically styled if you have the css included but its simple table structor makes it easy to style.
|
|
||||||
|
|
||||||
Features:
|
Features:
|
||||||
|
|
||||||
@ -16,13 +61,27 @@ Features:
|
|||||||
- Mobile column hiding
|
- Mobile column hiding
|
||||||
- Checkboxes
|
- Checkboxes
|
||||||
|
|
||||||
|
|
||||||
[View on NPM](https://www.npmjs.com/package/@ztimson/ng-datatable)
|
[View on NPM](https://www.npmjs.com/package/@ztimson/ng-datatable)
|
||||||
|
|
||||||
## Installing
|
### Built With
|
||||||
|
[![Angular](https://img.shields.io/badge/Angular-DD0031?style=for-the-badge&logo=angular)](https://angular.io/)
|
||||||
|
[![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge&logo=typescript&logoColor=white)](https://typescriptlang.org/)
|
||||||
|
|
||||||
1. Install package `npm install @ztimson/ng-datatable --save`
|
## Setup
|
||||||
2. Import into module
|
|
||||||
|
<details>
|
||||||
|
<summary>
|
||||||
|
<h3 id="production" style="display: inline">
|
||||||
|
Production
|
||||||
|
</h3>
|
||||||
|
</summary>
|
||||||
|
|
||||||
|
#### Prerequisites
|
||||||
|
- [Node.js](https://nodejs.org/en/download)
|
||||||
|
|
||||||
|
#### Instructions
|
||||||
|
1. Install package `npm install @ztimson/ng-datatable --save`
|
||||||
|
2. Import into module
|
||||||
|
|
||||||
```Typescript
|
```Typescript
|
||||||
import {NgDatatableModule} from '@ztimsonm/ng-datatable'
|
import {NgDatatableModule} from '@ztimsonm/ng-datatable'
|
||||||
@ -37,13 +96,31 @@ import {NgDatatableModule} from '@ztimsonm/ng-datatable'
|
|||||||
export class AppModule { }
|
export class AppModule { }
|
||||||
```
|
```
|
||||||
|
|
||||||
3. Add to template
|
3. Add to template
|
||||||
|
|
||||||
```HTML
|
```HTML
|
||||||
<ng-datatable [columns]="columns" [data]="data"></ng-datatable>
|
<ng-datatable [columns]="columns" [data]="data"></ng-datatable>
|
||||||
```
|
```
|
||||||
|
</details>
|
||||||
|
|
||||||
## API
|
<details>
|
||||||
|
<summary>
|
||||||
|
<h3 id="development" style="display: inline">
|
||||||
|
Development
|
||||||
|
</h3>
|
||||||
|
</summary>
|
||||||
|
|
||||||
|
#### Prerequisites
|
||||||
|
- [Node.js](https://nodejs.org/en/download)
|
||||||
|
|
||||||
|
#### Instructions
|
||||||
|
1. Install the dependencies: `npm install`
|
||||||
|
2. Start the Angular server: `npm run start`
|
||||||
|
3. Open [http://localhost:4200](http://localhost:4200)
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
## Documentation
|
||||||
|
|
||||||
### NgDatatableComponent
|
### NgDatatableComponent
|
||||||
|
|
||||||
@ -148,3 +225,9 @@ Exported As: `Column`
|
|||||||
| sortFn: (a, b) => 1/0/-1 | Custom function to sort rows by |
|
| sortFn: (a, b) => 1/0/-1 | Custom function to sort rows by |
|
||||||
| template: TemplateRef<any> | Template to render row with |
|
| template: TemplateRef<any> | Template to render row with |
|
||||||
| width: number/string | CSS width property |
|
| width: number/string | CSS width property |
|
||||||
|
|
||||||
|
|
||||||
|
## License
|
||||||
|
Copyright © 2023 Zakary Timson | Available under the Apache 2.0 License
|
||||||
|
|
||||||
|
See the [license](./LICENSE) for more information.
|
||||||
|
@ -1,9 +1,9 @@
|
|||||||
Table CSS
|
Table CSS
|
||||||
<input [(ngModel)]="tableCSS"> Selection Mode
|
<input [(ngModel)]="tableCSS"> Selection Mode
|
||||||
<select [(ngModel)]="selectionMode">
|
<select [(ngModel)]="selectionMode">
|
||||||
<option>None</option>
|
<option>None</option>
|
||||||
<option>single</option>
|
<option>single</option>
|
||||||
<option>multi</option>
|
<option>multi</option>
|
||||||
</select>
|
</select>
|
||||||
Checkbox
|
Checkbox
|
||||||
<input type="checkbox" [(ngModel)]="checkbox"> Expandable
|
<input type="checkbox" [(ngModel)]="checkbox"> Expandable
|
||||||
@ -13,13 +13,13 @@ Checkbox
|
|||||||
<input placeholder="Search" (keyup)="search.next($event.target.value)">
|
<input placeholder="Search" (keyup)="search.next($event.target.value)">
|
||||||
<br> Selected: {{table.selectedRows.size}}/{{table.processedData.length}}
|
<br> Selected: {{table.selectedRows.size}}/{{table.processedData.length}}
|
||||||
<ng-datatable #table [cssClass]="tableCSS" [columns]="columns" [data]="data" [expandedTemplate]="expandable ? expanded : null"
|
<ng-datatable #table [cssClass]="tableCSS" [columns]="columns" [data]="data" [expandedTemplate]="expandable ? expanded : null"
|
||||||
[showCheckbox]="checkbox" [paginate]="true" [selectionMode]="selectionMode == 'None' ? null : selectionMode" (rowSelected)="log($event)">
|
[showCheckbox]="checkbox" [paginate]="true" [selectionMode]="selectionMode == 'None' ? null : selectionMode" (rowSelected)="log($event)">
|
||||||
<ng-template #expanded let-object="object">
|
<ng-template #expanded let-object="object">
|
||||||
Hello {{object.firstName}} {{object.lastName}}, How are you today?
|
Hello {{object.firstName}} {{object.lastName}}, How are you today?
|
||||||
<span *ngIf="object.age < 18">I can see that you are under age.</span>
|
<span *ngIf="object.age < 18">I can see that you are under age.</span>
|
||||||
<span *ngIf="object.age > 84">I can see that you are over the average life expectancy.</span>
|
<span *ngIf="object.age > 84">I can see that you are over the average life expectancy.</span>
|
||||||
</ng-template>
|
</ng-template>
|
||||||
<ng-template #age let-value="value">
|
<ng-template #age let-value="value">
|
||||||
<strong [ngClass]="{'text-success': value < 18, 'text-danger': value > 84}">{{value}}</strong>
|
<strong [ngClass]="{'text-success': value < 18, 'text-danger': value > 84}">{{value}}</strong>
|
||||||
</ng-template>
|
</ng-template>
|
||||||
</ng-datatable>
|
</ng-datatable>
|
||||||
|
File diff suppressed because one or more lines are too long
Loading…
Reference in New Issue
Block a user