# reactjs-datatable

> Datatable component for React

Latest version **1.2.9** (published 2020-04-09) · ISC license · 0 weekly downloads

## Install

```sh
npm install reactjs-datatable
pnpm add reactjs-datatable
yarn add reactjs-datatable
bun add reactjs-datatable
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.2.9 |
| Published | 2020-04-09 |
| First published | 2020-02-29 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 7 |
| Unpacked size | 1.5 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | @codemize |
| Maintainers | codemize |

## Links

- npm: https://www.npmjs.com/package/reactjs-datatable
- Repository: https://github.com/fabio-alss-freitas/reactjs-datatable
- Homepage: https://github.com/fabio-alss-freitas/reactjs-datatable#readme
- Issues: https://github.com/fabio-alss-freitas/reactjs-datatable/issues
- npm.io page: https://npm.io/package/reactjs-datatable

## Dependencies (7)

- [jszip](https://npm.io/package/jszip.md) ^3.2.2
- [react](https://npm.io/package/react.md) ^16.12.0
- [jquery](https://npm.io/package/jquery.md) ^3.4.1
- [pdfmake](https://npm.io/package/pdfmake.md) ^0.1.64
- [prop-types](https://npm.io/package/prop-types.md) ^15.7.2
- [datatables.net-bs](https://npm.io/package/datatables.net-bs.md) ^1.10.20
- [datatables.net-buttons-bs](https://npm.io/package/datatables.net-buttons-bs.md) ^1.6.1

## Recent versions

- 1.2.9 (latest) — 2020-04-09
- 1.2.7 — 2020-04-09
- 1.2.6 — 2020-04-06
- 1.2.5 — 2020-04-06
- 1.2.4 — 2020-04-06
- 1.2.3 — 2020-03-10
- 1.2.2 — 2020-03-09
- 1.2.1 — 2020-03-03
- 1.2.0 — 2020-03-03
- 1.1.9 — 2020-03-03
- 1.1.8 — 2020-03-02
- 1.1.7 — 2020-03-02
- 1.1.6 — 2020-03-02
- 1.1.5 — 2020-03-02
- 1.1.4 — 2020-03-02
- … 11 more at https://npm.io/package/reactjs-datatable/versions

## README

<h1 align="center">
  ReactJS Datatable
</h1>

<div align="center">
Datatable converted to React component.
</div>

## Installation

`yarn add reactjs-datatable`
or
`npm install --save reactjs-datatable`

## Usage

```javascript
import Datatable from "reactjs-datatable";

render() {
    return (
     <div className={"box-body"}>
            <Datatable
              tableRef={tableRef}
              id={id}
              idRequired={idRequired}
              fetchUrl={fetchUrl}
              hideAddButton={hideAddButton}
              onAddPress={onAddPress}
              onEditPress={this.handleOnEditPress}
              editableRow={editableRow}
              exportOptions={["csv","pdf"]}
              onDeletePress={this.handleOnDeletePress}
              serverDisabled={serverDisabled}
              columns={columns}
              hideBoxSearch={hideBoxSearch}
              hidePagingInfo={hidePagingInfo}
              columnDefs={[{ type: "date-uk", targets: 2 }]}
            />
          </div>
    );
  }
```

tableRef: PropTypes.func,

columns: PropTypes.array,
columnDefs: PropTypes.object,

## Props

| Name           | Description                                                                                                                                                                                                                                                                                                                                                                 | Type     | Required | Default Value |
| :------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------- | :------: | :-----------: |
| fetchUrl       | Nome da rota de requisição ao servidor. Esse nome será concatenado com os parâmetros, formando a seguinte url: datatable/**fetchUrl**?start=_0_&length=_50_&order=_nome_&mode=_asc_&search=_Ativo_. Lembrando que as colunas também serão buscadas do servidor através da url: datatable/**fetchUrl**/colunas                                                               | String   |          |               |
| idRequired     | É necessário enviar um Id junto a url de requisição?                                                                                                                                                                                                                                                                                                                        | Boolean  |          |     false     |
| id             | Id a ser enviado junto a url de requisição, formando a seguinte url: datatable/_fetchUrl_?**id=1**&start=_0_&length=_50_&order=_nome_&mode=_asc_&search=_Ativo_                                                                                                                                                                                                             | String   |          |               |
| hideAddButton  | Esconder botão de Adicionar Novo Registro?                                                                                                                                                                                                                                                                                                                                  | Boolean  |          |     false     |
| onAddPress     | Função a ser acionada ao clicar no botão Adicionar Novo Registro.                                                                                                                                                                                                                                                                                                           | Function |          |               |
| onEditPress    | Função a ser executada ao ser pressionado um botão de editar em uma coluna de ação. Lembrando que deve ser retornado da API, como data da coluna, algo como: <pre><code><button id="edit_1" type="button" class="btn btn-link btn-datatable"...</pre></code>. O id do botao deve ser 'edit\_**id**'. Como parâmetro da função, será retornado todos os dados da linha.      | Function |          |               |
| onDeletePress  | Função a ser executada ao ser pressionado um botão de deletar em uma coluna de ação. Lembrando que deve ser retornado da API, como data da coluna, algo como: <pre><code><button id="delete_1" type="button" class="btn btn-link btn-datatable"...</pre></code>. O id do botao deve ser 'delete\_**id**'. Como parâmetro da função, será retornado todos os dados da linha. | Function |          |               |
| exportOptions  | Array de strings com os tipos de exportações: "csv" e "pdf". Exemplo: ["csv","pdf"].                                                                                                                                                                                                                                                                                        | Array    |          |               |
| hideBoxSearch  | Esconder caixa de pesquisa?                                                                                                                                                                                                                                                                                                                                                 | Boolean  |          |     false     |
| hidePagingInfo | Esconder informação e botões de paginação?                                                                                                                                                                                                                                                                                                                                  | Boolean  |          |     false     |
| editableRow    | Ativar opção de travar em uma linha ao ser pressionado o botão de editar.                                                                                                                                                                                                                                                                                                   | Boolean  |          |     false     |
| serverDisabled | Desativar serverside e inserir dados manualmente a tabela?                                                                                                                                                                                                                                                                                                                  | Boolean  |          |     false     |
| columns        | Colunas inseridas manualmente. Deve seguir o padrão do [DataTable - Columns](https://datatables.net/reference/option/columns)                                                                                                                                                                                                                                               | Object   |          |               |
| columnDefs     | Definições especiais de colunas. Deve seguir o padrão do [DataTable - ColumnDefs](https://datatables.net/reference/option/columnDefs)                                                                                                                                                                                                                                       | Object   |          |               |
| data           | Array de dados.                                                                                                                                                                                                                                                                                                                                                             | Array    |          |               |
| tableRef       | Referência direta ao datatable, para que possa usar qualquer método do mesmo, ou fazer o CRUD manual a tabela.                                                                                                                                                                                                                                                              | Object   |          |               |

## Exemplo de inserção manual:

```javascript
...

componentDidMount() {
 this.tableRef.row
    .add({
      cod: selectedOption.value,
      nome: selectedOption.label.split("-")[1].trim(),
      qtde: qtdeSolicitada
    })
    .draw(false)
}

...
render() {
<Datatable
    tableRef={r => (this.tableRef = r)}
    serverDisabled
    columns={[
      { title: "Código", data: "cod", orderable: false },
      { title: "Nome", data: "nome", orderable: false },
      { title: "Quantidade", data: "qtde", orderable: false },
    ]}
  />
}
...
```

[Clique aqui](https://datatables.net/reference/api/), para mais informações sobre o DataTable.

## Author

Codemize

## License

ISC

---
_Source: https://npm.io/package/reactjs-datatable · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
