HTMLCheckMatrix.php

Go to the documentation of this file.

<?php

class HTMLCheckMatrix extends HTMLFormField implements HTMLNestedFilterable {
    private static $requiredParams = [
        // Required by underlying HTMLFormField
        'fieldname',
        // Required by HTMLCheckMatrix
        'rows',
        'columns'
    ];

    public function __construct( $params ) {
        $missing = array_diff( self::$requiredParams, array_keys( $params ) );
        if ( $missing ) {
            throw new HTMLFormFieldRequiredOptionsException( $this, $missing );
        }
        parent::__construct( $params );
    }

    public function validate( $value, $alldata ) {
        $rows = $this->mParams['rows'];
        $columns = $this->mParams['columns'];

        // Make sure user-defined validation callback is run
        $p = parent::validate( $value, $alldata );
        if ( $p !== true ) {
            return $p;
        }

        // Make sure submitted value is an array
        if ( !is_array( $value ) ) {
            return false;
        }

        // If all options are valid, array_intersect of the valid options
        // and the provided options will return the provided options.
        $validOptions = [];
        foreach ( $rows as $rowTag ) {
            foreach ( $columns as $columnTag ) {
                $validOptions[] = $columnTag . '-' . $rowTag;
            }
        }
        $validValues = array_intersect( $value, $validOptions );
        if ( count( $validValues ) == count( $value ) ) {
            return true;
        } else {
            return $this->msg( 'htmlform-select-badoption' );
        }
    }

    public function getInputHTML( $value ) {
        $html = '';
        $tableContents = '';
        $rows = $this->mParams['rows'];
        $columns = $this->mParams['columns'];

        $attribs = $this->getAttributes( [ 'disabled', 'tabindex' ] );

        // Build the column headers
        $headerContents = Html::rawElement( 'td', [], "\u{00A0}" );
        foreach ( $columns as $columnLabel => $columnTag ) {
            $headerContents .= Html::rawElement( 'th', [], $columnLabel );
        }
        $thead = Html::rawElement( 'tr', [], "\n$headerContents\n" );
        $tableContents .= Html::rawElement( 'thead', [], "\n$thead\n" );

        $tooltipClass = 'mw-icon-question';
        if ( isset( $this->mParams['tooltip-class'] ) ) {
            $tooltipClass = $this->mParams['tooltip-class'];
        }

        // Build the options matrix
        foreach ( $rows as $rowLabel => $rowTag ) {
            // Append tooltip if configured
            if ( isset( $this->mParams['tooltips'][$rowLabel] ) ) {
                $tooltipAttribs = [
                    'class' => "mw-htmlform-tooltip $tooltipClass",
                    'title' => $this->mParams['tooltips'][$rowLabel],
                    'aria-label' => $this->mParams['tooltips'][$rowLabel]
                ];
                $rowLabel .= ' ' . Html::element( 'span', $tooltipAttribs, '' );
            }
            $rowContents = Html::rawElement( 'td', [], $rowLabel );
            foreach ( $columns as $columnTag ) {
                $thisTag = "$columnTag-$rowTag";
                // Construct the checkbox
                $thisAttribs = [
                    'id' => "{$this->mID}-$thisTag",
                    'value' => $thisTag,
                ];
                $checked = in_array( $thisTag, (array)$value, true );
                if ( $this->isTagForcedOff( $thisTag ) ) {
                    $checked = false;
                    $thisAttribs['disabled'] = 1;
                    $thisAttribs['class'] = 'checkmatrix-forced checkmatrix-forced-off';
                } elseif ( $this->isTagForcedOn( $thisTag ) ) {
                    $checked = true;
                    $thisAttribs['disabled'] = 1;
                    $thisAttribs['class'] = 'checkmatrix-forced checkmatrix-forced-on';
                }

                $checkbox = $this->getOneCheckboxHTML( $checked, $attribs + $thisAttribs );

                $rowContents .= Html::rawElement(
                    'td',
                    [],
                    $checkbox
                );
            }
            $tableContents .= Html::rawElement( 'tr', [], "\n$rowContents\n" );
        }

        // Put it all in a table
        $html .= Html::rawElement( 'table',
                [ 'class' => 'mw-htmlform-matrix' ],
                Html::rawElement( 'tbody', [], "\n$tableContents\n" ) ) . "\n";

        return $html;
    }

    public function getInputOOUI( $value ) {
        $attribs = $this->getAttributes( [ 'disabled', 'tabindex' ] );

        return new MediaWiki\Widget\CheckMatrixWidget(
            [
                'name' => $this->mName,
                'infusable' => true,
                'id' => $this->mID,
                'rows' => $this->mParams['rows'],
                'columns' => $this->mParams['columns'],
                'tooltips' => $this->mParams['tooltips'] ?? [],
                'forcedOff' => $this->mParams['force-options-off'] ?? [],
                'forcedOn' => $this->mParams['force-options-on'] ?? [],
                'values' => $value,
            ] + OOUI\Element::configFromHtmlAttributes( $attribs )
        );
    }

    protected function getOneCheckboxHTML( $checked, $attribs ) {
        $checkbox = Xml::check( "{$this->mName}[]", $checked, $attribs );
        if ( $this->mParent->getConfig()->get( 'UseMediaWikiUIEverywhere' ) ) {
            $checkbox = Html::openElement( 'div', [ 'class' => 'mw-ui-checkbox' ] ) .
                $checkbox .
                Html::element( 'label', [ 'for' => $attribs['id'] ] ) .
                Html::closeElement( 'div' );
        }
        return $checkbox;
    }

    protected function isTagForcedOff( $tag ) {
        return isset( $this->mParams['force-options-off'] )
            && in_array( $tag, $this->mParams['force-options-off'] );
    }

    protected function isTagForcedOn( $tag ) {
        return isset( $this->mParams['force-options-on'] )
            && in_array( $tag, $this->mParams['force-options-on'] );
    }

    public function getTableRow( $value ) {
        list( $errors, $errorClass ) = $this->getErrorsAndErrorClass( $value );
        $inputHtml = $this->getInputHTML( $value );
        $fieldType = static::class;
        $helptext = $this->getHelpTextHtmlTable( $this->getHelpText() );
        $cellAttributes = [ 'colspan' => 2 ];

        $hideClass = '';
        $hideAttributes = [];
        if ( $this->mHideIf ) {
            $hideAttributes['data-hide-if'] = FormatJson::encode( $this->mHideIf );
            $hideClass = 'mw-htmlform-hide-if';
        }

        $label = $this->getLabelHtml( $cellAttributes );

        $field = Html::rawElement(
            'td',
            [ 'class' => 'mw-input' ] + $cellAttributes,
            $inputHtml . "\n$errors"
        );

        $html = Html::rawElement( 'tr',
            [ 'class' => "mw-htmlform-vertical-label $hideClass" ] + $hideAttributes,
            $label );
        $html .= Html::rawElement( 'tr',
            [ 'class' => "mw-htmlform-field-$fieldType {$this->mClass} $errorClass $hideClass" ] +
                $hideAttributes,
            $field );

        return $html . $helptext;
    }

    public function loadDataFromRequest( $request ) {
        if ( $this->isSubmitAttempt( $request ) ) {
            // Checkboxes are just not added to the request arrays if they're not checked,
            // so it's perfectly possible for there not to be an entry at all
            return $request->getArray( $this->mName, [] );
        } else {
            // That's ok, the user has not yet submitted the form, so show the defaults
            return $this->getDefault();
        }
    }

    public function getDefault() {
        return $this->mDefault ?? [];
    }

    public function filterDataForSubmit( $data ) {
        $columns = HTMLFormField::flattenOptions( $this->mParams['columns'] );
        $rows = HTMLFormField::flattenOptions( $this->mParams['rows'] );
        $res = [];
        foreach ( $columns as $column ) {
            foreach ( $rows as $row ) {
                // Make sure option hasn't been forced
                $thisTag = "$column-$row";
                if ( $this->isTagForcedOff( $thisTag ) ) {
                    $res[$thisTag] = false;
                } elseif ( $this->isTagForcedOn( $thisTag ) ) {
                    $res[$thisTag] = true;
                } else {
                    $res[$thisTag] = in_array( $thisTag, $data );
                }
            }
        }

        return $res;
    }

    protected function getOOUIModules() {
        return [ 'mediawiki.widgets.CheckMatrixWidget' ];
    }

    protected function shouldInfuseOOUI() {
        return true;
    }
}