OOUIHTMLForm.php

Go to the documentation of this file.

<?php
 
namespace MediaWiki\HTMLForm;
 
use DomainException;
use MediaWiki\Context\IContextSource;
use MediaWiki\Html\Html;
use MediaWiki\Linker\Linker;
use MediaWiki\Parser\Sanitizer;
use MediaWiki\Status\Status;
 
class OOUIHTMLForm extends HTMLForm {
    private $oouiErrors;
    private $oouiWarnings;
 
    public function __construct( $descriptor, IContextSource $context, string $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;
    }
 
    public function getButtons() {
        $buttons = '';
 
        if ( $this->mShowSubmit ) {
            $attribs = [
                'infusable' => true,
                'classes' => [ 'mw-htmlform-submit' ],
                'type' => 'submit',
                'label' => $this->getSubmitText(),
                'value' => $this->getSubmitText(),
                'flags' => $this->mSubmitFlags,
            ];
 
            if ( $this->mSubmitID !== null ) {
                $attribs['id'] = $this->mSubmitID;
            }
 
            if ( $this->mSubmitName !== null ) {
                $attribs['name'] = $this->mSubmitName;
            }
 
            if ( $this->mSubmitTooltip !== null ) {
                $attribs += [
                    'title' => Linker::titleAttrib( $this->mSubmitTooltip ),
                    'accessKey' => Linker::accesskey( $this->mSubmitTooltip ),
                ];
            }
 
            if ( $this->mSubmitLockIcon ) {
                $attribs['icon'] = 'lock';
            }
 
            $buttons .= new \OOUI\ButtonInputWidget( $attribs );
        }
 
        if ( $this->mShowCancel ) {
            $buttons .= new \OOUI\ButtonWidget( [
                'label' => $this->msg( 'cancel' )->text(),
                'href' => $this->getCancelTargetURL(),
            ] );
        }
 
        foreach ( $this->mButtons as $button ) {
            $attrs = [];
 
            if ( $button['attribs'] ) {
                $attrs += $button['attribs'];
            }
 
            if ( isset( $button['id'] ) ) {
                $attrs['id'] = $button['id'];
            }
 
            if ( 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'],
            ] + $attrs );
        }
 
        if ( !$buttons ) {
            return '';
        }
 
        return Html::rawElement( 'div',
            [ 'class' => 'mw-htmlform-submit-buttons' ], "\n$buttons" ) . "\n";
    }
 
    protected function wrapFieldSetSection( $legend, $section, $attributes, $isRoot ) {
        // @phan-suppress-previous-line PhanParamSignatureMismatch We're different from our parent intentionally
        // to get a user visible effect, wrap the fieldset into a framed panel layout
        $layout = new \OOUI\PanelLayout( [
            'expanded' => false,
            'padded' => true,
            'framed' => true,
        ] );
 
        $layout->appendContent(
            new \OOUI\FieldsetLayout( [
                'label' => $legend,
                'items' => [
                    new \OOUI\Widget( [
                        'content' => new \OOUI\HtmlSnippet( $section )
                    ] ),
                ],
            ] + $attributes )
        );
        return $layout;
    }
 
    protected function formatField( HTMLFormField $field, $value ) {
        return $field->getOOUI( $value );
    }
 
    protected function formatSection( array $fieldsHtml, $sectionName, $anyFieldHasLabel ) {
        if ( !$fieldsHtml ) {
            // Do not generate any wrappers for empty sections. Sections may be empty if they only have
            // subsections, but no fields. A legend will still be added in wrapFieldSetSection().
            return '';
        }
 
        $html = implode( '', $fieldsHtml );
 
        if ( $sectionName ) {
            return Html::rawElement(
                'div',
                [ 'id' => Sanitizer::escapeIdForAttribute( $sectionName ) ],
                $html
            );
        }
        return $html;
    }
 
    public function getErrorsOrWarnings( $elements, $elementsType ) {
        if ( $elements === '' ) {
            return '';
        }
 
        if ( !in_array( $elementsType, [ 'error', 'warning' ], true ) ) {
            throw new DomainException( $elementsType . ' is not a valid type.' );
        }
        $errors = [];
        if ( $elements instanceof Status ) {
            if ( !$elements->isGood() ) {
                foreach ( $elements->getMessages( $elementsType ) as $msg ) {
                    $errors[] = $this->getMessage( $msg )->parse();
                }
            }
        } elseif ( $elementsType === 'error' ) {
            if ( is_array( $elements ) ) {
                foreach ( $elements as $error ) {
                    $errors[] = $this->getMessage( $error )->parse();
                }
            } elseif ( $elements && $elements !== true ) {
                $errors[] = (string)$elements;
            }
        }
 
        foreach ( $errors as &$error ) {
            $error = new \OOUI\HtmlSnippet( $error );
        }
 
        // Used in formatFormHeader()
        if ( $elementsType === 'error' ) {
            $this->oouiErrors = $errors;
        } else {
            $this->oouiWarnings = $errors;
        }
        return '';
    }
 
    public function getHeaderHtml( $section = null ) {
        if ( $section === null ) {
            // We handle $this->mHeader elsewhere, in getBody()
            return '';
        } else {
            return parent::getHeaderHtml( $section );
        }
    }
 
    protected function formatFormHeader(): string {
        if ( !( $this->mHeader || $this->oouiErrors || $this->oouiWarnings ) ) {
            return '';
        }
        $classes = [
            'mw-htmlform-ooui-header',
            ...$this->oouiErrors ? [ 'mw-htmlform-ooui-header-errors' ] : [],
            ...$this->oouiWarnings ? [ 'mw-htmlform-ooui-header-warnings' ] : [],
        ];
        // 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 ) ] );
            // In case the form header contains any form elements, avoid treating the entire header
            // as a clickable label (T428359). Maybe it shouldn't be a `<label>` in the first place…
            $element->setAttributes( [ 'for' => '' ] );
        } else {
            $element = new \OOUI\Widget( [] );
        }
        return ( new \OOUI\FieldLayout(
            $element,
            [
                'align' => 'top',
                'errors' => $this->oouiErrors,
                'notices' => $this->oouiWarnings,
                'classes' => $classes,
            ]
        ) )->toString();
    }
 
    public function getBody() {
        return $this->formatFormHeader() . parent::getBody();
    }
 
    public function wrapForm( $html ) {
        if ( is_string( $this->mWrapperLegend ) ) {
            $phpClass = $this->mCollapsible ? CollapsibleFieldsetLayout::class : \OOUI\FieldsetLayout::class;
            $content = new $phpClass( [
                'label' => $this->mWrapperLegend,
                'collapsed' => $this->mCollapsed,
                'items' => [
                    new \OOUI\Widget( [
                        'content' => new \OOUI\HtmlSnippet( $html )
                    ] ),
                ],
            ] + \OOUI\Element::configFromHtmlAttributes( $this->mWrapperAttributes ) );
        } else {
            $content = new \OOUI\HtmlSnippet( $html );
        }
 
        $form = new \OOUI\FormLayout( $this->getFormAttributes() + [
            'classes' => [ 'mw-htmlform', 'mw-htmlform-ooui' ],
            'content' => $content,
        ] );
 
        // 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;
    }
}
 
class_alias( OOUIHTMLForm::class, 'OOUIHTMLForm' );