Double field with a dropdown list constructed from a system message in the format * Optgroup header ** <option value>=""> * New Optgroup header Plus a text field underneath for an additional reason. More...
Public Member Functions | |
| __construct ($params) | |
| Initialise the object. | |
| getInputHTML ($value) | |
| This function must be implemented to return the HTML to generate the input object itself. | |
| getSize () | |
| loadDataFromRequest ($request) | |
| validate ($value, $alldata) | |
| Override this function to add specific validation checks on the field input. | |
Static Public Member Functions | |
| static | parseMessage ($string, $otherName=null) |
| Build a drop-down box from a textual list. | |
Detailed Description
Double field with a dropdown list constructed from a system message in the format * Optgroup header ** <option value>=""> * New Optgroup header Plus a text field underneath for an additional reason.
The 'value' of the field is "<select>: <extra reason>", or "<extra reason>" if nothing has been selected in the select dropdown.
- Todo:
- FIXME: If made 'required', only the text field should be compulsory.
Definition at line 2501 of file HTMLForm.php.
Constructor & Destructor Documentation
| HTMLSelectAndOtherField::__construct | ( | $ | params | ) |
Initialise the object.
- Parameters:
-
array $params Associative Array. See HTMLForm doc for syntax.
- Since:
- 1.22 The 'label' attribute no longer accepts raw HTML, use 'label-raw' instead
- Exceptions:
-
MWException
Reimplemented from HTMLFormField.
Definition at line 2503 of file HTMLForm.php.
Member Function Documentation
| HTMLSelectAndOtherField::getInputHTML | ( | $ | value | ) |
This function must be implemented to return the HTML to generate the input object itself.
It should not implement the surrounding table cells/rows, or labels/help messages.
- Parameters:
-
string $value the value to set the input to; eg a default text for a text input.
- Returns:
- String valid HTML.
Reimplemented from HTMLSelectField.
Definition at line 2569 of file HTMLForm.php.
Definition at line 2636 of file HTMLForm.php.
| HTMLSelectAndOtherField::loadDataFromRequest | ( | $ | request | ) |
- Parameters:
-
$request WebRequest
- Returns:
- Array("<overall message>","<select value>","<text field value>")
Reimplemented from HTMLFormField.
Definition at line 2601 of file HTMLForm.php.
| static HTMLSelectAndOtherField::parseMessage | ( | $ | string, |
| $ | otherName = null |
||
| ) | [static] |
Build a drop-down box from a textual list.
- Parameters:
-
string $string message text string $otherName name of "other reason" option
- Returns:
- Array TODO: this is copied from Xml::listDropDown(), deprecate/avoid duplication?
Definition at line 2535 of file HTMLForm.php.
| HTMLSelectAndOtherField::validate | ( | $ | value, |
| $ | alldata | ||
| ) |
Override this function to add specific validation checks on the field input.
Don't forget to call parent::validate() to ensure that the user-defined callback mValidationCallback is still run
- Parameters:
-
string $value the value the field was submitted with array $alldata the data collected from the form
- Returns:
- Mixed Bool true on success, or String error to display.
Reimplemented from HTMLSelectField.
Definition at line 2642 of file HTMLForm.php.
The documentation for this class was generated from the following file:
- includes/HTMLForm.php
