MediaWiki  REL1_21
HTMLSelectAndOtherField Class Reference

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...

Inheritance diagram for HTMLSelectAndOtherField:
Collaboration diagram for HTMLSelectAndOtherField:

List of all members.

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 2191 of file HTMLForm.php.


Constructor & Destructor Documentation

Initialise the object.

Parameters:
array$paramsAssociative Array. See HTMLForm doc for syntax.
Exceptions:
MWException

Reimplemented from HTMLFormField.

Definition at line 2193 of file HTMLForm.php.


Member Function Documentation

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$valuethe value to set the input to; eg a default text for a text input.
Returns:
String valid HTML.

Reimplemented from HTMLSelectField.

Definition at line 2259 of file HTMLForm.php.

Definition at line 2326 of file HTMLForm.php.

Parameters:
$requestWebRequest
Returns:
Array("<overall message>","<select value>","<text field value>")

Reimplemented from HTMLFormField.

Definition at line 2291 of file HTMLForm.php.

References as, HTMLFormField\getDefault(), and HTMLFormField\msg().

static HTMLSelectAndOtherField::parseMessage ( string,
otherName = null 
) [static]

Build a drop-down box from a textual list.

Parameters:
string$stringmessage text
string$otherNamename of "other reason" option
Returns:
Array TODO: this is copied from Xml::listDropDown(), deprecate/avoid duplication?

Definition at line 2225 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$valuethe value the field was submitted with
array$alldatathe data collected from the form
Returns:
Mixed Bool true on success, or String error to display.

Reimplemented from HTMLSelectField.

Definition at line 2332 of file HTMLForm.php.


The documentation for this class was generated from the following file: