Code Coverage for /Users/ericduran/Sites/drupal/drupal/core/lib/Drupal/Core/Template/AttributeValueBase.php

1	<?php
2
3	/**
4	* @file
5	* Contains \Drupal\Core\Template\AttributeValueBase.
6	*/
7
8	namespace Drupal\Core\Template;
9	use Drupal\Component\Utility\Html;
10
11	/**
12	* Defines the base class for an attribute type.
13	*
14	* @see \Drupal\Core\Template\Attribute
15	*/
16	abstract class AttributeValueBase {
17
18	/**
19	* Renders '$name=""' if $value is an empty string.
20	*
21	* @see \Drupal\Core\Template\AttributeValueBase::render()
22	*/
23	const RENDER_EMPTY_ATTRIBUTE = TRUE;
24
25	/**
26	* The value itself.
27	*
28	* @var mixed
29	*/
30	protected $value;
31
32	/**
33	* The name of the value.
34	*
35	* @var mixed
36	*/
37	protected $name;
38
39	/**
40	* Constructs a \Drupal\Core\Template\AttributeValueBase object.
41	*/
42	public function __construct($name, $value) {
43	$this->name = $name;
44	$this->value = $value;
45	}
46
47	/**
48	* Returns a string representation of the attribute.
49	*
50	* While __toString only returns the value in a string form, render()
51	* contains the name of the attribute as well.
52	*
53	* @return string
54	* The string representation of the attribute.
55	*/
56	public function render() {
57	$value = (string) $this;
58	if (isset($this->value) && static::RENDER_EMPTY_ATTRIBUTE \|\| !empty($value)) {
59	return Html::escape($this->name) . '="' . $value . '"';
60	}
61	}
62
63	/**
64	* Returns the raw value.
65	*/
66	public function value() {
67	return $this->value;
68	}
69
70	/**
71	* Implements the magic __toString() method.
72	*/
73	abstract function __toString();
74
75	}