MediaWiki REL1_31
HTMLRadioField.php
Go to the documentation of this file.
1<?php
2
14 public function __construct( $params ) {
15 parent::__construct( $params );
16
17 if ( isset( $params['flatlist'] ) ) {
18 $this->mClass .= ' mw-htmlform-flatlist';
19 }
20 }
21
22 public function validate( $value, $alldata ) {
23 $p = parent::validate( $value, $alldata );
24
25 if ( $p !== true ) {
26 return $p;
27 }
28
29 if ( !is_string( $value ) && !is_int( $value ) ) {
30 return $this->msg( 'htmlform-required' );
31 }
32
33 $validOptions = HTMLFormField::flattenOptions( $this->getOptions() );
34
35 if ( in_array( strval( $value ), $validOptions, true ) ) {
36 return true;
37 } else {
38 return $this->msg( 'htmlform-select-badoption' );
39 }
40 }
41
50 public function getInputHTML( $value ) {
51 $html = $this->formatOptions( $this->getOptions(), strval( $value ) );
52
53 return $html;
54 }
55
56 public function getInputOOUI( $value ) {
57 $options = [];
58 foreach ( $this->getOptions() as $label => $data ) {
59 $options[] = [
60 'data' => $data,
61 'label' => $this->mOptionsLabelsNotFromMessage ? new OOUI\HtmlSnippet( $label ) : $label,
62 ];
63 }
64
65 return new OOUI\RadioSelectInputWidget( [
66 'name' => $this->mName,
67 'id' => $this->mID,
68 'value' => $value,
69 'options' => $options,
70 ] + OOUI\Element::configFromHtmlAttributes(
71 $this->getAttributes( [ 'disabled', 'tabindex' ] )
72 ) );
73 }
74
75 public function formatOptions( $options, $value ) {
77
78 $html = '';
79
80 $attribs = $this->getAttributes( [ 'disabled', 'tabindex' ] );
81 $elementFunc = [ Html::class, $this->mOptionsLabelsNotFromMessage ? 'rawElement' : 'element' ];
82
83 # @todo Should this produce an unordered list perhaps?
84 foreach ( $options as $label => $info ) {
85 if ( is_array( $info ) ) {
86 $html .= Html::rawElement( 'h1', [], $label ) . "\n";
87 $html .= $this->formatOptions( $info, $value );
88 } else {
89 $id = Sanitizer::escapeIdForAttribute( $this->mID . "-$info" );
90 $classes = [ 'mw-htmlform-flatlist-item' ];
91 if ( $wgUseMediaWikiUIEverywhere || $this->mParent instanceof VFormHTMLForm ) {
92 $classes[] = 'mw-ui-radio';
93 }
94 $radio = Xml::radio( $this->mName, $info, $info === $value, $attribs + [ 'id' => $id ] );
95 $radio .= '&#160;' . call_user_func( $elementFunc, 'label', [ 'for' => $id ], $label );
96
97 $html .= ' ' . Html::rawElement(
98 'div',
99 [ 'class' => $classes ],
100 $radio
101 );
102 }
103 }
104
105 return $html;
106 }
107
108 protected function needsLabel() {
109 return false;
110 }
111}
$wgUseMediaWikiUIEverywhere
Temporary variable that applies MediaWiki UI wherever it can be supported.
The parent class to generate form fields.
static flattenOptions( $options)
flatten an array of options to a single array, for instance, a set of "<options>" inside "<optgroups>...
getOptions()
Fetch the array of options from the field's parameters.
getAttributes(array $list)
Returns the given attributes from the parameters.
msg()
Get a translated interface message.
Radio checkbox fields.
__construct( $params)
needsLabel()
Should this field have a label, or is there no input element with the appropriate id for the label to...
validate( $value, $alldata)
Override this function to add specific validation checks on the field input.
formatOptions( $options, $value)
getInputHTML( $value)
This returns a block of all the radio options, in one cell.
getInputOOUI( $value)
Same as getInputHTML, but returns an OOUI object.
Compact stacked vertical format for forms.
null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped & $options
Definition hooks.txt:2001
null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses just before the function returns a value If you return an< a > element with HTML attributes $attribs and contents $html will be returned If you return $ret will be returned and may include noclasses & $html
Definition hooks.txt:2013
null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses just before the function returns a value If you return an< a > element with HTML attributes $attribs and contents $html will be returned If you return $ret will be returned and may include noclasses after processing & $attribs
Definition hooks.txt:2014
$params