silverstripe-framework/tests/php/Forms/ListboxFieldTest.php

<?php

namespace SilverStripe\Forms\Tests;

use SilverStripe\Forms\Tests\ListboxFieldTest\Article;
use SilverStripe\Forms\Tests\ListboxFieldTest\Tag;
use SilverStripe\Forms\Tests\ListboxFieldTest\TestObject;
use SilverStripe\ORM\DataObject;
use SilverStripe\Dev\CSSContentParser;
use SilverStripe\Dev\SapphireTest;
use SilverStripe\Forms\ListboxField;
use SilverStripe\Forms\RequiredFields;
use SilverStripe\View\ArrayData;

class ListboxFieldTest extends SapphireTest {

	protected static $fixture_file = 'ListboxFieldTest.yml';

	protected $extraDataObjects = array(
		TestObject::class,
		Article::class,
		Tag::class
	);

	public function testFieldWithManyManyRelationship() {
		$articleWithTags = $this->objFromFixture(Article::class, 'articlewithtags');
		$tag1 = $this->objFromFixture(Tag::class, 'tag1');
		$tag2 = $this->objFromFixture(Tag::class, 'tag2');
		$tag3 = $this->objFromFixture(Tag::class, 'tag3');
		$field = new ListboxField("Tags", "Test field", DataObject::get(Tag::class)->map()->toArray());
		$field->setValue(null, $articleWithTags);

		$p = new CSSContentParser($field->Field());
		$tag1xml = $p->getByXpath('//option[@value=' . $tag1->ID . ']');
		$tag2xml = $p->getByXpath('//option[@value=' . $tag2->ID . ']');
		$tag3xml = $p->getByXpath('//option[@value=' . $tag3->ID . ']');
		$this->assertEquals('selected', (string)$tag1xml[0]['selected']);
		$this->assertEquals('selected', (string)$tag2xml[0]['selected']);
		$this->assertNull($tag3xml[0]['selected']);
	}

	public function testFieldWithDisabledItems() {
		$articleWithTags = $this->objFromFixture(Article::class, 'articlewithtags');
		$tag1 = $this->objFromFixture(Tag::class, 'tag1');
		$tag2 = $this->objFromFixture(Tag::class, 'tag2');
		$tag3 = $this->objFromFixture(Tag::class, 'tag3');
		$field = new ListboxField("Tags", "Test field", DataObject::get(Tag::class)->map()->toArray());
		$field->setValue(null, $articleWithTags);
		$field->setDisabledItems(array($tag1->ID, $tag3->ID));

		$p = new CSSContentParser($field->Field());
		$tag1xml = $p->getByXpath('//option[@value=' . $tag1->ID . ']');
		$tag2xml = $p->getByXpath('//option[@value=' . $tag2->ID . ']');
		$tag3xml = $p->getByXpath('//option[@value=' . $tag3->ID . ']');
		$this->assertEquals('selected', (string)$tag1xml[0]['selected']);
		$this->assertEquals('disabled', (string)$tag1xml[0]['disabled']);
		$this->assertEquals('selected', (string)$tag2xml[0]['selected']);
		$this->assertNull($tag2xml[0]['disabled']);
		$this->assertNull($tag3xml[0]['selected']);
		$this->assertEquals('disabled', (string)$tag3xml[0]['disabled']);
	}

	public function testSaveIntoNullValueWithMultipleOff() {
		$choices = array('a' => 'a value', 'b' => 'b value','c' => 'c value');
		$field = new ListboxField('Choices', 'Choices', $choices);

		$obj = new TestObject();
		$field->setValue('a');
		$field->saveInto($obj);
		$field->setValue(null);
		$field->saveInto($obj);
		$this->assertNull($obj->Choices);
	}

	public function testSaveIntoNullValueWithMultipleOn() {
		$choices = array('a' => 'a value', 'b' => 'b value','c' => 'c value');
		$field = new ListboxField('Choices', 'Choices', $choices);

		$obj = new TestObject();
		$field->setValue(array('a', 'c'));
		$field->saveInto($obj);
		$field->setValue('');
		$field->saveInto($obj);
		$this->assertEquals('', $obj->Choices);
	}

	public function testSaveInto() {
		$choices = array('a' => 'a value', 'b' => 'b value','c' => 'c value');
		$field = new ListboxField('Choices', 'Choices', $choices);

		$obj = new TestObject();
		$field->setValue('a');
		$field->saveInto($obj);
		$this->assertEquals('["a"]', $obj->Choices);
	}

	public function testSaveIntoMultiple() {
		$choices = array('a' => 'a value', 'b' => 'b value','c' => 'c value');
		$field = new ListboxField('Choices', 'Choices', $choices);

		// As array
		$obj1 = new TestObject();
		$field->setValue(array('a', 'c'));
		$field->saveInto($obj1);
		$this->assertEquals('["a","c"]', $obj1->Choices);

		// As string
		$obj2 = new TestObject();
		$obj2->Choices = '["a","c"]';
		$field->setValue(null, $obj2);
		$this->assertEquals(array('a', 'c'), $field->Value());
		$field->saveInto($obj2);
		$this->assertEquals('["a","c"]', $obj2->Choices);
	}

	public function testSaveIntoManyManyRelation() {
		$article = $this->objFromFixture(Article::class, 'articlewithouttags');
		$articleWithTags = $this->objFromFixture(Article::class, 'articlewithtags');
		$tag1 = $this->objFromFixture(Tag::class, 'tag1');
		$tag2 = $this->objFromFixture(Tag::class, 'tag2');
		$field = new ListboxField("Tags", "Test field", DataObject::get(Tag::class)->map()->toArray());

		// Save new relations
		$field->setValue(array($tag1->ID,$tag2->ID));
		$field->saveInto($article);
		$article = DataObject::get_by_id(Article::class, $article->ID, false);
		$this->assertEquals(array($tag1->ID, $tag2->ID), $article->Tags()->sort('ID')->column('ID'));

		// Remove existing relation
		$field->setValue(array($tag1->ID));
		$field->saveInto($article);
		$article = DataObject::get_by_id(Article::class, $article->ID, false);
		$this->assertEquals(array($tag1->ID), $article->Tags()->sort('ID')->column('ID'));

		// Set NULL value
		$field->setValue(null);
		$field->saveInto($article);
		$article = DataObject::get_by_id(Article::class, $article->ID, false);
		$this->assertEquals(array(), $article->Tags()->sort('ID')->column('ID'));
	}

	public function testFieldRenderingMultipleOff() {
		$choices = array('a' => 'a value', 'b' => 'b value','c' => 'c value');
		$field = new ListboxField('Choices', 'Choices', $choices);
		$field->setValue('a');
		$parser = new CSSContentParser($field->Field());
		$optEls = $parser->getBySelector('option');
		$this->assertEquals(3, count($optEls));
		$this->assertEquals('selected', (string)$optEls[0]['selected']);
		$this->assertEquals('', (string)$optEls[1]['selected']);
		$this->assertEquals('', (string)$optEls[2]['selected']);
	}

	public function testFieldRenderingMultipleOn() {
		$choices = array('a' => 'a value', 'b' => 'b value','c' => 'c value');
		$field = new ListboxField('Choices', 'Choices', $choices);
		$field->setValue(array('a', 'c'));
		$parser = new CSSContentParser($field->Field());
		$optEls = $parser->getBySelector('option');
		$this->assertEquals(3, count($optEls));
		$this->assertEquals('selected', (string)$optEls[0]['selected']);
		$this->assertEquals('', (string)$optEls[1]['selected']);
		$this->assertEquals('selected', (string)$optEls[2]['selected']);
	}

	public function testValidationWithArray() {
		//test with array input
		$field = ListboxField::create('Test', 'Testing', array(
			1 => "One",
			2 => "Two",
			3 => "Three"
		));
		$validator = new RequiredFields();

		$field->setValue(1);
		$this->assertTrue(
			$field->validate($validator),
			'Validates values in source map'
		);
		$field->setValue(array(1));
		$this->assertTrue(
			$field->validate($validator),
			'Validates values within source array'
		);
		//non valid value should fail
		$field->setValue(4);
		$this->assertFalse(
			$field->validate($validator),
			'Does not validates values not within source array'
		);
	}

	public function testValidationWithDataList() {
		//test with datalist input
		$tag1 = $this->objFromFixture(Tag::class, 'tag1');
		$tag2 = $this->objFromFixture(Tag::class, 'tag2');
		$tag3 = $this->objFromFixture(Tag::class, 'tag3');
		$field = ListboxField::create('Test', 'Testing', DataObject::get(Tag::class)->map()->toArray());
		$validator = new RequiredFields();

		$field->setValue(
			$tag1->ID
		);
		$this->assertTrue(
			$field->validate($validator),
			'Field validates values in source map'
		);

		/**
		 * @todo re-enable these tests when field validation is removed from {@link ListboxField::setValue()} and moved
		 * to the {@link ListboxField::validate()} function
		 */
//		$field->setValue(4);
//		$this->assertFalse(
//			$field->validate($validator),
//			'Field does not validate values outside of source map'
//		);
		$field->setValue(false, new ArrayData(array(
			$tag1->ID => $tag1->ID,
			$tag2->ID => $tag2->ID
		)));
		$this->assertTrue(
			$field->validate($validator),
			'Validates values in source map'
		);
		//invalid value should fail
		$field->setValue(4);
		$this->assertFalse(
			$field->validate($validator),
			'Does not validate values not within source map'
		);
	}

}