EditWatchlistNormalHTMLForm Class Reference
Extend OOUIHTMLForm purely so we can have a more sane way of getting the section headers. More...
Inheritance diagram for EditWatchlistNormalHTMLForm:
Collaboration diagram for EditWatchlistNormalHTMLForm:
Public Member Functions | |
| displaySection ( $fields, $sectionName='', $fieldsetIDPrefix='', &$hasUserVisibleFields=false) | |
| getLegend ( $namespace) | |
| Get a string to go in the "<legend>" of a section fieldset. More... | |
 Public Member Functions inherited from OOUIHTMLForm | |
| __construct ( $descriptor, $context=null, $messagePrefix='') | |
| Build a new HTMLForm from an array of field attributes. More... | |
| getBody () | |
| Get the whole body of the form. More... | |
| getButtons () | |
| Get the submit and (potentially) reset buttons. More... | |
| getErrorsOrWarnings ( $elements, $elementsType) | |
| getHeaderText ( $section=null) | |
| Get header text. More... | |
| wrapForm ( $html) | |
| Wrap the form innards in an actual "<form>" element. More... | |
| Public Member Functions inherited from HTMLForm | |
| addButton ( $data) | |
| Add a button to the form. More... | |
| addFooterText ( $msg, $section=null) | |
| Add footer text, inside the form. More... | |
| addHeaderText ( $msg, $section=null) | |
| Add HTML to the header, inside the form. More... | |
| addHiddenField ( $name, $value, array $attribs=[]) | |
| Add a hidden field to the output. More... | |
| addHiddenFields (array $fields) | |
| Add an array of hidden fields to the output. More... | |
| addPostText ( $msg) | |
| Add text to the end of the display. More... | |
| addPreText ( $msg) | |
| Add HTML to introductory message. More... | |
| displayForm ( $submitResult) | |
| Display the form (sending to the context's OutputPage object), with an appropriate error message or stack of messages, and any validation errors, etc. More... | |
| filterDataForSubmit ( $data) | |
| Overload this if you want to apply special filtration routines to the form as a whole, after it's submitted but before it's processed. More... | |
| formatErrors ( $errors) | |
| Format a stack of error messages into a single HTML string. More... | |
| getAction () | |
| Get the value for the action attribute of the form. More... | |
| getDisplayFormat () | |
| Getter for displayFormat. More... | |
| getErrors ( $errors) | |
| Format and display an error message stack. More... | |
| getField ( $fieldname) | |
| getFooterText ( $section=null) | |
| Get footer text. More... | |
| getHiddenFields () | |
| Get the hidden fields that should go inside the form. More... | |
| getHTML ( $submitResult) | |
| Returns the raw HTML generated by the form. More... | |
| getMethod () | |
| getPreText () | |
| Get the introductory message HTML. More... | |
| getSubmitText () | |
| Get the text for the submit button, either customised or a default. More... | |
| getTitle () | |
| Get the title. More... | |
| hasField ( $fieldname) | |
| loadData () | |
| Construct the form fields from the Descriptor array. More... | |
| needsJSForHtml5FormValidation () | |
| Whether this form, with its current fields, requires the user agent to have JavaScript enabled for the client-side HTML5 form validation to work correctly. More... | |
| prepareForm () | |
| Prepare form for submission. More... | |
| setAction ( $action) | |
| Set the value for the action attribute of the form. More... | |
| setAutocomplete ( $autocomplete) | |
| Set the value for the autocomplete attribute of the form. More... | |
| setCancelTarget ( $target) | |
| Sets the target where the user is redirected to after clicking cancel. More... | |
| setDisplayFormat ( $format) | |
| Set format in which to display the form. More... | |
| setFooterText ( $msg, $section=null) | |
| Set footer text, inside the form. More... | |
| setFormIdentifier ( $ident) | |
| Set an internal identifier for this form. More... | |
| setHeaderText ( $msg, $section=null) | |
| Set header text, inside the form. More... | |
| setId ( $id) | |
| setIntro ( $msg) | |
| Set the introductory message, overwriting any existing message. More... | |
| setMessagePrefix ( $p) | |
| Set the prefix for various default messages. More... | |
| setMethod ( $method='post') | |
| Set the method used to submit the form. More... | |
| setName ( $name) | |
| setPostText ( $msg) | |
| Set text at the end of the display. More... | |
| setPreText ( $msg) | |
| Set the introductory message HTML, overwriting any existing message. More... | |
| setSubmitCallback ( $cb) | |
| Set a callback to a function to do something with the form once it's been successfully validated. More... | |
| setSubmitDestructive () | |
| Identify that the submit button in the form has a destructive action. More... | |
| setSubmitID ( $t) | |
| Set the id for the submit button. More... | |
| setSubmitName ( $name) | |
| setSubmitProgressive () | |
| Identify that the submit button in the form has a progressive action. More... | |
| setSubmitText ( $t) | |
| Set the text for the submit button. More... | |
| setSubmitTextMsg ( $msg) | |
| Set the text for the submit button to a message. More... | |
| setSubmitTooltip ( $name) | |
| setTableId ( $id) | |
| Set the id of the \<table\> or outermost \<div\> element. More... | |
| setTitle ( $t) | |
| Set the title for form submission. More... | |
| setTokenSalt ( $salt) | |
| Set the salt for the edit token. More... | |
| setValidationErrorMessage ( $msg) | |
| Set a message to display on a validation error. More... | |
| setWrapperLegend ( $legend) | |
| Prompt the whole form to be wrapped in a "<fieldset>", with this text as its "<legend>" element. More... | |
| setWrapperLegendMsg ( $msg) | |
| Prompt the whole form to be wrapped in a "<fieldset>", with this message as its "<legend>" element. More... | |
| show () | |
| The here's-one-I-made-earlier option: do the submission if posted, or display the form with or without funky validation errors. More... | |
| showAlways () | |
| Same as self::show with the difference, that the form will be added to the output, no matter, if the validation was good or not. More... | |
| showCancel ( $show=true) | |
| Show a cancel button (or prevent it). More... | |
| suppressDefaultSubmit ( $suppressSubmit=true) | |
| Stop a default submit button being shown for this form. More... | |
| suppressReset ( $suppressReset=true) | |
| Stop a reset button being shown for this form. More... | |
| tryAuthorizedSubmit () | |
| Try submitting, with edit token check first. More... | |
| trySubmit () | |
| Validate all the fields, and call the submission callback function if everything is kosher. More... | |
| wasSubmitted () | |
| Test whether the form was considered to have been submitted or not, i.e. More... | |
| Public Member Functions inherited from ContextSource | |
| canUseWikiPage () | |
| Check whether a WikiPage object can be get with getWikiPage(). More... | |
| exportSession () | |
| Export the resolved user IP, HTTP headers, user ID, and session ID. More... | |
| getConfig () | |
| getContext () | |
| Get the base IContextSource object. More... | |
| getLanguage () | |
| getOutput () | |
| getRequest () | |
| getSkin () | |
| getStats () | |
| getTiming () | |
| getUser () | |
| getWikiPage () | |
| Get the WikiPage object. More... | |
| msg ( $key) | |
| Get a Message object with context set Parameters are the same as wfMessage() More... | |
| setContext (IContextSource $context) | |
Additional Inherited Members | |
| Static Public Member Functions inherited from OOUIHTMLForm | |
| static | loadInputFromParameters ( $fieldname, $descriptor, HTMLForm $parent=null) |
| Initialise a new Object for the field. More... | |
| Static Public Member Functions inherited from HTMLForm | |
| static | factory ( $displayFormat) |
| Construct a HTMLForm object for given display type. More... | |
| static | getClassFromDescriptor ( $fieldname, &$descriptor) |
| Get the HTMLFormField subclass for this descriptor. More... | |
| Public Attributes inherited from HTMLForm | |
| $mFieldData | |
| Static Public Attributes inherited from HTMLForm | |
| static | $typeMappings |
| Protected Member Functions inherited from OOUIHTMLForm | |
| formatSection (array $fieldsHtml, $sectionName, $anyFieldHasLabel) | |
| Put a form section together from the individual fields' HTML, merging it and wrapping. More... | |
| wrapFieldSetSection ( $legend, $section, $attributes, $isRoot) | |
| @inheritDoc More... | |
| Protected Member Functions inherited from HTMLForm | |
| getFormAttributes () | |
Get HTML attributes for the <form> tag. More... | |
| getMessage ( $value) | |
| Turns a *-message parameter (which could be a MessageSpecifier, or a message name, or a name + parameters array) into a Message. More... | |
| Protected Attributes inherited from OOUIHTMLForm | |
| string | $displayFormat = 'ooui' |
| Symbolic display format name. More... | |
| Protected Attributes inherited from HTMLForm | |
| array | $availableDisplayFormats |
| Available formats in which to display the form. More... | |
| array | $availableSubclassDisplayFormats |
| Available formats in which to display the form. More... | |
| string | $displayFormat = 'table' |
| Format in which to display form. More... | |
| bool string | $mAction = false |
| Form action URL. More... | |
| string null | $mAutocomplete = null |
| Form attribute autocomplete. More... | |
| $mButtons = [] | |
| $mCancelTarget | |
| $mFieldTree | |
| HTMLFormField[] | $mFlatFields |
| $mFooter = '' | |
| $mFormIdentifier | |
| $mHeader = '' | |
| $mHiddenFields = [] | |
| $mId | |
| $mMessagePrefix | |
| $mMethod = 'post' | |
| $mName | |
| $mPost = '' | |
| $mPre = '' | |
| $mSectionFooters = [] | |
| $mSectionHeaders = [] | |
| $mShowCancel = false | |
| $mShowReset = false | |
| $mShowSubmit = true | |
| $mSubmitCallback | |
| $mSubmitFlags = [ 'primary', 'progressive' ] | |
| $mSubmitID | |
| $mSubmitName | |
| $mSubmitText | |
| $mSubmitTooltip | |
| $mSubSectionBeforeFields = true | |
| If true, sections that contain both fields and subsections will render their subsections before their fields. More... | |
| $mTableId = '' | |
| $mTitle | |
| string array | $mTokenSalt = '' |
| Salt for the edit token. More... | |
| $mUseMultipart = false | |
| $mValidationErrorMessage | |
| $mWasSubmitted = false | |
| $mWrapperLegend = false | |
Detailed Description
Extend OOUIHTMLForm purely so we can have a more sane way of getting the section headers.
Definition at line 24 of file EditWatchlistNormalHTMLForm.php.
Member Function Documentation
◆ displaySection()
| EditWatchlistNormalHTMLForm::displaySection | ( | $fields, | |
$sectionName = '', |
|||
$fieldsetIDPrefix = '', |
|||
| & | $hasUserVisibleFields = false |
||
| ) |
- Todo:
- Document
- Parameters
-
array[] | HTMLFormField[] $fields Array of fields (either arrays or objects). string $sectionName ID attribute of the "<table>" tag for this section, ignored if empty. string $fieldsetIDPrefix ID prefix for the "<fieldset>" tag of each subsection, ignored if empty. bool &$hasUserVisibleFields Whether the section had user-visible fields.
- Exceptions
-
LogicException When called on uninitialized field data, e.g. When HTMLForm::displayForm was called without calling HTMLForm::prepareForm first.
- Returns
- string
Reimplemented from HTMLForm.
Definition at line 33 of file EditWatchlistNormalHTMLForm.php.
◆ getLegend()
| EditWatchlistNormalHTMLForm::getLegend | ( | $key | ) |
Get a string to go in the "<legend>" of a section fieldset.
Override this if you want something more complicated.
- Parameters
-
string $key
- Returns
- string Plain text (not HTML-escaped)
Reimplemented from HTMLForm.
Definition at line 25 of file EditWatchlistNormalHTMLForm.php.
References ContextSource\getContext(), ContextSource\msg(), and NS_MAIN.
The documentation for this class was generated from the following file:
- includes/specials/forms/EditWatchlistNormalHTMLForm.php
