OOUIHTMLForm.php

Go to the documentation of this file.

<?php

class OOUIHTMLForm extends HTMLForm {
    private $oouiErrors;
    private $oouiWarnings;

    public function __construct( $descriptor, $context = null, $messagePrefix = '' ) {
        parent::__construct( $descriptor, $context, $messagePrefix );
        $this->getOutput()->enableOOUI();
        $this->getOutput()->addModuleStyles( 'mediawiki.htmlform.ooui.styles' );
    }

    protected $displayFormat = 'ooui';

    public static function loadInputFromParameters( $fieldname, $descriptor,
        HTMLForm $parent = null
    ) {
        $field = parent::loadInputFromParameters( $fieldname, $descriptor, $parent );
        $field->setShowEmptyLabel( false );
        return $field;
    }

    function getButtons() {
        $buttons = '';

        // IE<8 has bugs with <button>, so we'll need to avoid them.
        $isBadIE = preg_match( '/MSIE [1-7]\./i', $this->getRequest()->getHeader( 'User-Agent' ) );

        if ( $this->mShowSubmit ) {
            $attribs = [ 'infusable' => true ];

            if ( isset( $this->mSubmitID ) ) {
                $attribs['id'] = $this->mSubmitID;
            }

            if ( isset( $this->mSubmitName ) ) {
                $attribs['name'] = $this->mSubmitName;
            }

            if ( isset( $this->mSubmitTooltip ) ) {
                $attribs += Linker::tooltipAndAccesskeyAttribs( $this->mSubmitTooltip );
            }

            $attribs['classes'] = [ 'mw-htmlform-submit' ];
            $attribs['type'] = 'submit';
            $attribs['label'] = $this->getSubmitText();
            $attribs['value'] = $this->getSubmitText();
            $attribs['flags'] = $this->mSubmitFlags;
            $attribs['useInputTag'] = $isBadIE;

            $buttons .= new OOUI\ButtonInputWidget( $attribs );
        }

        if ( $this->mShowReset ) {
            $buttons .= new OOUI\ButtonInputWidget( [
                'type' => 'reset',
                'label' => $this->msg( 'htmlform-reset' )->text(),
                'useInputTag' => $isBadIE,
            ] );
        }

        if ( $this->mShowCancel ) {
            $target = $this->mCancelTarget ?: Title::newMainPage();
            if ( $target instanceof Title ) {
                $target = $target->getLocalURL();
            }
            $buttons .= new OOUI\ButtonWidget( [
                'label' => $this->msg( 'cancel' )->text(),
                'href' => $target,
            ] );
        }

        foreach ( $this->mButtons as $button ) {
            $attrs = [];

            if ( $button['attribs'] ) {
                $attrs += $button['attribs'];
            }

            if ( isset( $button['id'] ) ) {
                $attrs['id'] = $button['id'];
            }

            if ( $isBadIE ) {
                $label = $button['value'];
            } elseif ( isset( $button['label-message'] ) ) {
                $label = new OOUI\HtmlSnippet( $this->getMessage( $button['label-message'] )->parse() );
            } elseif ( isset( $button['label'] ) ) {
                $label = $button['label'];
            } elseif ( isset( $button['label-raw'] ) ) {
                $label = new OOUI\HtmlSnippet( $button['label-raw'] );
            } else {
                $label = $button['value'];
            }

            $attrs['classes'] = isset( $attrs['class'] ) ? (array)$attrs['class'] : [];

            $buttons .= new OOUI\ButtonInputWidget( [
                'type' => 'submit',
                'name' => $button['name'],
                'value' => $button['value'],
                'label' => $label,
                'flags' => $button['flags'],
                'framed' => $button['framed'],
                'useInputTag' => $isBadIE,
            ] + $attrs );
        }

        if ( !$buttons ) {
            return '';
        }

        return Html::rawElement( 'div',
            [ 'class' => 'mw-htmlform-submit-buttons' ], "\n$buttons" ) . "\n";
    }

    protected function wrapFieldSetSection( $legend, $section, $attributes ) {
        // to get a user visible effect, wrap the fieldset into a framed panel layout
        $layout = new OOUI\PanelLayout( [
            'expanded' => false,
            'padded' => true,
            'framed' => true,
            'infusable' => false,
        ] );

        $layout->appendContent(
            new OOUI\FieldsetLayout( [
                'label' => $legend,
                'infusable' => false,
                'items' => [
                    new OOUI\Widget( [
                        'content' => new OOUI\HtmlSnippet( $section )
                    ] ),
                ],
            ] + $attributes )
        );
        return $layout;
    }

    protected function formatSection( array $fieldsHtml, $sectionName, $anyFieldHasLabel ) {
        $config = [
            'items' => $fieldsHtml,
        ];
        if ( $sectionName ) {
            $config['id'] = Sanitizer::escapeId( $sectionName );
        }
        if ( is_string( $this->mWrapperLegend ) ) {
            $config['label'] = $this->mWrapperLegend;
        }
        return new OOUI\FieldsetLayout( $config );
    }

    function getErrorsOrWarnings( $elements, $elementsType ) {
        if ( !in_array( $elementsType, [ 'error', 'warning' ] ) ) {
            throw new DomainException( $elementsType . ' is not a valid type.' );
        }
        if ( !$elements ) {
            $errors = [];
        } elseif ( $elements instanceof Status ) {
            if ( $elements->isGood() ) {
                $errors = [];
            } else {
                $errors = $elements->getErrorsByType( $elementsType );
                foreach ( $errors as &$error ) {
                    // Input:  [ 'message' => 'foo', 'errors' => [ 'a', 'b', 'c' ] ]
                    // Output: [ 'foo', 'a', 'b', 'c' ]
                    $error = array_merge( [ $error['message'] ], $error['params'] );
                }
            }
        } elseif ( $elementsType === 'errors' )  {
            $errors = $elements;
            if ( !is_array( $errors ) ) {
                $errors = [ $errors ];
            }
        } else {
            $errors = [];
        }

        foreach ( $errors as &$error ) {
            $error = $this->getMessage( $error )->parse();
            $error = new OOUI\HtmlSnippet( $error );
        }

        // Used in getBody()
        if ( $elementsType === 'error' ) {
            $this->oouiErrors = $errors;
        } else {
            $this->oouiWarnings = $errors;
        }
        return '';
    }

    function getHeaderText( $section = null ) {
        if ( is_null( $section ) ) {
            // We handle $this->mHeader elsewhere, in getBody()
            return '';
        } else {
            return parent::getHeaderText( $section );
        }
    }

    function getBody() {
        $fieldset = parent::getBody();
        // FIXME This only works for forms with no subsections
        if ( $fieldset instanceof OOUI\FieldsetLayout ) {
            $classes = [ 'mw-htmlform-ooui-header' ];
            if ( $this->oouiErrors ) {
                $classes[] = 'mw-htmlform-ooui-header-errors';
            }
            if ( $this->oouiWarnings ) {
                $classes[] = 'mw-htmlform-ooui-header-warnings';
            }
            if ( $this->mHeader || $this->oouiErrors || $this->oouiWarnings ) {
                // if there's no header, don't create an (empty) LabelWidget, simply use a placeholder
                if ( $this->mHeader ) {
                    $element = new OOUI\LabelWidget( [ 'label' => new OOUI\HtmlSnippet( $this->mHeader ) ] );
                } else {
                    $element = new OOUI\Widget( [] );
                }
                $fieldset->addItems( [
                    new OOUI\FieldLayout(
                        $element,
                        [
                            'align' => 'top',
                            'errors' => $this->oouiErrors,
                            'notices' => $this->oouiWarnings,
                            'classes' => $classes,
                        ]
                    )
                ], 0 );
            }
        }
        return $fieldset;
    }

    function wrapForm( $html ) {
        $form = new OOUI\FormLayout( $this->getFormAttributes() + [
            'classes' => [ 'mw-htmlform-ooui' ],
            'content' => new OOUI\HtmlSnippet( $html ),
        ] );

        // Include a wrapper for style, if requested.
        $form = new OOUI\PanelLayout( [
            'classes' => [ 'mw-htmlform-ooui-wrapper' ],
            'expanded' => false,
            'padded' => $this->mWrapperLegend !== false,
            'framed' => $this->mWrapperLegend !== false,
            'content' => $form,
        ] );

        return $form;
    }
}