HTMLCheckField.php

Go to the documentation of this file.

<?php
 
use MediaWiki\Html\Html;
use MediaWiki\MainConfigNames;
use MediaWiki\Request\WebRequest;
 
class HTMLCheckField extends HTMLFormField {
 
    public function getInputHTML( $value ) {
        $useMediaWikiUIEverywhere = false;
        if ( $this->mParent ) {
            $useMediaWikiUIEverywhere = $this->mParent->getConfig()->get( MainConfigNames::UseMediaWikiUIEverywhere );
        }
 
        if ( !empty( $this->mParams['invert'] ) ) {
            $value = !$value;
        }
 
        $attr = $this->getTooltipAndAccessKey();
        $attr['id'] = $this->mID;
 
        $attr += $this->getAttributes( [ 'disabled', 'tabindex' ] );
 
        if ( $this->mClass !== '' ) {
            $attr['class'] = $this->mClass;
        }
 
        $attrLabel = [ 'for' => $this->mID ];
        if ( isset( $attr['title'] ) ) {
            // propagate tooltip to label
            $attrLabel['title'] = $attr['title'];
        }
 
        $isCodexForm = $this->mParent instanceof CodexHTMLForm;
        $isVForm = $this->mParent instanceof VFormHTMLForm;
 
        if ( $isCodexForm ) {
            $attrClass = $attr['class'] ?? '';
            $attr['class'] = $attrClass . ' cdx-checkbox__input';
            $attrLabel['class'] = 'cdx-checkbox__label';
        }
        $chkDivider = $isCodexForm ?
                "<span class=\"cdx-checkbox__icon\">\u{00A0}</span>" :
                "\u{00A0}";
        $chkLabel = Xml::check( $this->mName, $value, $attr ) .
            $chkDivider .
            Html::rawElement( 'label', $attrLabel, $this->mLabel );
 
        if ( $isCodexForm || $useMediaWikiUIEverywhere || $isVForm ) {
            $chkLabelClass = $isCodexForm ? 'cdx-checkbox' : 'mw-ui-checkbox';
            $chkLabel = Html::rawElement(
                'div',
                [ 'class' => $chkLabelClass ],
                $chkLabel
            );
        }
 
        return $chkLabel;
    }
 
    public function getInputOOUI( $value ) {
        if ( !empty( $this->mParams['invert'] ) ) {
            $value = !$value;
        }
 
        $attr = $this->getTooltipAndAccessKeyOOUI();
        $attr['id'] = $this->mID;
        $attr['name'] = $this->mName;
 
        $attr += OOUI\Element::configFromHtmlAttributes(
            $this->getAttributes( [ 'disabled', 'tabindex' ] )
        );
 
        if ( $this->mClass !== '' ) {
            $attr['classes'] = [ $this->mClass ];
        }
 
        $attr['selected'] = $value;
        $attr['value'] = '1'; // Nasty hack, but needed to make this work
 
        return new OOUI\CheckboxInputWidget( $attr );
    }
 
    public function getLabel() {
        if ( $this->mParent instanceof OOUIHTMLForm ) {
            return $this->mLabel ?? '';
        } elseif (
            $this->mParent instanceof HTMLForm &&
            $this->mParent->getDisplayFormat() === 'div'
        ) {
            return '';
        } else {
            return "\u{00A0}";
        }
    }
 
    protected function getLabelAlignOOUI() {
        return 'inline';
    }
 
    protected function needsLabel() {
        return false;
    }
 
    public function getDefault() {
        return (bool)$this->mDefault;
    }
 
    public function loadDataFromRequest( $request ) {
        $invert = isset( $this->mParams['invert'] ) && $this->mParams['invert'];
 
        // Fetch the value in either one of the two following case:
        // - we have a valid submit attempt (form was just submitted)
        // - we have a value (an URL manually built by the user, or GET form with no wpFormIdentifier)
        if ( $this->isSubmitAttempt( $request ) || $request->getCheck( $this->mName ) ) {
            return $invert
                ? !$request->getBool( $this->mName )
                : $request->getBool( $this->mName );
        } else {
            return $this->getDefault();
        }
    }
}