TreeWalker#
TreeWalker.whatToShow#
Właściwość whatToShow
zwraca maskę bitową (liczba całkowita) skojarzoną z danym przemierzaczem drzewa. 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 walker_bitmask = treeWalker.whatToShow;
gdzie poszczególne człony oznaczają:
- walker_bitmask - maska bitowa w postaci liczby całkowitej.
- treeWalker - przemierzacz drzewa będący obiektem kontekstu.
Maska bitowa jest ustawiana bezpośrednio przy tworzeniu przemierzacza drzewa (jako drugi argumenty) za pomocą metody Document.createTreeWalker()
i nigdy nie ulega zmianie. W przypadku pominięcia argumentu zwrócona zostanie domyślna wartość 4294967295
(0xFFFFFFFF
), co jest równoważne stałej NodeFilter.SHOW_ALL
.
Prosty przykład:
<script>
// Tworzymy nowego przemierzacza drzewa z domyślną maską bitów
var walker1 = document.createTreeWalker(document);
// Tworzymy nowego przemierzacza drzewa z konkretną maską bitów
var walker2 = document.createTreeWalker(document, 0x80 | 0x800);
document.write(walker1.whatToShow); // 4294967295
document.write("<br>");
document.write(walker2.whatToShow); // 2176
</script>
Niektóre przeglądarki (np. IE lub starsze wydania Chrome) mogą niewłaściwie ustawiać/zwracać pewne wartości dla maski bitowej, chociaż nie będzie to miało negatywnego wpływu na proces filtrowania (szczegóły).
Składnia Web IDL#
interface TreeWalker { readonly attribute unsigned long whatToShow; }