Show TOC

TransparentContainer-EigenschaftenLocate this document in the navigation structure

Verwendung

Eigenschaften im View Designer

  • ariaLandmark

    Mit dieser Eigenschaft können Sie für die Container-UI-Elemente Group, Tray, Panel, PanelStack, ScrollContainer und TransparentContainer Accessible Rich Internet Applications (ARIA) Landmarks festlegen. D.h., Sie markieren die Funktion von UI-Elementen, um für Ihre Anwendung die Navigation mit Bildschirmlesegeräten zu ermöglichen. Wenn Sie die Eigenschaft ariaLandmark setzen, werden die ARIA Landmarks durch das role-Attribut einem HTML-Element hinzugefügt.

    Wert

    Beschreibung

    Application

    Webanwendungsbereich (im Gegensatz zum Webdokument)

    Article

    Bereich, der aus einem eigenständigen Teil eines Dokuments oder einer Seite besteht (z.B. Foreneintrag, Zeitschriften- oder Zeitungsarftikel, Weblogeintrag, Benutzerkommentar)

    Banner

    Seitenkopf

    Complementary

    Bereich mit Zusatzinformationen, die den Hauptinhalt unterstützen und ohne Bezug auf diesen verständlich sind

    Contentinfo

    Metadaten, die sich auf das Eltern-Dokument beziehen (z.B. Fußnoten, Copyright oder Links auf Datenschutzerklärungen)

    Form

    Elemente, die zusammen ein Formular ergeben

    Main

    Hauptinhaltsbereich

    Navigation

    Elemente zur Navigation innerhalb des Dokuments oder zu ähnlichen Dokumenten (z.B. Links)

    None

    keine Landmark Role

    Search

    Bereich mit Suchfunktion

  • isLayoutContainer

    Festlegung, ob der TransparentContainer als Layout-Container fungiert.

    Hinweis

    Beachten Sie, dass im Fall von isLayout=true der defaultButton nicht funktioniert. In der Entwicklungsumgebung wird dies abgeprüft. Die Angabe des defaultButtons wird nur dann erlaubt, wenn TransparentContainer.isLayoutContainer=false.

    • isLayoutContainer=true:

      Der Container dient nur zum Layouting des Views, er hat keine semantische Eigenschaften. In diesem Fall kann kein defaultButton angegeben werden, es kann kein Fokus auf ihn gesetzt werden, er kann nicht über die TAB-Taste annavigiert werden, und im barrierefreien Modus wird er nicht von einem Bildschirmausleseprogramm vorgelesen.

    • isLayoutContainer=false:

      Der Container dient zum Layouting und stellt zugleich eine semantische Gruppierung dar, z.B. gruppiert er Labels und InputFields zu einem Formular.

      In diesem Fall kann der TransparentContainer durch Tabben erreicht werden und er wird im barrierefreien Modus auch vorgelesen, d.h. die entsprechenden Eigenschaften für die Barrierefreiheit (siehe TransparentContainer) müssen gesetzt werden. Es ist möglich, einen "Default Button" über die Eigenschaft defaultButtonId zu setzen.

  • labeledBy

    Festlegung der ID des mit einer Beschriftung versehenen SectionHeaders. Diese Eigenschaft wird für nicht-layoutende Container verwendet (isLayoutContainer = false), um einen SectionHeader als Titel-Control mit diesem Container zu verbinden. Die Verbindung zwischen einem existierenden SectionHeader und einem TransparentContainer über labeledBy ist für die Barrierefreiheit wichtig.

  • explanation

    Hilfetext, der bei eingeschaltetem Hilfe-Modus ausgegeben wird. Diese Eigenschaft ist von einem Administrator personalisierbar. Weitere Informationen: Eigenschaft explanation.

  • scrollLeft

    horizontale Position der Scrollbar

    scrollLeft kann nur dynamisch gesetzt bzw. gelesen werden. Es ist nicht möglich, scrollLeft an den Context zu binden.

  • scrollTop

    vertikale Position der Scrollbar

    scrollTop kann nur dynamisch gesetzt bzw. gelesen werden. Es ist nicht möglich, scrollTop an den Context zu binden.

Hinweis

Um die vertikale und horizontale Position der Scrollbar abzurufen oder zu setzen, stehen die folgenden Getter- und Settermethoden zur Verfügung:

  • GET_SCROLL_LEFT: liefert die horizontale Scrollposition

  • GET_SCROLL_TOP: liefert die vertikale Scrollposition

  • SET_SCROLL_LEFT: Setzen der horizontalen Scrollposition

  • SET_SCROLL_TOP: Setzen der vertikalen Scrollposition

Hinweis

Der Ausganswert der Attribute scrollLeft und scrollTop ist -1. Dieser Wert kann nicht mehr durch Scrollen erreicht werden. Dadurch ist es der Applikation möglich, zu erkennen ob der Container gescrollt wurde oder nicht. Der kleinste Wert, der nach dem Scrollen in beide Richtungen erreicht werden kann ist daher 0.