Mercurial > hg > isophonics-drupal-site
diff core/lib/Drupal/Component/Render/MarkupTrait.php @ 0:4c8ae668cc8c
Initial import (non-working)
author | Chris Cannam |
---|---|
date | Wed, 29 Nov 2017 16:09:58 +0000 |
parents | |
children | 129ea1e6d783 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/core/lib/Drupal/Component/Render/MarkupTrait.php Wed Nov 29 16:09:58 2017 +0000 @@ -0,0 +1,77 @@ +<?php + +namespace Drupal\Component\Render; + +use Drupal\Component\Utility\Unicode; + +/** + * Implements MarkupInterface and Countable for rendered objects. + * + * @see \Drupal\Component\Render\MarkupInterface + */ +trait MarkupTrait { + + /** + * The safe string. + * + * @var string + */ + protected $string; + + /** + * Creates a Markup object if necessary. + * + * If $string is equal to a blank string then it is not necessary to create a + * Markup object. If $string is an object that implements MarkupInterface it + * is returned unchanged. + * + * @param mixed $string + * The string to mark as safe. This value will be cast to a string. + * + * @return string|\Drupal\Component\Render\MarkupInterface + * A safe string. + */ + public static function create($string) { + if ($string instanceof MarkupInterface) { + return $string; + } + $string = (string) $string; + if ($string === '') { + return ''; + } + $safe_string = new static(); + $safe_string->string = $string; + return $safe_string; + } + + /** + * Returns the string version of the Markup object. + * + * @return string + * The safe string content. + */ + public function __toString() { + return $this->string; + } + + /** + * Returns the string length. + * + * @return int + * The length of the string. + */ + public function count() { + return Unicode::strlen($this->string); + } + + /** + * Returns a representation of the object for use in JSON serialization. + * + * @return string + * The safe string content. + */ + public function jsonSerialize() { + return $this->__toString(); + } + +}