Wyniki wyszukiwania

wizard

W tym artykule

« Dokumentacja XUL [ Przykłady | Atrybuty | Własności | Metody | Podobne ]

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="https://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 {{ XULProp|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

canAdvance: Typ: boolean; Ta własność jest ustawiona na true, jeśli użytkownik naciśnie przycisk 'Dalej', aby przejść do następnej strony. Jeśli ta własność jest ustawiona na false, użytkownik nie może przejść do następnej strony. Ustaw tą własność na true, aby zasygnalizować, że użytkownik może przejść do następnej strony. Ustawiając własność na false, przejście do następnej strony zostanie odrzucone (zabronione). Możemy to zobaczyć poprzez włączony lub wyłączony przycisk 'Dalej' lub na ostatniej stronie kreatora będzie umieszczony przycisk 'Zakończ'.

canRewind: Typ: boolean; Ta własność jest ustawiona na true, jeśli użytkownik może nacisnąć przycisk Wstecz, aby przejść do poprzedniej strony. Jeśli własność jest false, użytkownik nie będzie mógł przejść do poprzedniej strony. Ustaw tą własność na true, aby zasygnalizować, że użytkownik może przejść do poprzedniej strony. Ustaw na false, aby nie pozwolić na przeniesienie do poprzedniej strony. Posiada efekt włączonego lub wyłączonego przycisku Wstecz.

currentPage: Typ: element wizardpage; Wartość zwraca element kreatora (wizardpage), który jest aktualnie wyświetlany. Możemy modyfikować tą wartość, aby zmienić aktualną stronę.

onFirstPage: Typ: boolean; Ta własność jest ustawiona na true, jeśli użytkownik jest na pierwszej stronie, która może być lub nie być pierwsza w indeksie.

onLastPage: Typ: boolean; Ta własność jest ustawiona na true, jeśli użytkownik jest na ostatniej stronie kreatora.

pageCount: Typ: integer; Ta własność trzyma liczbę stron w kreatorze (wizard).

pageIndex: Typ: integer; Ta własność zwraca indeks aktualnie zaznaczonej strony. Możemy zmienić zaznaczenie strony poprzez modyfikacje tej własności.

pageStep: Typ: integer; This property returns the number of pages that the user has navigated through so far, meaning that the user would press the Back button this many times to go back to the beginning. This property is different than pageIndex, because pages are not necessarily navigated in order.

title: Typ: string; Tytuł, który pojawia się na górze kreatora (wizard). Jest przesłaniany przez atrybut label na indywidualnych stronach.

wizardPages: Typ: DOM NodeList elementów wizardpage; Ta własność podtrzymuje listę elementów wizardpage w wizard.

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 <var>pageID</var>. 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

Etykiety:

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

Ostatnia aktualizacja: teoli, 29.05.2014, 05:52:53