HTMLFormElement.php

Go to the documentation of this file.

<?php
 
trait HTMLFormElement {
 
    protected $hideIf = null;
    protected $modules = null;
 
    public function initializeHTMLFormElement( array $config = [] ) {
        // Properties
        $this->hideIf = $config['hideIf'] ?? null;
        $this->modules = $config['modules'] ?? [];
 
        // Initialization
        if ( $this->hideIf ) {
            $this->addClasses( [ 'mw-htmlform-hide-if' ] );
        }
        if ( $this->modules ) {
            // JS code must be able to read this before infusing (before OOUI is even loaded),
            // so we put this in a separate attribute (not with the rest of the config).
            // And it's not needed anymore after infusing, so we don't put it in JS config at all.
            $this->setAttributes( [ 'data-mw-modules' => implode( ',', $this->modules ) ] );
        }
        $this->registerConfigCallback( function ( &$config ) {
            if ( $this->hideIf !== null ) {
                $config['hideIf'] = $this->hideIf;
            }
        } );
    }
}
 
class HTMLFormFieldLayout extends OOUI\FieldLayout {
    use HTMLFormElement;
 
    public function __construct( $fieldWidget, array $config = [] ) {
        parent::__construct( $fieldWidget, $config );
 
        // Traits
        $this->initializeHTMLFormElement( $config );
    }
 
    protected function getJavaScriptClassName() {
        return 'mw.htmlform.FieldLayout';
    }
}
 
class HTMLFormActionFieldLayout extends OOUI\ActionFieldLayout {
    use HTMLFormElement;
 
    public function __construct( $fieldWidget, $buttonWidget = false, array $config = [] ) {
        parent::__construct( $fieldWidget, $buttonWidget, $config );
 
        // Traits
        $this->initializeHTMLFormElement( $config );
    }
 
    protected function getJavaScriptClassName() {
        return 'mw.htmlform.ActionFieldLayout';
    }
}