MediaWiki 1.30.2

[autoinstallsdev/mediawiki.git] / vendor / oojs / oojs-ui / php / widgets / ComboBoxInputWidget.php

diff --git a/vendor/oojs/oojs-ui/php/widgets/ComboBoxInputWidget.php b/vendor/oojs/oojs-ui/php/widgets/ComboBoxInputWidget.php
new file mode 100644 (file)
index 0000000..c2f8d34
--- /dev/null
+++ b/vendor/oojs/oojs-ui/php/widgets/ComboBoxInputWidget.php
@@ -0,0 +1,79 @@
+<?php
+
+namespace OOUI;
+
+/**
+ * Combo box input widget, wrapping a text input with `<datalist>`. Intended to be used within a
+ * OO.ui.FormLayout.
+ */
+class ComboBoxInputWidget extends TextInputWidget {
+       /**
+        * HTML `<option>` tags for this widget, as Tags.
+        * @var array
+        */
+       protected $options = [];
+
+       /**
+        * @param array $config Configuration options
+        * @param array[] $config['options'] Array of menu options in the format
+        *   `[ 'data' => …, 'label' => … ]`
+        */
+       public function __construct( array $config = [] ) {
+               // ComboBoxInputWidget shouldn't support `multiline`
+               $config['multiline'] = false;
+
+               // Parent constructor
+               parent::__construct( $config );
+
+               // Initialization
+               $this->forceAutocomplete = isset( $config['autocomplete'] ) ? $config['autocomplete'] : false;
+               $this->downIndicator = new IndicatorWidget( [ 'indicator' => 'down' ] );
+               $this->datalist = new Tag( 'datalist' );
+               $this->datalist->setAttributes( [ 'id' => Tag::generateElementId() ] );
+               $this->input->setAttributes( [ 'list' => $this->datalist->getAttribute( 'id' ) ] );
+
+               $this->setOptions( isset( $config['options'] ) ? $config['options'] : [] );
+               $this->addClasses( [ 'oo-ui-comboBoxInputWidget', 'oo-ui-comboBoxInputWidget-php' ] );
+               $this->appendContent( $this->downIndicator, $this->datalist );
+       }
+
+       /**
+        * Set the options available for this input.
+        *
+        * @param array[] $options Array of menu options in the format
+        *   `[ 'data' => …, 'label' => … ]`
+        * @return $this
+        */
+       public function setOptions( $options ) {
+               $this->options = [];
+
+               $this->datalist->clearContent();
+               foreach ( $options as $opt ) {
+                       $option = ( new Tag( 'option' ) )
+                               ->setAttributes( [ 'value' => $opt['data'] ] )
+                               ->appendContent( isset( $opt['label'] ) ? $opt['label'] : $opt['data'] );
+
+                       $this->options[] = $option;
+                       $this->datalist->appendContent( $option );
+               }
+
+               return $this;
+       }
+
+       public function getConfig( &$config ) {
+               $o = [];
+               foreach ( $this->options as $option ) {
+                       $label = $option->content[0];
+                       $data = $option->getAttribute( 'value' );
+                       $o[] = [ 'data' => $data, 'label' => $label ];
+               }
+               $config['options'] = $o;
+               // JS ComboBoxInputWidget has `autocomplete: false` in the defaults. Make sure
+               // explicitly passing `autocomplete: true` overrides that. Doing so doesn't make
+               // much sense, this is just to make the tests happy.
+               if ( $this->forceAutocomplete ) {
+                       $config['autocomplete'] = true;
+               }
+               return parent::getConfig( $config );
+       }
+}