Basic Form Example

Form is a fundamental component of any web application. Agile Toolkit greatly simplifies form creation.

example 1
CommentLinkCopy
$form=$page->add('Form');
$form->addField('line','name');
$form->addField('line','surname');
$form->addSubmit();

if($form->isSubmitted()){
  $form->js()->univ()->alert('Thank you, '.
    $form->get('name').' '.$form->get('surname'))->execute();
}
Demo
example 2
CommentLinkCopy
$f=$page->add('Form');

// email field
$f->addField('line','email')
    ->validateNotNull()
    ->validateField('filter_var($this->get(), FILTER_VALIDATE_EMAIL)')
    ;

// Submit handling    
$f->addSubmit('Check email');
if($f->isSubmitted()){
    $f->js()->univ()->alert('Email '.$f->get('email').' is valid')->execute();
}

// Application is safe from arbitary code injection, but validate input at will
Demo
example 3
CommentLinkCopy
$f=$page->add('Form');

// using multiple validations on a same field
$f->addField('line','username')->validateNotNull()
    ->validateField('preg_match("/^[a-z]+$/",$this->get())')
    ->validateField('strlen($this->get())>=6','Too short')
    ->validateField('20>=strlen($this->get())','Too long');

$f->addField('password','pasword')->validateNotNull();
$f->addSubmit('Login');

if($f->isSubmitted()){
    $f->js()->univ()->alert('[Demo] Login Successful')->execute();
}
Demo

Form Elements

There are many field types you can use with form. In addition you can add your own field types or use add-on which may provide additional types.

field types
CommentLinkCopy
$form=$page->add('Form');
$form->addComment('This form shows all sorts of fields you can use by default');
$form->addField('Line','line');
$form->addField('Password','password');
$form->addField('Checkbox','checkbox');
$form->addField('Dropdown','dropdown');
$form->addField('CheckboxList','checkboxlist');
$form->addField('Radio','radio');
$form->addField('DatePicker','date');
$form->addField('Text','text');

$form->addSeparator();
$form->addField('Slider','Slider');
$form->addField('upload','upload');

$form->addSeparator('Here are some variations in how you can use fields');
$form->addField('Search','Search');
$form->addSubmit();
Demo
This form shows all sorts of fields you can use by default
No available options #1No available options #2
No available options #3
MinMax

Use with Model

The most convenient way to use form is to have it's fields populated from a Model.

model 1
CommentLinkCopy
$form = $page->add('Form');
$form->setModel('Employee');
$form->addSubmit();
Demo
model 2
CommentLinkCopy
$f = $page->add('Form');

// defining arary of fields to show and sequence order
$f->setModel('Employee',array('name'));
Demo
model 3
CommentLinkCopy
$model = $page->add('Model_Employee');
$model->addCondition('salary','<=',3000);

$f=$page->add('Form');

$f->setModel($model,array('name','salary'));
$f->getElement('salary')->setFieldHint('Must not exceed 3000');
$f->addSubmit();

$f->onSubmit(function($f){
	try {
		$f->update()->js()->univ()->successMessage('Saved with id='.$f->model->id)->execute();
	}catch(Exception $e){
		$f->js()->univ()->alert('Failed to add record')->execute();
	}
});
Demo
Must not exceed 3000
Disqus