MediaWiki REL1_30
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 protected function shouldInfuseOOUI() {
76 return true;
77 }
78
79 public function formatOptions( $options, $value ) {
81
82 $html = '';
83
84 $attribs = $this->getAttributes( [ 'disabled', 'tabindex' ] );
85 $elementFunc = [ 'Html', $this->mOptionsLabelsNotFromMessage ? 'rawElement' : 'element' ];
86
87 # @todo Should this produce an unordered list perhaps?
88 foreach ( $options as $label => $info ) {
89 if ( is_array( $info ) ) {
90 $html .= Html::rawElement( 'h1', [], $label ) . "\n";
91 $html .= $this->formatOptions( $info, $value );
92 } else {
93 $id = Sanitizer::escapeIdForAttribute( $this->mID . "-$info" );
94 $classes = [ 'mw-htmlform-flatlist-item' ];
95 if ( $wgUseMediaWikiUIEverywhere || $this->mParent instanceof VFormHTMLForm ) {
96 $classes[] = 'mw-ui-radio';
97 }
98 $radio = Xml::radio( $this->mName, $info, $info === $value, $attribs + [ 'id' => $id ] );
99 $radio .= '&#160;' . call_user_func( $elementFunc, 'label', [ 'for' => $id ], $label );
100
101 $html .= ' ' . Html::rawElement(
102 'div',
103 [ 'class' => $classes ],
104 $radio
105 );
106 }
107 }
108
109 return $html;
110 }
111
112 protected function needsLabel() {
113 return false;
114 }
115}
$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.
shouldInfuseOOUI()
Whether the field should be automatically infused.
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:1971
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:1983
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:1984
$params