An open API service indexing awesome lists of open source software.

https://github.com/ryoucerious/cerious-widgets

Powerful Angular UI Components
https://github.com/ryoucerious/cerious-widgets

Last synced: 1 day ago
JSON representation

Powerful Angular UI Components

Awesome Lists containing this project

README

          

![Cerious Widgets](cerious-widgets-sm.png)

# Cerious Widgets - Cerious Grid

**(Pronounced: Serious)**

**A seriously powerful Angular grid β€” for developers who demand control, flexibility, and performance.**
Part of the [Cerious Widgets](https://github.com/rYOUcerious/cerious-widgets) collection.

See: https://ryoucerious.github.io/cerious-widgets/

---

## πŸš€ Why Cerious Grid?

Cerious Grid isn't just a table β€” it's a full-blown, enterprise-grade Angular grid built for speed, extensibility, and total customization.

With a modern plugin system, rich templating support, and no heavy dependencies, it's everything you need to build real-world data-intensive apps.

---

## ✨ Features

## ⚑️ Core UX & Performance
- πŸ” **Virtual Scrolling** β€” Render thousands of rows without performance hits
- πŸ”„ **Pagination**
- 🌐 **Server-Side Mode** β€” Pagination, Filtering, Virtual Scroll

## 🧭 Layout & Interaction
- ↕️ **Column Resizing and Pinning**
- πŸ”— **Drag-and-Drop Columns**
- 🧱 **Grouped Column Headers**
- πŸ“Š **Group By** β€” with drag-to-group UI
- 🧬 **Nested Rows** β€” Use any Angular template for children (tables, charts, etc.)

## πŸ” Data Interaction
- 🧠 **Multi-Column Sorting** β€” Ctrl/Meta click to multi-sort
- 🧹 **Column Filtering** β€” Text, number, select, date

## 🧾 Customization
- 🧾 **Custom Templates** β€” Cells, headers, rows β€” fully yours
- πŸ’‘ **Directive-Based Plugin Templates**

## 🧩 Extensibility & Persistence
- 🧩 **Pluggable Architecture** β€” Add or override behavior without touching core
- πŸ’Ύ **Save & Restore Views** β€” Favorites, state, layout

## πŸ“€ Output & Licensing
- πŸ“¦ **Excel Export** β€” One-liner export with [`write-excel-file`](https://www.npmjs.com/package/write-excel-file)
- πŸ”“ **MIT Licensed and Fully Open Source**

---

## πŸ“¦ Installation

```bash
npm install ngx-cerious-widgets
```

Import via module or import directly into into your component.
```bash
@NgModule({
declarations: [
AppComponent
],
imports: [
BrowserModule,
CeriousWidgetsModule
],
providers: [],
bootstrap: [AppComponent]
})
export class AppModule { }
```

Add the styles to `angular.json`
```bash
"node_modules/ngx-cerious-widgets/styles/grid-styles-generated.scss",
```

---

## πŸ§ͺ Quick Start

```html

```

---

## 🧩 Plugin Example

```ts
export class MyPlugin implements GridPlugin {
onInit(api: GridApi) {
api.onCellClick.subscribe(cell => {
console.log('Cell clicked:', cell);
});
}
}
```

You can also consume templates using Angular `@Directive()`s to inject content dynamically.

---

## πŸ“Έ Live Demos

StackBlitz playground: https://stackblitz.com/edit/stackblitz-starters-5jca2yeb?file=angular.json

---

## 🀝 Contributing

We welcome your ideas, plugins, and PRs.
Head to the [issues page](https://github.com/your-org/cerious-grid/issues) to suggest features or report bugs.

---

## πŸ“ License

MIT β€” free for personal and commercial projects.

---

## 🧠 Built With Purpose

Cerious Grid was built by a developer who’s spent nearly two decades in enterprise front-end development.
If you’ve ever been frustrated by AG Grid’s licensing or boxed in by rigid tables β€” **this is for you**.

https://ryoucerious.github.io/cerious-widgets/