CKTIS / JavaScript
document.createElement — tworzenie elementu DOM
document.createElement tworzy nowy element DOM o podanej nazwie. Nie wstawia go automatycznie do dokumentu.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
document.createElement(localName)
document.createElement(localName, options)document.createElement(localName, options) zwraca nowy element bez rodzica. Argument localName jest nazwą elementu, nie kodem HTML. Treść ustaw przez textContent, a element dołącz osobno, np. przez appendChild.
W dokumencie HTML nazwa jest zamieniana na małe litery ASCII. Niepoprawna nazwa powoduje DOMException o nazwie InvalidCharacterError. Do jawnego wyboru przestrzeni nazw służy createElementNS.
W opcjonalnym argumencie options właściwość is wskazuje zarejestrowaną nazwę niestandardowego elementu, który rozszerza wbudowany element wskazany przez localName. Aby utworzyć autonomiczny element niestandardowy, podaj jego zarejestrowaną nazwę bezpośrednio jako localName, a nie jako options.is. Safari nie obsługuje niestandardowych elementów rozszerzających elementy wbudowane, więc to użycie options.is nie działa we wszystkich przeglądarkach.
Przykład pokazuje tylko wywołanie z jednym argumentem, bez options. Wymaga dokumentu HTML w przeglądarce; sama obsługa JavaScript nie gwarantuje dostępności document.
Przykłady
const element = document.createElement("DIV");
element.textContent = "Hello";
console.log(element.localName);
console.log(element.textContent);
console.log(element.parentNode === null);Wynik
div Hello true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.