Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/activewidgets/svelte

Virtualized Svelte Data Grid
https://github.com/activewidgets/svelte

data-grid data-table datagrid datatable grid scrolling svelte table virtual virtualized

Last synced: 5 days ago
JSON representation

Virtualized Svelte Data Grid

Awesome Lists containing this project

README

        

###

# ActiveWidgets/Svelte • Datagrid

[![npm version](https://img.shields.io/npm/v/@activewidgets/svelte)](https://www.npmjs.com/package/@activewidgets/svelte "View this project on npm")
[![npm downloads](https://img.shields.io/npm/dm/@activewidgets/svelte)](https://www.npmjs.com/package/@activewidgets/svelte "npm package downloads/month")
[![Github issues](https://img.shields.io/github/issues/activewidgets/svelte)](https://github.com/activewidgets/svelte/issues "See Github issues")
[![Github repo](https://img.shields.io/github/stars/activewidgets/svelte?label=GitHub&style=social)](https://github.com/activewidgets/svelte "Open Github repo")

ActiveWidgets is a multi-framework UI component library. This package provides [virtualized datagrid component for Svelte](https://activewidgets.com/svelte/data-grid/).

[Live demo](https://svelte.activewidgets.com) / [Developer guide](https://activewidgets.com/guide/) / [API reference](https://activewidgets.com/api/)

[![Datagrid demo](https://cdn.activewidgets.com/assets/screens/demo.png)](https://svelte.activewidgets.com)

- [Installation](#installation)
- [Usage](#usage)
- [Data properties](#data-properties)
- [User events](#user-events)

## Installation

Add [@activewidgets/svelte](/api/packages/svelte/) to your project dependencies -

```sh
> npm i --save @activewidgets/svelte
```

## Usage

Now you can import ActiveWidgets component classes -

```js
import { Datagrid } from "@activewidgets/svelte";
```

and use them like any standard Svelte component.

```html

import { Datagrid } from '@activewidgets/svelte';
import './styles.css';

let rows = [
{ message: 'Hello, World!' }
];

```
[Live example](https://svelte.activewidgets.com/examples/svelte/hello-world/) | [Source on github](https://github.com/activewidgets/svelte/tree/master/examples/hello-world) | [Edit on stackblitz](https://stackblitz.com/github/activewidgets/svelte/tree/master/examples/hello-world?file=src/app.svelte)

## Data properties

You have to provide [columns](/api/datagrid/columns/) and [rows](/api/datagrid/rows/) properties to the datagrid to show some data. The properties of each `column` object define how the data will be rendered -

- [field](/api/datagrid/columns/#field) - where the cell data comes from (string|function)
- [header](/api/datagrid/columns/#header) - column header (string|object)
- [width](/api/datagrid/columns/#width) - column width (number, in pixels)
- [align](/api/datagrid/columns/#align) - cell text alignment (left|right|center)
- [format](/api/datagrid/columns/#format) - number/date format (string|function)
- [fixed](/api/datagrid/columns/#fixed) - fixed (true/false) for columns on the left or right side

The `style` (string|object) or `className` properties allow to change the styling of the column and cell elements.

```html

// ...

const columns = [
{header: 'Code', field: 'customerID', width: 80, style: 'background:#def', fixed: true},
{header: 'Company Name', field: 'companyName', width: 160},
{header: 'Contact', field: 'contactName', width: 120},
{header: 'Title', field: 'contactTitle', width: 120},
{header: 'Address', field: 'address', width: 120, align: 'right'}
];

const rows = northwind.customers;

```
[Live example](https://svelte.activewidgets.com/examples/svelte/columns/) | [Source on github](https://github.com/activewidgets/svelte/tree/master/examples/columns) | [Edit on stackblitz](https://stackblitz.com/github/activewidgets/svelte/tree/master/examples/columns?file=src/app.svelte)

## User events

In addition to the standard DOM keyboard and mouse events the datagrid emits composite
[mouse](/api/datagrid/mouse-event/) event which makes it easier to find the elements affected by the user action -

```html

// ...

function onMouse({row}){
alert(`row ${row.key} clicked!`);
}

onMouse(e.detail)} />
```
[Live example](https://svelte.activewidgets.com/examples/svelte/events/) | [Source on github](https://github.com/activewidgets/svelte/tree/master/examples/events) | [Edit on stackblitz](https://stackblitz.com/github/activewidgets/svelte/tree/master/examples/events?file=src/app.svelte)

## More info

- [Live demo](https://svelte.activewidgets.com)
- [Developer guide](https://activewidgets.com/guide/)
- [API reference](https://activewidgets.com/api/)
- [Licensing](https://activewidgets.com/licenses/)
- [Support forum](https://activewidgets.com/messages/)

---

[![ActiveWidgets](https://activewidgets.com/include/logo/aw-logo-40.png)](https://activewidgets.com)