XUL:dialog

z Mozilla Developer Center, polskiego centrum programistów Mozilli.

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

Ten element stosuje się zamiast elementu window dla okien dialogowych. Atrybutu buttons można użyć do ustawienia, które przyciski powinny być wyświetlane w oknie dialogowym. Przyciski te będą umieszczane w miejscu określonym przez daną platformę.

Dodatkowe informacje są dostępne w kursie XUL.

Atrybuty

buttonaccesskeyaccept, buttonaccesskeycancel, buttonaccesskeydisclosure, buttonaccesskeyextra1, buttonaccesskeyextra2, buttonaccesskeyhelp, buttonalign, buttondir, buttondisabledaccept, buttonlabelaccept, buttonlabelcancel, buttonlabeldisclosure, buttonlabelextra1, buttonlabelextra2, buttonlabelhelp, buttonorient, buttonpack, buttons, defaultButton, ondialogaccept, ondialogcancel, ondialogdisclosure, ondialogextra1, ondialogextra2, ondialoghelp, title

Własności

buttons, defaultButton

Metody

acceptDialog, cancelDialog, centerWindowOnScreen, getButton, moveToAlertPosition

[edytuj] Przykłady

<?xml version="1.0"?>
<?xml-stylesheet href="chrome://global/skin/global.css" type="text/css"?>
<dialog id="donothing" title="Dialog example"
   xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"
   buttons="accept,cancel"
   buttonlabelcancel="Cancel"
   buttonlabelaccept="Save"
   ondialogaccept="return doOK();"
   ondialogcancel="return doCancel();">
    
    <dialogheader title="Options" description="My preferences"/>
    <groupbox>
      <caption label="Colour"/>
      <radiogroup>
        <radio label="Red"/>
        <radio label="Green" selected="true"/>
        <radio label="Blue"/>
      </radiogroup>
      <label value="Nickname"/>
      <textbox />
   </groupbox>
</dialog>

[edytuj] Atrybuty

Dziedziczy z elementu XUL align, allowevents, allownegativeassertions, class, coalesceduplicatearcs, collapsed, container, containment, context, contextmenu, datasources, dir, empty, equalsize, flags, flex, height, hidden, id, insertafter, insertbefore, left, maxheight, maxwidth, menu, minheight, minwidth, mousethrough, observes, ordinal, orient, pack, persist, popup, position, preference-editable, ref, removeelement, sortDirection, sortResource, sortResource2, statustext, style, template, tooltip, tooltiptext, top, uri, wait-cursor, width

buttonaccesskeyaccept

Typ: string

Klawisz dostępu dla przycisku 'Akceptuj'.

buttonaccesskeycancel

Typ: string

Klawisz dostępu dla przycisku Anuluj.

buttonaccesskeydisclosure

Typ: string

Klawisz dostępu dla przycisku typu "disclosure" (zwykle "Szczegóły" - przyp. tłum.).

buttonaccesskeyextra1

Typ: string

Klawisz dostępu dla pierwszego przycisku.

buttonaccesskeyextra2

Typ: string

Klawisz dostępu dla drugiego dodatkowego przycisku.

buttonaccesskeyhelp

Typ: string

Klawisz dostępu dla przycisku "Pomoc".

buttonalign

Typ: string

Wartość atrybutu align dla pudełka zawierającego przyciski.

buttondir

Typ: string

Wartość atrybutu dir dla pudełka zawierającego przyciski.

buttondisabledaccept

Typ: boolean

Jeśli true, przycisk akceptacji jest początkowo wyłączony.

buttonlabelaccept

Typ: string

Etykieta do wyświetlenia na przycisku "Akceptuj".

buttonlabelcancel

Typ: string

Etykieta do wyświetlenia na przycisku "Anuluj".

buttonlabeldisclosure

Typ: string

Etykieta do wyświetlenia na przycisku "disclosure".

buttonlabelextra1

Typ: string

Etykieta do wyświetlenia na pierwszym dodatkowym przycisku.

buttonlabelextra2

Typ: string

Etykieta do wyświetlenia na drugim dodatkowym przycisku.

buttonlabelhelp

Typ: string

Etykieta do wyświetlenia na przycisku "Pomoc".

buttonorient

Typ: string

Wartość atrybutu orient dla pudełka zawierającego przyciski.

buttonpack

Typ: string

Wartość atrybutu pack dla pudełka zawierającego przyciski.

buttons

Typ: rozdzielona przecinkami lista poniższych wartości

Rozdzielona przecinkami lista przycisków do wyświetlenia w okienku dialogowym. Przyciski zostaną umieszczone w odpowiednim miejscu w zależności od platformy systemowej użytkownika, a podstawowa obsługa zdarzeń zostanie wykonana automatycznie. Następujące wartości mogą zostać użyte w tej liście:

• accept: Przycisk OK, który będzie akceptował zmiany po naciśnięciu. Ten przycisk będzie także przyciskiem domyślnym.
• cancel: Przycisk Anuluj, który będzie anulował operacje.
• help: Przycisk Pomoc służący do wyświetlenia okienka pomocy.
• disclosure: Przycisk pokazujący więcej informacji. Może być to przycisk lub trójkąt rozwijający.
• extra1: Opcjonalny przycisk dodatkowy. Można ustawić jego etykietę za pomocą atrybutu buttonlabelextra1.
• extra2: Drugi opcjonalny przycisk dodatkowy. Można ustawić jego etykietę za pomocą atrybutu buttonlabelextra2.

defaultButton

Typ: string

Zwykle nie powinno się ustawiać tego atrybutu. Określa on domyślny przycisk w oknie dialogowym. Zazwyczaj oznacza to, że przycisk zostanie aktywowany po naciśnięciu klawisza Enter. Atrybutowi temu powinna być przypisana jedna z wartości używanych przez atrybut buttons.

ondialogaccept

Typ: kod skryptu

Kod w tym atrybucie jest wywołany po naciśnięciu przycisku akceptacji lub po wywołaniu metody acceptDialog.

ondialogcancel

Typ: kod skryptu

Kod w tym atrybucie jest wywołany po naciśnięciu przycisku 'Anuluj' lub po wywołaniu metody cancelDialog.

ondialogdisclosure

Typ: Kod skryptu

Kod w tym atrybucie jest wywołany po naciśnięciu przycisku ujawniającego (ang. disclosure).

ondialogextra1

Typ: kod skryptu

Kod w tym atrybucie jest wywołany po naciśnięciu pierwszego przycisku dodatkowego.

ondialogextra2

Typ: kod skryptu

Kod w tym atrybucie jest wywołany po naciśnięciu drugiego przycisku dodatkowego.

ondialoghelp

Typ: kod skryptu

Kod w tym atrybucie jest wywołany po naciśnięciu przycisku 'Pomoc'.

title

Typ: string

Tekst wyświetlony na pasku tytułu w oknie dialogowym.

[edytuj] Własności

Dziedziczy z elementu XUL align, allowEvents, boxObject, builder, className, collapsed, contextMenu, controllers, currentItem, database, datasources, dir, flex, height, hidden, id, left, listBoxObject, maxHeight, maxWidth, menu, minHeight, minWidth, observes, ordinal, orient, pack, persist, ref, resource, statusText, style, tooltip, tooltipText, top, value, width Dziedziczy z elementu DOM attributes, childNodes, cloneNode, firstChild, lastChild, localName, namespaceURI, nextSibling, nodeName, nodeType, nodeValue, ownerDocument, parentNode, prefix, previousSibling, tagName

buttons

Typ: rozdzielona przecinkami lista poniższych wartości

Rozdzielona przecinkami lista przycisków do wyświetlenia w okienku dialogowym. Przyciski zostaną umieszczone w odpowiednim miejscu w zależności od platformy systemowej użytkownika, a podstawowa obsługa zdarzeń zostanie wykonana automatycznie. Następujące wartości mogą zostać użyte w tej liście:

• accept: Przycisk OK, który będzie akceptował zmiany po naciśnięciu. Ten przycisk będzie także przyciskiem domyślnym.
• cancel: Przycisk Anuluj, który będzie anulował operację.
• help: Przycisk Pomoc służący do wyświetlenia okienka pomocy.
• disclosure: Przycisk pokazujący więcej informacji. Może być to przycisk lub trójkąt rozwijający.
• extra1: Opcjonalny przycisk dodatkowy. Można ustawić jego etykietę za pomocą atrybutu buttonlabelextra1.
• extra2: Drugi opcjonalny przycisk dodatkowy. Można ustawić jego etykietę za pomocą atrybutu buttonlabelextra2.

defaultButton

Typ: string

Zwykle nie powinno się ustawiać tej własności. Określa ona domyślny przycisk w oknie dialogowym. Zazwyczaj oznacza to, że przycisk zostanie aktywowany po naciśnięciu klawisza Enter. Własności tej powinna być przypisana jedna z wartości używanych przez atrybut buttons.

[edytuj] Metody

Dziedziczy z elementu XUL blur, click, doCommand, focus, getElementsByAttribute 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

acceptDialog ()

Zwraca typ: nie zwraca wartości

Akceptuje okienko dialogowe i je zamyka, działa podobnie jak naciśnięcie przycisku OK.

cancelDialog ()

Zwraca typ: nie zwraca wartości

Anuluje okienko dialogowe i je zamyka, działa podobnie jak naciśnięcie przycisku Anuluj.

centerWindowOnScreen ()

Zwraca typ: nie zwraca wartości

Ustawia okienko dialogowe na środku ekranu.

getButton ( typ )

Zwraca typ: element button

Zwraca element button o zadanym typie, znajdujący się w okienku dialogowym.

moveToAlertPosition ()

Zwraca typ: nie zwraca wartości

Przenosi okno dialogowe na pozycję właściwą dla okna z ostrzeżeniem, jednocześnie nadając mu rozmiar właściwy dla takiego okna.

[edytuj] Podobne

Elementy

dialogheader