* Some field types support multi-level arrays.
* 'options-messages' -- associative array mapping message keys to values.
* Some field types support multi-level arrays.
- * 'options-message' -- message key to be parsed to extract the list of
+ * 'options-message' -- message key or object to be parsed to extract the list of
* options (like 'ipbreason-dropdown').
- * 'label-message' -- message key for a message to use as the label.
+ * 'label-message' -- message key or object for a message to use as the label.
* can be an array of msg key and then parameters to
* the message.
* 'label' -- alternatively, a raw text message. Overridden by
* label-message
* 'help' -- message text for a message to use as a help text.
- * 'help-message' -- message key for a message to use as a help text.
+ * 'help-message' -- message key or object for a message to use as a help text.
* can be an array of msg key and then parameters to
* the message.
* Overwrites 'help-messages' and 'help'.
- * 'help-messages' -- array of message key. As above, each item can
+ * 'help-messages' -- array of message keys/objects. As above, each item can
* be an array of msg key and then parameters.
* Overwrites 'help'.
* 'required' -- passed through to the object, indicating that it
*/
class HTMLForm extends ContextSource {
// A mapping of 'type' inputs onto standard HTMLFormField subclasses
- public static $typeMappings = array(
+ public static $typeMappings = [
'api' => 'HTMLApiField',
'text' => 'HTMLTextField',
'textwithbutton' => 'HTMLTextFieldWithButton',
'url' => 'HTMLTextField',
'title' => 'HTMLTitleTextField',
'user' => 'HTMLUserTextField',
- );
+ ];
public $mFieldData;
protected $mFieldTree;
protected $mShowReset = false;
protected $mShowSubmit = true;
- protected $mSubmitFlags = array( 'constructive', 'primary' );
+ protected $mSubmitFlags = [ 'constructive', 'primary' ];
protected $mSubmitCallback;
protected $mValidationErrorMessage;
protected $mPre = '';
protected $mHeader = '';
protected $mFooter = '';
- protected $mSectionHeaders = array();
- protected $mSectionFooters = array();
+ protected $mSectionHeaders = [];
+ protected $mSectionFooters = [];
protected $mPost = '';
protected $mId;
+ protected $mName;
protected $mTableId = '';
protected $mSubmitID;
*/
protected $mAction = false;
+ /**
+ * Form attribute autocomplete. false does not set the attribute
+ * @since 1.27
+ * @var bool|string
+ */
+ protected $mAutocomplete = false;
+
protected $mUseMultipart = false;
- protected $mHiddenFields = array();
- protected $mButtons = array();
+ protected $mHiddenFields = [];
+ protected $mButtons = [];
protected $mWrapperLegend = false;
* Available formats in which to display the form
* @var array
*/
- protected $availableDisplayFormats = array(
+ protected $availableDisplayFormats = [
'table',
'div',
'raw',
'inline',
- );
+ ];
/**
* Available formats in which to display the form
* @var array
*/
- protected $availableSubclassDisplayFormats = array(
+ protected $availableSubclassDisplayFormats = [
'vform',
'ooui',
- );
+ ];
/**
* Construct a HTMLForm object for given display type. May return a HTMLForm subclass.
}
// Expand out into a tree.
- $loadedDescriptor = array();
- $this->mFlatFields = array();
+ $loadedDescriptor = [];
+ $this->mFlatFields = [];
foreach ( $descriptor as $fieldname => $info ) {
$section = isset( $info['section'] )
$newName = array_shift( $sectionParts );
if ( !isset( $setSection[$newName] ) ) {
- $setSection[$newName] = array();
+ $setSection[$newName] = [];
}
$setSection =& $setSection[$newName];
*/
function trySubmit() {
$valid = true;
- $hoistedErrors = array();
+ $hoistedErrors = [];
$hoistedErrors[] = isset( $this->mValidationErrorMessage )
? $this->mValidationErrorMessage
- : array( 'htmlform-invalid-input' );
+ : [ 'htmlform-invalid-input' ];
$this->mWasSubmitted = true;
if ( $res !== true ) {
$valid = false;
if ( $res !== false && !$field->canDisplayErrors() ) {
- $hoistedErrors[] = array( 'rawmessage', $res );
+ $hoistedErrors[] = [ 'rawmessage', $res ];
}
}
}
*
* @return HTMLForm $this for chaining calls (since 1.20)
*/
- public function addHiddenField( $name, $value, $attribs = array() ) {
- $attribs += array( 'name' => $name );
- $this->mHiddenFields[] = array( $value, $attribs );
+ public function addHiddenField( $name, $value, $attribs = [] ) {
+ $attribs += [ 'name' => $name ];
+ $this->mHiddenFields[] = [ $value, $attribs ];
return $this;
}
*/
public function addHiddenFields( array $fields ) {
foreach ( $fields as $name => $value ) {
- $this->mHiddenFields[] = array( $value, array( 'name' => $name ) );
+ $this->mHiddenFields[] = [ $value, [ 'name' => $name ] ];
}
return $this;
'Incorrect number of arguments for deprecated calling style'
);
}
- $data = array(
+ $data = [
'name' => $args[0],
'value' => $args[1],
'id' => isset( $args[2] ) ? $args[2] : null,
'attribs' => isset( $args[3] ) ? $args[3] : null,
- );
+ ];
} else {
if ( !isset( $data['name'] ) ) {
throw new InvalidArgumentException( 'A name is required' );
throw new InvalidArgumentException( 'A value is required' );
}
}
- $this->mButtons[] = $data + array(
+ $this->mButtons[] = $data + [
'id' => null,
'attribs' => null,
'flags' => null,
- );
+ ];
return $this;
}
? 'multipart/form-data'
: 'application/x-www-form-urlencoded';
# Attributes
- $attribs = array(
+ $attribs = [
'action' => $this->getAction(),
'method' => $this->getMethod(),
'enctype' => $encType,
- );
+ ];
if ( !empty( $this->mId ) ) {
$attribs['id'] = $this->mId;
}
+ if ( !empty( $this->mAutocomplete ) ) {
+ $attribs['autocomplete'] = $this->mAutocomplete;
+ }
+ if ( !empty ( $this->mName ) ) {
+ $attribs['name'] = $this->mName;
+ }
return $attribs;
}
return Html::rawElement(
'form',
- $this->getFormAttributes() + array( 'class' => 'visualClear' ),
+ $this->getFormAttributes() + [ 'class' => 'visualClear' ],
$html
);
}
$html .= Html::hidden(
'wpEditToken',
$this->getUser()->getEditToken( $this->mTokenSalt ),
- array( 'id' => 'wpEditToken' )
+ [ 'id' => 'wpEditToken' ]
) . "\n";
$html .= Html::hidden( 'title', $this->getTitle()->getPrefixedText() ) . "\n";
}
$useMediaWikiUIEverywhere = $this->getConfig()->get( 'UseMediaWikiUIEverywhere' );
if ( $this->mShowSubmit ) {
- $attribs = array();
+ $attribs = [];
if ( isset( $this->mSubmitID ) ) {
$attribs['id'] = $this->mSubmitID;
$attribs += Linker::tooltipAndAccesskeyAttribs( $this->mSubmitTooltip );
}
- $attribs['class'] = array( 'mw-htmlform-submit' );
+ $attribs['class'] = [ 'mw-htmlform-submit' ];
if ( $useMediaWikiUIEverywhere ) {
foreach ( $this->mSubmitFlags as $flag ) {
if ( $this->mShowReset ) {
$buttons .= Html::element(
'input',
- array(
+ [
'type' => 'reset',
'value' => $this->msg( 'htmlform-reset' )->text(),
'class' => ( $useMediaWikiUIEverywhere ? 'mw-ui-button' : null ),
- )
+ ]
) . "\n";
}
$isBadIE = preg_match( '/MSIE [1-7]\./i', $this->getRequest()->getHeader( 'User-Agent' ) );
foreach ( $this->mButtons as $button ) {
- $attrs = array(
+ $attrs = [
'type' => 'submit',
'name' => $button['name'],
'value' => $button['value']
- );
+ ];
if ( isset( $button['label-message'] ) ) {
$label = $this->msg( $button['label-message'] )->parse();
}
if ( $useMediaWikiUIEverywhere ) {
- $attrs['class'] = isset( $attrs['class'] ) ? (array)$attrs['class'] : array();
+ $attrs['class'] = isset( $attrs['class'] ) ? (array)$attrs['class'] : [];
$attrs['class'][] = 'mw-ui-button';
}
}
$html = Html::rawElement( 'span',
- array( 'class' => 'mw-htmlform-submit-buttons' ), "\n$buttons" ) . "\n";
+ [ 'class' => 'mw-htmlform-submit-buttons' ], "\n$buttons" ) . "\n";
return $html;
}
}
return $errorstr
- ? Html::rawElement( 'div', array( 'class' => 'error' ), $errorstr )
+ ? Html::rawElement( 'div', [ 'class' => 'error' ], $errorstr )
: '';
}
$msg = array_shift( $error );
} else {
$msg = $error;
- $error = array();
+ $error = [];
}
$errorstr .= Html::rawElement(
'li',
- array(),
+ [],
$this->msg( $msg, $error )->parse()
);
}
- $errorstr = Html::rawElement( 'ul', array(), $errorstr );
+ $errorstr = Html::rawElement( 'ul', [], $errorstr );
return $errorstr;
}
* @since 1.24
*/
public function setSubmitDestructive() {
- $this->mSubmitFlags = array( 'destructive', 'primary' );
+ $this->mSubmitFlags = [ 'destructive', 'primary' ];
}
/**
* @since 1.25
*/
public function setSubmitProgressive() {
- $this->mSubmitFlags = array( 'progressive', 'primary' );
+ $this->mSubmitFlags = [ 'progressive', 'primary' ];
}
/**
return $this;
}
+ /**
+ * @param string $name 'name' attribute for the form
+ * @return HTMLForm $this for chaining calls
+ */
+ public function setName( $name ) {
+ $this->mName = $name;
+
+ return $this;
+ }
+
/**
* Prompt the whole form to be wrapped in a "<fieldset>", with
* this text as its "<legend>" element.
&$hasUserVisibleFields = false ) {
$displayFormat = $this->getDisplayFormat();
- $html = array();
+ $html = [];
$subsectionHtml = '';
$hasLabel = false;
$section .
$this->getFooterText( $key );
- $attributes = array();
+ $attributes = [];
if ( $fieldsetIDPrefix ) {
$attributes['id'] = Sanitizer::escapeId( "$fieldsetIDPrefix$key" );
}
return $html;
}
- $classes = array();
+ $classes = [];
if ( !$anyFieldHasLabel ) { // Avoid strange spacing when no labels exist
$classes[] = 'mw-htmlform-nolabel';
}
- $attribs = array(
+ $attribs = [
'class' => implode( ' ', $classes ),
- );
+ ];
if ( $sectionName ) {
$attribs['id'] = Sanitizer::escapeId( $sectionName );
if ( $displayFormat === 'table' ) {
return Html::rawElement( 'table',
$attribs,
- Html::rawElement( 'tbody', array(), "\n$html\n" ) ) . "\n";
+ Html::rawElement( 'tbody', [], "\n$html\n" ) ) . "\n";
} elseif ( $displayFormat === 'inline' ) {
return Html::rawElement( 'span', $attribs, "\n$html\n" );
} else {
* Construct the form fields from the Descriptor array
*/
function loadData() {
- $fieldData = array();
+ $fieldData = [];
foreach ( $this->mFlatFields as $fieldname => $field ) {
if ( !empty( $field->mParams['nodata'] ) ) {
return $this->getTitle()->getLocalURL();
}
+
+ /**
+ * Set the value for the autocomplete attribute of the form.
+ * When set to false (which is the default state), the attribute get not set.
+ *
+ * @since 1.27
+ *
+ * @param string|bool $autocomplete
+ *
+ * @return HTMLForm $this for chaining calls
+ */
+ public function setAutocomplete( $autocomplete ) {
+ $this->mAutocomplete = $autocomplete;
+
+ return $this;
+ }
}