*/
/**
- * Class for generating HTML <select> elements.
+ * Class for generating HTML <select> or <datalist> elements.
*/
class XmlSelect {
- protected $options = array();
+ protected $options = [];
protected $default = false;
- protected $attributes = array();
+ protected $tagName = 'select';
+ protected $attributes = [];
public function __construct( $name = false, $id = false, $default = false ) {
if ( $name ) {
}
/**
- * @param string $default
+ * @param string|array $default
*/
public function setDefault( $default ) {
$this->default = $default;
}
+ /**
+ * @param string|array $tagName
+ */
+ public function setTagName( $tagName ) {
+ $this->tagName = $tagName;
+ }
+
/**
* @param string $name
* @param string $value
*/
public function addOption( $label, $value = false ) {
$value = $value !== false ? $value : $label;
- $this->options[] = array( $label => $value );
+ $this->options[] = [ $label => $value ];
}
/**
* label => ( label => value, label => value )
*
* @param array $options
- * @param string $default
+ * @param string|array $default
* @return string
*/
static function formatOptions( $options, $default = false ) {
foreach ( $options as $label => $value ) {
if ( is_array( $value ) ) {
$contents = self::formatOptions( $value, $default );
- $data .= Html::rawElement( 'optgroup', array( 'label' => $label ), $contents ) . "\n";
+ $data .= Html::rawElement( 'optgroup', [ 'label' => $label ], $contents ) . "\n";
} else {
- $data .= Xml::option( $label, $value, $value === $default ) . "\n";
+ // If $default is an array, then the <select> probably has the multiple attribute,
+ // so we should check if each $value is in $default, rather than checking if
+ // $value is equal to $default.
+ $selected = is_array( $default ) ? in_array( $value, $default ) : $value === $default;
+ $data .= Xml::option( $label, $value, $selected ) . "\n";
}
}
$contents .= self::formatOptions( $options, $this->default );
}
- return Html::rawElement( 'select', $this->attributes, rtrim( $contents ) );
+ return Html::rawElement( $this->tagName, $this->attributes, rtrim( $contents ) );
}
}