mmo-upload

1 symbol · generated 5 Oct 2026

element

mmo-upload

Drop files, or pick them, and send them to mmo.edms: a chunk at a time, two files at once, each one resumed where the server stopped when a chunk fails.

<mmo-upload url token labels attachment max accept></mmo-upload>

Extends: CustomShadowElement

Index

	url	where mmo.edms' api is: the page's (`MMO.edms.config.url`) by default
	token	the session's CSRF token: the page's by default
	labels	the labels of the files: ids, or quoted paths and `"#tags"`, separated by spaces
	attachment	the uid of an entity the files are attached to
	max	how many files it takes at most
	accept	the types it takes, as an `<input type="file">` says them (`image,.pdf`)
	temporary	no file is made: each one's `id` is for the application to take its bytes
	auto	the files are sent as soon as they are dropped
	disabled	takes no file
	ViewDefault static readonly accessor
	api readonly accessor	The api the files are sent to
	disabled accessor	Get the disabled attribute
	labels accessor	Get the labels attribute
	attachment accessor	Get the attachment attribute
	temporary accessor	Get the temporary attribute
	auto readonly accessor	Get the auto attribute
	max accessor	Get the max attribute
	accept accessor	Get the accept attribute
	init()
	handleLabelKeydown(event)	Handle the keydown event of the label
	filesChange(input)	Handle the change event of the file input
	addFiles(files)	Add files to send: with `auto`, they are sent once they are all added
	accepts(file)
	addFile(file, submit)	Add a file to send
	removeItem(item)	Stop sending a file, and forget it
	submit(event)	Send the files not sent yet (those that failed are sent again)
	send(api, item)	Send one file: it never throws, what went wrong is on its row
	clear()	Remove every file
	update()	The send button, and the frosted zone once nothing more can be added
	.dragover	set while files are dragged over the element
	.maxed	set once it holds as many files as `max`
	.no-submit	hides the send button (the page calls `submit()` itself)

Attributes9

url

mmo-upload.jhs

where mmo.edms' api is: the page's (MMO.edms.config.url) by default

url

token

mmo-upload.jhs

the session's CSRF token: the page's by default

token

labels

mmo-upload.jhs

the labels of the files: ids, or quoted paths and "#tags", separated by spaces

labels

attachment

mmo-upload.jhs

the uid of an entity the files are attached to

attachment

max

mmo-upload.jhs

how many files it takes at most

max

accept

mmo-upload.jhs

the types it takes, as an <input type="file"> says them (image,.pdf)

accept

temporary

mmo-upload.jhs

no file is made: each one's id is for the application to take its bytes

temporary

auto

mmo-upload.jhs

the files are sent as soon as they are dropped

auto

disabled

mmo-upload.jhs

takes no file

disabled

Properties9

ViewDefault

staticreadonlyaccessormmo-upload.jhs:51

static get ViewDefault()

api

readonlyaccessormmo-upload.jhs:59

The api the files are sent to

get api()

Type: MMO.edms.Api

disabled

accessormmo-upload.jhs:67

Get the disabled attribute

get disabled() set disabled(value)

Type: boolean

labels

accessormmo-upload.jhs:80

Get the labels attribute

get labels() set labels(value)

Type: string | array

attachment

accessormmo-upload.jhs:92

Get the attachment attribute

get attachment() set attachment(value)

Type: string

temporary

accessormmo-upload.jhs:104

Get the temporary attribute

get temporary() set temporary(value)

Type: boolean

auto

readonlyaccessormmo-upload.jhs:117

Get the auto attribute

get auto()

Type: boolean

max

accessormmo-upload.jhs:125

Get the max attribute

get max() set max(value)

Type: number

accept

accessormmo-upload.jhs:138

Get the accept attribute

get accept() set accept(value)

Type: string

Methods11

init()

mmo-upload.jhs:35

init()

handleLabelKeydown(event)

mmo-upload.jhs:150

Handle the keydown event of the label

handleLabelKeydown(event)

event Event - The event

filesChange(input)

mmo-upload.jhs:161

Handle the change event of the file input

filesChange(input)

input HTMLInputElement - The input

addFiles(files)

mmo-upload.jhs:171

Add files to send: with auto, they are sent once they are all added

addFiles(files)

files FileList | Array<File>

accepts(file)

mmo-upload.jhs:180

accepts(file)

file	`File`
returns	`boolean`	true if the element takes a file of that type (`accept`)

addFile(file, submit)

mmo-upload.jhs:194

Add a file to send

addFile(file, submit = true)

file	`File`	- The file to add
submit = true	`boolean`	- with `auto`, send it at once
returns	`?Object`	the file's item, null if it is refused

removeItem(item)

mmo-upload.jhs:229

Stop sending a file, and forget it

removeItem(item)

item Object - addFile

submit(event)

mmo-upload.jhs:242

Send the files not sent yet (those that failed are sent again)

submit(event = null)

event = null	`?Event`	- The event
returns	`Promise<{files: Array<Object>, errors: Array<Error>`	>} the files made -- for a temporary upload, `{id, name, temporary}` -- and the errors