Metoda substringData() w XML DOM

Definicja i użycie

Metoda substringData() z Tekst lub Komentarz wyodrębniony z węzła.}}

Gramatyka:

CharacterData.substringData(start,length)
Parametr Opis
start Wymagane. Pozycja pierwszego znaku w zwracanym podciągu.
length Wymagane. Liczba znaków w zwracanym podciągu.

Zwracana wartość

Zwraca ciąg znaków, który zawiera tekst z węzła Text lub Comment od start zaczynając od length znaków.

Rzuca

Metoda ta może rzucać wyjątek o następującym kodzie: Wyjątek DOMException:

INDEX_SIZE_ERR - Parametr start lub length jest ujemny lub length większy niż długość węzła Text lub Comment.

DOMSTRING_SIZE_ERR - Podany zakres tekstu jest zbyt długi, aby wpisać go do ciągu znaków w implementacji JavaScript przeglądarki.

Opis

Metoda ta wydrawa z węzła Text lub Comment tekst od start zaczynając od length znaków. Metoda ta jest używana tylko wtedy, gdy liczba znaków zawartych w tekście węzła jest większa niż maksymalna liczba znaków, którą można wpisać do ciągu znaków w implementacji JavaScript przeglądarki. W tym przypadku program JavaScript nie może bezpośrednio używać atrybutu data węzła Text lub Comment, ale musi użyć krótszego podciągu tekstu węzła. W praktyce, takie sytuacje są rzadko spotykane.

Strony związane

Podręcznik XML DOM:Text.replaceData()

Podręcznik XML DOM:Comment.replaceData()