CustomStateSet: add() method

Baseline 2024
Newly available

Since ⁨May 2024⁩, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

The add method of the CustomStateSet interface adds value representing a custom state to the CustomStateSet.

Custom elements with a specific state can be selected using the :state() pseudo-class, specifying the desired state as an argument.

Syntax

js
add(value)

Parameters

value

A string that represents the custom state.

Return value

Undefined.

Examples

The following function adds the state checked to a CustomStateSet.

js
class MyCustomElement extends HTMLElement {
  set checked(flag) {
    if (flag) {
      this._internals.states.add("checked");
    }
  }
}

Specifications

Specification
HTML
# custom-state-pseudo-class

Browser compatibility