HTMLSelectAndOtherField.php

Go to the documentation of this file.

<?php

class HTMLSelectAndOtherField extends HTMLSelectField {
    function __construct( $params ) {
        if ( array_key_exists( 'other', $params ) ) {
            // Do nothing
        } elseif ( array_key_exists( 'other-message', $params ) ) {
            $params['other'] = $this->getMessage( $params['other-message'] )->plain();
        } else {
            $params['other'] = $this->msg( 'htmlform-selectorother-other' )->plain();
        }

        parent::__construct( $params );

        if ( $this->getOptions() === null ) {
            // Sulk
            throw new MWException( 'HTMLSelectAndOtherField called without any options' );
        }
        if ( !in_array( 'other', $this->mOptions, true ) ) {
            // Have 'other' always as first element
            $this->mOptions = [ $params['other'] => 'other' ] + $this->mOptions;
        }
        $this->mFlatOptions = self::flattenOptions( $this->getOptions() );

    }

    function getInputHTML( $value ) {
        $select = parent::getInputHTML( $value[1] );

        $textAttribs = [
            'id' => $this->mID . '-other',
            'size' => $this->getSize(),
            'class' => [ 'mw-htmlform-select-and-other-field' ],
            'data-id-select' => $this->mID,
        ];

        if ( $this->mClass !== '' ) {
            $textAttribs['class'][] = $this->mClass;
        }

        $allowedParams = [
            'required',
            'autofocus',
            'multiple',
            'disabled',
            'tabindex',
            'maxlength', // gets dynamic with javascript, see mediawiki.htmlform.js
        ];

        $textAttribs += $this->getAttributes( $allowedParams );

        $textbox = Html::input( $this->mName . '-other', $value[2], 'text', $textAttribs );

        return "$select<br />\n$textbox";
    }

    function getInputOOUI( $value ) {
        return false;
    }

    function loadDataFromRequest( $request ) {
        if ( $request->getCheck( $this->mName ) ) {
            $list = $request->getText( $this->mName );
            $text = $request->getText( $this->mName . '-other' );

            // Should be built the same as in mediawiki.htmlform.js
            if ( $list == 'other' ) {
                $final = $text;
            } elseif ( !in_array( $list, $this->mFlatOptions, true ) ) {
                # User has spoofed the select form to give an option which wasn't
                # in the original offer.  Sulk...
                $final = $text;
            } elseif ( $text == '' ) {
                $final = $list;
            } else {
                $final = $list . $this->msg( 'colon-separator' )->inContentLanguage()->text() . $text;
            }
        } else {
            $final = $this->getDefault();

            $list = 'other';
            $text = $final;
            foreach ( $this->mFlatOptions as $option ) {
                $match = $option . $this->msg( 'colon-separator' )->inContentLanguage()->text();
                if ( strpos( $text, $match ) === 0 ) {
                    $list = $option;
                    $text = substr( $text, strlen( $match ) );
                    break;
                }
            }
        }

        return [ $final, $list, $text ];
    }

    function getSize() {
        return isset( $this->mParams['size'] ) ? $this->mParams['size'] : 45;
    }

    function validate( $value, $alldata ) {
        # HTMLSelectField forces $value to be one of the options in the select
        # field, which is not useful here.  But we do want the validation further up
        # the chain
        $p = parent::validate( $value[1], $alldata );

        if ( $p !== true ) {
            return $p;
        }

        if ( isset( $this->mParams['required'] )
            && $this->mParams['required'] !== false
            && $value[1] === ''
        ) {
            return $this->msg( 'htmlform-required' )->parse();
        }

        return true;
    }
}