com.google.gwt.aria.client.Role Maven / Gradle / Ivy
/*
* Copyright 2012 Google Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
* in compliance with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software distributed under the License
* is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
* or implied. See the License for the specific language governing permissions and limitations under
* the License.
*/
package com.google.gwt.aria.client;
/////////////////////////////////////////////////////////
// This is auto-generated code. Do not manually edit! //
/////////////////////////////////////////////////////////
import com.google.gwt.dom.client.Element;
/**
* 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 {@link Roles}) should be used to
* modify HTML elements.
*
* For more details, see The Roles Model
* in the ARIA specification.
*/
public interface Role {
/**
* Returns the value of the
*
* aria-atomic attribute for the {@code element} or "" if no
* such attribute is present.
*/
String getAriaAtomicProperty(Element element);
/**
* Returns the value of the
*
* aria-busy attribute for the {@code element} or "" if no
* such attribute is present.
*/
String getAriaBusyState(Element element);
/**
* Returns the value of the
*
* aria-controls attribute for the {@code element} or "" if no
* such attribute is present.
*/
String getAriaControlsProperty(Element element);
/**
* Returns the value of the
*
* aria-describedby attribute for the {@code element} or "" if no
* such attribute is present.
*/
String getAriaDescribedbyProperty(Element element);
/**
* Returns the value of the
*
* aria-disabled attribute for the {@code element} or "" if no
* such attribute is present.
*/
String getAriaDisabledState(Element element);
/**
* Returns the value of the
*
* aria-dropeffect attribute for the {@code element} or "" if no
* such attribute is present.
*/
String getAriaDropeffectProperty(Element element);
/**
* Returns the value of the
*
* aria-flowto attribute for the {@code element} or "" if no
* such attribute is present.
*/
String getAriaFlowtoProperty(Element element);
/**
* Returns the value of the
*
* aria-grabbed attribute for the {@code element} or "" if no
* such attribute is present.
*/
String getAriaGrabbedState(Element element);
/**
* Returns the value of the
*
* aria-haspopup attribute for the {@code element} or "" if no
* such attribute is present.
*/
String getAriaHaspopupProperty(Element element);
/**
* Returns the value of the
*
* aria-hidden attribute for the {@code element} or "" if no
* such attribute is present.
*/
String getAriaHiddenState(Element element);
/**
* Returns the value of the
*
* aria-invalid attribute for the {@code element} or "" if no
* such attribute is present.
*/
String getAriaInvalidState(Element element);
/**
* Returns the value of the
*
* aria-labelledby attribute for the {@code element} or "" if no
* such attribute is present.
*/
String getAriaLabelledbyProperty(Element element);
/**
* Returns the value of the
*
* aria-label attribute for the {@code element} or "" if no
* such attribute is present.
*/
String getAriaLabelProperty(Element element);
/**
* Returns the value of the
*
* aria-live attribute for the {@code element} or "" if no
* such attribute is present.
*/
String getAriaLiveProperty(Element element);
/**
* Returns the value of the
*
* aria-owns attribute for the {@code element} or "" if no
* such attribute is present.
*/
String getAriaOwnsProperty(Element element);
/**
* Returns the value of the
*
* aria-relevant attribute for the {@code element} or "" if no
* such attribute is present.
*/
String getAriaRelevantProperty(Element element);
/**
* Gets the ARIA 'role' attribute name as defined in the
* WAI-ARIA standard.
*
* @see Roles documentation
*/
String getName();
/**
* Returns the value of the
*
* tabIndex attribute for the {@code element} or "" if no
* such attribute is present.
*/
String getTabindexExtraAttribute(Element element);
/**
* Removes the 'role' attribute from the {@code element}.
*
* @see Roles documentation
*/
void remove(Element element);
/**
* Removes the
*
* aria-atomic attribute from the {@code element}.
*/
void removeAriaAtomicProperty(Element element);
/**
* Removes the
*
* aria-busy attribute from the {@code element}.
*/
void removeAriaBusyState(Element element);
/**
* Removes the
*
* aria-controls attribute from the {@code element}.
*/
void removeAriaControlsProperty(Element element);
/**
* Removes the
*
* aria-describedby attribute from the {@code element}.
*/
void removeAriaDescribedbyProperty(Element element);
/**
* Removes the
*
* aria-disabled attribute from the {@code element}.
*/
void removeAriaDisabledState(Element element);
/**
* Removes the
*
* aria-dropeffect attribute from the {@code element}.
*/
void removeAriaDropeffectProperty(Element element);
/**
* Removes the
*
* aria-flowto attribute from the {@code element}.
*/
void removeAriaFlowtoProperty(Element element);
/**
* Removes the
*
* aria-grabbed attribute from the {@code element}.
*/
void removeAriaGrabbedState(Element element);
/**
* Removes the
*
* aria-haspopup attribute from the {@code element}.
*/
void removeAriaHaspopupProperty(Element element);
/**
* Removes the
*
* aria-hidden attribute from the {@code element}.
*/
void removeAriaHiddenState(Element element);
/**
* Removes the
*
* aria-invalid attribute from the {@code element}.
*/
void removeAriaInvalidState(Element element);
/**
* Removes the
*
* aria-labelledby attribute from the {@code element}.
*/
void removeAriaLabelledbyProperty(Element element);
/**
* Removes the
*
* aria-label attribute from the {@code element}.
*/
void removeAriaLabelProperty(Element element);
/**
* Removes the
*
* aria-live attribute from the {@code element}.
*/
void removeAriaLiveProperty(Element element);
/**
* Removes the
*
* aria-owns attribute from the {@code element}.
*/
void removeAriaOwnsProperty(Element element);
/**
* Removes the
*
* aria-relevant attribute from the {@code element}.
*/
void removeAriaRelevantProperty(Element element);
/**
* Removes the
*
* tabIndex attribute from the {@code element}.
*/
void removeTabindexExtraAttribute(Element element);
/**
* Sets the 'role' attribute of the given {@code element} to the appropriate
* value for this role.
*
* @see Roles documentation
*/
void set(Element element);
/**
* Sets the
*
* aria-atomic attribute for the {@code element} to the given {@code value}.
*/
void setAriaAtomicProperty(Element element, boolean value);
/**
* Sets the
*
* aria-busy attribute for the {@code element} to the given {@code value}.
*/
void setAriaBusyState(Element element, boolean value);
/**
* Sets the
*
* aria-controls attribute for the {@code element} to the given {@code value}.
*/
void setAriaControlsProperty(Element element, Id... value);
/**
* Sets the
*
* aria-describedby attribute for the {@code element} to the given {@code value}.
*/
void setAriaDescribedbyProperty(Element element, Id... value);
/**
* Sets the
*
* aria-disabled attribute for the {@code element} to the given {@code value}.
*/
void setAriaDisabledState(Element element, boolean value);
/**
* Sets the
*
* aria-dropeffect attribute for the {@code element} to the given {@code value}.
*/
void setAriaDropeffectProperty(Element element, DropeffectValue... value);
/**
* Sets the
*
* aria-flowto attribute for the {@code element} to the given {@code value}.
*/
void setAriaFlowtoProperty(Element element, Id... value);
/**
* Sets the
*
* aria-grabbed attribute for the {@code element} to the given {@code value}.
*/
void setAriaGrabbedState(Element element, GrabbedValue value);
/**
* Sets the
*
* aria-haspopup attribute for the {@code element} to the given {@code value}.
*/
void setAriaHaspopupProperty(Element element, boolean value);
/**
* Sets the
*
* aria-hidden attribute for the {@code element} to the given {@code value}.
*/
void setAriaHiddenState(Element element, boolean value);
/**
* Sets the
*
* aria-invalid attribute for the {@code element} to the given {@code value}.
*/
void setAriaInvalidState(Element element, InvalidValue value);
/**
* Sets the
*
* aria-labelledby attribute for the {@code element} to the given {@code value}.
*/
void setAriaLabelledbyProperty(Element element, Id... value);
/**
* Sets the
*
* aria-label attribute for the {@code element} to the given {@code value}.
*/
void setAriaLabelProperty(Element element, String value);
/**
* Sets the
*
* aria-live attribute for the {@code element} to the given {@code value}.
*/
void setAriaLiveProperty(Element element, LiveValue value);
/**
* Sets the
*
* aria-owns attribute for the {@code element} to the given {@code value}.
*/
void setAriaOwnsProperty(Element element, Id... value);
/**
* Sets the
*
* aria-relevant attribute for the {@code element} to the given {@code value}.
*/
void setAriaRelevantProperty(Element element, RelevantValue... value);
/**
* Sets the
*
* tabIndex attribute for the {@code element} to the given {@code value}.
*/
void setTabindexExtraAttribute(Element element, int value);
}