9f67233641306e2afc9c3abfd55176a84c1358dc
5 * Operates similarly to HTMLMultiSelectField, but instead of using an array of
6 * options, uses an array of rows and an array of columns to dynamically
7 * construct a matrix of options. The tags used to identify a particular cell
8 * are of the form "columnName-rowName"
12 * - Required list of columns in the matrix.
14 * - Required list of rows in the matrix.
16 * - Accepts array of column-row tags to be displayed as enabled but unavailable to change
18 * - Accepts array of column-row tags to be displayed as disabled but unavailable to change.
20 * - Optional array mapping row label to tooltip content
22 * - Optional CSS class used on tooltip container span. Defaults to mw-icon-question.
24 class HTMLCheckMatrix
extends HTMLFormField
implements HTMLNestedFilterable
{
25 static private $requiredParams = [
26 // Required by underlying HTMLFormField
28 // Required by HTMLCheckMatrix
33 public function __construct( $params ) {
34 $missing = array_diff( self
::$requiredParams, array_keys( $params ) );
36 throw new HTMLFormFieldRequiredOptionsException( $this, $missing );
38 parent
::__construct( $params );
41 function validate( $value, $alldata ) {
42 $rows = $this->mParams
['rows'];
43 $columns = $this->mParams
['columns'];
45 // Make sure user-defined validation callback is run
46 $p = parent
::validate( $value, $alldata );
51 // Make sure submitted value is an array
52 if ( !is_array( $value ) ) {
56 // If all options are valid, array_intersect of the valid options
57 // and the provided options will return the provided options.
59 foreach ( $rows as $rowTag ) {
60 foreach ( $columns as $columnTag ) {
61 $validOptions[] = $columnTag . '-' . $rowTag;
64 $validValues = array_intersect( $value, $validOptions );
65 if ( count( $validValues ) == count( $value ) ) {
68 return $this->msg( 'htmlform-select-badoption' )->parse();
73 * Build a table containing a matrix of checkbox options.
74 * The value of each option is a combination of the row tag and column tag.
75 * mParams['rows'] is an array with row labels as keys and row tags as values.
76 * mParams['columns'] is an array with column labels as keys and column tags as values.
78 * @param array $value Array of the options that should be checked
82 function getInputHTML( $value ) {
85 $rows = $this->mParams
['rows'];
86 $columns = $this->mParams
['columns'];
88 $attribs = $this->getAttributes( [ 'disabled', 'tabindex' ] );
90 // Build the column headers
91 $headerContents = Html
::rawElement( 'td', [], ' ' );
92 foreach ( $columns as $columnLabel => $columnTag ) {
93 $headerContents .= Html
::rawElement( 'td', [], $columnLabel );
95 $tableContents .= Html
::rawElement( 'tr', [], "\n$headerContents\n" );
97 $tooltipClass = 'mw-icon-question';
98 if ( isset( $this->mParams
['tooltip-class'] ) ) {
99 $tooltipClass = $this->mParams
['tooltip-class'];
102 // Build the options matrix
103 foreach ( $rows as $rowLabel => $rowTag ) {
104 // Append tooltip if configured
105 if ( isset( $this->mParams
['tooltips'][$rowLabel] ) ) {
107 'class' => "mw-htmlform-tooltip $tooltipClass",
108 'title' => $this->mParams
['tooltips'][$rowLabel],
110 $rowLabel .= ' ' . Html
::element( 'span', $tooltipAttribs, '' );
112 $rowContents = Html
::rawElement( 'td', [], $rowLabel );
113 foreach ( $columns as $columnTag ) {
114 $thisTag = "$columnTag-$rowTag";
115 // Construct the checkbox
117 'id' => "{$this->mID}-$thisTag",
120 $checked = in_array( $thisTag, (array)$value, true );
121 if ( $this->isTagForcedOff( $thisTag ) ) {
123 $thisAttribs['disabled'] = 1;
124 } elseif ( $this->isTagForcedOn( $thisTag ) ) {
126 $thisAttribs['disabled'] = 1;
129 $checkbox = $this->getOneCheckbox( $checked, $attribs +
$thisAttribs );
131 $rowContents .= Html
::rawElement(
137 $tableContents .= Html
::rawElement( 'tr', [], "\n$rowContents\n" );
140 // Put it all in a table
141 $html .= Html
::rawElement( 'table',
142 [ 'class' => 'mw-htmlform-matrix' ],
143 Html
::rawElement( 'tbody', [], "\n$tableContents\n" ) ) . "\n";
148 protected function getOneCheckbox( $checked, $attribs ) {
149 if ( $this->mParent
instanceof OOUIHTMLForm
) {
150 return new OOUI\
CheckboxInputWidget( [
151 'name' => "{$this->mName}[]",
152 'selected' => $checked,
153 ] + OOUI\Element
::configFromHtmlAttributes(
157 $checkbox = Xml
::check( "{$this->mName}[]", $checked, $attribs );
158 if ( $this->mParent
->getConfig()->get( 'UseMediaWikiUIEverywhere' ) ) {
159 $checkbox = Html
::openElement( 'div', [ 'class' => 'mw-ui-checkbox' ] ) .
161 Html
::element( 'label', [ 'for' => $attribs['id'] ] ) .
162 Html
::closeElement( 'div' );
168 protected function isTagForcedOff( $tag ) {
169 return isset( $this->mParams
['force-options-off'] )
170 && in_array( $tag, $this->mParams
['force-options-off'] );
173 protected function isTagForcedOn( $tag ) {
174 return isset( $this->mParams
['force-options-on'] )
175 && in_array( $tag, $this->mParams
['force-options-on'] );
179 * Get the complete table row for the input, including help text,
180 * labels, and whatever.
181 * We override this function since the label should always be on a separate
182 * line above the options in the case of a checkbox matrix, i.e. it's always
183 * a "vertical-label".
185 * @param string $value The value to set the input to
187 * @return string Complete HTML table row
189 function getTableRow( $value ) {
190 list( $errors, $errorClass ) = $this->getErrorsAndErrorClass( $value );
191 $inputHtml = $this->getInputHTML( $value );
192 $fieldType = get_class( $this );
193 $helptext = $this->getHelpTextHtmlTable( $this->getHelpText() );
194 $cellAttributes = [ 'colspan' => 2 ];
197 $hideAttributes = [];
198 if ( $this->mHideIf
) {
199 $hideAttributes['data-hide-if'] = FormatJson
::encode( $this->mHideIf
);
200 $hideClass = 'mw-htmlform-hide-if';
203 $label = $this->getLabelHtml( $cellAttributes );
205 $field = Html
::rawElement(
207 [ 'class' => 'mw-input' ] +
$cellAttributes,
208 $inputHtml . "\n$errors"
211 $html = Html
::rawElement( 'tr',
212 [ 'class' => "mw-htmlform-vertical-label $hideClass" ] +
$hideAttributes,
214 $html .= Html
::rawElement( 'tr',
215 [ 'class' => "mw-htmlform-field-$fieldType {$this->mClass} $errorClass $hideClass" ] +
219 return $html . $helptext;
223 * @param WebRequest $request
227 function loadDataFromRequest( $request ) {
228 if ( $this->mParent
->getMethod() == 'post' ) {
229 if ( $request->wasPosted() ) {
230 // Checkboxes are not added to the request arrays if they're not checked,
231 // so it's perfectly possible for there not to be an entry at all
232 return $request->getArray( $this->mName
, [] );
234 // That's ok, the user has not yet submitted the form, so show the defaults
235 return $this->getDefault();
238 // This is the impossible case: if we look at $_GET and see no data for our
239 // field, is it because the user has not yet submitted the form, or that they
240 // have submitted it with all the options unchecked. We will have to assume the
241 // latter, which basically means that you can't specify 'positive' defaults
243 return $request->getArray( $this->mName
, [] );
247 function getDefault() {
248 if ( isset( $this->mDefault
) ) {
249 return $this->mDefault
;
255 function filterDataForSubmit( $data ) {
256 $columns = HTMLFormField
::flattenOptions( $this->mParams
['columns'] );
257 $rows = HTMLFormField
::flattenOptions( $this->mParams
['rows'] );
259 foreach ( $columns as $column ) {
260 foreach ( $rows as $row ) {
261 // Make sure option hasn't been forced
262 $thisTag = "$column-$row";
263 if ( $this->isTagForcedOff( $thisTag ) ) {
264 $res[$thisTag] = false;
265 } elseif ( $this->isTagForcedOn( $thisTag ) ) {
266 $res[$thisTag] = true;
268 $res[$thisTag] = in_array( $thisTag, $data );