cakephp/tests/TestCase/View/Widget/SelectBoxTest.php

<?php
/**
 * CakePHP(tm) : Rapid Development Framework (http://cakephp.org)
 * Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
 *
 * Licensed under The MIT License
 * For full copyright and license information, please see the LICENSE.txt
 * Redistributions of files must retain the above copyright notice.
 *
 * @copyright     Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
 * @link          http://cakephp.org CakePHP(tm) Project
 * @since         3.0.0
 * @license       http://www.opensource.org/licenses/mit-license.php MIT License
 */
namespace Cake\Test\TestCase\View\Widget;

use Cake\TestSuite\TestCase;
use Cake\View\StringTemplate;
use Cake\View\Widget\SelectBox;

/**
 * SelectBox test case
 */
class SelectBoxTest extends TestCase {

/**
 * setup method.
 *
 * @return void
 */
	public function setUp() {
		parent::setUp();
		$templates = [
			'select' => '<select name="{{name}}"{{attrs}}>{{content}}</select>',
			'selectMultiple' => '<select name="{{name}}[]" multiple="multiple"{{attrs}}>{{content}}</select>',
			'option' => '<option value="{{value}}"{{attrs}}>{{text}}</option>',
			'optgroup' => '<optgroup label="{{label}}"{{attrs}}>{{content}}</optgroup>',
		];
		$this->templates = new StringTemplate($templates);
	}

/**
 * test render no options
 *
 * @return void
 */
	public function testRenderNoOptions() {
		$select = new SelectBox($this->templates);
		$data = [
			'id' => 'BirdName',
			'name' => 'Birds[name]',
			'options' => []
		];
		$result = $select->render($data);
		$expected = [
			'select' => ['name' => 'Birds[name]', 'id' => 'BirdName'],
			'/select'
		];
		$this->assertTags($result, $expected);
	}

/**
 * test simple rendering
 *
 * @return void
 */
	public function testRenderSimple() {
		$select = new SelectBox($this->templates);
		$data = [
			'id' => 'BirdName',
			'name' => 'Birds[name]',
			'options' => ['a' => 'Albatross', 'b' => 'Budgie']
		];
		$result = $select->render($data);
		$expected = [
			'select' => ['name' => 'Birds[name]', 'id' => 'BirdName'],
			['option' => ['value' => 'a']], 'Albatross', '/option',
			['option' => ['value' => 'b']], 'Budgie', '/option',
			'/select'
		];
		$this->assertTags($result, $expected);
	}

/**
 * test simple iterator rendering
 *
 * @return void
 */
	public function testRenderSimpleIterator() {
		$select = new SelectBox($this->templates);
		$options = new \ArrayObject(['a' => 'Albatross', 'b' => 'Budgie']);
		$data = [
			'name' => 'Birds[name]',
			'options' => $options,
			'empty' => true
		];
		$result = $select->render($data);
		$expected = [
			'select' => ['name' => 'Birds[name]'],
			['option' => ['value' => '']], '/option',
			['option' => ['value' => 'a']], 'Albatross', '/option',
			['option' => ['value' => 'b']], 'Budgie', '/option',
			'/select'
		];
		$this->assertTags($result, $expected);
	}

/**
 * test complex option rendering
 *
 * @return void
 */
	public function testRenderComplex() {
		$select = new SelectBox($this->templates);
		$data = [
			'id' => 'BirdName',
			'name' => 'Birds[name]',
			'options' => [
				['value' => 'a', 'text' => 'Albatross'],
				['value' => 'b', 'text' => 'Budgie', 'data-foo' => 'bar'],
			]
		];
		$result = $select->render($data);
		$expected = [
			'select' => ['name' => 'Birds[name]', 'id' => 'BirdName'],
			['option' => ['value' => 'a']],
			'Albatross',
			'/option',
			['option' => ['value' => 'b', 'data-foo' => 'bar']],
			'Budgie',
			'/option',
			'/select'
		];
		$this->assertTags($result, $expected);
	}

/**
 * test rendering with a selected value
 *
 * @return void
 */
	public function testRenderSelected() {
		$select = new SelectBox($this->templates);
		$data = [
			'id' => 'BirdName',
			'name' => 'Birds[name]',
			'val' => '1',
			'options' => [
				1 => 'one',
				'1x' => 'one x',
				'2' => 'two',
				'2x' => 'two x',
			]
		];
		$result = $select->render($data);
		$expected = [
			'select' => ['name' => 'Birds[name]', 'id' => 'BirdName'],
			['option' => ['value' => '1', 'selected' => 'selected']], 'one', '/option',
			['option' => ['value' => '1x']], 'one x', '/option',
			['option' => ['value' => '2']], 'two', '/option',
			['option' => ['value' => '2x']], 'two x', '/option',
			'/select'
		];
		$this->assertTags($result, $expected);

		$data['val'] = 2;
		$result = $select->render($data);
		$expected = [
			'select' => ['name' => 'Birds[name]', 'id' => 'BirdName'],
			['option' => ['value' => '1']], 'one', '/option',
			['option' => ['value' => '1x']], 'one x', '/option',
			['option' => ['value' => '2', 'selected' => 'selected']], 'two', '/option',
			['option' => ['value' => '2x']], 'two x', '/option',
			'/select'
		];
		$this->assertTags($result, $expected);
	}

/**
 * test rendering a multi select
 *
 * @return void
 */
	public function testRenderMultipleSelect() {
		$select = new SelectBox($this->templates);
		$data = [
			'id' => 'BirdName',
			'name' => 'Birds[name]',
			'multiple' => true,
			'options' => ['a' => 'Albatross', 'b' => 'Budgie']
		];
		$result = $select->render($data);
		$expected = [
			'select' => [
				'name' => 'Birds[name][]',
				'id' => 'BirdName',
				'multiple' => 'multiple',
			],
			['option' => ['value' => 'a']], 'Albatross', '/option',
			['option' => ['value' => 'b']], 'Budgie', '/option',
			'/select'
		];
		$this->assertTags($result, $expected);
	}

/**
 * test rendering multi select & selected values
 *
 * @return void
 */
	public function testRenderMultipleSelected() {
		$select = new SelectBox($this->templates);
		$data = [
			'multiple' => true,
			'id' => 'BirdName',
			'name' => 'Birds[name]',
			'val' => ['1', '2', 'burp'],
			'options' => [
				1 => 'one',
				'1x' => 'one x',
				'2' => 'two',
				'2x' => 'two x',
			]
		];
		$result = $select->render($data);
		$expected = [
			'select' => [
				'name' => 'Birds[name][]',
				'multiple' => 'multiple',
				'id' => 'BirdName'
			],
			['option' => ['value' => '1', 'selected' => 'selected']], 'one', '/option',
			['option' => ['value' => '1x']], 'one x', '/option',
			['option' => ['value' => '2', 'selected' => 'selected']], 'two', '/option',
			['option' => ['value' => '2x']], 'two x', '/option',
			'/select'
		];
		$this->assertTags($result, $expected);
	}

/**
 * test rendering with option groups
 *
 * @return void
 */
	public function testRenderOptionGroups() {
		$select = new SelectBox($this->templates);
		$data = [
			'name' => 'Birds[name]',
			'options' => [
				'Mammal' => [
					'beaver' => 'Beaver',
					'elk' => 'Elk',
				],
				'Bird' => [
					'budgie' => 'Budgie',
					'eagle' => 'Eagle',
				]
			]
		];
		$result = $select->render($data);
		$expected = [
			'select' => [
				'name' => 'Birds[name]',
			],
			['optgroup' => ['label' => 'Mammal']],
			['option' => ['value' => 'beaver']],
			'Beaver',
			'/option',
			['option' => ['value' => 'elk']],
			'Elk',
			'/option',
			'/optgroup',
			['optgroup' => ['label' => 'Bird']],
			['option' => ['value' => 'budgie']],
			'Budgie',
			'/option',
			['option' => ['value' => 'eagle']],
			'Eagle',
			'/option',
			'/optgroup',
			'/select'
		];
		$this->assertTags($result, $expected);
	}

/**
 * test rendering with option groups and escaping
 *
 * @return void
 */
	public function testRenderOptionGroupsEscape() {
		$select = new SelectBox($this->templates);
		$data = [
			'name' => 'Birds[name]',
			'options' => [
				'>XSS<' => [
					'1' => 'One>',
				],
			]
		];
		$result = $select->render($data);
		$expected = [
			'select' => [
				'name' => 'Birds[name]',
			],
			['optgroup' => ['label' => '&gt;XSS&lt;']],
			['option' => ['value' => '1']],
			'One&gt;',
			'/option',
			'/optgroup',
			'/select'
		];
		$this->assertTags($result, $expected);

		$data['escape'] = false;
		$result = $select->render($data);
		$expected = [
			'select' => [
				'name' => 'Birds[name]',
			],
			['optgroup' => ['label' => '>XSS<']],
			['option' => ['value' => '1']],
			'One>',
			'/option',
			'/optgroup',
			'/select'
		];
		$this->assertTags($result, $expected);
	}

/**
 * test rendering with option groups
 *
 * @return void
 */
	public function testRenderOptionGroupsWithAttributes() {
		$select = new SelectBox($this->templates);
		$data = [
			'name' => 'Birds[name]',
			'options' => [
				[
					'text' => 'Mammal',
					'data-foo' => 'bar',
					'options' => [
						'beaver' => 'Beaver',
						'elk' => 'Elk',
					]
				]
			]
		];
		$result = $select->render($data);
		$expected = [
			'select' => [
				'name' => 'Birds[name]',
			],
			['optgroup' => ['data-foo' => 'bar', 'label' => 'Mammal']],
			['option' => ['value' => 'beaver']],
			'Beaver',
			'/option',
			['option' => ['value' => 'elk']],
			'Elk',
			'/option',
			'/optgroup',
			'/select'
		];
		$this->assertTags($result, $expected);
	}

/**
 * test rendering with option groups with traversable nodes
 *
 * @return void
 */
	public function testRenderOptionGroupsTraversable() {
		$select = new SelectBox($this->templates);
		$mammals = new \ArrayObject(['beaver' => 'Beaver', 'elk' => 'Elk']);
		$data = [
			'name' => 'Birds[name]',
			'options' => [
				'Mammal' => $mammals,
				'Bird' => [
					'budgie' => 'Budgie',
					'eagle' => 'Eagle',
				]
			]
		];
		$result = $select->render($data);
		$expected = [
			'select' => [
				'name' => 'Birds[name]',
			],
			['optgroup' => ['label' => 'Mammal']],
			['option' => ['value' => 'beaver']],
			'Beaver',
			'/option',
			['option' => ['value' => 'elk']],
			'Elk',
			'/option',
			'/optgroup',
			['optgroup' => ['label' => 'Bird']],
			['option' => ['value' => 'budgie']],
			'Budgie',
			'/option',
			['option' => ['value' => 'eagle']],
			'Eagle',
			'/option',
			'/optgroup',
			'/select'
		];
		$this->assertTags($result, $expected);
	}

/**
 * test rendering option groups and selected values
 *
 * @return void
 */
	public function testRenderOptionGroupsSelectedAndDisabled() {
		$select = new SelectBox($this->templates);
		$data = [
			'name' => 'Birds[name]',
			'val' => ['1', '2', 'burp'],
			'disabled' => ['1x', '2x', 'nope'],
			'options' => [
				'ones' => [
					1 => 'one',
					'1x' => 'one x',
				],
				'twos' => [
					'2' => 'two',
					'2x' => 'two x',
				]
			]
		];
		$result = $select->render($data);
		$expected = [
			'select' => [
				'name' => 'Birds[name]',
			],

			['optgroup' => ['label' => 'ones']],
			['option' => ['value' => '1', 'selected' => 'selected']], 'one', '/option',
			['option' => ['value' => '1x', 'disabled' => 'disabled']], 'one x', '/option',
			'/optgroup',
			['optgroup' => ['label' => 'twos']],
			['option' => ['value' => '2', 'selected' => 'selected']], 'two', '/option',
			['option' => ['value' => '2x', 'disabled' => 'disabled']], 'two x', '/option',
			'/optgroup',
			'/select'
		];
		$this->assertTags($result, $expected);
	}

/**
 * test rendering a totally disabled element
 *
 * @return void
 */
	public function testRenderDisabled() {
		$select = new SelectBox($this->templates);
		$data = [
			'disabled' => true,
			'name' => 'Birds[name]',
			'options' => ['a' => 'Albatross', 'b' => 'Budgie'],
			'val' => 'a',
		];
		$result = $select->render($data);
		$expected = [
			'select' => [
				'name' => 'Birds[name]',
				'disabled' => 'disabled',
			],
			['option' => ['value' => 'a', 'selected' => 'selected']], 'Albatross', '/option',
			['option' => ['value' => 'b']], 'Budgie', '/option',
			'/select'
		];
		$this->assertTags($result, $expected);
	}

/**
 * test rendering a disabled element
 *
 * @return void
 */
	public function testRenderDisabledMultiple() {
		$select = new SelectBox($this->templates);
		$data = [
			'disabled' => ['a', 'c'],
			'val' => 'a',
			'name' => 'Birds[name]',
			'options' => [
				'a' => 'Albatross',
				'b' => 'Budgie',
				'c' => 'Canary',
			]
		];
		$result = $select->render($data);
		$expected = [
			'select' => [
				'name' => 'Birds[name]',
			],
			['option' => ['value' => 'a', 'selected' => 'selected', 'disabled' => 'disabled']],
			'Albatross',
			'/option',
			['option' => ['value' => 'b']],
			'Budgie',
			'/option',
			['option' => ['value' => 'c', 'disabled' => 'disabled']],
			'Canary',
			'/option',
			'/select'
		];
		$this->assertTags($result, $expected);
	}

/**
 * test rendering with an empty value
 *
 * @return void
 */
	public function testRenderEmptyOption() {
		$select = new SelectBox($this->templates);
		$data = [
			'id' => 'BirdName',
			'name' => 'Birds[name]',
			'empty' => true,
			'options' => ['a' => 'Albatross', 'b' => 'Budgie']
		];
		$result = $select->render($data);
		$expected = [
			'select' => ['name' => 'Birds[name]', 'id' => 'BirdName'],
			['option' => ['value' => '']], '/option',
			['option' => ['value' => 'a']], 'Albatross', '/option',
			['option' => ['value' => 'b']], 'Budgie', '/option',
			'/select'
		];
		$this->assertTags($result, $expected);

		$data['empty'] = 'empty';
		$result = $select->render($data);
		$expected = [
			'select' => ['name' => 'Birds[name]', 'id' => 'BirdName'],
			['option' => ['value' => '']], 'empty', '/option',
			['option' => ['value' => 'a']], 'Albatross', '/option',
			['option' => ['value' => 'b']], 'Budgie', '/option',
			'/select'
		];
		$this->assertTags($result, $expected);

		$data['empty'] = 'empty';
		$data['val'] = '';
		$result = $select->render($data);
		$expected = [
			'select' => ['name' => 'Birds[name]', 'id' => 'BirdName'],
			['option' => ['value' => '', 'selected' => 'selected']], 'empty', '/option',
			['option' => ['value' => 'a']], 'Albatross', '/option',
			['option' => ['value' => 'b']], 'Budgie', '/option',
			'/select'
		];
		$this->assertTags($result, $expected);

		$data['val'] = false;
		$result = $select->render($data);
		$this->assertTags($result, $expected);
	}

/**
 * Test rendering with disabling escaping.
 *
 * @return void
 */
	public function testRenderEscapingOption() {
		$select = new SelectBox($this->templates);
		$data = [
			'name' => 'Birds[name]',
			'options' => [
				'a' => '>Albatross',
				'b' => '>Budgie',
				'c' => '>Canary',
			]
		];
		$result = $select->render($data);
		$expected = [
			'select' => [
				'name' => 'Birds[name]',
			],
			['option' => ['value' => 'a']],
			'&gt;Albatross',
			'/option',
			['option' => ['value' => 'b']],
			'&gt;Budgie',
			'/option',
			['option' => ['value' => 'c']],
			'&gt;Canary',
			'/option',
			'/select'
		];
		$this->assertTags($result, $expected);

		$data = [
			'escape' => false,
			'name' => 'Birds[name]',
			'options' => [
				'>a' => '>Albatross',
			]
		];
		$result = $select->render($data);
		$expected = [
			'select' => [
				'name' => 'Birds[name]',
			],
			['option' => ['value' => '>a']],
			'>Albatross',
			'/option',
			'/select'
		];
		$this->assertTags($result, $expected);
	}

}