GWT 2.7.0

com.google.gwt.aria.client
Interface Role

All Known Subinterfaces:
AlertdialogRole, AlertRole, ApplicationRole, ArticleRole, BannerRole, ButtonRole, CheckboxRole, ColumnheaderRole, ComboboxRole, CommandRole, ComplementaryRole, CompositeRole, ContentinfoRole, DefinitionRole, DialogRole, DirectoryRole, DocumentRole, FormRole, GridcellRole, GridRole, GroupRole, HeadingRole, ImgRole, InputRole, LandmarkRole, LinkRole, ListboxRole, ListitemRole, ListRole, LogRole, MainRole, MarqueeRole, MathRole, MenubarRole, MenuitemcheckboxRole, MenuitemradioRole, MenuitemRole, MenuRole, NavigationRole, NoteRole, OptionRole, PresentationRole, ProgressbarRole, RadiogroupRole, RadioRole, RangeRole, RegionRole, RowgroupRole, RowheaderRole, RowRole, ScrollbarRole, SearchRole, SectionheadRole, SectionRole, SelectRole, SeparatorRole, SliderRole, SpinbuttonRole, StatusRole, StructureRole, TablistRole, TabpanelRole, TabRole, TextboxRole, TimerRole, ToolbarRole, TooltipRole, TreegridRole, TreeitemRole, TreeRole, WidgetRole, WindowRole
All Known Implementing Classes:
AlertdialogRoleImpl, AlertRoleImpl, ApplicationRoleImpl, ArticleRoleImpl, BannerRoleImpl, ButtonRoleImpl, CheckboxRoleImpl, ColumnheaderRoleImpl, ComboboxRoleImpl, ComplementaryRoleImpl, ContentinfoRoleImpl, DefinitionRoleImpl, DialogRoleImpl, DirectoryRoleImpl, DocumentRoleImpl, FormRoleImpl, GridcellRoleImpl, GridRoleImpl, GroupRoleImpl, HeadingRoleImpl, ImgRoleImpl, LinkRoleImpl, ListboxRoleImpl, ListitemRoleImpl, ListRoleImpl, LogRoleImpl, MainRoleImpl, MarqueeRoleImpl, MathRoleImpl, MenubarRoleImpl, MenuitemcheckboxRoleImpl, MenuitemradioRoleImpl, MenuitemRoleImpl, MenuRoleImpl, NavigationRoleImpl, NoteRoleImpl, OptionRoleImpl, PresentationRoleImpl, ProgressbarRoleImpl, RadiogroupRoleImpl, RadioRoleImpl, RegionRoleImpl, RoleImpl, RowgroupRoleImpl, RowheaderRoleImpl, RowRoleImpl, ScrollbarRoleImpl, SearchRoleImpl, SeparatorRoleImpl, SliderRoleImpl, SpinbuttonRoleImpl, StatusRoleImpl, TablistRoleImpl, TabpanelRoleImpl, TabRoleImpl, TextboxRoleImpl, TimerRoleImpl, ToolbarRoleImpl, TooltipRoleImpl, TreegridRoleImpl, TreeitemRoleImpl, TreeRoleImpl

public interface Role

A generic ARIA Role. This interface defines generic methods for setting, getting, and removing attributes on DOM Elements so that they can be identified by screen readers. Subtypes define methods for specific roles.

The ARIA specification defines a hierarchy of roles, which is mirrored here as a hierarchy of Java interfaces. Some roles are abstract and define methods that are common to their children. Only concrete roles (available via methods in Roles) should be used to modify HTML elements.

For more details, see The Roles Model in the ARIA specification.


Method Summary
 java.lang.String getAriaAtomicProperty(Element element)
          Returns the value of the aria-atomic attribute for the element or "" if no such attribute is present.
 java.lang.String getAriaBusyState(Element element)
          Returns the value of the aria-busy attribute for the element or "" if no such attribute is present.
 java.lang.String getAriaControlsProperty(Element element)
          Returns the value of the aria-controls attribute for the element or "" if no such attribute is present.
 java.lang.String getAriaDescribedbyProperty(Element element)
          Returns the value of the aria-describedby attribute for the element or "" if no such attribute is present.
 java.lang.String getAriaDisabledState(Element element)
          Returns the value of the aria-disabled attribute for the element or "" if no such attribute is present.
 java.lang.String getAriaDropeffectProperty(Element element)
          Returns the value of the aria-dropeffect attribute for the element or "" if no such attribute is present.
 java.lang.String getAriaFlowtoProperty(Element element)
          Returns the value of the aria-flowto attribute for the element or "" if no such attribute is present.
 java.lang.String getAriaGrabbedState(Element element)
          Returns the value of the aria-grabbed attribute for the element or "" if no such attribute is present.
 java.lang.String getAriaHaspopupProperty(Element element)
          Returns the value of the aria-haspopup attribute for the element or "" if no such attribute is present.
 java.lang.String getAriaHiddenState(Element element)
          Returns the value of the aria-hidden attribute for the element or "" if no such attribute is present.
 java.lang.String getAriaInvalidState(Element element)
          Returns the value of the aria-invalid attribute for the element or "" if no such attribute is present.
 java.lang.String getAriaLabelledbyProperty(Element element)
          Returns the value of the aria-labelledby attribute for the element or "" if no such attribute is present.
 java.lang.String getAriaLabelProperty(Element element)
          Returns the value of the aria-label attribute for the element or "" if no such attribute is present.
 java.lang.String getAriaLiveProperty(Element element)
          Returns the value of the aria-live attribute for the element or "" if no such attribute is present.
 java.lang.String getAriaOwnsProperty(Element element)
          Returns the value of the aria-owns attribute for the element or "" if no such attribute is present.
 java.lang.String getAriaRelevantProperty(Element element)
          Returns the value of the aria-relevant attribute for the element or "" if no such attribute is present.
 java.lang.String getName()
          Gets the ARIA 'role' attribute name as defined in the WAI-ARIA standard.
 java.lang.String getTabindexExtraAttribute(Element element)
          Returns the value of the tabIndex attribute for the element or "" if no such attribute is present.
 void remove(Element element)
          Removes the 'role' attribute from the element.
 void removeAriaAtomicProperty(Element element)
          Removes the aria-atomic attribute from the element.
 void removeAriaBusyState(Element element)
          Removes the aria-busy attribute from the element.
 void removeAriaControlsProperty(Element element)
          Removes the aria-controls attribute from the element.
 void removeAriaDescribedbyProperty(Element element)
          Removes the aria-describedby attribute from the element.
 void removeAriaDisabledState(Element element)
          Removes the aria-disabled attribute from the element.
 void removeAriaDropeffectProperty(Element element)
          Removes the aria-dropeffect attribute from the element.
 void removeAriaFlowtoProperty(Element element)
          Removes the aria-flowto attribute from the element.
 void removeAriaGrabbedState(Element element)
          Removes the aria-grabbed attribute from the element.
 void removeAriaHaspopupProperty(Element element)
          Removes the aria-haspopup attribute from the element.
 void removeAriaHiddenState(Element element)
          Removes the aria-hidden attribute from the element.
 void removeAriaInvalidState(Element element)
          Removes the aria-invalid attribute from the element.
 void removeAriaLabelledbyProperty(Element element)
          Removes the aria-labelledby attribute from the element.
 void removeAriaLabelProperty(Element element)
          Removes the aria-label attribute from the element.
 void removeAriaLiveProperty(Element element)
          Removes the aria-live attribute from the element.
 void removeAriaOwnsProperty(Element element)
          Removes the aria-owns attribute from the element.
 void removeAriaRelevantProperty(Element element)
          Removes the aria-relevant attribute from the element.
 void removeTabindexExtraAttribute(Element element)
          Removes the tabIndex attribute from the element.
 void set(Element element)
          Sets the 'role' attribute of the given element to the appropriate value for this role.
 void setAriaAtomicProperty(Element element, boolean value)
          Sets the aria-atomic attribute for the element to the given value.
 void setAriaBusyState(Element element, boolean value)
          Sets the aria-busy attribute for the element to the given value.
 void setAriaControlsProperty(Element element, Id... value)
          Sets the aria-controls attribute for the element to the given value.
 void setAriaDescribedbyProperty(Element element, Id... value)
          Sets the aria-describedby attribute for the element to the given value.
 void setAriaDisabledState(Element element, boolean value)
          Sets the aria-disabled attribute for the element to the given value.
 void setAriaDropeffectProperty(Element element, DropeffectValue... value)
          Sets the aria-dropeffect attribute for the element to the given value.
 void setAriaFlowtoProperty(Element element, Id... value)
          Sets the aria-flowto attribute for the element to the given value.
 void setAriaGrabbedState(Element element, GrabbedValue value)
          Sets the aria-grabbed attribute for the element to the given value.
 void setAriaHaspopupProperty(Element element, boolean value)
          Sets the aria-haspopup attribute for the element to the given value.
 void setAriaHiddenState(Element element, boolean value)
          Sets the aria-hidden attribute for the element to the given value.
 void setAriaInvalidState(Element element, InvalidValue value)
          Sets the aria-invalid attribute for the element to the given value.
 void setAriaLabelledbyProperty(Element element, Id... value)
          Sets the aria-labelledby attribute for the element to the given value.
 void setAriaLabelProperty(Element element, java.lang.String value)
          Sets the aria-label attribute for the element to the given value.
 void setAriaLiveProperty(Element element, LiveValue value)
          Sets the aria-live attribute for the element to the given value.
 void setAriaOwnsProperty(Element element, Id... value)
          Sets the aria-owns attribute for the element to the given value.
 void setAriaRelevantProperty(Element element, RelevantValue... value)
          Sets the aria-relevant attribute for the element to the given value.
 void setTabindexExtraAttribute(Element element, int value)
          Sets the tabIndex attribute for the element to the given value.
 

Method Detail

getAriaAtomicProperty

java.lang.String getAriaAtomicProperty(Element element)
Returns the value of the aria-atomic attribute for the element or "" if no such attribute is present.


getAriaBusyState

java.lang.String getAriaBusyState(Element element)
Returns the value of the aria-busy attribute for the element or "" if no such attribute is present.


getAriaControlsProperty

java.lang.String getAriaControlsProperty(Element element)
Returns the value of the aria-controls attribute for the element or "" if no such attribute is present.


getAriaDescribedbyProperty

java.lang.String getAriaDescribedbyProperty(Element element)
Returns the value of the aria-describedby attribute for the element or "" if no such attribute is present.


getAriaDisabledState

java.lang.String getAriaDisabledState(Element element)
Returns the value of the aria-disabled attribute for the element or "" if no such attribute is present.


getAriaDropeffectProperty

java.lang.String getAriaDropeffectProperty(Element element)
Returns the value of the aria-dropeffect attribute for the element or "" if no such attribute is present.


getAriaFlowtoProperty

java.lang.String getAriaFlowtoProperty(Element element)
Returns the value of the aria-flowto attribute for the element or "" if no such attribute is present.


getAriaGrabbedState

java.lang.String getAriaGrabbedState(Element element)
Returns the value of the aria-grabbed attribute for the element or "" if no such attribute is present.


getAriaHaspopupProperty

java.lang.String getAriaHaspopupProperty(Element element)
Returns the value of the aria-haspopup attribute for the element or "" if no such attribute is present.


getAriaHiddenState

java.lang.String getAriaHiddenState(Element element)
Returns the value of the aria-hidden attribute for the element or "" if no such attribute is present.


getAriaInvalidState

java.lang.String getAriaInvalidState(Element element)
Returns the value of the aria-invalid attribute for the element or "" if no such attribute is present.


getAriaLabelledbyProperty

java.lang.String getAriaLabelledbyProperty(Element element)
Returns the value of the aria-labelledby attribute for the element or "" if no such attribute is present.


getAriaLabelProperty

java.lang.String getAriaLabelProperty(Element element)
Returns the value of the aria-label attribute for the element or "" if no such attribute is present.


getAriaLiveProperty

java.lang.String getAriaLiveProperty(Element element)
Returns the value of the aria-live attribute for the element or "" if no such attribute is present.


getAriaOwnsProperty

java.lang.String getAriaOwnsProperty(Element element)
Returns the value of the aria-owns attribute for the element or "" if no such attribute is present.


getAriaRelevantProperty

java.lang.String getAriaRelevantProperty(Element element)
Returns the value of the aria-relevant attribute for the element or "" if no such attribute is present.


getName

java.lang.String getName()
Gets the ARIA 'role' attribute name as defined in the WAI-ARIA standard.

See Also:
Roles documentation

getTabindexExtraAttribute

java.lang.String getTabindexExtraAttribute(Element element)
Returns the value of the tabIndex attribute for the element or "" if no such attribute is present.


remove

void remove(Element element)
Removes the 'role' attribute from the element.

See Also:
Roles documentation

removeAriaAtomicProperty

void removeAriaAtomicProperty(Element element)
Removes the aria-atomic attribute from the element.


removeAriaBusyState

void removeAriaBusyState(Element element)
Removes the aria-busy attribute from the element.


removeAriaControlsProperty

void removeAriaControlsProperty(Element element)
Removes the aria-controls attribute from the element.


removeAriaDescribedbyProperty

void removeAriaDescribedbyProperty(Element element)
Removes the aria-describedby attribute from the element.


removeAriaDisabledState

void removeAriaDisabledState(Element element)
Removes the aria-disabled attribute from the element.


removeAriaDropeffectProperty

void removeAriaDropeffectProperty(Element element)
Removes the aria-dropeffect attribute from the element.


removeAriaFlowtoProperty

void removeAriaFlowtoProperty(Element element)
Removes the aria-flowto attribute from the element.


removeAriaGrabbedState

void removeAriaGrabbedState(Element element)
Removes the aria-grabbed attribute from the element.


removeAriaHaspopupProperty

void removeAriaHaspopupProperty(Element element)
Removes the aria-haspopup attribute from the element.


removeAriaHiddenState

void removeAriaHiddenState(Element element)
Removes the aria-hidden attribute from the element.


removeAriaInvalidState

void removeAriaInvalidState(Element element)
Removes the aria-invalid attribute from the element.


removeAriaLabelledbyProperty

void removeAriaLabelledbyProperty(Element element)
Removes the aria-labelledby attribute from the element.


removeAriaLabelProperty

void removeAriaLabelProperty(Element element)
Removes the aria-label attribute from the element.


removeAriaLiveProperty

void removeAriaLiveProperty(Element element)
Removes the aria-live attribute from the element.


removeAriaOwnsProperty

void removeAriaOwnsProperty(Element element)
Removes the aria-owns attribute from the element.


removeAriaRelevantProperty

void removeAriaRelevantProperty(Element element)
Removes the aria-relevant attribute from the element.


removeTabindexExtraAttribute

void removeTabindexExtraAttribute(Element element)
Removes the tabIndex attribute from the element.


set

void set(Element element)
Sets the 'role' attribute of the given element to the appropriate value for this role.

See Also:
Roles documentation

setAriaAtomicProperty

void setAriaAtomicProperty(Element element,
                           boolean value)
Sets the aria-atomic attribute for the element to the given value.


setAriaBusyState

void setAriaBusyState(Element element,
                      boolean value)
Sets the aria-busy attribute for the element to the given value.


setAriaControlsProperty

void setAriaControlsProperty(Element element,
                             Id... value)
Sets the aria-controls attribute for the element to the given value.


setAriaDescribedbyProperty

void setAriaDescribedbyProperty(Element element,
                                Id... value)
Sets the aria-describedby attribute for the element to the given value.


setAriaDisabledState

void setAriaDisabledState(Element element,
                          boolean value)
Sets the aria-disabled attribute for the element to the given value.


setAriaDropeffectProperty

void setAriaDropeffectProperty(Element element,
                               DropeffectValue... value)
Sets the aria-dropeffect attribute for the element to the given value.


setAriaFlowtoProperty

void setAriaFlowtoProperty(Element element,
                           Id... value)
Sets the aria-flowto attribute for the element to the given value.


setAriaGrabbedState

void setAriaGrabbedState(Element element,
                         GrabbedValue value)
Sets the aria-grabbed attribute for the element to the given value.


setAriaHaspopupProperty

void setAriaHaspopupProperty(Element element,
                             boolean value)
Sets the aria-haspopup attribute for the element to the given value.


setAriaHiddenState

void setAriaHiddenState(Element element,
                        boolean value)
Sets the aria-hidden attribute for the element to the given value.


setAriaInvalidState

void setAriaInvalidState(Element element,
                         InvalidValue value)
Sets the aria-invalid attribute for the element to the given value.


setAriaLabelledbyProperty

void setAriaLabelledbyProperty(Element element,
                               Id... value)
Sets the aria-labelledby attribute for the element to the given value.


setAriaLabelProperty

void setAriaLabelProperty(Element element,
                          java.lang.String value)
Sets the aria-label attribute for the element to the given value.


setAriaLiveProperty

void setAriaLiveProperty(Element element,
                         LiveValue value)
Sets the aria-live attribute for the element to the given value.


setAriaOwnsProperty

void setAriaOwnsProperty(Element element,
                         Id... value)
Sets the aria-owns attribute for the element to the given value.


setAriaRelevantProperty

void setAriaRelevantProperty(Element element,
                             RelevantValue... value)
Sets the aria-relevant attribute for the element to the given value.


setTabindexExtraAttribute

void setTabindexExtraAttribute(Element element,
                               int value)
Sets the tabIndex attribute for the element to the given value.


GWT 2.7.0