Gridito (falešný datagrid) – komponenta

DibiDataSource nebo fluent ?

wunderbar, bring it on!

Honza Marek napsal(a):

Falešný datagrid je budoucí konkurenční produkt k datagridu od Romana Sklenáře. A už se můžu pochlubit demem na http://griddemo.janmarek.net/document_root/.

Proč to vyvíjíš „znova“? Ono je to postavené na PHP 5.3…?

Lopata, despiq:

Můžete kouknout zhruba, jak se ten grid definuje: https://gist.github.com/346294

Oproti „velkému datagridu“ pro vlastní vykreslování buněk nebo vytvoření funkčních tlačítek potřebuju mnohem méně kódu. Nemusim definovat signály nebo zakládat šablony pohledům s formulářema na upravení či založení nového záznamu.

Dalším plusem mého řešení je témovatelnost pomocí jQuery UI a nezávislost na DibiDataSource.

Abych to shrnul, cílem není okopírovat kompletní funkčnost Romanova datagridu, ale abych já měl jednodušší práci, když budu vyrábět nějaké administrační rozhranní.

Je to venku: https://github.com/…arek/Gridito

A jede to i na PHP 5.2, když se tomu trošku pomůže :)

Spokojen nejsem, ale teď jsem měsíc nebyl schopen naprogramovat ani čárku. Z velkejch věcí určitě budu potřebovat filtry a pak pár nějakejch detailů. Jinak nejsem moc spokojen s tím „CRUDem“. Když odešlu chybně vyplněný formulář a neodchytí to JS, tak přijdu o data. Ale tohle je bohužel koncepční, nikoliv implementační záležitost, takže řešení se musí vymyslet, nikoliv naklepat.

Měl bych ještě jeden dotaz: přidal jsem jeden formulář ke Griditu (předtím jsem používal Gridito jen read only) a celkem jsem se divil adrese: nazevKomponenty-toolbar-1-token=865f…(zbytek toho hausnumera). Co je to za token? Co umožňuje? Je citlivý?

Aha, takže ve chvíli, kdy se ten token dostane do URL, přestává být citlivý, že? Pokud to dobře chápu, tak tím pádem se nemusím bát potenciálních odkazů ven z cílové stránky.

Ještě bych měl menší kritiku: mezi jednotlivá tlačítka by se hodilo nějaké whitespace, bez stylů to pak může bypadat jako jedno slovo, což není dobře.

Buď mi to pošli nebo na githubu vyrob fork.

v6ak napsal(a):

Fork you! ;-)

Super,

Měl bych pár dotazů k implementaci:

• Gridito\IModel::setSorting(…) má počítat jenn s řazením podle jednoho sloupce?

Ano. Pro uživatele je řazení podle jednoho sloupce většinou lepší. Pokud budu implementovat řazení podle více sloupců, asi přidám metodu setMultiSorting nebo něco takového.

• Má Gridito\IModel::setupGrid(Gridito\Grid) dělat i něco kromě nastavení primárního klíče?

Můžeš si tam dělat co chceš. Slouží to k libovolné inicializaci komponenty.

Chtěl bych, aby se na mě sesypala kritika za Gridito\IEditableModel a použití ArrayAccess včetně návratových hodnot (vizte Gridito\DibiEditableModel). Je to ještě OK, nebo radši k tomu nemám ohýbat ArrayAccess a definovat vlastní metody? Anebo to mám udělat ještě jinak? Variantu použít IModel a k tomu nějaký IEditableRecord jsem zavrhl kvůli vetší volnosti, byl by k tomu potřeba ohýbat např. i Ormion, což nechci.

Neměl jsem čas to zatím prozkoumat, ale jinak bych asi ArrayAccess v tomhle případě nepoužil.

Měl bych drobnou výhradu k názvu IModel – možná by to mělo být spíše IRepository.

Proč?

Dále bych měl určitou výhradu k tomu, že IModel je ohledně stránkování apod. brán jako mutable. To znamená, že je vpodstatě potřeba pokažé vrátit novou instanci.

Asi nerozumím.

Dále jsem proti generování ID v podobě ++$this->toolbarButtonId. Takto někomu pod rukama přehodím pořadí tlačítek (třeba zveřejnit vs. smazat) a je v háji. Asi by to chtělo explicitní uvádění id.

Možná by to šlo nějak volitelně.

Pak bych měl i jedno řešení potenciálních problémů: Gridito mi nechtělo stránkovat. Zjistil jsem, že v @layout.phtml (víceméně původní ze skeletonu) je k {include #content} potřeba přidat zavináč.

Jasně, je to komponenta, která používá ajax.

Jo, do názvu tématu PLS přidej i název ‚Gridito‘, třeba i „Gridito – Falešný datagrid – komponenta“.

ok

Já právě uvažuju o implementaci :)

No, částečně. Napsal jsem https://gist.github.com/430117 (na Windows jede pod Cygwinem), udělal pár ručních úprav (potřeboval jsem honem funkční Gridito) a tím to skončilo. Doma asi napíšu nějaký lepší skript. A pokud se budu nudit, implementuji i překlad anonymních funkcí na třídy, takže půjde přeložit i EditableGrid apod. BTW: On ten trochu lepší nástroj by mohl sloužit i k opačné portaci. A vlastně by se mi to asi taky hodilo.
Jinak, vzpomínám si na tyto ruční úpravy:

• Přejmenování Button na Gridito_Button (kolize s \Nette\Forms\Button)
• Názvy tříd s tlačítky byly ve stringu, asi ve třídě Grid. Bylo z nich potřeba odstranit namespace.
• V nějakých renderovacích metodách tlačítek a asi i třídy Grid bylo potřeba se vyhnout použití method chainingu. Ale to jsem možná jen měl starou verzi Nette.

Pokud to chceš honem udělat, použij ten skript. Co bude potřeba dodělat, o to se PHP brzy přihlásí chybovou hláškou.

Tak na vyzkoušení můžeš použít i PHP 5.3.

Já bych teď asi už začal na autoportaci pro PHP 5.2. Pak bych jednu nezveřejněnou třídu z 5.2 upravil pro 5.3. Pak bych měl asi nějak sloučit svůj fork a upravit všechny modely kvůli jednomu menšímu BC breaku – jak to na GITu udělat co nejčistěji?

Jinak BC breaky – nedávno byl jeden BC break v IModelu, ale nevím, jaké jsou další plány Honzy. Já navrhoval změnu identifikace tlačítek („Dále jsem proti generování ID v podobě ++$this->toolbarButtonId. Takto někomu pod rukama přehodím pořadí tlačítek (třeba zveřejnit vs. smazat) a je v háji. Asi by to chtělo explicitní uvádění id.“), která by sice bez BC breaku šla, ale bylo by to dost kostrbaté. Nechci se do toho pouštět sám, protože řešením bez Honzova souhlasu bych riskoval vývoj dvou vzájemně nekompatibilních větví.

<EDIT n=„1“>Jo, asi časem upravím trošku IEditableModel tak, aby nepoužíval ArrayAccess.</EDIT>

Šířka jednotlivých sloupců – zajímavá poznámka, mělo by jít stejně jako barvení sudých a lichých řádků (vlastní šablonou), ale bylo by možná vhodné mít příjemnější cestu. Nechceš přiložit ruku k dílu zde?

<EDIT n=„2“>Jo, ještě by bylo asi dobré vymyslet nějaký dobrý způsob, jak předávat šablonám parametry tak, aby:

• šlo využít nápověd IDE
• šablona mohla mít svoje specifické vlastnosti
• dědičnost nebyla zneužita

Co říkáte na toto?:

$grid->setTemplate(MyGreatGridTemplate::create()->setFoo(12)->setColumnSize('foo', '64px'));

Další věc je, že by se dalo toto nějak zakomponovat do Honzova návrhu o nastavení Gridita v šablonách . Bylo by to cooler.
</EDIT>

Editoval v6ak (22. 9. 2010 8:37)

1. Bug report: v OrmionModel jsou špatně parametry u metody setLimit (přebývá offset).
2. Feature request, dotaz: nebylo by lepší ukládat řazení a stránku do fragmentu? Uřivatelsky mi přijde lepší, když jsem se někam dolistoval, dám F5, ale nehodí mě to za defaultní pohled.

Jestli to budu hodně potřebovat, tak to možná někdy v budoucnu udělám. Proto by mě ještě zajímalo – neplánuje se toto řešit nějak centrálně v Nette (uložení/načtení parametrů ve fragmentu)?

Přesněji řečeno Nette 2… :-)

Někdy je lepší udělat BC break, než vláčet historii. Na druhou stranu, v takovém případě je lepší toho udělat více naráz.

Přiznám se, že:

• Ten přistup s array se mi nelíbí, snadno se zde dělá chyba a IDE nenapovídá.
• Byl bych pro více typů sloupců, zpracováni DateTime možná do obecného sloupce nepatří.

Dal bych přednost klasickým setterům. Ty mi ostatně znemožní se snažit nastavovat sloupci něco, co mu nepatří.

Teda, ještě lepší je asi JavaFX-like deklarativní přístup, ale ten v PHP s plnou podporou IDE asi jen tak neuděláme.

Já to řešil takto (v PHP >= 5.3):

$pres = $this;
$grid->addButton("Upravit", null)->setLink(function ($row) use($pres)
				  {
					  return $pres->link("edit", array("id" => $row->id));
				  })->setIcon("pencil");

Ahoj, chtěl bych se zeptat na asi elementární věc. Gridito mi funguje krásně, ale jen na homepage. Pokud se dostanu hlouběji ve struktuře webu, kde je zobrazení vázáno na nějaké id, toto id se nepředává ve vygenerovaných odkazech.

Pokud navštívím url: text/123, funguje vše v pořádku, id 123 se správně předá a vše se vykreslí.

    $router[] = new Route('text/<id>', array(
        'module'    => 'Front',
        'presenter' => 'Text',
        'action'    => 'showText',
        'id' => NULL,
    ));

...
$id = $this->getParam('id');
$grid->setModel(new Gridito\DibiFluentModel($model->getTextById($id)  ));

ale všechny vygenerované odkazy (stránkování, řazení) tvoří url text/?grid-sort…

můžete mi s tím nějak pomoci, díky.. :)

Gridito je kompatibilní s Nette 2.0 alfa 2

Ahoj,

chtěl bych se zeptat, než si začnu tvořit vlastní úpravu, jestli není někde třeba skryta verze se sloupcem checkboxů, jako používá datagrid pro hromadné akce?

Šel bych na to přes vlastní šablonu a obalení tabulky formulářem..

Díky za info

Michal

$grid->addButton('name', 'Popisek')->setConfirmationQuestion('jo?');

// nebo

$grid->addButton('name', 'Popisek')->setConfirmationQuestion(function ($entity) {
	return "Zničit $entity->name?";
});

Pak to vyhodí klasickej JS confirm.

Zkus si to z mobilu, nevím, jestli budeš chtít stále. Ale možná pár takových jako delete by šlo.