mmo-select

1 symbole · générée le 27 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>

Étend: 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: a `required` one holds a value, whatever its mode.
	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: replaces the options it had, the other groups' are kept
	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

Attributs11

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

Propriétés12

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:201

Get the enum of the select

get enum() set enum(value)

Type: array

multiple

accessormmo-select.jhs:259

Get the multiple of the select

get multiple() set multiple(value)

Type: boolean

validationMessage

accessormmo-select.jhs:286

Get the validation message of the select

get validationMessage() set validationMessage(value)

Type: string

validity

readonlyaccessormmo-select.jhs:302

Get the validity of the select

get validity()

Type: object

willValidate

readonlyaccessormmo-select.jhs:323

Check if the select will validate

get willValidate()

Type: boolean

value

accessormmo-select.jhs:373

Get the value of the select

get value() set value(value)

Type: array | *

search

accessormmo-select.jhs:681

Get the search of the select

get search() set search(value)

Type: string

Méthodes28

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:243

Check if the select has an input

hasInput()

retourne boolean true if the select has an input

isDropdown()

mmo-select.jhs:251

Check if the select is a dropdown

isDropdown()

retourne boolean true if the select is a dropdown

isMultiple()

mmo-select.jhs:278

Check if the select is multiple

isMultiple()

retourne boolean true if the select is multiple

checkValidity()

mmo-select.jhs:334

Check the validity of the select: a required one holds a value, whatever its mode.

checkValidity()

The value is the one chosen, or given before its options load (`userValue`), never the text of the search: an empty one (`with-input`, `dropdown`; a field saved as '') is no choice (my.oviepro #264). A select that is not `required` is valid empty, as a <select> is.

retourne boolean true if the select is valid

isSameValue(value, search, multiple)

mmo-select.jhs:349

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
retourne	`boolean`	true

clear()

mmo-select.jhs:364

Clear the value of the select

clear()

setValueByIndex(group, index)

mmo-select.jhs:436

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:482

Set the value of the select by node

setValueByNode(node)

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

addGroup(id, label)

mmo-select.jhs:506

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()`
retourne

addOption(value, label, group)

mmo-select.jhs:538

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
retourne		the node created