Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eea/volto-react-table-widget
https://github.com/eea/volto-react-table-widget
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/eea/volto-react-table-widget
- Owner: eea
- License: mit
- Created: 2022-03-06T16:14:54.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2023-11-17T18:09:43.000Z (about 1 year ago)
- Last Synced: 2024-11-05T00:35:25.508Z (2 months ago)
- Language: JavaScript
- Size: 63.5 KB
- Stars: 7
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-volto - volto-react-table-widget - Widget to replace Volto's ObjectListWidget to edit data-grid like widgets in a more performant way with a table based on [react-table](https://tanstack.com/table/v8/) (Addons / Widgets)
README
# volto-react-table-widget
[](https://github.com/eea/volto-react-table-widget/releases)
[](https://ci.eionet.europa.eu/view/Github/job/volto-addons/job/volto-react-table-widget/job/master/display/redirect)
[](https://sonarqube.eea.europa.eu/dashboard?id=volto-react-table-widget-master)
[](https://sonarqube.eea.europa.eu/dashboard?id=volto-react-table-widget-master)
[](https://sonarqube.eea.europa.eu/dashboard?id=volto-react-table-widget-master)
[](https://sonarqube.eea.europa.eu/dashboard?id=volto-react-table-widget-master)
[](https://ci.eionet.europa.eu/view/Github/job/volto-addons/job/volto-react-table-widget/job/develop/display/redirect)
[](https://sonarqube.eea.europa.eu/dashboard?id=volto-react-table-widget-develop)
[](https://sonarqube.eea.europa.eu/dashboard?id=volto-react-table-widget-develop)
[](https://sonarqube.eea.europa.eu/dashboard?id=volto-react-table-widget-develop)
[](https://sonarqube.eea.europa.eu/dashboard?id=volto-react-table-widget-develop)
[Volto](https://github.com/plone/volto) add-on to provide a [react-table](https://react-table.tanstack.com/) based widget for Volto to use it with fields with a large set of values.
The widget can be used like Volto's [ObjectListWidget](https://docs.voltocms.com/storybook/?path=/story/widgets-object-list-json--default&globals=measureEnabled:false), but it's more performant when you have a large set of values.
It also provides a CSV import and export functionality using the powerwful [react-papaparse](https://www.npmjs.com/package/react-papaparse) library.
## How to use it
This widget have to be configured like Volto's ObjectListWidget:
- You need to define a schema which will be used to create the table headings. Example:
```jsx
const ItemSchema = () => ({
title: 'Downloadable File',
properties: {
title: {
title: 'Title',
description: 'Enter the title of this file.',
type: 'string',
},
file: {
title: 'File name',
description: 'Enter the file name.',
type: 'string',
},
area: {
title: 'Area of interest',
description: 'Enter the area of this file.',
type: 'string',
},
year: {
title: 'Year',
description: 'Enter the year of this file.',
type: 'number',
minimum: 1900,
},
version: {
title: 'Version',
description: 'Enter the version of this file.',
type: 'string',
},
resolution: {
title: 'Resolution',
description: 'Enter the resolution of this file. Ex.: 100m',
type: 'string',
},
type: {
title: 'Type',
description: 'Enter the file type of this file. Ex.: Raster or Vector',
choices: [
['Raster', 'Raster'],
['Vector', 'Vector'],
],
},
format: {
title: 'Format',
description: 'Enter the format of this file.',
type: 'string',
},
size: {
title: 'Size',
description: 'Enter the size of this file. Ex.: 3.5 GB',
type: 'string',
},
path: {
title: 'Path',
description: 'Enter the absolute path of this file in the storage',
type: 'string',
},
source: {
title: 'Source',
description: 'Enter the source of this file (this is an internal).',
choices: [
['EEA', 'EEA'],
['HOTSPOTS', 'HOTSPOTS'],
],
},
},
fieldsets: [
{
id: 'default',
title: 'File',
fields: [
'title',
'file',
'area',
'year',
'version',
'resolution',
'type',
'format',
'size',
'path',
'source',
],
},
],
required: [],
});
```
- You need to configure your content type's schema to use it.
```jsx
import React from 'react';
import { ReactTableWidget } from '@eeacms/volto-react-table-widget';
const DownloadableFilesTableWidget = (props) => {
return (
props.onChange(id, { items: value })}
/>
);
};
export default DownloadableFilesTableWidget;
```
You can enable/disable the CSV import and export passing the relevant parameter to the widget.
## Features
[Video2](https://github.com/erral/volto-react-table-widget-talk/blob/main/public/2-fast.mp4)
[Video3](https://github.com/erral/volto-react-table-widget-talk/blob/main/public/3-fast.mp4)
[Video4](https://github.com/erral/volto-react-table-widget-talk/blob/main/public/4-fast.mp4)
## Getting started
### Try volto-react-table-widget with Docker
1. Get the latest Docker images
```
docker pull plone
docker pull plone/volto
```
1. Start Plone backend
```
docker run -d --name plone -p 8080:8080 -e SITE=Plone -e PROFILES="profile-plone.restapi:blocks" plone
```
1. Start Volto frontend
```
docker run -it --rm -p 3000:3000 --link plone -e ADDONS="@eeacms/volto-react-table-widget" plone/volto
```
1. Go to http://localhost:3000
### Add volto-react-table-widget to your Volto project
1. Make sure you have a [Plone backend](https://plone.org/download) up-and-running at http://localhost:8080/Plone
1. Start Volto frontend
- If you already have a volto project, just update `package.json`:
```JSON
"addons": [
"@eeacms/volto-react-table-widget"
],
"dependencies": {
"@eeacms/volto-react-table-widget": "^1.0.0"
}
```
- If not, create one:
```
npm install -g yo @plone/generator-volto
yo @plone/volto my-volto-project --addon @eeacms/volto-react-table-widget
cd my-volto-project
```
1. Install new add-ons and restart Volto:
```
yarn
yarn start
```
1. Go to http://localhost:3000
1. Happy editing!
## Release
See [RELEASE.md](https://github.com/eea/volto-react-table-widget/blob/master/RELEASE.md).
## How to contribute
See [DEVELOP.md](https://github.com/eea/volto-react-table-widget/blob/master/DEVELOP.md).
## Copyright and license
The Initial Owner of the Original Code is European Environment Agency (EEA).
All Rights Reserved.
See [LICENSE.md](https://github.com/eea/volto-react-table-widget/blob/master/LICENSE.md) for details.
## Funding
[European Environment Agency (EU)](http://eea.europa.eu)