We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

Ten element powinien być stosowany do tworzenia kreatorów krok-po-kroku, jaki znajduje się w różnych aplikacjach aby przeprowadzić użytkownika przez jakieś zadanie. Jest to okno z kilkoma krokami znajdującymi się na kilku stronach. Element wizard tworzy okno i dostarcza nagłówek oraz przyciski wzdłuż dolnej krawędzi i obsługuje nawigację pomiędzy stronami. Każda strona powinna być tworzona używając elementu wizardpage. Strony wyświetlane są w takiej kolejności w jakiej zostały umieszczone wewnątrz elementu wizard, chyba że użyjesz atrybutów next i pageid stron by zmienić sekwencję. Kreator zostanie wyświetlony w sposób odpowiedni dla platformy i motywu użytkownika. W nowszych wersjach Mozilli, element statusbar może zostać umieszczony bezpośrednio wewnątrz elementu wizard i będzie współdzielony przez wszystkie strony.

Dodatkowe informacje są dostępne w kursie XUL.

Atrybuty
firstpage, lastpage, onextra1, onextra2, onwizardback, onwizardcancel, onwizardfinish, onwizardnext, pagestep, title
Własności
canAdvance, canRewind, currentPage, onFirstPage, onLastPage, pageCount, pageIndex, pageStep, title, wizardPages
Metody
advance, cancel, extra1, extra2, getButton, getPageById, goTo, rewind

Przykłady

<?xml version="1.0"?>
<?xml-stylesheet href="chrome://global/skin/" type="text/css"?>

<wizard id="theWizard" title="Secret Code Wizard"
  xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">

<script>
function checkCode(){
  document.getElementById('theWizard').canAdvance = (document.getElementById('secretCode').value == "cabbage");
} 
</script>

  <wizardpage onpageshow="checkCode();">
       <label value="Enter the secret code:"/>
       <textbox id="secretCode" onkeyup="checkCode();"/>
  </wizardpage>

  <wizardpage>
       <label value="That is the correct secret code."/>
  </wizardpage>

</wizard>

Atrybuty

firstpage
Typ: boolean
Ustawiony na true, jeśli wizard jest na pierwszej stronie.


lastpage
Typ: boolean
Ustawiony na true, jeśli wizard jest na ostatniej stronie.


onextra1
Typ: kod skryptu
Ten atrybut powinien być ustawiony w kodzie, który wywołany bedzie kiedy użytkownik naciśnie dodatkowy przycisk (<tt>extra1</tt>).


onextra2
Typ: kod skryptu
Ten atrybut powinien być ustawiony w kodzie, który wywołany bedzie kiedy użytkownik naciśnie dodatkowy przycisk (<tt>extra2</tt>).


onwizardback
Typ: kod skryptu
Powinien być ustawiony kod, który jest wywołany kiedy użytkownik naciśnie przycisk Wstecz. Zwraca true, aby pozwolić na to by wyświetlić wcześniejszą stronę i false, aby nie pozwolić na powrót do wcześniejszej strony. Zastosuj własność canRewind, aby zasygnalizować użytkownikowi (przez odłączenie przycisku Wstecz), że on nie może wrócić do poprzedniej strony.
onwizardcancel
Typ: kod skryptu
Powinien być ustawiony kod, który jest wywołany, kiedy użytkownik naciśnie przycisk Anuluj. Zwraca true, aby pozwolić kreatorowi zostać anulowanym i zamkniętym lub zwróci false, aby chronić kreator przed anulowaniem. Use the canCancel property to indicate to the user (by disabling the Cancel button) that they cannot cancel.

 

onwizardfinish
Typ: kod skryptu
Powinien być ustawiać kod, który jest wywoływany kiedy użytkownik naciśnie przycisk Zakończ, który pojawi się przycisk Dalej na ostatniej stronie kreatora. Zwraca true pozwalając kreatorowi na zamknięcie się lub zwraca false, zapobiega przejście do następnej strony. Zastosuj własność canAdvance, aby zasygnalizować użytkownikowi (poprzez wyłączenie przycisku Zakończ), że nie ma on końca.
onwizardnext
Typ: kod skryptu
Powinien być ustawiać kod, który jest wywoływany kiedy użytkownik naciśnie przycisk Dalej, podczas pobytu na bieżącej stronie. Zwraca true pozwalając następnej stronie na wyświetlenie sie i zwraca false nie pozwalając na przejście do następnej strony. Zastosuj własność canAdvance aby zasygnalizować użytkownikowi (poprzez wyłączenie przycisku Dalej), że nie może on przejść do następnej strony.
pagestep
Typ: integer
Indeks bieżącej strony.
title
Typ: string
Tekst wyświetlony na pasku tytułu w oknie dialogowym.



Własności

Metody

Dziedziczy z elementu XUL
blur, click, doCommand, focus, getElementsByAttribute getElementsByAttributeNS

Dziedziczy z elementu DOM
addEventListener(), appendChild(), dispatchEvent(), getAttribute(), getAttributeNode(), getAttributeNodeNS(), getAttributeNS(), getElementsByTagName(), getElementsByTagNameNS(), hasAttribute(), hasAttributeNS(), hasAttributes(), hasChildNodes(), insertBefore(), isSupported(), normalize(), removeAttribute(), removeAttributeNode(), removeAttributeNS(), removeChild(), removeEventListener(), replaceChild(), setAttribute(), setAttributeNode(), setAttributeNodeNS(), setAttributeNS()

advance( pageID )
Zwraca typ: nie zwraca wartości
Wywołaj tą metodę, aby przejść stronę dalej. Jest równoważna naciśnięciu przycisku Dalej. Własność canAdvance musi być ustawiona na true dla strony, która będzie zmieniona. Kod w atrybucie onwizardnext jest wywołany przed zmianą strony. Argument pageID pozwala nam określić indeks strony do której mamy przejść. Dostarcza null jako argument przejścia do strony dalej w pewnej kolejności.
cancel()
Zwraca typ: nie zwraca wartości
Wywołuje tą metodę do anulowania i zamknięcia kreatora. Kod w atrybucie onwizardcancel jest wywołany zanim okno kreatora zostanie anulowane.


extra1()
Zwraca typ: nie zwraca wartości
Wywołanie tej metody symuluje naciśnięcie dodatkowego przycisku (<tt>extra1</tt>). Kod w atrybucie onextra1 zostanie wywołany.


extra2()
Zwraca typ: nie zwraca wartości
Wywołanie tej metody symuluje naciśnięcie dodatkowego przycisku (<tt>extra2</tt>). Kod w atrybucie onextra2 zostanie wywołany.


getButton( typ )
Zwraca typ: element button
Zwraca element button o zadanym typie, znajdujący się w okienku dialogowym.


getPageById( pageID )
Zwraca typ: element wizardpage
Zwraca element wizardpage przesyłając go do określonej <var>pageID</var>.


goTo( pageID )
Zwraca typ: nie zwraca wartości
Ta metoda jest stosowana do zmiany, która strona jest aktualnie wyświetlana, określona poprzez argument pageID. Strona będzie zmieniona niezależnie od własności canAdvance lub canRewind. Atrybuty onwizardback i onwizardnext nie są wywoływane podczas użycia tej metody.
rewind()
Zwraca typ: nie zwraca wartości
Wywołaj tą metodę, aby przejść wstecz na stronie. Jest równoważna naciśnięciu przycisku Wstecz. Własność canRewind musi być ustawiona na true dla strony, która będzie zmieniona. Kod w atrybucie onwizardback jest wywołany przed zmianą strony.

Podobne

wizardpage

Autorzy i etykiety dokumentu

Autorzy tej strony: teoli, lmorchard, Mgjbot, Ptak82, VooEak, Taken
Ostatnia aktualizacja: teoli,