mmo-select

1 symbol · generated 5 Oct 2026

element

mmo-select

Select element to display a list of options

<mmo-select name icon readonly disabled value required url search multiple enum placeholder></mmo-select>

Extends: CustomAPIElement

You can put <option> and <optgroup> inside the mmo-select. They will be converted automatically. WARNING: using <option> only allow to put string value. Using setOptions permits using any type of value.

Index

	name	the name of the icon
	icon	the icon of the select
	readonly	if true, the select is readonly
	disabled	if true, the select is disabled
	value	the current value of the mmo-select (NOTE: can be any type, object included).
	required	if true, the select is required
	url	an url to a json api or a json stringify object: {collection, repository, filters}
	search	the current text being searched
	multiple	if true, the select is multiple
	enum	the enum of the select
	placeholder	the placeholder of the select
	ViewDefault static readonly accessor
	data accessor	Set the data of the select
	disabled accessor	Get the disabled of the select
	readonly accessor	Get the readonly of the select
	required accessor	Get the required of the select
	enum accessor	Get the enum of the select
	multiple accessor	Get the multiple of the select
	validationMessage accessor	Get the validation message of the select
	validity readonly accessor	Get the validity of the select
	willValidate readonly accessor	Check if the select will validate
	value accessor	Get the value of the select
	search accessor	Get the search of the select
	constructor()
	init()
	focus()	Focus the input element
	hasInput()	Check if the select has an input
	isDropdown()	Check if the select is a dropdown
	isMultiple()	Check if the select is multiple
	checkValidity()	Check the validity of the select
	isSameValue(value, search, multiple)	Check if search is contained or is the same value as value As entities cannot be compared, if the value is an entity, we check if their uid is the same
	clear()	Clear the value of the select
	setValueByIndex(group, index)	Set the value of the select by index
	setValueByNode(node)	Set the value of the select by node
	addGroup(id, label)	Add a group for options
	addOption(value, label, group)	Add option
	removeOption(value)	Remove an option from the select
	removeGroup(group)	Remove a group from the select
	setOptions(options, group)	Set options for a specific group
	getOptions(group)	Get the options of a specific group from the select
	clearOptions()	Clear all options of the select
	clearSearch()	Clear the search of the select
	select(index)	Select an element (but don't set the value)
	toggleSelectAll()	Toggle the select all of the select
	updatePosition()	Update the position of the select
	show(event)	Show select close to its input
	isShown()	Check if the select is shown
	hide()	Hide hintbox
	eventClick(event)	On click event
	eventInput(event)	On input event
	eventKey(event)	On key event
	.with-input	show the input search
	.dropdown	show the options like a dropdown
	.anchor-top	the list opens upwards, for a control near the bottom of the screen
	.rounded	add a border radius to the select
	.searching	add a border to the select
	.floating	displays the select as a floating element
	.compact	reduce the gap between the options

Attributes11

name

mmo-select.jhs

the name of the icon

name

icon

mmo-select.jhs

the icon of the select

icon

readonly

mmo-select.jhs

if true, the select is readonly

readonly

disabled

mmo-select.jhs

if true, the select is disabled

disabled

value

mmo-select.jhs

the current value of the mmo-select (NOTE: can be any type, object included). It CAN be different of the value in the input.

value

required

mmo-select.jhs

if true, the select is required

required

url

mmo-select.jhs

an url to a json api or a json stringify object: {collection, repository, filters}

url

search

mmo-select.jhs

the current text being searched

search

multiple

mmo-select.jhs

if true, the select is multiple

multiple

enum

mmo-select.jhs

the enum of the select

enum

placeholder

mmo-select.jhs

the placeholder of the select

placeholder

Properties12

ViewDefault

staticreadonlyaccessormmo-select.jhs:40

static get ViewDefault()

data

accessormmo-select.jhs:118

Set the data of the select

set data(value)

disabled

accessormmo-select.jhs:146

Get the disabled of the select

get disabled() set disabled(value)

Type: boolean

readonly

accessormmo-select.jhs:163

Get the readonly of the select

get readonly() set readonly(value)

Type: boolean

required

accessormmo-select.jhs:180

Get the required of the select

get required() set required(value)

Type: boolean

enum

accessormmo-select.jhs:197

Get the enum of the select

get enum() set enum(value)

Type: array

multiple

accessormmo-select.jhs:255

Get the multiple of the select

get multiple() set multiple(value)

Type: boolean

validationMessage

accessormmo-select.jhs:282

Get the validation message of the select

get validationMessage() set validationMessage(value)

Type: string

validity

readonlyaccessormmo-select.jhs:298

Get the validity of the select

get validity()

Type: object

willValidate

readonlyaccessormmo-select.jhs:319

Check if the select will validate

get willValidate()

Type: boolean

value

accessormmo-select.jhs:366

Get the value of the select

get value() set value(value)

Type: array | *

search

accessormmo-select.jhs:652

Get the search of the select

get search() set search(value)

Type: string

Methods28

constructor()

mmo-select.jhs:47

constructor()

init()

mmo-select.jhs:60

init()

focus()

mmo-select.jhs:109

Focus the input element

focus()

hasInput()

mmo-select.jhs:239

Check if the select has an input

hasInput()

returns boolean true if the select has an input

isDropdown()

mmo-select.jhs:247

Check if the select is a dropdown

isDropdown()

returns boolean true if the select is a dropdown

isMultiple()

mmo-select.jhs:274

Check if the select is multiple

isMultiple()

returns boolean true if the select is multiple

checkValidity()

mmo-select.jhs:327

Check the validity of the select

checkValidity()

returns boolean true if the select is valid

isSameValue(value, search, multiple)

mmo-select.jhs:342

Check if search is contained or is the same value as value As entities cannot be compared, if the value is an entity, we check if their uid is the same

isSameValue(value, search, multiple = false)

value	`Array` \| `*`	the current select's value (a list if multiple)
search	`*`	the new value to look for
multiple = false
returns	`boolean`	true

clear()

mmo-select.jhs:357

Clear the value of the select

clear()

setValueByIndex(group, index)

mmo-select.jhs:420

Set the value of the select by index

setValueByIndex(group, index)

group	`string`	- The group of the select
index	`number`	- The index of the select

setValueByNode(node)

mmo-select.jhs:466

Set the value of the select by node

setValueByNode(node)

node	`Element`	- The node of the select
returns	`boolean`	true if the value is set by node

addGroup(id, label)

mmo-select.jhs:490

Add a group for options

addGroup(id, label = null)

id	`string`
label = null	`?(string` \| `Node` \| `MMO.core.dom.Html)`	the group's header, the id when there is none: text unless it is a node (`MMO.core.dom.appendChildren`), markup you wrote goes through `MMO.core.dom.html()`
returns

addOption(value, label, group)

mmo-select.jhs:522

Add option

addOption(value, label = null, group = null)

value	`*`	any value to use as the value
label = null	`?(string` \| `Node` \| `NodeList` \| `MMO.core.dom.Html)`	what the option shows, the value when there is none: text unless it is a node (`MMO.core.dom.appendChildren`) -- an entity's title from the api shows as it was typed. Markup you wrote goes through `MMO.core.dom.html()`
group = null	`string` \| `Element`	an id for a group
returns		the node created