FormTest.php

<?php
/**
 * Lithium: the most rad php framework
 *
 * @copyright     Copyright 2011, Union of RAD (http://union-of-rad.org)
 * @license       http://opensource.org/licenses/bsd-license.php The BSD License
 */

namespace lithium\tests\cases\template\helper;

use Exception;
use lithium\action\Request;
use lithium\net\http\Router;
use lithium\data\entity\Record;
use lithium\data\entity\Document;
use lithium\template\helper\Form;
use lithium\tests\mocks\template\helper\MockFormPost;
use lithium\tests\mocks\template\helper\MockFormRenderer;

class FormTest extends \lithium\test\Unit {

	protected $_model = 'lithium\tests\mocks\template\helper\MockFormPost';

	/**
	 * Test object instance.
	 *
	 * @var object
	 */
	public $form = null;

	/**
	 * The rendering context object.
	 *
	 * @var object
	 */
	public $context = null;

	public $base = null;

	protected $_routes = array();

	/**
	 * Initialize test by creating a new object instance with a default context.
	 */
	public function setUp() {
		$this->_routes = Router::get();
		Router::reset();
		Router::connect('/{:controller}/{:action}/{:id}.{:type}', array('id' => null));
		Router::connect('/{:controller}/{:action}/{:args}');

		$request = new Request();
		$request->params = array('controller' => 'posts', 'action' => 'index');
		$request->persist = array('controller');

		$this->context = new MockFormRenderer(compact('request'));
		$this->form = new Form(array('context' => $this->context));

		$base = trim($this->context->request()->env('base'), '/') . '/';
		$this->base = ($base == '/') ? $base : '/' . $base;
	}

	public function tearDown() {
		Router::reset();

		foreach ($this->_routes as $route) {
			Router::connect($route);
		}
	}

	public function testFormCreation() {
		$result = $this->form->create();
		$this->assertTags($result, array(
			'form' => array('action' => "{$this->base}posts", 'method' => 'post')
		));

		$result = $this->form->create(null, array('method' => 'get'));
		$this->assertTags($result, array(
			'form' => array('action' => "{$this->base}posts", 'method' => 'get')
		));

		$result = $this->form->create(null, array('type' => 'file'));
		$this->assertTags($result, array('form' => array(
			'action' => "{$this->base}posts",
			'enctype' => 'multipart/form-data',
			'method' => 'post'
		)));

		$result = $this->form->create(null, array('method' => 'get', 'type' => 'file'));
		$this->assertTags($result, array('form' => array(
			'action' => "{$this->base}posts",
			'method' => 'post',
			'enctype' => 'multipart/form-data'
		)));

		$result = $this->form->create(null, array('id' => 'Registration'));
		$this->assertTags($result, array(
			'form' => array(
				'action' => "{$this->base}posts",
				'method' => 'post',
				'id' => 'Registration'
			)
		));
	}

	/**
	 * Tests creating forms with non-browser compatible HTTP methods, required for REST interfaces.
	 */
	public function testRestFormCreation() {
		$result = $this->form->create(null, array('action' => 'delete', 'method' => 'delete'));

		$this->assertTags($result, array(
			'form' => array(
				'action' => "{$this->base}posts/delete", 'method' => 'post'
			),
			'input' => array('type' => "hidden", 'name' => '_method', 'value' => 'DELETE')
		));

		$result = $this->form->create(null, array('method' => 'put', 'type' => 'file'));
		$this->assertTags($result, array(
			'form' => array(
				'action' => "{$this->base}posts",
				'method' => 'post',
				'enctype' => 'multipart/form-data'
			),
			'input' => array('type' => "hidden", 'name' => '_method', 'value' => 'PUT')
		));

		$record = new Record(array('exists' => true, 'model' => $this->_model));
		$result = $this->form->create($record);

		$this->assertTags($result, array(
			'form' => array('action' => "{$this->base}posts", 'method' => 'post'),
			'input' => array('type' => "hidden", 'name' => '_method', 'value' => 'PUT')
		));
	}

	public function testFormCreationWithBinding() {
		$record = new Record(array('model' => $this->_model, 'data' => array(
			'id' => '5',
			'author_id' => '2',
			'title' => 'This is a saved post',
			'body' => 'This is the body of the saved post'
		)));
		$result = $this->form->create($record);
		$this->assertTags($result, array(
			'form' => array('action' => "{$this->base}posts", 'method' => 'post')
		));
	}

	/**
	 * Ensures that password fields aren't rendered with pre-populated values from bound record or
	 * document objects.
	 */
	public function testPasswordWithBindingValue() {
		$this->form->create(new Record(array(
			'model' => $this->_model, 'data' => array('pass' => 'foobar')
		)));
		$result = $this->form->password('pass');

		$this->assertTags($result, array(
			'input' => array('type' => 'password', 'name' => 'pass', 'id' => 'MockFormPostPass')
		));
	}

	public function testFormDataBinding() {
		$this->expectException('The data connection default is not configured');

		try {
			MockFormPost::config(array('connection' => false));
		} catch (Exception $e) {
			MockFormPost::config(array('connection' => false));
		}

		$record = new Record(array('model' => $this->_model, 'data' => array(
			'id' => '5',
			'author_id' => '2',
			'title' => 'This is a saved post',
			'body' => 'This is the body of the saved post'
		)));

		$result = $this->form->create($record);
		$this->assertTags($result, array(
			'form' => array('action' => "{$this->base}posts", 'method' => 'post')
		));

		$result = $this->form->text('title');
		$this->assertTags($result, array('input' => array(
			'type' => 'text', 'name' => 'title',
			'value' => 'This is a saved post', 'id' => 'MockFormPostTitle'
		)));

		$result = $this->form->end();
		$this->assertTags($result, array('/form'));

		$result = $this->form->text('title');
		$this->assertTags($result, array('input' => array(
			'type' => 'text', 'name' => 'title', 'id' => 'Title'
		)));
	}

	public function testTextBox() {
		$result = $this->form->text('foo');
		$this->assertTags($result, array('input' => array(
			'type' => 'text', 'name' => 'foo', 'id' => 'Foo'
		)));
	}

	public function testElementsWithDefaultConfiguration() {
		$this->form = new Form(array(
			'context' => new MockFormRenderer(), 'base' => array('class' => 'editable')
		));

		$result = $this->form->text('foo');
		$this->assertTags($result, array('input' => array(
			'type' => 'text', 'name' => 'foo', 'class' => 'editable', 'id' => 'Foo'
		)));

		$this->form->config(array('base' => array('maxlength' => 255)));

		$result = $this->form->text('foo');
		$this->assertTags($result, array('input' => array(
			'type' => 'text', 'name' => 'foo', 'class' => 'editable',
			'maxlength' => '255', 'id' => 'Foo'
		)));

		$this->form->config(array('text' => array('class' => 'locked')));

		$result = $this->form->text('foo');
		$this->assertTags($result, array('input' => array(
			'type' => 'text', 'name' => 'foo', 'class' => 'locked',
			'maxlength' => '255', 'id' => 'Foo'
		)));

		$result = $this->form->config();
		$expected = array(
			'base' => array('class' => 'editable', 'maxlength' => 255),
			'text' => array('class' => 'locked'),
			'textarea' => array(),
			'templates' => array('create' => 'form', 'end' => 'form-end'),
			'attributes' => array('id' => $result['attributes']['id'])
		);
		$this->assertEqual($expected, $result);
		$this->assertTrue(is_callable($result['attributes']['id']));
	}

	public function testFormElementWithDefaultValue() {
		$result = $this->form->text('foo', array('default' => 'Message here'));

		$this->assertTags($result, array('input' => array(
			'type' => 'text', 'name' => 'foo', 'value' => 'Message here', 'id' => 'Foo'
		)));

		$result = $this->form->text('foo', array(
			'default' => 'Message here', 'value' => 'My Name Is Jonas', 'id' => 'Foo'
		));
		$this->assertTags($result, array('input' => array(
			'type' => 'text', 'name' => 'foo', 'value' => 'My Name Is Jonas', 'id' => 'Foo'
		)));

		$result = $this->form->text('foo', array('value' => 'My Name Is Jonas'));
		$this->assertTags($result, array('input' => array(
			'type' => 'text', 'name' => 'foo', 'value' => 'My Name Is Jonas', 'id' => 'Foo'
		)));
	}

	public function testFormInputField() {
		$result = $this->form->file('upload');
		$this->assertTags($result, array('input' => array(
			'type' => 'file', 'name' => 'upload', 'id' => 'Upload'
		)));
	}

	public function testHiddenFieldWithId() {
		$result = $this->form->hidden('my_field');
		$this->assertTags($result, array('input' => array(
			'type' => 'hidden', 'name' => 'my_field', 'id' => 'MyField'
		)));
	}

	public function testLabelGeneration() {
		$result = $this->form->label('next', 'Enter the next value >>');
		$this->assertTags($result, array(
			'label' => array('for' => 'next'),
			'Enter the next value &gt;&gt;',
			'/label'
		));

		$result = $this->form->label('user_name');
		$this->assertTags($result, array(
			'label' => array('for' => 'user_name'),
			'User Name',
			'/label'
		));

		$result = $this->form->label('first_name', array(
			'First Name' => array('id' => 'first_name_label')
		));
		$this->assertTags($result, array(
			'label' => array('for' => 'first_name', 'id' => 'first_name_label'),
			'First Name',
			'/label'
		));

		$result = $this->form->label('first_name', array(
			null => array('id' => 'first_name_label')
		));
		$this->assertTags($result, array(
			'label' => array('for' => 'first_name', 'id' => 'first_name_label'),
			'First Name',
			'/label'
		));
	}

	public function testLabelGenerationWithNoEscape() {
		$result = $this->form->label('next', 'Enter the next value >>', array('escape' => false));
		$this->assertTags($result, array(
			'label' => array('for' => 'next'),
			'Enter the next value >>',
			'/label'
		));
	}

	public function testSubmitGeneration() {
		$result = $this->form->submit('Continue >');
		$this->assertTags($result, array('input' => array(
			'type' => 'submit',
			'value' => 'Continue &gt;'
		)));

		$result = $this->form->submit('Continue >', array('class' => 'special'));
		$this->assertTags($result, array('input' => array(
			'type' => 'submit',
			'value' => 'Continue &gt;',
			'class' => 'special'
		)));
	}

	public function testTextareaGeneration() {
		$result = $this->form->textarea('foo', array('value' => 'some content'));
		$this->assertTags($result, array(
			'textarea' => array('name' => 'foo', 'id' => 'Foo'),
			'some content',
			'/textarea'
		));
	}

	public function testCheckboxGeneration() {
		$result = $this->form->checkbox('foo');
		$this->assertTags($result, array(
			array('input' => array('type' => 'hidden', 'value' => '', 'name' => 'foo')),
			array('input' => array(
				'type' => 'checkbox', 'value' => '1', 'name' => 'foo', 'id' => 'Foo'
			))
		));

		$result = $this->form->checkbox('foo', array('checked' => false));
		$this->assertTags($result, array(
			array('input' => array('type' => 'hidden', 'value' => '', 'name' => 'foo')),
			array('input' => array(
				'type' => 'checkbox', 'value' => '1', 'name' => 'foo', 'id' => 'Foo'
			))
		));

		$result = $this->form->checkbox('foo', array('checked' => true));
		$this->assertTags($result, array(
			array('input' => array('type' => 'hidden', 'value' => '', 'name' => 'foo')),
			array('input' => array(
				'type' => 'checkbox', 'value' => '1', 'name' => 'foo',
				'checked' => 'checked', 'id' => 'Foo'
			))
		));

		$record = new Record(array('model' => $this->_model, 'data' => array('foo' => true)));
		$this->form->create($record);

		$result = $this->form->checkbox('foo');
		$this->assertTags($result, array(
			array('input' => array('type' => 'hidden', 'value' => '', 'name' => 'foo')),
			array('input' => array(
				'type' => 'checkbox', 'value' => '1', 'name' => 'foo',
				'checked' => 'checked', 'id' => 'MockFormPostFoo'
			))
		));
	}

	public function testCustomCheckbox() {
		$result = $this->form->checkbox('foo', array('value' => '1'));
		$this->assertTags($result, array(
			array('input' => array('type' => 'hidden', 'value' => '', 'name' => 'foo')),
			array('input' => array(
				'type' => 'checkbox', 'value' => '1',  'name' => 'foo', 'id' => 'Foo'
			))
		));

		$result = $this->form->checkbox('foo', array('checked' => true, 'value' => '1'));
		$this->assertTags($result, array(
			array('input' => array('type' => 'hidden', 'value' => '', 'name' => 'foo')),
			array('input' => array(
				'type' => 'checkbox', 'value' => '1',  'name' => 'foo',
				'checked' => 'checked', 'id' => 'Foo'
			))
		));

		$record = new Record(array('model' => $this->_model, 'data' => array('foo' => true)));
		$this->form->create($record);

		$result = $this->form->checkbox('foo', array('value' => '1'));
		$this->assertTags($result, array(
			array('input' => array('type' => 'hidden', 'value' => '', 'name' => 'foo')),
			array('input' => array(
				'type' => 'checkbox', 'value' => '1',  'name' => 'foo',
				'id' => 'MockFormPostFoo', 'checked' => 'checked'
			))
		));

		$result = $this->form->checkbox('foo', array('value' => true));
		$this->assertTags($result, array(
			array('input' => array('type' => 'hidden', 'value' => '', 'name' => 'foo')),
			array('input' => array(
				'type' => 'checkbox', 'value' => '1',  'name' => 'foo', 'id' => 'MockFormPostFoo'
			))
		));
	}

	public function testCustomValueCheckbox() {
		$result = $this->form->checkbox('foo', array('value' => 'HERO'));
		$this->assertTags($result, array(
			array('input' => array('type' => 'hidden', 'value' => '', 'name' => 'foo')),
			array('input' => array(
				'type' => 'checkbox', 'value' => 'HERO', 'name' => 'foo', 'id' => 'Foo'
			))
		));

		$result = $this->form->checkbox('foo', array('value' => 'nose'));
		$this->assertTags($result, array(
			array('input' => array('type' => 'hidden', 'value' => '', 'name' => 'foo')),
			array('input' => array(
				'type' => 'checkbox', 'value' => 'nose', 'name' => 'foo', 'id' => 'Foo'
			))
		));

		$record = new Record(array('model' => $this->_model, 'data' => array('foo' => 'nose')));
		$record->foo = 'nose';
		$this->form->create($record);

		$result = $this->form->checkbox('foo', array('value' => 'nose'));
		$this->assertTags($result, array(
			array('input' => array('type' => 'hidden', 'value' => '', 'name' => 'foo')),
			array('input' => array(
				'type' => 'checkbox', 'value' => 'nose', 'name' => 'foo', 'id' => 'MockFormPostFoo'
			))
		));

		$record = new Record(array('model' => $this->_model, 'data' => array('foo' => 'foot')));
		$this->form->create($record);

		$result = $this->form->checkbox('foo', array('value' => 'nose'));
		$this->assertTags($result, array(
			array('input' => array('type' => 'hidden', 'value' => '', 'name' => 'foo')),
			array('input' => array(
				'type' => 'checkbox', 'value' => 'nose', 'name' => 'foo',
				'checked' => 'checked', 'id' => 'MockFormPostFoo'
			))
		));
	}

	public function testSelectGeneration() {
		$result = $this->form->select('foo');

		$this->assertTags($result, array(
			'select' => array('name' => 'foo', 'id' => 'Foo'), '/select'
		));

		$result = $this->form->select(
			'colors',
			array('r' => 'red', 'g' => 'green', 'b' => 'blue'),
			array('id' => 'Colors', 'value' => 'g')
		);

		$this->assertTags($result, array(
			'select' => array('name' => 'colors', 'id' => 'Colors'),
			array('option' => array('value' => 'r')),
			'red',
			'/option',
			array('option' => array('value' => 'g', 'selected' => 'selected')),
			'green',
			'/option',
			array('option' => array('value' => 'b')),
			'blue',
			'/option',
			'/select'
		));
	}

	public function testSelectWithEmptyOption() {
		$result = $this->form->select('numbers', array('1' => 'first', '2' => 'second'), array(
			'empty' => true
		));

		$this->assertTags($result, array(
			'select' => array('id' => 'Numbers', 'name' => 'numbers'),
			array('option' => array('value' => '', 'selected' => 'selected')),
			'/option',
			array('option' => array('value' => '1')),
			'first',
			'/option',
			array('option' => array('value' => '2')),
			'second',
			'/option',
			'/select'
		));

		$result = $this->form->select('numbers', array('1' => 'first', '2' => 'second'), array(
			'empty' => '> Make a selection'
		));

		$this->assertTags($result, array(
			'select' => array('name' => 'numbers', 'id' => 'Numbers'),
			array('option' => array('value' => '', 'selected' => 'selected')),
			'&gt; Make a selection',
			'/option',
			array('option' => array('value' => '1')),
			'first',
			'/option',
			array('option' => array('value' => '2')),
			'second',
			'/option',
			'/select'
		));
	}
	
	public function testRecursiveSelect() {
		$list = array(
			'Linux' => array(
				'1' => 'Ubuntu 10.10',
				'2' => 'CentOS 5'
			),
			'Other' => array(
				'4' => 'Solaris',
				'5' => 'Windows Server 2010 R2'
			)
		);
		$result = $this->form->select('opsys', $list, array('empty' => 
			'Select one', 'value' => '5'
		));

		$this->assertTags($result, array(
			'select' => array('name' => 'opsys', 'id' => 'Opsys'),
			array('option' => array('value' => '')),
			'Select one',
			'/option',			
			array('optgroup' => array('label' => 'Linux')),
			array('option' => array('value' => '1')),
			'Ubuntu 10.10',
			'/option',
			array('option' => array('value' => '2')),
			'CentOS 5',
			'/option',
			'/optgroup',
			array('optgroup' => array('label' => 'Other')),
			array('option' => array('value' => '4')),
			'Solaris',
			'/option',
			array('option' => array('value' => '5', 'selected' => 'selected')),
			'Windows Server 2010 R2',
			'/option',
			'/optgroup',
			'/select'
		));
	}

	public function testTemplateRemapping() {
		$result = $this->form->password('passwd');
		$this->assertTags($result, array('input' => array(
			'type' => 'password', 'name' => 'passwd', 'id' => 'Passwd'
		)));

		$this->form->config(array('templates' => array('password' => 'text')));

		$result = $this->form->password('passwd');
		$this->assertTags($result, array('input' => array(
			'type' => 'text', 'name' => 'passwd', 'id' => 'Passwd'
		)));
	}

	public function testMultiSelect() {
		$expected = array(
			'select' => array('name' => 'numbers[]', 'id' => 'Numbers', 'multiple' => 'multiple'),
			array('option' => array('value' => '', 'selected' => 'selected')),
			'&gt; Make a selection',
			'/option',
			array('option' => array('value' => '1')),
			'first',
			'/option',
			array('option' => array('value' => '2')),
			'second',
			'/option',
			'/select'
		);
		$result = $this->form->select('numbers', array('1' => 'first', '2' => 'second'), array(
			'empty' => '> Make a selection',
			'multiple' => true
		));
		$this->assertTags($result, $expected);

		$expected = array(
			'select' => array(
				'name' => 'numbers[]', 'multiple' => 'multiple', 'size' => 5, 'id' => 'Numbers'
			),
			array('option' => array('value' => '1')),
			'first',
			'/option',
			array('option' => array('value' => '2')),
			'second',
			'/option',
			'/select'
		);
		$result = $this->form->select('numbers', array('1' => 'first', '2' => 'second'), array(
			'multiple' => true,
			'size' => 5
		));
		$this->assertTags($result, $expected);
	}

	public function testMultiselected() {
		$expected = array(
			'select' => array('name' => 'numbers[]', 'id' => 'Numbers', 'multiple' => 'multiple'),
			array('option' => array('value' => '1', 'selected' => 'selected')),
			'first',
			'/option',
			array('option' => array('value' => '2')),
			'second',
			'/option',
			array('option' => array('value' => '3', 'selected' => 'selected')),
			'third',
			'/option',
			array('option' => array('value' => '4', 'selected' => 'selected')),
			'fourth',
			'/option',
			'/select'
		);
		$list = array(1 => 'first', 2 => 'second', 3 => 'third', 4 => 'fourth');
		$options = array('value' => array(1, 3, 4), 'multiple' => true);
		$result = $this->form->select('numbers', $list, $options);
		$this->assertTags($result, $expected);
	}

	public function testFormCreateWithMoreParams() {
		$request = new Request();
		$request->params = array('controller' => 'mock', 'action' => 'test', 'args' => array('1'));
		$context = new MockFormRenderer(compact('request'));
		$form = new Form(compact('context'));

		$result = $form->create();
		$this->assertTags($result, array('form' => array(
			'action' => "{$this->base}mock/test/1",
			'method' => 'post'
		)));
	}

	public function testFormCreateWithMoreParamsButSpecifiedAction() {
		$request = new Request();
		$request->params = array('controller' => 'mock', 'action' => 'test', 'args' => array('1'));
		$request->persist = array('controller');
		$context = new MockFormRenderer(compact('request'));
		$form = new Form(compact('context'));

		$result = $form->create(null, array('action' => 'radness'));
		$this->assertTags($result, array('form' => array(
			'action' => "{$this->base}mock/radness",
			'method' => 'post'
		)));
	}

	public function testFormField() {
		$result = $this->form->field('name');
		$this->assertTags($result, array(
			'div' => array(),
			'label' => array('for' => 'Name'), 'Name', '/label',
			'input' => array('type' => 'text', 'name' => 'name', 'id' => 'Name'),
			'/div'
		));

		$result = $this->form->field('name', array('type' => 'radio', 'value' => 'foo'));
		$this->assertTags($result, array(
			'div' => array(),
			'input' => array('type' => 'radio', 'name' => 'name', 'value' => 'foo', 'id' => 'Name'),
			'label' => array('for' => 'Name'), 'Name', '/label',
			'/div'
		));

		$result = $this->form->field('name', array('type' => 'checkbox'));
		$expected = array(
			'<div>',
			'<input type="hidden" name="name" value="" />',
			'<input type="checkbox" name="name" id="Name" value="1" />',
			'<label for="Name">Name</label></div>'
		);
		$this->assertEqual(join('', $expected), $result);
	}

	/**
	 * Verifies that calls to `field()` with `'type' => 'hidden'` do not produce `<label />`s.
	 */
	public function testHiddenFieldWithNoLabel() {
		$result = $this->form->field('foo', array('type' => 'hidden'));
		$this->assertTags($result, array(
			'div' => array(),
			'input' => array('type' => 'hidden', 'name' => 'foo', 'id' => 'Foo'),
			'/div'
		));
	}

	public function testFormFieldWithCustomTemplate() {
		$result = $this->form->field('name', array(
			'template' => '<div{:wrap}>{:label}: {:input}{:error}</div>'
		));
		$this->assertTags($result, array(
			'div' => array(),
			'label' => array('for' => 'Name'), 'Name', '/label', ':',
			'input' => array('type' => 'text', 'name' => 'name', 'id' => 'Name')
		));
	}

	public function testFieldWithLabelShorthand() {
		$result = $this->form->field(array('name' => 'Enter a name'));
		$this->assertTags($result, array(
			'div' => array(),
			'label' => array('for' => 'Name'), 'Enter a name', '/label',
			'input' => array('type' => 'text', 'name' => 'name', 'id' => 'Name')
		));
	}

	/**
	 * Demonstrates that the options for a `<label />` element can be passed through the `field()`
	 * method, using the label text as a key.
	 */
	public function testFieldLabelWithOptions() {
		$result = $this->form->field('name', array(
			'label' => array('Item Name' => array('class' => 'required'))
		));
		$this->assertTags($result, array(
			'div' => array(),
			'label' => array('for' => 'Name', 'class' => 'required'), 'Item Name', '/label',
			'input' => array('type' => 'text', 'name' => 'name', 'id' => 'Name')
		));

		$result = $this->form->field('video_preview', array(
			'label' => array('<a href="http://www.youtube.com/">Youtube</a>' => array(
				'escape' => false
			))
		));
		$this->assertTags($result, array(
			'div' => array(),
			'label' => array('for' => 'VideoPreview'),
			'a' => array('href' => 'http://www.youtube.com/'), 'Youtube', '/a', '/label',
			'input' => array('type' => 'text', 'name' => 'video_preview', 'id' => 'VideoPreview')
		));
	}

	public function testMultipleFields() {
		$result = $this->form->field(array(
			'name' => 'Enter a name',
			'phone_number',
			'email' => 'Enter a valid email'
		));
		$this->assertTags($result, array(
			array('div' => array()),
				array('label' => array('for' => 'Name')),
					'Enter a name',
				'/label',
				array('input' => array('type' => 'text', 'name' => 'name', 'id' => 'Name')),
			'/div',

			array('div' => array()),
				array('label' => array('for' => 'PhoneNumber')),
					'Phone Number',
				'/label',
				array('input' => array(
					'type' => 'text', 'name' => 'phone_number', 'id' => 'PhoneNumber'
				)),
			'/div',

			array('div' => array()),
				array('label' => array('for' => 'Email')),
					'Enter a valid email',
				'/label',
				array('input' => array('type' => 'text', 'name' => 'email', 'id' => 'Email')),
			'/div'
		));
	}

	public function testCustomInputTypes() {
		// Creates an HTML5 'range' input slider:
		$range = $this->form->range('completion', array('min' => 0, 'max' => 100));
		$this->assertTags($range, array('input' => array(
			'type' => 'range', 'name' => 'completion',
			'min' => '0', 'max' => '100', 'id' => 'Completion'
		)));
	}

	public function testFieldWithCustomType() {
		$field = $this->form->field('completion', array(
			'type' => 'range', 'id' => 'completion', 'min' => '0', 'max' => '100',
			'label' => 'Completion %', 'wrap' => array('class' => 'input')
		));
		$this->assertTags($field, array(
			'div' => array('class' => 'input'),
			'label' => array('for' => 'completion'), 'Completion %', '/label',
			'input' => array(
				'type' => 'range', 'name' => 'completion',
				'id' => 'completion', 'min' => '0', 'max' => '100'
			),
			'/div'
		));
	}

	public function testFormFieldSelect() {
		$result = $this->form->field('states', array(
			'type' => 'select', 'list' => array('CA', 'RI')
		));
		$this->assertTags($result, array(
			'div' => array(),
			'label' => array('for' => 'States'), 'States', '/label',
			'select' => array('name' => 'states', 'id' => 'States'),
			array('option' => array('value' => '0', 'selected' => 'selected')),
			'CA',
			'/option',
			array('option' => array('value' => '1')),
			'RI',
			'/option',
			'/select'
		));
	}

	public function testFormErrorWithout() {
		$this->form->create(null);
		$result = $this->form->error('name');
		$this->assertTrue(is_null($result));
	}

	public function testFormErrorWithRecordAndStringError() {
		$record = new Record(array('model' => $this->_model));
		$record->errors(array('name' => 'Please enter a name'));
		$this->form->create($record);

		$result = $this->form->error('name');
		$this->assertTags($result, array(
			'div' => array('class' => 'error'), 'Please enter a name', '/div'
		));
	}

	public function testFormMultipleErrors() {
		$record = new Record(array('model' => $this->_model));
		$record->errors(array('email' => array('Empty', 'Valid')));
		$this->form->create($record);

		$result = $this->form->error('email');
		$this->assertTags($result, array(
			array('div' => array('class' => 'error')), 'Empty', '/div',
			array('div' => array('class' => 'error')), 'Valid', '/div'
		));

		$result = $this->form->error('email', 0);
		$this->assertTags($result, array('div' => array('class' => 'error'), 'Empty', '/div'));

		$result = $this->form->error('email', 1);
		$this->assertTags($result, array('div' => array('class' => 'error'), 'Valid', '/div'));

		$result = $this->form->error('email', true);
		$this->assertTags($result, array('div' => array('class' => 'error'), 'Empty', '/div'));
	}

	public function testFormErrorWithRecordAndSpecificKey() {
		$record = new Record(array('model' => $this->_model));
		$record->errors(array('name' => array('Please enter a name')));
		$this->form->create($record);

		$result = $this->form->error('name', 0);
		$this->assertTags($result, array(
			'div' => array('class' => 'error'), 'Please enter a name', '/div'
		));
	}

	public function testFormErrorWithRecordAndSpecificKeyAndValue() {
		$record = new Record(array('model' => $this->_model));
		$record->name = 'Nils';
		$record->errors(array('name' => array('Please enter a name')));
		$this->form->create($record);

		$result = $this->form->error('name');
		$this->assertTags($result, array(
			'div' => array('class' => 'error'), 'Please enter a name', '/div'
		));
	}

	public function testFormFieldWithError() {
		$record = new Record(array('model' => $this->_model));
		$record->errors(array('name' => array('Please enter a name')));
		$this->form->create($record);

		$result = $this->form->field('name');
		$this->assertTags($result, array(
			'<div', 'label' => array('for' => 'MockFormPostName'), 'Name', '/label',
			'input' => array('type' => "text", 'name' => 'name', 'id' => 'MockFormPostName'),
			'div' => array('class' => "error"), 'Please enter a name', '/div', '/div'
		));
	}

	public function testErrorWithCustomConfiguration() {
		$this->form->config(array('error' => array('class' => 'custom-error-class')));

		$record = new Record(array('model' => $this->_model));
		$record->errors(array('name' => array('Please enter a name')));
		$this->form->create($record);

		$result = $this->form->field('name');
		$this->assertTags($result, array(
			'<div', 'label' => array('for' => 'MockFormPostName'), 'Name', '/label',
			'input' => array('type' => "text", 'name' => 'name', 'id' => 'MockFormPostName'),
			'div' => array('class' => "custom-error-class"), 'Please enter a name', '/div', '/div'
		));
	}

	/**
	 * Tests that the string template form `Form::field()` can be overridden.
	 */
	public function testFieldTemplateOverride() {
		$this->form->config(array('templates' => array('field' => '{:label}{:input}{:error}')));
		$result = $this->form->field('name', array('type' => 'text'));
		$this->assertTags($result, array(
			'label' => array('for' => 'Name'), 'Name', '/label',
			'input' => array('type' => 'text', 'name' => 'name', 'id' => 'Name')
		));
	}

	/**
	 * Tests that the `field()` method properly renders a `<select />` element if the `'list'`
	 * option is passed.
	 */
	public function testFieldAssumeSelectIfList() {
		$result = $this->form->field('colors', array(
			'list' => array('r' => 'red', 'g' => 'green', 'b' => 'blue')
		));
		$expected = array(
			'<div',
				array('label' => array('for' => 'Colors')),
					'Colors',
				'/label',
				'select' => array('name' => 'colors', 'id' => 'Colors'),
					array('option' => array('value' => 'r')),
						'red',
					'/option',
					array('option' => array('value' => 'g')),
						'green',
					'/option',
					array('option' => array('value' => 'b')),
						'blue',
					'/option',
				'/select',
			'/div'
		);
		$this->assertTags($result, $expected);
	}

	public function testFieldInputIdWithFormId() {
		$this->form->create(null, array('id' => 'registration'));
		$result = $this->form->field('name');

		$this->assertTags($result, array(
			'div' => array(),
			'label' => array('for' => 'Name'), 'Name', '/label',
			'input' => array('type' => 'text', 'name' => 'name', 'id' => 'Name')
		));
	}

	/**
	 * Tests that inputs for nested objects can be assigned using dot syntax.
	 */
	public function testNestedFieldAccess() {
		$doc = new Document(array('data' => array('foo' => array('bar' => 'value'))));
		$this->form->create($doc);

		$result = $this->form->text('foo.bar');
		$this->assertTags($result, array('input' => array(
			'type' => 'text', 'name' => 'foo[bar]', 'id' => 'FooBar', 'value' => 'value'
		)));

		$result = $this->form->field('foo.bar');
		$this->assertTags($result, array(
			'div' => array(),
			'label' => array('for' => 'FooBar'), 'Foo Bar', '/label',
			'input' => array(
				'type' => 'text', 'name' => 'foo[bar]', 'id' => 'FooBar', 'value' => 'value'
			)
		));
	}

	/**
	 * Tests rendering errors for nested fields.
	 */
	public function testNestedFieldError() {
		$doc = new Document(array('data' => array('foo' => array('bar' => 'value'))));
		$doc->errors(array('foo.bar' => 'Something bad happened.'));

		$this->form->create($doc);
		$result = $this->form->field('foo.bar');

		$this->assertTags($result, array(
			array('div' => array()),
			'label' => array('for' => 'FooBar'), 'Foo Bar', '/label',
			'input' => array(
				'type' => 'text', 'name' => 'foo[bar]', 'id' => 'FooBar', 'value' => 'value'
			),
			'div' => array('class' => 'error'), 'Something bad happened.', '/div',
			array('/div' => array())
		));
	}

	public function testFormCreationWithNoContext() {
		$this->form = new Form(array('context' => new MockFormRenderer(array(
			'request' => new Request(array('base' => '/bbq'))
		))));
		$result = $this->form->create(null, array('url' => '/foo'));

		$this->assertTags($result, array('form' => array(
			'action' => "/bbq/foo", 'method'=> "post"
		)));
	}

	/**
	 * Tests that magic method support can be used to automatically generate a `<button />` tag
	 * based on the default string template.
	 */
	public function testAutoMagicButton() {
		$result = $this->form->button('Foo!', array('id' => 'bar'));
		$this->assertTags($result, array('button' => array('id' => 'bar'), 'Foo!', '/button'));
	}
}

?>