ublaboo/datagrid: mocný, rychlý, rozšiřitelný, hezký, anglicky dokumentovaný datagrid

Ahoj,

narazil jsem na par veci:

• hideable columns nefunguji s setRememberState(FALSE)
• schovani / zobrazeni sloupce resetuje filtry
• kdyz je pouzit outer filtr, tak se filtr zobrazuje i kdyz je sloupec schovan

Diky!

@Blujacker 1, Ano, Datagrid::setRememberState(FALSE) sdělí datagridu, aby přestal pracovat se session, tudíž se nemá kam ukládat informace o skrytých sloupcích.

Jaké navrhuješ řešení? Vyhazovat nějakou notice, pokud chce uživatel skrývat sloupce bez session? Nebo zkusit vynutit jiné úložiště při zákazu použití session, třeba cache?

2, Jakou verzi používáš? Máš aktuální assety? Na webu dokumentace (ublaboo.org/datagrid) je vše v pořádku.

3, Hmm, toje otázka – schovat, neschovat? Přeci jde o filtr, ne o sloupec.

@igor.pocta Děkuji za report, opravím.

@david.zlaty Ty používáš ArrayDataSource?

@david.zlaty Vysvětlím, proč je tomu tak.

1. V url je něco jako ?do=mujGrid-inlineEdit
2. Nette chce vytvořit mujGrid, tak zavolá tvoji továrničku
3. Tvoje továrnička vytvoří instanci datagridu, nastaví datasource, sloupce a filtry
4. Tvoje továrnička vrátí datagrid
5. Nette nad vrácenou komponentou zavolá ::handleInlineEdit, to asi zavolá nějaké tvoje callbacky
6. Vykreslí se datagrid

Už je jasno? Datasource se nastavuje ještě před přidáním záznamu. Což je problém, pokud používáš ArrayDataSoure. Pokud bys používal cokoliv jiného, tak by se data tahaly „líně“ až při načítání dat.

Z principu to nelze řešit jinak. Takže:

1. Bu'd si uděláš nějaký datasource, který bude „líně“ vracet data.
2. Použiješ jiný datasource
3. Třída InlineEdit má event ::$onCustomRedraw, do něj si přidej svůj callback. V něm můžeš znovu nastavit datasource (již aktuální) a udělat to, co by jinak udělal datagrid – překreslil změněný řádek: https://github.com/…DataGrid.php#…
4. Nastav datasource znovu ještě jinak, například v eventu DataGrid::$onRender.

@Barvoj Ano. Je to chyba v UI\Control. Buď pošli PR, kde bude místo $this->getTemplate()->add('rows', $rows); $this->getTemplate()->rows = $rows;, nebo si aktualizuj Nette na 2.4 :D (tuším, že už je to tam opraveno).

@flamengo Ahoj.

1. Ano, DataGrid::getPaginator()->setTemplateFile(...)
2. Ano, ideálně si vytvoř třídu DataGridFactory, kterou si budeš předávat do presenterů/komponent, kde datagrid využíváš a tam místo new DataGrid budeš volat $this->datagridFactory->create($this, $name). Právě v této factory budeš dělat něco takového:

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

$grid->setTemplateFile(...);

return $grid;

3. Ano, viz dokumentace: http://ublaboo.org/datagrid/column#… :)

@flamengo EDIT: Pleteš asi víc věcí dohromady. Ty jsi chtěl vytvářet funkcionalitu metody v Interface, to v PHP nelze… To může dělat třída, která Interface dědí.

Doporučuji přečíst (celý článek): https://doc.nette.org/…n/components#…

Buď můžeš vytvořit komponentu takto:

My Presenter
{
	public function createComponentGrid()
	{
		$grid = new DataGrid;

		return $grid;
	}
}

nebo takto:

My Presenter
{
	public function createComponentGrid($name) // $name = 'grid'
	{
		$grid = new DataGrid($this, $name);
	}
}

Všimni si, že už u druhého příkladu nemusíš uvádět return statement. Proč – to se dozvíš ve výše zmíněném článku. Jde o moment, kdy se komponenta přiřazuje k rodiči (jiné komponentě/prsenteru). A pokud bych měl u obou příkladů použít factory na grid, bude to vypadat asi takto:

Buď můžeš vytvořit komponentu takto:

My Presenter
{
	/**
     * @var GridFactory
     * @inject
     */
	public $gridFactory

	public function createComponentGrid()
	{
		$grid = $this->gridFactory->create();

		return $grid;
	}
}

class GridFactory
{
	public function create()
	{
		return new \Ublaboo\DataGrid\DataGrid;
	{
}

nebo takto:

My Presenter
{
	/**
     * @var GridFactory
     * @inject
     */
	public $gridFactory

	public function createComponentGrid($name) // $name = 'grid'
	{
		$grid = $this->gridFactory->create($this, $name);
	}
}

class GridFactory
{
	public function create($parent, $name)
	{
		return new \Ublaboo\DataGrid\DataGrid($parent, $name);
	{
}

V tomhle případě ta factory nepotřebuje žádné závislosti, tak nemusíš řešit žádný Interface..

Editoval Pavel Janda (11. 8. 2016 11:20)

Ahoj,
otázka ohľadom addColumnLink a addAction – je možné (ako ?) nastaviť parametre params, ktoré by mali parametrizovať výsledný href odkaz tak, aby som do nich dostal vlastné parametre, resp. nečerpané zo stĺpcov DataGridu ?

<?php
$grid = new DataGrid($this, $name);

$grid->setDataSource($this->structure->articles);

$grid->addColumnText('id', '#ID', 'id');

// vysledny link = cms.cms-administration/edit/15
$grid->addColumnLink('articleLabel', 'Article Label', ':Cms:CmsAdministration:edit', 'label', [ 'id' => 'id'] );

// vysledny link = cms.cms-administration/edit/15
// 'type' => 'article' je ignorovane
$grid->addColumnLink('articleLabel2', 'Article Label', ':Cms:CmsAdministration:edit', 'label', [ 'id' => 'id', 'type' => 'article'] );
?>

Občas je potreba link vytvoriť trochu custom, napríklad pridanie konštanty, ktorá v datagride nie je definovaná, čo je vlastne aj prípad kedy som narazil na tento problém. Pridanie columnLinku articleLabel2 teda ignoruje parameter ‚type‘ ⇒ ‚article‘ a výsledný odkaz je potom totožný ako columnLink articleLabel.

ublaboo/datagrid v4.4.9
nette/application v2.3.13

Ďakujem

Editoval unnamed21 (11. 8. 2016 23:39)

Ahoj,
existuje, nebo bude existovat nějaká podpora pro Paginator ?
Bez toho nefunguje stránkování s Doctrine správně :(

Pavel Janda napsal(a):

@esorimer Tento datagrid tebou zmíněný Paginator používá. Viz:
count: https://github.com/…taSource.php#…
limit: https://github.com/…taSource.php#…

Ten limit právě nefunguje správně.

Mám tabulku A, která má vztah 1:M s tabulkou B.
Když udělám dotaz, kde chci vše z A, co má konrétní záznam z B (B.id = 123),
uká že mi DataGrid výsledek „Zobrazuji 1–5 z 9 záznamů“ (Žádné stránkování,přičemž limit je na dataGridu nastaven na 10).

Tj. správně to ukáže, že má zobrzit 9 záznamů, ale zobrazí to jen 5.

To je proto, protože 5 záznamů z A má (v průměru) dvě relace s B, tj. po JOINu zaberou dohromady 10 řádků – limit datagridu).

Edit:
Tak když nahradím tuto řádku https://github.com/…taSource.php#L99
za return new Doctrine\ORM\Tools\Pagination\Paginator($this->getQuery());
tak to funguje správně. Takže díky za nápovědu :)

Editoval esorimer (17. 8. 2016 14:48)

Koukám na příklad s tree-view a moc nerozumím dotazu
$join = $this->db->select(‚id, parent_category_id‘)
->from(‚ublaboo_category‘)
->groupBy(‚parent_category_id‘);

To přece nemůže fungovat.:-) Díky

@PavelJanda myslím že @rumcais1 naráží na to, že se používá GROUP BY aniž by se selectovala nějaká agregovaná funkce.

@PavelJanda

Můžeš poslat PR. :)

Když to já bohužel neumím a nerad bych něco pokazil :(

4. Na webu dokumentace ho nevidíš? (http://ublaboo.org/datagrid), vpravo dole, velké červené tlačítko s nápisem RESET FILTER

Reset tlačítko je vidět až v případě, že je nějaký filtr aktivní jsme zjistil. Nicméně já pouze potřebuji resetovat způsob řazení položek na výchozí, nikoliv filtrování.
Přijde mi to dost důležité kvůli tomu, aby si uživatel mohl řazení vyresetovat a vidět tak, v jakém pořadí se položky zobrazí na front-endu. Dodělal jsem si metodu a v šabloně k tomu odpovídající tlačítko:

public function handleResetSort(){
	$this->page = 1;
	$this->saveSessionData('_grid_page', 1);
	$this->sort = $this->default_sort;
	$this->saveSessionData('_grid_sort', $this->sort);
	$this->reload(['grid']);
}

5. Pokud má sloupec takovýto příznak, tak po každé směně řazení podle tohoto sloupce se uživatel octne na první stránce.

Ať testuji jak testuji, tak opravdu mi to nefungovalo jak by mělo. Nakonec záhada odhalena. V metodě handleSort() se reloaduje pouze snippet table, Chce to přidat

$this->reload(['pagination']);

nebo překreslit celý grid.

ŠABLONA PAGINATORU
Ještě dotaz k šabloně paginatoru. Asi to zase bude nějaká hloupost. Pokud jsem oprpavil zdroják (výše), tak vše funguje pouze v případě původní šablony. Jakmile dle kódu níže načtu svou šablonu (i když je identická s původní), tak se paginator nepřekresluje a nefunguje ani překlad translator. Netuším, čím by to mohlo být.

use Ublaboo\DataGrid\DataGrid;
class DataGridFactory{
	/** @return DataGrid */
	public function create($parent, $name = 'grid'){
		$grid = new DataGrid($parent, $name);
		$grid->getPaginator()->setTemplateFile(__DIR__ . '../moje/data_grid_paginator.latte');
		return $grid;
	}
}

SLOUPEC TYPU „TIME“
Dále jsme narazil asi na chybu, nebo opět dělám něco špatně.

MySQL tabulka:

CREATE TABLE dates (
id int(11) UNSIGNED NOT NULL,
date date DEFAULT NULL,
time_from time DEFAULT NULL,
time_to time DEFAULT NULL
) ENGINE=MyISAM DEFAULT CHARSET=utf8 COLLATE=utf8_czech_ci;

INSERT INTO dates (id, date, time_from, time_to) VALUES (1, ‚2016–11–11‘, ‚23:59:00‘, ‚00:00:00‘);

A chci zobrazit sloupec typu „time“:

$grid->addColumnDateTime('time_from', 'forms.inputs.time_from');

Zobrazí se chyba:
Warning
DateTime::createFromFormat() expects parameter 2 to be string, object given

File: …\ublaboo\datagrid\src\Utils\DateTimeHelper.php:28

23:        public static function tryConvertToDateTime($value)
24:        {
25:            /**
26:             * Try to convert string Y-m-d to DateTime object
27:             */
28:            $date = \DateTime::createFromFormat('Y-m-d', $value);

EDIT:
Při pokusu zobrazit sloupec „time“ jako text:

$grid->addColumnText('time_from', 'forms.inputs.time_from');

Warning
htmlspecialchars() expects parameter 1 to be string, object given

File: …\vendor\latte\latte\src\Latte\Runtime\Filters.php:47

43:        public static function escapeHtmlText($s)
44:        {
45:            return $s instanceof IHtmlString || $s instanceof \Nette\Utils\IHtmlString
46:                ? $s->__toString(TRUE)
47:                : htmlSpecialChars($s, ENT_NOQUOTES, 'UTF-8');

Nevíš prosím, co je špatně?

Předem díky moc.

Editoval flamengo (18. 8. 2016 13:26)

Pavel Janda napsal(a):

@esorimer Díky za upřesnění. Nechtěl bys poslat PR, který by přes nějaký setter DataGrid řekl doctrine datasourceu, aby používal ten paginator, jak píšeš? Tedy že by by default používat stávající verzi, ale uživatel si mohl volit i tebou zmíněnou?

No já tomu zas tak moc nerozumím. Nevím např. k čemu je tam to $this->data. $data je protected a nikde se do něj nepřiřazuje. Dle té poznámky ve funkci getData() to vypadá, jako by to někdo chtěl řešit v potokovi, ale kdo ví.

Já to vyřešil jednoduše rozšířením DataGridu a DoctrineDataSource:

<?php

namespace App\Lib;

use Ublaboo\DataGrid\DataGrid as DG;
use Ublaboo\DataGrid\DataSource\DoctrineDataSource;

class DataGrid extends DG
{
    public function setDataSource($source) {
		return parent::setDataSource(new DoctrinePaginator($source, $this->primary_key));
    }
}

class DoctrinePaginator extends DoctrineDataSource
{
	public function getData() {
	    return new \Doctrine\ORM\Tools\Pagination\Paginator($this->getQuery());
	}
}
?>

Asi by nebyl problém přidat nějaký flag do konstruktoru DoctrineDataSource, ale kvůli „primary_key“ parametru by nebylo hezký, aby ho musel programátor sám instanciovat.
Možná bych na to vytvořil nějakou hloupou obálku, něco jako:

<?php
class Ublaboo\DataGrid\DoctrinePaginator {
    public function __construct(QueryBuilder $qb) {
        $this->qb = $qb;
    }
	//...
}
//.... a pak v konstruktoru Ublaboo\DataGrid\DataModel přidal podmínku:
if($source instanceof DoctrinePaginator) {
		$source = new DataSource\DoctrineDataSource($source->getQueryBuilder(), $primary_key, $usePaginator=TRUE);
}
?>

…

@iNviNho Dej si někam do JS souboru:

$.nette.ext('bootstrapSwitch', {
	success: function(payload) {
		$('.bootstrapSwitch').bootstrapSwitch();
	}
});

Co se stane: Určitě používáš (používá to i ublaboo/datagrid), nette.ajax.js (https://componette.org/search/?…). Kód výše ti po dokončení nette ajax requestu inicializuje ty switche.

Editoval Pavel Janda (18. 8. 2016 20:38)

@mirek.vales Používáš ArraDataSource, že? :P

Pavel Janda napsal(a):

@mirek.vales Doporučuji přečíst si tento a po něm jdoudí 3 komentáře: https://forum.nette.org/…any-datagrid?p=10

Moc díky za rychlou reakci. ArrayDataSource jsem nepoužíval. Pomohla funkce onCustomRedraw (viz.poslané 3 komentáře), kdy mi nedošlo, že po uložení dat do databáze je pro opakované zobrazení ve stránce ještě musím znovu načíst z databáze (a následně volat invalidaci snippetů).

			$grid->getInlineEdit()->onCustomRedraw[] = function() use ($grid) {
				$grid->setDataSource($this->db->query('SELECT id,name FROM myTable')->fetchAll());
				$grid->redrawControl();
			};

Zdravíčko! Předně děkuji za skvělý datagrid, je to fakt pecka! :)
Mám dotaz, je možné používat MultiSelect i na sloupec, který má hodnoty NULL v databázi?

Konkrétně vypisuju kategorie, do kterých patří produkty z e-shopu, ale některé produkty nemají kategorii (mají NULL hodnotu u kategorie). Chtěl bych, aby bylo možné filtrovat i produkty bez kategorie, ale pokud filtruju produkty Bez kategorie následujícím způsobem, filtr pro NULL hodnotu nefunguje resp. zobrazuje stále všechny produkty:

$categories = $this->db->table('eshop_categories');
$categoryMap = [];
foreach ($categories as $category) {
    $categoryMap[$category->id] = $category->name;
}
$categoryMap[null] = 'Bez kategorie';
$grid->addColumnText('category', 'Kategorie')
    ->setReplacement($categoryMap)
    ->setFilterMultiSelect($categoryMap);

Ahoj, už tu byl dotaz na link s parametrem/parametry a odpovídal jsi že se dá použít custom renderer, bohužel když ho takto použiju, celý html prvek <a> se vypíše jako text, dá se tomu nějak zabránit ? či je jiný způsob vytvoření custom linku ?

<?php
$grid->addColumnLink('now', 'Vytvořeno', 'Action:edit' , 'now', ['id' => 'row_id'])
		->setRenderer(function($row)
			{
			$test = "<a class='' href='/action/edit/".$row->row_id."?backlink=xyzž'>".$row->now."</a>";
             return $test;
			})
?>

@ftcp nešlo by to obejít vytvořením Nette\Utils\Html objektu? + použít nette generátor odkazů

Editoval CZechBoY (24. 8. 2016 11:12)

Přiznávám, že střílím od boku, ale tipnul bych si: co je před první tečkou, použije se jako doména, tj. název neon souboru bude ublaboo_datagrid.%locale%.neon, no a zbytek je cesta v poli – v tomto případě tedy bude jednorozměrné:

save: Uložit
cancel: Storno
...

Používám jako datasource Yetorm a v entitě mám funkci getProductsWithBrand() vracející počet produktů
Jak můžu tuto hodnotu přidat do datagridu, nevím jak k ní přistoupit v funkci addColumnText

$grid->addColumnText('co tady?', 'Počet produktů');

Podobný problém mám i když chci ziskat jen odkaz na jinou entitu. řešení jako je v dokumentaci pro Doctrine mi nefunguje(nezna sloupec).
Děkuji za pomoc

Editoval Domki (24. 8. 2016 20:48)

Ok s gitem ale tolik neumím, takže uplně moc nevím kde založit issue?

Ono já tedy teď používám přes getTable z YetOrm ActiveRow, protože jako datasource nešel YetOrm přidat. Což mi bylo poraděno cca před měsícem tady.

Pavel Janda napsal(a):

@Domki To bude pravděpodobně tím, že pro doctrine (, nextras a leanmapper) entity jsem implementoval lehce širší property access věc. Můžeš poslat PR s přidáním yetorm-related-stuff. A nebo založ issue, popiš v ní, jak se chovají entity v yetorm (nebo přilož nějakou dokumentaci) a já se na to o dovolené podívám. :)

Určitě bude dobré to přidat.

Editoval Domki (25. 8. 2016 10:44)

Jo já vím již dříve jsem se tu ptal jestli je možnost využívat YetOrm a entity, co jsem pochopil, tak jako datasource yetorm nelze využít.
Pak mi @PavelKravčík napsal že můžu použít převod getTable na Selection.
Ale pak nevím jak přidat sloupce z jiných tabulek propojených cizím klíčem. (Právě v entitě využívaných danou funkcí). Jestli je nějaká možnost když Yetorm(entitu) převedu na NDBT/Selection?

Nebo možno přidat podporu i přímo pro Yetorm?

@PavelKravčík

Pavel Janda napsal(a):

@Domki Aha, ale pokud používáš jako datasource NDBT\Selection, pak nepoužíváš entity.

@Domki Ano, přesně jak zmínil @PavelKravčík – pokud chceš položit složitější dotaz přes NDB::query(), použij zmíněný ublaboo/datagrid-nette-database-data-source. Dovolí ti složité dotazy a přitom se nebude fetchovat do paměti celá databáze :) .