includes/htmlform/fields/HTMLSelectAndOtherField.php

   1 <?php
   2
   3 /**
   4  * Double field with a dropdown list constructed from a system message in the format
   5  *     * Optgroup header
   6  *     ** <option value>
   7  *     * New Optgroup header
   8  * Plus a text field underneath for an additional reason.  The 'value' of the field is
   9  * "<select>: <extra reason>", or "<extra reason>" if nothing has been selected in the
  10  * select dropdown.
  11  * @todo FIXME: If made 'required', only the text field should be compulsory.
  12  */
  13 class HTMLSelectAndOtherField extends HTMLSelectField {
  14         public function __construct( $params ) {
  15                 if ( array_key_exists( 'other', $params ) ) {
  16                         // Do nothing
  17                 } elseif ( array_key_exists( 'other-message', $params ) ) {
  18                         $params['other'] = $this->getMessage( $params['other-message'] )->plain();
  19                 } else {
  20                         $params['other'] = $this->msg( 'htmlform-selectorother-other' )->plain();
  21                 }
  22
  23                 parent::__construct( $params );
  24
  25                 if ( $this->getOptions() === null ) {
  26                         // Sulk
  27                         throw new MWException( 'HTMLSelectAndOtherField called without any options' );
  28                 }
  29                 if ( !in_array( 'other', $this->mOptions, true ) ) {
  30                         // Have 'other' always as first element
  31                         $this->mOptions = [ $params['other'] => 'other' ] + $this->mOptions;
  32                 }
  33                 $this->mFlatOptions = self::flattenOptions( $this->getOptions() );
  34         }
  35
  36         public function getInputHTML( $value ) {
  37                 $select = parent::getInputHTML( $value[1] );
  38
  39                 $textAttribs = [
  40                         'id' => $this->mID . '-other',
  41                         'size' => $this->getSize(),
  42                         'class' => [ 'mw-htmlform-select-and-other-field' ],
  43                         'data-id-select' => $this->mID,
  44                 ];
  45
  46                 if ( $this->mClass !== '' ) {
  47                         $textAttribs['class'][] = $this->mClass;
  48                 }
  49
  50                 if ( isset( $this->mParams['maxlength-unit'] ) ) {
  51                         $textAttribs['data-mw-maxlength-unit'] = $this->mParams['maxlength-unit'];
  52                 }
  53
  54                 $allowedParams = [
  55                         'required',
  56                         'autofocus',
  57                         'multiple',
  58                         'disabled',
  59                         'tabindex',
  60                         'maxlength', // gets dynamic with javascript, see mediawiki.htmlform.js
  61                         'maxlength-unit', // 'bytes' or 'codepoints', see mediawiki.htmlform.js
  62                 ];
  63
  64                 $textAttribs += $this->getAttributes( $allowedParams );
  65
  66                 $textbox = Html::input( $this->mName . '-other', $value[2], 'text', $textAttribs );
  67
  68                 return "$select<br />\n$textbox";
  69         }
  70
  71         protected function getOOUIModules() {
  72                 return [ 'mediawiki.widgets.SelectWithInputWidget' ];
  73         }
  74
  75         public function getInputOOUI( $value ) {
  76                 $this->mParent->getOutput()->addModuleStyles( 'mediawiki.widgets.SelectWithInputWidget.styles' );
  77
  78                 # TextInput
  79                 $textAttribs = [
  80                         'name' => $this->mName . '-other',
  81                         'value' => $value[2],
  82                 ];
  83
  84                 $allowedParams = [
  85                         'required',
  86                         'autofocus',
  87                         'multiple',
  88                         'disabled',
  89                         'tabindex',
  90                         'maxlength',
  91                 ];
  92
  93                 $textAttribs += OOUI\Element::configFromHtmlAttributes(
  94                         $this->getAttributes( $allowedParams )
  95                 );
  96
  97                 if ( $this->mClass !== '' ) {
  98                         $textAttribs['classes'] = [ $this->mClass ];
  99                 }
 100
 101                 # DropdownInput
 102                 $dropdownInputAttribs = [
 103                         'name' => $this->mName,
 104                         'id' => $this->mID . '-select',
 105                         'options' => $this->getOptionsOOUI(),
 106                         'value' => $value[1],
 107                 ];
 108
 109                 $allowedParams = [
 110                         'tabindex',
 111                         'disabled',
 112                 ];
 113
 114                 $dropdownInputAttribs += OOUI\Element::configFromHtmlAttributes(
 115                         $this->getAttributes( $allowedParams )
 116                 );
 117
 118                 if ( $this->mClass !== '' ) {
 119                         $dropdownInputAttribs['classes'] = [ $this->mClass ];
 120                 }
 121
 122                 return $this->getInputWidget( [
 123                         'id' => $this->mID,
 124                         'textinput' => $textAttribs,
 125                         'dropdowninput' => $dropdownInputAttribs,
 126                         'or' => false,
 127                         'classes' => [ 'mw-htmlform-select-and-other-field' ],
 128                         'data' => [
 129                                 'maxlengthUnit' => isset( $this->mParams['maxlength-unit'] )
 130                                         ? $this->mParams['maxlength-unit'] : 'bytes'
 131                         ],
 132                 ] );
 133         }
 134
 135         public function getInputWidget( $params ) {
 136                 return new MediaWiki\Widget\SelectWithInputWidget( $params );
 137         }
 138
 139         /**
 140          * @param WebRequest $request
 141          *
 142          * @return array("<overall message>","<select value>","<text field value>")
 143          */
 144         public function loadDataFromRequest( $request ) {
 145                 if ( $request->getCheck( $this->mName ) ) {
 146                         $list = $request->getText( $this->mName );
 147                         $text = $request->getText( $this->mName . '-other' );
 148
 149                         // Should be built the same as in mediawiki.htmlform.js
 150                         if ( $list == 'other' ) {
 151                                 $final = $text;
 152                         } elseif ( !in_array( $list, $this->mFlatOptions, true ) ) {
 153                                 # User has spoofed the select form to give an option which wasn't
 154                                 # in the original offer.  Sulk...
 155                                 $final = $text;
 156                         } elseif ( $text == '' ) {
 157                                 $final = $list;
 158                         } else {
 159                                 $final = $list . $this->msg( 'colon-separator' )->inContentLanguage()->text() . $text;
 160                         }
 161                 } else {
 162                         $final = $this->getDefault();
 163
 164                         $list = 'other';
 165                         $text = $final;
 166                         foreach ( $this->mFlatOptions as $option ) {
 167                                 $match = $option . $this->msg( 'colon-separator' )->inContentLanguage()->text();
 168                                 if ( strpos( $text, $match ) === 0 ) {
 169                                         $list = $option;
 170                                         $text = substr( $text, strlen( $match ) );
 171                                         break;
 172                                 }
 173                         }
 174                 }
 175
 176                 return [ $final, $list, $text ];
 177         }
 178
 179         public function getSize() {
 180                 return isset( $this->mParams['size'] ) ? $this->mParams['size'] : 45;
 181         }
 182
 183         public function validate( $value, $alldata ) {
 184                 # HTMLSelectField forces $value to be one of the options in the select
 185                 # field, which is not useful here.  But we do want the validation further up
 186                 # the chain
 187                 $p = parent::validate( $value[1], $alldata );
 188
 189                 if ( $p !== true ) {
 190                         return $p;
 191                 }
 192
 193                 if ( isset( $this->mParams['required'] )
 194                         && $this->mParams['required'] !== false
 195                         && $value[1] === ''
 196                 ) {
 197                         return $this->msg( 'htmlform-required' );
 198                 }
 199
 200                 return true;
 201         }
 202 }