CharacterData#
CharacterData.length#
Właściwość length
zwraca liczbę jednostek kodowych, które tworzą dane tekstowe skojarzone z danym węzłem znakowym. Jeśli dane tekstowe będą pustym łańcuchem znakowym to zwrócona zostanie wartość 0
. Właściwość jest tylko do odczytu.
Opis działania#
Samo wywołanie i poszczególne jego części najlepiej objaśnić na zapisie składniowym:
var code_units = node.length;
gdzie poszczególne człony oznaczają:
- code_units - liczba całkowita reprezentująca ilość jednostek kodowych w danych tekstowych.
- node - węzeł znakowy będący obiektem kontekstu.
Więcej informacji na temat jednostek kodowych umieszczono w materiałach związanych z kodowaniem, ze szczególnym uwzględnieniem działu "Zestawy znaków - Wstęp" z kursu HTML.
Prosty przykład:
<script>
var newText1 = document.createTextNode("Początkowa treść");
var newText2 = document.createTextNode("");
var newText3 = document.createTextNode(" ");
var newText4 = document.createTextNode("𦓻");
document.write("Węzeł tekstowy o treści 'Początkowa treść' składa się z:" + "<br>");
document.write(newText1.length + " jednostek kodowych"); // 16 jednostek kodowych
document.write("<br><br>");
document.write("Węzeł tekstowy o treści '' składa się z:" + "<br>");
document.write(newText2.length + " jednostek kodowych"); // 0 jednostek kodowych
document.write("<br><br>");
document.write("Węzeł tekstowy o treści ' ' (zawarta jedna spacja) składa się z:" + "<br>");
document.write(newText3.length + " jednostek kodowych"); // 1 jednostek kodowych
document.write("<br><br>");
document.write("Węzeł tekstowy o treści '𦓻' składa się z:" + "<br>");
document.write(newText4.length + " jednostek kodowych"); // 2 jednostek kodowych
</script>
Składnia Web IDL#
interface CharacterData : Node { readonly attribute unsigned long length; }
Specyfikacje i inne materiały#
Pasek społecznościowy