mmo-element-doc

the tag name to document (mmo-icon). Changing it re-reads everything.

element

Type

string

Re-read the documented element and rebuild the page. Called on init and whenever the element attribute changes.

Read the documentation of an element: what its jsdoc declared, plus the slots its shadow root actually has -- a slot nobody documented is still a slot, and hiding it would be a lie.

Read the configurator's starting point from the preset slot.

Put the configurator back to what the preset asks for.

Show the preview on the next ground: what looks right on white can vanish on ink.

Build one control per attribute, class and slot. @return {void}

Add one titled group of rows to the configurator, unless it would be empty.

One line of the configurator: a switch, a name, a field and what it is for.

Rebuild the preview from the current configuration, and the html that would produce it.

Write the configured element out as a page would: attributes in order, slotted children one per line, nothing the reader would have to delete.

Copy the generated html.

Build the reference tables, in the order a reader needs them. @return {void}

Add one reference table, unless the element has nothing to put in it.

jsdoc writes @attr name - what it does: the dash is a separator, not part of the sentence.

Render a default value for the reference: an em dash when there is none.

a <script type="application/json"> giving the configurator its starting point: attributes (per name: value, values to offer, type), classes already on, slots with their starting content, and ground (surface, bg or ink).

<slot name="preset">

anything to show under the reference, for a page that has more to say.

<slot>

hide the configurator and show the preview and the reference only

.compact