AttributeList

Manages HTML attributes on an ElementNode. Accessed via node.attributes.

Attributes set via element definition are managed automatically. Use AttributeList directly when you need to read or mutate attributes imperatively inside lifecycle hooks.

Methods

get(name)

Returns the current value of an attribute.

node.attributes.get("class")     // "btn active"
node.attributes.get("disabled")  // true | undefined

set(name, value)

Sets or updates an attribute value.

node.attributes.set("aria-expanded", "true")
node.attributes.set("tabindex", 0)
node.attributes.set("disabled", true)

has(name)

Returns true if the attribute exists.

node.attributes.has("disabled")  // boolean

remove(name)

Removes an attribute from the element.

node.attributes.remove("disabled")

toggle(name, force?)

Toggles a boolean attribute (disabled, hidden, checked, etc.).

node.attributes.toggle("disabled")         // flip
node.attributes.toggle("disabled", true)   // force on
node.attributes.toggle("disabled", false)  // force off

onChange(name, callback)

Subscribes to changes on a specific attribute after the node is mounted and the attribute already exists. The listener auto-releases when the node is removed.

node.attributes.onChange("aria-expanded", (value) => {
    console.log("expanded:", value)
})

If you need to observe a value immediately, set the attribute first, then subscribe inside _onMount or another mounted lifecycle hook.

addClass(className)

Adds a class to the element's class list.

node.attributes.addClass("active")

removeClass(className)

Removes a class from the element's class list.

node.attributes.removeClass("active")

hasClass(className)

Returns true if the class exists in the element's class list.

node.attributes.hasClass("active")      // boolean

toggleClass(className)

Toggles a class in the element's class list.

node.attributes.toggleClass("active")

replaceClass(oldClass, newClass)

Replaces an existing class with a new one.

node.attributes.replaceClass("old", "new")