Nové formuláře Nette\Forms

ps. způsob, jak snadno upravit definice formulářů do nové podoby:

zaměňte

$form->addRule('name', Forms::FILLED, 'Zadejte prosím Vaše ID');
$form->addRule('name', Forms::NUMERIC, 'ID musí být číslo');
...

za

$form['name']->addRule(Form::FILLED, 'Zadejte prosím Vaše ID');
$form['name']->addRule(Form::NUMERIC, 'ID musí být číslo');
...

Jiný příklad:

$cond = $form->addCondition('submit', Forms::SUBMITTED);
$cond->addRule('note', Forms::REGEXP, 'Poznámka musí být ve tvaru %s', '/\d{3}/');

zaměňte za

$form['submit1']->addCondition(Form::SUBMITTED)
    ->addRuleFor($form['note'], Form::REGEXP, 'Poznámka musí být ve tvaru %s', '/\d{3}/');

LM napsal(a):

Jak je to se skrytými inputy, dřív je to automaticky renderovalo na konci formuláře, nyní se tak neděje a metoda renderHiddens už není, takže renderovat manuálně? Možná by stálo za to na to taky upozornit.

Mělo by to (snad) zařídit $form->render('body').

Díky za vylepšení! Warning: Komentář pro PHP < 5.3 by měl být ještě před apostrofy in ‚Nette/Form.php‘ on line 55.

Panda napsal(a):

Ještě se musí u konstant v argumentu $operation u metod FormControl::addCondition a Form::addRule zaměnit třída Forms (již neexistující) za třídu Form (kam se konstanty pčesunuly), tzn. Forms::SUBMITTED → Form:SUBMITTED, Forms::FILLED → Form::FILLED, atd., jinak to skončí parádní chybou o neexistující třídě. :)

To je pravda, post upravím.

Jinak nové formy vypadají a jsou naprosto báječné, Nette dál kvete…

Díky!

Ahoj. Ak chcem používať formuláre v presenteri, tak platí ešte toto riešenie?

Spikee napsal(a):

Ahoj. Ak chcem používať formuláre v presenteri, tak platí ešte toto riešenie?

Platí, ale použij třídu AppForm, která je speciálně pro použití v presenteru – má obslužné mechanismy na zpracování signálů. Od třídy Form se liší také tím tím, že má převrácené argumenty v konstruktoru (AppForm je má stejně jako staré Forms, Form má nyní jako první argument jméno a až jako druhý rodičovský IComponentContainer), takže když to použiješ přesně podle udaného řešení, připomene Ti nutnost použití AppForm chybové hlášení (tzn. prostě to nebude fungovat).

//Doplnění: LM byl o něco rychlejší, omlouvám se…

Editoval Panda (11. 8. 2008 21:36)

Zdravim… Takze trida Form funguje samostatne, ale AppForm je vylepsena pro pouziti v Presenteru.

Snad bych jen rad upozornil, ze se docela zasadne zmenila metoda Form::isSubbmited().

• nevraci bool, ale objekt s rozhanim ISubmitterControl
• dale nema parametr na dotaz zda odeslano tim nebo tim tlacitkem

Uprimne prijde mi kapku divna tato konstrukce, ke ktery jsem ted nucen:

$btn = $form->isSubmitted();
if($btn->name=='save') {
	$this->redirect('default', true);
}
else {
	$this->redirect('new', true);
}

Osobne bych ji opravil at vraci bool (kdyz uz se jmenuje isXYZ()) a pridal getSubmittedBy(). Originalni parametr v isSubmitedBy($by) byl uzasny napad, ktery se ted nekam vytratil.

Jeste jedna vec:
onSubmit se provede pouze kdyz fyl formular uspesne a validne odeslan?

Rad bych udelal jeste nekde jinde na strance upozorneni, ze form je chybne vyplnen, ale nevim kde neco takoveho zachytit. Mozna by stalo za to udelat neco jako onValidationError a nebo onSubmit udelat pokazde pri odeslani a onSuccessSubmit pri validnim odeslani.

Hmm?

phx napsal(a):

Jeste jedna vec:
onSubmit se provede pouze kdyz fyl formular uspesne a validne odeslan?

Pokud je jeho vlastnost onlyValid nastavena na true (jako že defaultně je), tak ano.

Rad bych udelal jeste nekde jinde na strance upozorneni, ze form je chybne vyplnen, ale nevim kde neco takoveho zachytit. Mozna by stalo za to udelat neco jako onValidationError a nebo onSubmit udelat pokazde pri odeslani a onSuccessSubmit pri validnim odeslani.

Pokud je formulář chybně vyplněn, tak si chyby zpracuje sám a vykreslí je hned před tělíčko. Stačí nakouknout do kousku metody ConventionalRenderer::render:

	$this->render('begin'); // renderuje počáteční <form ...>
	$this->render('errors'); // renderuje chyby - jako ul
	$this->render('body');
	$this->render('end'); // renderuje </form>

Chybu také můžeš sám přidat metodou addError, nebo FormControl::addError.

Pokud by jsi chtěl chyby kreslit ještě někde jinde, tak doporučuji kouknout na metody hasErrors a getErrors.

phx napsal(a):

Zdravim… Takze trida Form funguje samostatne, ale AppForm je vylepsena pro pouziti v Presenteru.

Snad bych jen rad upozornil, ze se docela zasadne zmenila metoda Form::isSubbmited().

• nevraci bool, ale objekt s rozhanim ISubmitterControl
• dale nema parametr na dotaz zda odeslano tim nebo tim tlacitkem

Uprimne prijde mi kapku divna tato konstrukce, ke ktery jsem ted nucen:

$btn = $form->isSubmitted();
if($btn->name=='save') {
	$this->redirect('default', true);
}
else {
	$this->redirect('new', true);
}

Osobne bych ji opravil at vraci bool (kdyz uz se jmenuje isXYZ()) a pridal getSubmittedBy(). Originalni parametr v isSubmitedBy($by) byl uzasny napad, ktery se ted nekam vytratil.

Vytratil se do rozhraní ISubmitterControl:

if($form['save']->isSubmittedBy()) {
	$this->redirect('default', true);
} else {
	$this->redirect('new', true);
}

Myslím, že tato konstrukce je ještě o něco lepší, než původní řešení s metodou Form::isSubmittedBy.

Mě osobně vůbec nevadí, že metoda Form::isSubmitted() nevrací bool, v podmínce jí mohu použít tak jako tak a navíc se dozvím, čím že to vlastně byl formulář odeslán. A to mi umožňuje použití jiné konstrukce:

if($submit = $form->isSubmitted())
{
	// možnost použít proměnnou $submit
}

To by se jinak psalo takto:

if($form->isSubmitted())
{
	$submit = $form->getSubmittedBy();
	// možnost použít proměnnou $submit
}

Tím ušetřím celý jeden řádek kódu s celým jedním voláním funkce. :)

phx napsal(a):

Snad bych jen rad upozornil, ze se docela zasadne zmenila metoda Form::isSubmitted().

• nevraci bool, ale objekt s rozhanim ISubmitterControl
• dale nema parametr na dotaz zda odeslano tim nebo tim tlacitkem

Uprimne prijde mi kapku divna tato konstrukce, ke ktery jsem ted nucen:

$btn = $form->isSubmitted();
if($btn->name=='save') {
	$this->redirect('default', true);
}
else {
	$this->redirect('new', true);
}

Použití by mohlo vypadat spíš takto:

if ($form->isSubmitted()) { ... }

nevadí, že vrácená hodnota je objekt, podmínka se vyhodnotí korektně.

A dotaz přímo na tlačítko:

if ($form['preview']->isSubmittedBy()) { ... }

Tímto způsobem je možné postihnout případné složitější struktury:

if ($form['subform']['preview']->isSubmittedBy()) { ... }

Co bych navrhl k diskusi, je název metody isSubmittedBy u prvků. Ten název není úplně šťastný, formulář má isSubmitted, jenže použit isSubmitted na tlačítku mi připadá divné – „odeslán“ je formulář, nikoliv tlačítko. Rozdíl mezi 1. a 7. pádem.

David Grudl napsal(a):

if ($form->isSubmitted()) { ... }

Ale tohle zase vypada nelogicky a priserne:

$btn = $form->isSubmitted();

Editoval phx (13. 8. 2008 16:46)

Dá se nějak získat vyrenderovaný formulář jako Nette\Web\Html? Aby šlo něco takového:

$form = new Form;

$container = Html::el('div');
$container->add($form);

echo $container;

Nebo je to zbytečné? Stačila by i metoda __toString.

OT. Nebudu šetřit díky za Nette.compact. Vidím stránku dřív, než stačím zadat adresu.

Lze jednoduše vložit více tlačítek ve vykreslované tabulce formuláře pomocí AppForm?

Ano, o to mi přesně šlo, jen jsem to zapomněl upřesnit.

Hm, díky za info.

Zavoláním $form['save']->setRendered(TRUE) je vynecháte z vykreslování $form->render('body') a pak je můžete vykreslit ručně.

Do sablony si posles samotny fomrular. (jde to i jinak???)

A pak napriklad:

		<fieldset style="margin: 0 auto 1em auto; width: 260px;">
			<legend>Heslo</legend>
			<?php $form->render('errors'); ?>
			<?php $form->render('begin'); ?>
			<table>
				<tr>
					<th><?= $form['pass1']->label ?></th>
					<td><?= $form['pass1']->control ?></td>
				</tr>
				<tr>
					<th><?= $form['pass2']->label ?></th>
					<td><?= $form['pass2']->control ?></td>
				</tr>
				<tr>
					<td></td>
					<td><?= $form['start']->control ?></td>
				</tr>
			</table>
			<?php $form->render('body'); ?>
			<?php $form->render('end'); ?>
		</fieldset>

Emailová adresa se v současné době validuje výrazem /^[^@]+@[^@]+\.[a-z]{2,6}$/i. Sice dobře chrání před překlepy při psaní, bojím se ale především možného podstrčení víceřádkového textu. Podobné riziko hrozí také u URL.

Bezpečný výraz před časem sestavil Jakub Vrána.

To je fakt, whitespaces ošetřím.

Děkuji!

Jakubův výraz je příliš přísný, selže například na adresách s diakritikou.

Je těžké udělat kompromis. Adresy s diakritikou nebo s mezerou („Lorem Ipsum“@lipsum.com) jsou platné, ale zatím asi špatně podporované. Pokud se diakritika vyskytne v doménové části, asi by bylo nejlepší doménu převést na její ascii ekvivalent.