<onlinq-collection>: The Dynamic Form Collection element
The <onlinq-collection>
element provides special properties and methods for
manipulating entries in a collection.
Attributes
This element's attributes include the global attributes.
-
prefix
The prefix ofname
attributes of input elements of the form collection. -
allow-add
Boolean attribute indicating whether new entries can be added to the collection. -
allow-delete
Boolean attribute indicating whether entries can be removed from the collection. -
allow-move
Boolean attribute indicating whether entries can be moved inside the collection. -
prototype-name
The replacement value for the entry prototype's index value. -
min
The minimum amount of entries in the collection. -
max
The maximum amount of entries in the collection.
Properties
This element inherits properties from its ancestors HTMLElement, Element, Node and EventTarget.
-
entries
(read-only)
An array containing the entry elements. -
prefix
The prefix ofname
attributes of input elements of the form collection. Defaults to its ownname
attribute value ornull
. -
allowAdd
Boolean property indicating whether new entries can be added to the collection. -
allowDelete
Boolean property indicating whether entries can be removed from the collection. -
allowMove
Boolean property indicating whether entries can be moved inside the collection. -
prototype
(read-only)
Returns the entry prototype if it exists. -
prototypeName
The replacement value for the entry prototype's index value. Defaults to__name__
. -
min
The minimum amount of entries in the collection. Defaults to0
. -
max
The maximum amount of entries in the collection. Use0
for unlimited entries. Defaults to0
.
Methods
This element inherits methods from its ancestors HTMLElement, Element, Node and EventTarget.
-
entry(index)
Returns the entry with the specified index. -
addEntry()
Adds a new entry to the end of the collection. -
deleteEntry(index)
Removes the entry with the specified index. -
moveEntry(index, targetIndex)
Moves the entry with the specified index to the specified target index. -
enableAddButtons()
Removesdisabled
attributes from buttons adding a new entry to the collection. -
disableAddButtons()
Addsdisabled
attributes from buttons adding a new entry to the collection.
Events
This element inherits events from its ancestors HTMLElement and Element.
-
entryAdded
Fired when a new entry is added to the collection. -
befireEntryRemoved
Fired before an entry is removed from the collection. -
entryRemoved
Fired when an entry is removed from the collection.
Slots
_root_
Direct descendents of the element are embedded as entries of the collection. Note that the collection can only interact with entries enclosed in theonlinq-collection-entry
tag.placeholder
The element shown as a placeholder when the collection is empty.actions
The container for all collection action buttons (Add entry). Use an empty element to hide all action buttons at once.add
The container for the Add entry action button. To use a custom button, add this slot containing abutton
element with thecollection-add
property. Note that this slot is part of theactions
slot, it will not show up if theactions
slot is defined.