diff options
Diffstat (limited to 'vendor/oojs/oojs-ui/php/mixins/TitledElement.php')
-rw-r--r-- | vendor/oojs/oojs-ui/php/mixins/TitledElement.php | 74 |
1 files changed, 74 insertions, 0 deletions
diff --git a/vendor/oojs/oojs-ui/php/mixins/TitledElement.php b/vendor/oojs/oojs-ui/php/mixins/TitledElement.php new file mode 100644 index 00000000..5f1317c4 --- /dev/null +++ b/vendor/oojs/oojs-ui/php/mixins/TitledElement.php @@ -0,0 +1,74 @@ +<?php + +namespace OOUI; + +/** + * Element with a title. + * + * Titles are rendered by the browser and are made visible when hovering the element. Titles are + * not visible on touch devices. + * + * @abstract + */ +class TitledElement extends ElementMixin { + /** + * Title text. + * + * @var string + */ + protected $title = null; + + public static $targetPropertyName = 'titled'; + + /** + * @param Element $element Element being mixed into + * @param array $config Configuration options + * @param string $config['title'] Title. If not provided, the static property 'title' is used. + */ + public function __construct( Element $element, array $config = array() ) { + // Parent constructor + $target = isset( $config['titled'] ) ? $config['titled'] : $element; + parent::__construct( $element, $target, $config ); + + // Initialization + $this->setTitle( + isset( $config['title'] ) ? $config['title'] : + ( isset( $element::$title ) ? $element::$title : null ) + ); + } + + /** + * Set title. + * + * @param string|null $title Title text or null for no title + * @chainable + */ + public function setTitle( $title ) { + if ( $this->title !== $title ) { + $this->title = $title; + if ( $title !== null ) { + $this->target->setAttributes( array( 'title' => $title ) ); + } else { + $this->target->removeAttributes( array( 'title' ) ); + } + } + + return $this; + } + + /** + * Get title. + * + * @return string Title string + */ + public function getTitle() { + return $this->title; + } + + public function getConfig( &$config ) { + if ( $this->title !== null ) { + $config['title'] = $this->title; + } + return parent::getConfig( $config ); + } +} |