contributte / datagrid

:muscle: DataGrid for Nette Framework: filtering, sorting, pagination, tree view, table view, translator, etc

Website 🚀 contributte.org | Contact 👨🏻‍💻 paveljanda.com, f3l1x.io | Twitter 🐦 @contributte

Usage

To install latest version of contributte/datagrid use Composer.

composer require ublaboo/datagrid

Documentation

For details on how to use this package, check out our documentation.

Shortly

You are looking at first class datagrid for Nette Framework. Supported features: filtering, sorting, pagination, tree view, table view, translator and many others. Give us a star, it makes us so happy. Thanks ⭐.️

What	Where
Documentation	contributte.org/packages/contributte/datagrid/
Demo	https://examples.contributte.org/datagrid-skeleton/
Example project	github.com/contributte/playground/tree/master/contributte-datagrid
Forum (EN)	will be updated
Forum (CZ)	forum.nette.org/cs/25444

Versions

State	Version	Branch	Nette	PHP
dev	^7.0.0	master	3.0+	>=8.0
stable	^6.7.0	master	3.0+	>=7.2
stable	^6.6.0	master	3.0+	>=7.2
stable	^5.7.1	v5.x	2.3	^5.6
stable	^4.4.22	v5.x	2.3	^5.6
stable	^3.3.1	v5.x	2.3	^5.3

Development

See how to contribute to this package. This package is currently maintained by these authors.

Future development

1. At the moment, we have limited time to maintain contributte datagrid for free. But you can create some maintenance time by sponsoring us. Ask us in email for available tarifs (email visible on https://github.com/paveljanda). At the moment, we have 1 little sponsor that gives us 1 hour of maintenance per month.

2. Sometimes, when there is a new issue opened (either with a new feature request or a bug report), we may assign a label with a dollar sign ($) and an amount of dollars to the issue. This is an opportunity for you to support datagrid vendor creators and resolve particular issue.

---

Consider to support contributte development team. Also thank you for using this package.

datagrid's Issues

add source files (datagrid.css, datagrid.js)

Do you think its possible to add here source files of css and javascript? It can be useful for my own theme.

Thanks

Přidat inline editaci

Web: Export Server error

Demo vyhadzuje server error.

Example of handleSort()

Does have somebody example of processing sorting? I can't get over it. I know it is not any issue, but I don't know how to right process it in database.

Tree-view: Chyba zoraďovania

Nie je možné presunúť položku na prvú/poslednú pozíciu vo vnorenom zozname.

Až založím vlákno na nette foru, udělat tyto věci:

1, Zeptat se, zda je žádaný multisort
2, Zeptat se, zda jsou žádané hromadné akce u tree view

Tree-view: stránkování potomků

AJAX: Send only datagrid snippets

In my project, I have $this->redrawControl() in startup in BasePresenter. As I want to redraw all snippets by default (and change this in render methods if needed).

However this breaks datagrid filtering, because in response I also get parent snippet, which redraws whole content (with grid).

I propose adding $this->getPresenter()->redrawControl(NULL, FALSE) here, which solves whole problem.

I'm not sure if this is BC break, but it could be avoided by adding onlyRedrawGrid option or something.

Also, onReload event would do the job (where I would call redrawControl(NULL, FALSE) myself).

I'm migrating from o5/grido, where on grid manipulation (filtering, paginating, ..) only grid snippets are returned no matter what I choose to redraw.

Upravit Happy, aby mohl člověk definovat thickness

DataGrid: Implement rendering via subcomponents

It would be great if we had the ability to do partial rendering, for example:

{control grid}

vs

<div class="panel panel-default">
    <div class="panel-body">
         {control grid:table}
    </div>
    <div class="panel-footer">
        {control grid:paginator}
        {control grid:perpage}
    </div>
</div>

Obalit vypisované položky přes vlastní třídu Row, rozšíření podmínek výpisu (např group action condition callback)

Group action condition callback - viz https://forum.nette.org/cs/25444-ublaboo-datagrid-mocny-rychly-rozsiritelny-hezky-anglicky-dokumentovany-datagrid#p169161.

Empty $column_count

Upozornenie s prázdnym výsledkom sa zobrazuje iba do jedného stĺpca.

Example

Toggle detail blok

Každý riadok môže mať svoj detail renderer.

Po definovaní bloku šablóny detail sa zobrazí pre každý riadok button detail.

Po kliknutí na tlačidlo sa načíta snippet s vykreslenou šablónou - samostatný riadok pod riadkom na ktorý bolo kliknuté.

Využitie

Mám zoznam faktúr. Všetky potrebné informácie sa mi do gridu nezmestia. Štandardne musím vytvoriť samostatnú stránku s náhľadom faktúry, presenter atď.

S touto úpravou definujem iba časť šablóny s detailom priamo do gridu.

Inšpirácia - detaily platieb v internetovom bankovníctve mBank.

Přidat data-sortable (reorder) pro normální (tam už to asi je - otestovat) i stromový výpis

tabulka bude mít data-sortable a data-sortable-url, na kterou bude posílat pole seřazených prvků podle atributu data-id, který má každá .

V případě tree view přesouvat i mezi rodiči - zasílat 1, pořadí a 2, parent id. V případě, že přesunu do prvního levelu, bude parent prázdný, ale pošle se.

Tree-view: Informácie o poradí sú nedostatočné

Jedno úrovňový zoznam

Odosielané informácie sú zbytočne príliš rozsiahle.

Metódou drag&drop sa vždy presúva presne jedna položka. Z toho dôvodu stačí odoslať primárny kľúč presúvanej položky a primárny kľúč položky pred ňou, nie je nutné odosielať poradie celého zoznamu.

Tree-view

V prípade tree-view sú informácie o presune položiek nedostatočné. Nezohľadňujú zanorenie.

Ako z toho von

Ideálne si predstavujem odosielať ako parametere:

• sort-id: Primárny kľúč presúvanej položky. Odosiela sa vždy.
• sort-parent: Primárny kľúč rodiča. Odosiela sa ak je položka zanorená v strome na inej ako prvej úrovni.
• sort-before: Primárny kľúč predchádzajúcej položky. Odosiela sa vždy ak nie je položka prvou v danej vetve.

Takto by bolo možné na strane servera upraviť poradie podla potreby s minimálnym množstvom prenášaných informácií, ale s dostatočnými informáciami pre určenie presnej polohy.

JS: Stromový výpis

1, Nějaká vtipná/skoro zanedbatelná animace načtení potomků a skrytí
2, Animace "caretu", který bude v tlačítku "načíst potomky"
3, Samotné pře-načítání rodiče, ještě doplním
4, Ještě doplním

Web: Demo inline editácie

Potešilo by demo inline editácie ;)

Doctrine data source

JS: každý ajax request propisovat do URL přes history API

Filtrace, stránkování, řazení, změna počtu položek na stránku - tyhle akce by měly probíhat ajaxově a propisovat se do URL, z jasného důvodu.

Sortable: Dotykové zariadenia

Sortable neviem použiť na mobile.

Zveřejnit až se vyřeší https://github.com/nette/latte/pull/95

nette/latte#95

Reset filter for "non remember state" filter

I have: Invalid argument supplied for foreach(), when I set $grid->setRememberState(false); and then tried to reset filter.

Udělat benchmarky rychlosti pro porovnání s ostatními gridy

Rozsiahlejšie možnosti vlastného renderu

Aktuálne je možné definovať vlastný render iba pre obsah bunky v štandardnom stave.

{define col-id}
    :)
{/define}

Bolo by fajn rozšíriť možnosti o:

• col-<id>-inline - šablóna inline editácie
• col-<id>-header - hlavička

Setter of default sort

Hey,
could you add $grid->setDefaultSort(); to allow default sorting?

3-stavový multisort

Každý stĺpec je po prvom kliknutí zoradený ASC, po druhom DESC a po treťom sa nezoraďuje.

Kliknutím na 1+N stĺpec sa nastavuje poradie zoradenia.

TreeView: Chevron icon is misplaced

Chevron icon is almost in the middle of the table with nothing to the left. Check the picture.

JS: auto-submit

Prvky (inputy) jako změna počtu položek na stránku, filtrování apod by se měly při změně autosubmitnout textové inputy filtrů s nějakým zpožděním - klasika.

Pridávanie nových záznamov

Inline pridávanie nových záznamov.

Použitie formulára z inline editácie v hlavičke/päte po kliknutí na pridanie záznamu + callback na uloženie.

Tree-view: Rozbalovanie prázdnych položiek

Mám položku, ktorá má v sebe zanorené ďalšie položky.

Ak z nej vyhádžem všetky podpoložky, stále zostane rodič s rozbalovacím tlačidlom.

Přidat DoctrineDataSource do dokumentace, vystavit na web s doctrine příklady.

Projet kód nějakým codecheckerem a linterem

Filter range

Je nejak možné filtrovať čísla/dátumy od-do, podobne ako cez TwiGrid?

Při refreshi url pomocí history api nenechávat bordel na konci

Wrong operator in documentation

Documentation
in Column Link.
instead of -> there is just -

How to add variable to template file?

Hi,
I want to add some variable to template file. It should be used here:

{extends $original_template} {define col-age} {$item} {$myOwnVariable} {/define}

Please, how to do it?
Maybe, it's beginners issue... sorry.

Thnx
Pavel

setDataSource() doesn't take array as argument

Hi there,
i tried:

public function createComponentSimpleGrid($name)
{
    $grid = new DataGrid($this, $name);
    $data = array("id"=> 1);
    $grid->setDataSource($data);
    $grid->addColumnText("id", "id");

}

but I am getting:

Argument 1 passed to Ublaboo\DataGrid\DataModel::__construct() must be an instance of Ublaboo\DataGrid\DataSource\IDataSource, instance of Ublaboo\DataGrid\DataSource\ArrayDataSource given

when i use this

$data_arr = array(
            0 => array(
                'id' => 5,
                'name' => 'Peter'
            ),
            1 => array(
                'id' => 5,
                'name' => 'John'
            ),
            2 => array(
                'id' => 5,
                'name' => 'Vern'
            )
        );

        $source = new ArrayDataSource($data_arr); //limitation for array

        $grid = new DataGrid($this, $name);

        $grid->setDataSource($source);
        $grid->addColumnText("id", "id");

I am getting

DataGrid can not take [Ublaboo\DataGrid\DataSource\ArrayDataSource] as data source. search► 

Group actions pro tree view

jQuery sortable způsobuje JS stack overflow - nebo tak něco.

DoctrineDataSource: Loading entities as array

So I found the problem we were talking about in #40,
you are getting doctrine data as an array which is wrong, entities aren't just packages of data, there are methods that supplement the data and those methods are needed.

I think DoctrineDataSource should be changed to return list of entities (objects) and for reading data, you should consider symfony/property-access.

Tree-view: Zanorenie do predvolene prázdnej položky

Položku nie je možné zaradiť do inej položky, ktorá pri prvotnom renderi neobsahovala potomkov.

Dibi fluent mssql data source

Předělat filtrovani date (date-range):

$this->data_source->where(
    'CONVERT(varchar(10), %n, 112) >= ?',
    $column,
    date('Ymd', $date_timestamp_from)
);

Column names not being translated

Column names are not being translated using provided translator instance.

Titulky sloupců pro tree view - jo/ne?

tfoot block

Bolo by možné pridať blok tfoot?

V rendereri stĺpcov by tak bolo možné nastaviť čiastkové výpočty a v päte vypísať sumár hodnôt a pod.

Vďaka!

Add option for custom name of handle for sorting

Because if you have more than one grid on page - you cannot handle it :)

Demo/Items per page: Error 500

When I choose All results per page on demo, server responds with error 500.

While I understand why this happens, it probably shouldn't on demo (It looks like it doesn't work, without any feedback to user).

Also, All is not translated, Vše is shown instead.

Vyřešit všechny @todo

Skrývanie/zobrazovanie stĺpcov

Use case:
Mám obrovské množstvo parametrov - potenciálne veľké množstvo stĺpcov. Každého klienta môžu zaujímať iné.
Grid obsahuje nastavenia a filtre pre všetky. V nastavení gridu je zoznam predvolene zobrazených stĺpcov.
Grid obsahuje komponentu (napr. checkbox dropdown list) so zoznamom všetkých definovaných stĺpcov.
Po označení/zrušení ktoréhokoľvek sa grid prekreslí podla nového nastavenia.
Poradie stĺpcov sa dá meniť - drag&drop.
Nastavenie sa ukladá do session.

Ak by som na toto poslal PR, bol by prijatý?

Sjednotit && dopsat doc blocks