The front-end part of the datagrid is completely rewritten in TypeScript, supports modern browsers and is fully customizable via plugins.
Datagrid has a lot of plugins. You can use them all or just some of them.
Plugins (features)
- AutosubmitPlugin
- Sends form on change
- CheckboxPlugin
- Check/uncheck rows
- ConfirmPlugin
- Confirmation dialog before action
- InlinePlugin (advanced)
- Inline editing
- EditablePlugin (advanced)
- Inline editing
- ItemDetailPlugin
- Item detail view
- TreeViewPlugin (advanced)
- Tree view
Plugins (integrations)
- DatepickerPlugin
- Abstraction for datepickers
- NetteFormsPlugin
- Abstraction for Nette Forms
- SelectpickerPlugin
- Abstraction for selectpickers
- SortablePlugin
- Abstraction for sorting
Integrations
- SortableJS (+SortablePlugin)
- Implementation for sorting
- TomSelect (+SelectpickerPlugin)
- Implementation of selectpicker
- VanillaDatepicker (+DatepickerPlugin)
- Implementation of datepicker
Example
import {
AutosubmitPlugin,
CheckboxPlugin,
ConfirmPlugin,
createDatagrids,
DatepickerPlugin,
InlinePlugin,
ItemDetailPlugin,
NetteFormsPlugin,
SelectpickerPlugin,
SortableJS,
SortablePlugin,
TomSelect,
TreeViewPlugin,
VanillaDatepicker
} from "../../vendor/ublaboo/datagrid/assets"
document.addEventListener("DOMContentLoaded", () => {
createDatagrids(new NajaAjax(naja), {
datagrid: {
plugins: [
new AutosubmitPlugin(),
new CheckboxPlugin(),
new ConfirmPlugin(),
new InlinePlugin(),
new ItemDetailPlugin(),
new NetteFormsPlugin(netteForms),
new SortablePlugin(new SortableJS()),
new DatepickerPlugin(new VanillaDatepicker({ buttonClass: 'btn' })),
new SelectpickerPlugin(new TomSelect(Select)),
new TreeViewPlugin(),
],
},
});
});There are prepared JS/TS and CSS files for precise functionality.
You have 2 ways to use datagrid's assets:
- Use CDN assets.
- Use frontend bundler.
Assets are available as NPM package @contributte/datagrid.
You can use CDN assets like this:
<!-- Datagrid (CDN) -->
<link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@6/css/all.min.css">
<link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/bootstrap@5/dist/css/bootstrap.min.css">
<link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/@contributte/datagrid@master/dist/datagrid-full.css">
<script defer src="https://cdn.jsdelivr.net/npm/@contributte/datagrid@master/dist/datagrid-full.js"></script>By default, datagrid-full.ts and datagrid-full.css are bundled and accessible via CDN.
- Take a look how
datagrid-full.tslooks.
It contains these plugins:
- AutosubmitPlugin
- CheckboxPlugin
- ConfirmPlugin
- InlinePlugin
- ItemDetailPlugin
- NetteFormsPlugin
- SortablePlugin
- DatepickerPlugin
- SelectpickerPlugin
- TreeViewPlugin
- Take a look how
datagrid-full.csslooks.
Note
CDN assets are not ideal for customization and optimization. Use bundler instead.
This example uses Vite. You can see example of using bundler in datagrid-skeleton.
You need to have these files in your project:
Follow these steps:
- Install dependencies
- Create
assets/js/main.jsandassets/css/main.css. - Create
vite.config.mjs. - Run
npm run build. - See
wwwandwww/distdirectory.
➜ tree www
www
├── dist
│ ├── app.css
│ ├── app.js
│ ├── fa-brands-400.ttf
│ ├── fa-brands-400.woff2
│ ├── fa-regular-400.ttf
│ ├── fa-regular-400.woff2
│ ├── fa-solid-900.ttf
│ ├── fa-solid-900.woff2
│ ├── fa-v4compatibility.ttf
│ ├── fa-v4compatibility.woff2
│ └── favicon.ico
└── index.php
- Include
www/dist/datagrid.jsandwww/dist/datagrid.cssin your@layout.latte.
<!-- Datagrid (bundled) -->
<link rel="stylesheet" type="text/css" href="{$basePath}/dist/app.css">
<script defer src="{$basePath}/dist/app.js"></script>This example uses Vite. You can see example of using bundler in datagrid-skeleton.
package.json
{
"dependencies": {
"@fortawesome/fontawesome-free": "^6.7.2",
"bootstrap": "^5.3.6",
"naja": "^2.6.1",
"nette-forms": "^3.5.3",
"sortablejs": "^1.15.6",
"tom-select": "^2.4.3",
"vanillajs-datepicker": "^1.3.4"
},
"devDependencies": {
"@types/sortablejs": "^1.15.8",
"@types/vanillajs-datepicker": "^1.3.5",
"autoprefixer": "^10.4.21",
"typescript": "^5.8.3",
"vite": "^6.3.5"
},
"scripts": {
"watch": "vite build --watch --mode=development",
"build": "vite build --mode=production"
}
}assets/js/main.js
import naja from "naja";
import netteForms from "nette-forms";
import {
AutosubmitPlugin,
CheckboxPlugin,
ConfirmPlugin,
createDatagrids,
DatepickerPlugin,
InlinePlugin,
ItemDetailPlugin,
NetteFormsPlugin,
SelectpickerPlugin,
SortableJS,
SortablePlugin,
TomSelect,
TreeViewPlugin,
VanillaDatepicker
} from "../../vendor/ublaboo/datagrid/assets"
import { NajaAjax } from "../../vendor/ublaboo/datagrid/assets/ajax";
import Select from "tom-select";
import { Dropdown } from "bootstrap";
// Styles
import '../css/main.css';
// Datagrid + UI
document.addEventListener("DOMContentLoaded", () => {
// Initialize dropdowns
Array.from(document.querySelectorAll('.dropdown'))
.forEach(el => new Dropdown(el))
// Initialize Naja (nette ajax)
naja.formsHandler.netteForms = netteForms;
naja.initialize();
// Initialize datagrids
createDatagrids(new NajaAjax(naja), {
datagrid: {
plugins: [
new AutosubmitPlugin(),
new CheckboxPlugin(),
new ConfirmPlugin(),
new InlinePlugin(),
new ItemDetailPlugin(),
new NetteFormsPlugin(netteForms),
new SortablePlugin(new SortableJS()),
new DatepickerPlugin(new VanillaDatepicker({ buttonClass: 'btn' })),
new SelectpickerPlugin(new TomSelect(Select)),
new TreeViewPlugin(),
],
},
});
});assets/css/main.css
/* Datagrid styles */
@import "@fortawesome/fontawesome-free/css/all.css";
@import 'bootstrap/dist/css/bootstrap.css';
@import 'vanillajs-datepicker/css/datepicker-bs5.css';
@import "tom-select/dist/css/tom-select.css";
@import "tom-select/dist/css/tom-select.bootstrap5.css";
@import '../../vendor/ublaboo/datagrid/assets/css/datagrid.css';
@import '../../vendor/ublaboo/datagrid/assets/css/tom-select.css';
/* Your styles */vite.config.mjs
import { defineConfig } from 'vite';
import { resolve } from 'path';
export default defineConfig(({ mode }) => {
const DEV = mode === 'development';
return {
publicDir: './assets/public',
resolve: {
alias: {
'@': resolve(__dirname, 'assets/js'),
'~': resolve(__dirname, 'node_modules'),
},
},
base: process.env.VITE_BASE ?? '/dist/',
server: {
open: false,
hmr: false,
},
css: {
postcss: [
"autoprefixer"
]
},
build: {
manifest: true,
assetsDir: '',
outDir: './www/dist/',
emptyOutDir: true,
minify: DEV ? false : 'esbuild',
rollupOptions: {
output: {
manualChunks: undefined,
chunkFileNames: '[name].js', // DEV ? '[name].js' : '[name]-[hash].js',
entryFileNames: '[name].js', // DEV ? '[name].js' : '[name].[hash].js',
assetFileNames: '[name].[ext]', // DEV ? '[name].[ext]' : '[name].[hash].[ext]',
},
input: {
app: './assets/js/main.js'
}
}
},
}
});