[addon datagrid] DataGrid

PetrP napsal(a):

1] upravit distribuci, abych mohl snadno komponentu vzít a použít a nemusel řešit co je součásti examples a podobně (je to všechno na jedné hromadě).

Určitě nějaký ten archív přidám (snad i minified/compact verzi), ale až při dalším vydání archívu (který bude až to odladím na PHP 5.3), do SVN bych to necpal.
Mělo by stačit vzít celý obsah složky s komponentou, pak soubor se styly a JS a defakto všechny obrázky. Zbytek (styly ikonek, modely, …) je na uživateli a může si to udělat jak je libo.

2] solidně to zprovoznit i bez RobotLoaderu.
Já ho nepoužívám (mám rád jasno v tom co requiruju) a musím při vytváření componenty zavolat cca 15 souborů (DataGridRenderer.php , Columns/TextColumn.php, Filters/TextFilter.php atak dále).
Bylo by lepší tyto souboru _once volat v továrničkách jako DataGrid::addColumn().

Všechny requiry jsem v jisté fázi odstranil, protože je to cesta kompromisu (půjde tak datagrid použít jak s minified verzí Nette tak i s normální právě za pomoci RobotLoaderu).

3] více ActionColumn, třeba nějak podobně jako Groupu u Forms tedy:

$grid->addActionColumn('Edit');
$grid->addAction('Editovat', 'something', Html::el('span')->class('icon icon-edit'));

$grid->addActionColumn('Další blbosti');
$grid->addAction('Bafnout', 'something!', Html::el('span','Bafnout'));
$grid->addAction('Kouknout', 'something!', Html::el('span','Kouknout'));

$grid->addActionColumn('Del');
$grid->addAction('Vymazat', 'something!', Html::el('span')->class('icon icon-del'));

Tohle by byla větší úprava a zrovna zde by se chtělo zamyslet, jestli by si ActionColumn neměl držet své akce u sebe. Teď si jejich manipulaci obstarává sám DataGrid, protože jsem při návrhu nepočítal s tím, že by tuto funkčnost mohl někdo potřebovat. Dokonce metoda addActionColumn byla přidána až skoro nakonec, kdy bylo třeba mít možnost jí nastavovat vlastnosti jako ostatním sloupcům.

To samé se týká filtrů, které jsou nyní uchovány globálně v DataGrid-u, protože se mi zdálo přehlednější držet si vše v jedné komponentě a nemuset přemýšlet, v jakém objektu je co uložené.

S odstupem času se na to ale dívám jinak a to tak, že podkomponenty, které spolu logicky souvisí (sloupce → filtr, sloupec akcí → akce, zaškrtávací sloupec → jednotlivé Checkboxy), by měly být spolu provázány. Pokud by někdo tyto důvody neznal a pokoušel by si napsat vlastní vykreslovač, mohl by u toho narazit a tápat.

Třeba taková interní komponenta checker, která se ve výsledku jeví jako zaškrtávací sloupec, není interně uložena jako DataGridColumn a při vykreslování je přistupováno přímo k formuláři, který checkboxy obsahuje, což taky může být matoucí.

Jelikož se jedná jen o interní změny a spíš jde o čistotu návrhu a lepší čitelnost kódu, nechal bych to k diskusi. Jediná změna v API by byla, že by se akce přidávaly nad konkrétním sloupcem či k poslednímu přidanému jak píšeš, otázka je co by bylo vhodnější.

$grid->addActionColumn('nazev', 'Popisek')->addAction('Popisek', 'signal');

// či alternativně
$grid->addActionColumn('nazev', 'Popisek');
$grid['nazev']->addAction('Popisek', 'signal');

EDIT: od r36 implementováno.

4] DataGrid::addAction() aby jako 3 parametr přijímal i string, tedy

$grid->addAction('Editovat', 'something!', 'edit');
// až teď jsem zjistil že funguje toto:
$grid->addAction('Editovat', 'something!');
// takže tento bod beru zpět, zajímavé je že to není nikde napsané ;]

Ano, povinné parametry jsou pouze první dva, pokud se 3. neuvede, vygeneruje se obyčejný odkaz s textem, který je zadán v prvním parametru.

5] Ve formatCallback mít možnost se dostat i k dalším datům z načteného řádku z db, nejčastěji potřebuju id

	public function callbackUrl($value,$row)

6] Případně mít i možnost vytvořit Column bez návaznosti na záznam v db, a obsah buňky si udělat dle formatCallbacku. (souvisí s bodem 5)

// Momentálně mám třeba toto ošklivé:
$dataSource = 'SELECT id as url ....';
$grid->addColumn('url', 'Url')->formatCallback[] = array($this,'callbackUrl');
public function callbackUrl($id)
{
	return Html::el('a','odkaz')->href($this->link(':Neco:',array('id'=>(int) $id));
}

// Představoval bych si třeba něco takovéhleho
$grid->addBlankColumn('Url')->formatCallback[] = array($this,'callbackUrl');
public function callbackUrl($row)
{
	return Html::el('a','odkaz')->href($this->link(':Neco:',array('id'=>(int) $row->id));
}

// I když zrovna tohle by šlo mnohem lépe řešit přes více ActionColumn (viz bod 3)
$grid->addActionColumn('Url');
$grid->addAction('odkaz', ':Neco:');

Nad takto umělým sloupcem by jsi ale ztratil možnosti řadit a filtrovat, proto bych toto řešil úplně stejně jako píšeš – aliasem. V jedné z prvních implementací byl jako druhý parametr právě celý řádek, ale nenašel důvod ho tam nechávat. Spíše naopak, jako důvod proč ho odstranit posloužila úvaha, že se můžu dostat k datům, ke kterým by se komponenta dostat neměla – stačí předat datasource s výběrem všech sloupců tabulky uživatelů a můžu přistupovat třeba k heslům.

Úprava je to ale jednoduchá, stačí si ve vykreslovači v metodě pro generování řádku gridu přidat do volání formatContent nad sloupcem jako druhý parametr proměnnou $data.

EDIT: Od revize 34 přijímá callback jako druhý parametr aktuální řádek DibiRow z DB pro lepší vazbu:

$grid['name']->formatCallback[] = function($value, DibiRow $data) { ... };

7] nefunguje mi $grid->multiOrder = false;. Tedy představuji si že si pak budu moci vybrat jen jeden sloupec při řazení.

Nepozoruju žádný problém, když si stáhneš demo aplikaci, tak vše šlape? (3. grid má zaplé řazení podle jednoho sloupce).

8] a taky bych potřeboval někdy úplně zrušit možnost změnit řazení něco jako $grid->order = false;
Sice to jde vyřešit vlastním vykreslováním, ale tohle by to mohlo umět v defaultu.

To je fakt, zatím má každý DataGridColumn členskou proměnnou $orderable, kde se dá nastavit, jestli se podle něj může řadit.

EDIT: Od revize 35 má DataGrid možnost řazení globálně vypnout:

$grid->disableOrder = TRUE;

Díky moc za skvělou komponentu, a za to že je skoro všechno public nebo protected, a můžu si to dle libosti upravovat ;]

Díky za první věcný report ;)

Editoval romansklenar (17. 7. 2009 23:45)

Kým čím? :)

Honza M. napsal(a):

Inzou, diplomem. Z toho si nic nedělej :-D

Neocenil tě Inza, ale ocenila tě Nette Foundation. Diplom dostaneš na první PS které se budeš opět účastnit – IMHO ho má u sebe David. Ti jej pak předáme;-)

_Martin_ napsal(a):

Inza napsal(a):

…IMHO ho má u sebe David.

Neexistuje tu, byť jen nekonečně malá pravděpodobnost, že onen diplom se nacházel v tašce, o kterou David přišel na autobusovém nádraží…?

Cože!!!:-) Peklíčko… kdyžtak Ti Nette Foundation vydá nový;-)… ale doufejme že byl někde jinde, co Davide?;-)..

1. Převod času obstarává ta samá funkce jako template helper date, takže ano, měl by.
2. Akce se neváží k žádnému datovému sloupci a jsou globální pro celou tabulku. Pro tenhle případ máš dvě možnosti:
   1. úprava rendereru v místech kde se vytváří akce při generování řádku
   2. nebo jednodušeji stejně jako v příkladu upravit dotaz datasourcu, tak abys měl nějaké sloupce, kterých se ta akce týká a mohl s těmi sloupci dál pracovat a vytvořit ten odkaz nahrazením:

$el = Html::el('span')->style('margin: 0 auto');

$grid->addColumn('pujceno', 'Status'); // 0 = auto máme k dispozici, 1 = auto má někdo půjčeno
$grid['pujceno']->replacement[0] = Html::el('a')->setHtml(clone $el->class("icon icon-pujcit")->title("Půjčit"))->href(...);
$grid['pujceno']->replacement[1] = Html::el('a')->setHtml(clone $el->class("icon icon-vratit")->title("Vrátit"))->href(...);

$grid->addColumn('servis', 'Servis');
$grid['servis']->replacement[''] = Html::el('a')->setHtml(clone $el->class("icon icon-servis")->title("Servisovat"))->href(...);

Editoval romansklenar (9. 6. 2009 8:50)

romansklenar napsal(a):

1. Převod času obstarává ta samá funkce jako template helper date, takže ano, měl by.

Super a dá se použít i u DateColumn callback? Mám totiž v DB uloženy data jako timestamp v UTC a pak k němu přičítam (int)date("Z") podle toho v jakem pasmu je uzivatel.

2. Akce se neváží k žádnému datovému sloupci a jsou globální pro celou tabulku. Pro tenhle případ máš dvě možnosti:
a) úprava rendereru v místech kde se vytváří akce při generování řádku
b) nebo jednodušeji stejně jako v příkladu upravit dotaz datasourcu, tak abys měl nějaké sloupce, kterých se ta akce týká a mohl s těmi sloupci dál pracovat a vytvořit ten odkaz nahrazením:

Možnost za b se zda na prvni pohled super ale chci mít akce nad sloupečky „pohromadě“ ve sloupečku s akcemi a sloupeček status zobrazovat klasicky (půjčeno, servis…). A tak budu muset sáhnout po možnosti a a trochu to rozpitvat. Podědit DataGridAction rozšířit o addRule a v rendereru na to brát ohled. Btw nešlo by hodit renderování akcí do samostatné metody?

A ještě me při pátrání nedošlo jak docílit klasikého paginatorou (první předchozí 1 2 3 4 … n další poslední)

DataGrid je skvělá věc, která mi ulehčila mnoho práce. Přikládám jeden nápad na rozšíření, v praxi velmi dobře využitelný.

Příkladem je databázová tabulka, kde jsou umístěné články, které chci následně vypsat. Problém je, že je chci vypsat od nejnovějšího.

Momentální je stav takový, že je musím seřadit v dibi::dataSource() a tudíž toto řazení je uplatněno vždy, takže nemůžou být seřazeny podle titulku či podle autora manuálně v DataGridu. Stačilo by vložit jednu funkci pro definici defaultního řazení (->setOrder($column,DESC/ASC)).

V případě, že by uživatel řadil výsledky dle sebe, tak by se defaultní řazení nepoužilo (použilo by se jen v případě, kdy není uplatněno manuální řazení).

David Grudl napsal(a):

Inza napsal(a):

Cože!!!:-) Peklíčko… kdyžtak Ti Nette Foundation vydá nový;-)… ale doufejme že byl někde jinde, co Davide?;-)..

bohužel :-((

Epic peklíčko…:-((( – Nevadí Nette Foundation vydá nový;-)…

parada testol som to a zda sa ze to korektne funguje, este malickost , ked stlacim reset state do zobrazenych poloziek na stranku mi to hodi all, co nie je pozadovany stav, malo vy to hodit nastavnu polozku z
$grid->itemsPerPage

a dalsia malickost zakazat polozku all, mam v tbaulke 7000 a viac zaznamov cize nechcem aby nahodou user si dal listnut vsetky :D

Balvan napsal(a):

parada testol som to a zda sa ze to korektne funguje, este malickost , ked stlacim reset state do zobrazenych poloziek na stranku mi to hodi all, co nie je pozadovany stav, malo vy to hodit nastavnu polozku z $grid->itemsPerPage

Jo blbne to. A vypadá to, že jen když člověk nezmění výchozí hodnotu (nenastavím sám $grid->itemsPerPage) :) takže zatím takový malý workaround než to fixnu.

a dalsia malickost zakazat polozku all, mam v tbaulke 7000 a viac zaznamov cize nechcem aby nahodou user si dal listnut vsetky :D

Jde nastavovat dle libosti:

$grid->displayedItems = array(5, 15, 50);

Prednastavene hodnoty filtra, nie tie ulozene ale pri prvom zobrazeni aby mi rovno odfiltroval pozadovany stav

priklad datepicker → defvalue nastavim dnesny datum a aby user ked tam pride rovno mal vybrane zaznami za dnes

ale to su uz len malickosti

Jo to je pěkná feature, zkusím zapracovat.

Editoval romansklenar (22. 6. 2009 17:50)

Takovej malinkatej bugreportik k stable verzi (tedy jestli to je ta která je ke stažení v extras):

// DataGridRenderer::getWrapper()
$pattern = '/(?<attr>[\w]+)="(?<value>[\w|\s|_| |-]+)"/i';
// vyhazuje v php 5.2.1 tuto chybu (neděje se v novějších verzích php)
// Warning:  preg_match_all() [function.preg-match-all]: Compilation failed: unrecognized character after (?< at offset 3 in ...

// když přidáp za ? Péčka tak funguje jak má
$pattern = '/(?P<attr>[\w]+)="(?P<value>[\w|\s|_| |-]+)"/i';

Týká se jenom stable verze, na google code bylo v revizi 26 předěláno na nové Nette\Html

Nevím jestli to budeš předělávat nebo raději vydáš tu betu ;] Nicméně to sem píšu, případně i pro někoho cizího.

PetrP napsal(a):

Nette\Web\Html podporuje už více tříd v továrničce el nativně, takže tato část kódu z rendereru úplně zmizí.

honzakuchar napsal(a):

Je tam několik řetězců, které jsou přímo zadrátované v rendereru, chybové hlášky zase v samotné tříde DataGrid. Ale ty nové verze nevycházejí tak často pokud se nebavíme o svn, ale o archívu v extras. Takže bych to neviděl zase jako problém to občas počeštit :)

Pokoušel jste se někdo o implementaci ImageColumn? .. jde mi např. o načítání obrázku z databáze..
Jak byste řešili toto:

<?php

$grid->addImageColumn('nahled_foto', 'Náhled' );
 ?>

a v ImageColumn něco takového:

<?php

public function formatContent($value)
	{
		$image = Image::fromString($value);

		return $image;
?>

Editoval Oggy (29. 6. 2009 23:01)

Jak vypisu do datagridu sloupec z databaze, kde mam ulozeny odkazy napr http://www.google.com aj. tak aby ve vykreslene tabulce byly odkazy klikaci s danym url?

dotTwelve napsal(a):

Jak vypisu do datagridu sloupec z databaze, kde mam ulozeny odkazy napr http://www.google.com aj. tak aby ve vykreslene tabulce byly odkazy klikaci s danym url?

$grid['odkaz']->formatCallback[] = 'nejakaFunkce';

function nejakaFunkce($value)
{
	return Html->el('a','odkázek')->href($value);
}

Přepisuješ konstruktor Controlu a nevoláš ho :) Teda aspoň přesně takhle se to u mě projevuje, pokud toto neudělám…

public function __construct($parametry) {
  parent::__construct();
  ...
}

BTW: Neměl by být ten link spíš ?key=22&do=zakazkaDelete ? Ale nevím, s datagridem jsem ještě nedělal.

Editoval LastHunter (3. 7. 2009 8:20)

No té komponenty, ve které máš ten kód public function handleZakazkyDelete($key) { .... (Asi Datagridu?)

Editoval LastHunter (3. 7. 2009 20:31)

jak to řešítě vy?

Plánuje sa v blízkej dobe robiť aj verzia pre php 5.3? Dosť by sa mi to zišlo, keďže všetky nové projekty už väčšinou robím len v tejto verzii.

Což není moc košér vůči MVC tahat název atributu z db do presenteru nebo controlu, takže doporučuju si dotaz připravit už v modelu a atributu, který použiješ jako keyName dát alias (třeba onen univerzální název parametru key).

Ted nevim, jak to vypada v datagridu, ale nebylo by jednodussi uz v datagridu si to prepsat jako key s tim, ze keyName by se nastavovalo porad stejne?

<?php
$grid->keyName = 'id_record';
/*
 ... uprava v datagridu ...
generovani odkazu -> link($destination,array('key' => $this->keyName));
*/
function handleSomething($key){..}
?>

Me se to zda jako jednodussi zasah, nez v modelu prepisovat SELECT *,id_record as key .... Jediny problem je se zpetnou kompatibilitou :(

Pravda, je to subjektivni, pouzivam totiz v administraci routu primo s id, takze ja jsem si metodu generovani odkazu v akcich prepsal.
Mozna by to slo snadno vyresit pomoci napr

<?php
$grid->oneKey = TRUE;
// popr
$grid->renameKey = 'key';
?>

nebo nejaky jiny vhodnejsi nazev, ktery by menil chovani gridu na generovani jednotneho klice.

A samozrejme taky ti chci podekovat za zverejneni tehle skvele komponenty :)

Editoval insider (6. 7. 2009 17:05)

Když to voláš, tak ještě není asi formulář datagridu vytvořen (ten se vytváří až při vykreslování), takže změnit se dá přes katalogový soubor gettextu a jeho překompilováním.

Má to svůj důvod (pokud by se ti to chtělo zkoumat tak to souvisí s detekcí signálů a odeslání formuláře), ale chápu, že by to tak být nemělo a snažím se přijít na nějaké řešení.

Díky, určitě se u toho inspiruji při přepisování do PHP 5.3. Můžu dát link na stažení i na stránku dokumentace?

Vrátil jsem se ještě k tomu problému, který popisuješ výše:

$form = $grid->getForm();
$form['operationSubmit']->getControlPrototype()->style("color: red");

A funguje to, jen to musíš použít nejlépe až těsně před voláním addComponent() v továrničce, protože jinak opravdu můžeš přistupovat ke komponentě, která neexistuje (uživatelská chyba). Nejspíše jsi to zavolal před $grid->allowOperations(), kdy ještě nemusí být ani formulář ani tlačítko vytvořeno (záleží na pořadí volání příkazů v továrničce).

Proto nejlépe až před voláním addComponent() což by měl být poslední řádek definice datagridu v továrničce – v tu chvíli už jsou vnitřní komponenty (filtry, zaškrtávací pole, tlačítka) formuláře vytvořeny.

Editoval romansklenar (8. 7. 2009 11:17)

PetrP napsal(a):

dotTwelve napsal(a):

Jak vypisu do datagridu sloupec z databaze, kde mam ulozeny odkazy napr http://www.google.com aj. tak aby ve vykreslene tabulce byly odkazy klikaci s danym url?

$grid['odkaz']->formatCallback[] = 'nejakaFunkce';

function nejakaFunkce($value)
{
	return Html->el('a','odkázek')->href($value);
}

Klikaci odkazy mi to negeneruje, zkoušel jsem kod:

function nejakaFunkce($value)
{
        return Html::el('a','odkaz')->href($value);
}

$grid->addColumn('www', 'URL');
$grid['www']->formatCallback[] = 'nejakaFunkce';

Funguje vam to?