Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

is — rozszerzenie wbudowanego elementu HTML

Atrybut is wskazuje definicję elementu niestandardowego rozszerzającego wbudowany element HTML. Zachowuje on natywną semantykę i zachowanie elementu bazowego, dodając funkcje autora.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

<button is="demo-button" type="button">Demo</button>

Atrybut is służy do tworzenia rozszerzonego elementu wbudowanego (customized built-in element). Jego wartość musi być poprawną nazwą elementu niestandardowego, zawierającą łącznik, np. demo-button. Nie jest to atrybut logiczny.

Klasa rozszerza odpowiedni interfejs, np. HTMLButtonElement, a rejestracja przez customElements.define() podaje { extends: "button" }. Nazwa bazowa w znaczniku musi pasować do extends. Element zachowuje localName równe button, natywną semantykę przycisku i obsługę disabled.

Element autonomiczny używa własnej nazwy znacznika; is nie może być na nim podany i nie wywoła tam rozszerzenia. Zmiana lub dodanie is przez setAttribute() po utworzeniu elementu nie zmienia jego typu. Programowo użyj document.createElement("button", { is: "demo-button" }).

Przykład rejestruje definicję po sparsowaniu przycisku, który zostaje następnie uaktualniony. Obsługa rozszerzonych elementów wbudowanych nie jest jednak powszechna we wszystkich przeglądarkach; sprawdź środowiska docelowe.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>is example</title>
<button is="demo-button" type="button" id="demo">Demo</button>
<script>
class DemoButton extends HTMLButtonElement {
  message() {
    return "custom behavior";
  }
}
customElements.define("demo-button", DemoButton, { extends: "button" });
const button = document.getElementById("demo");
console.log(button.localName);
console.log(button instanceof DemoButton);
console.log(button.message());
</script>
</html>

Wynik

button
true
custom behavior

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła