gecko-dev/accessible/html/HTMLElementAccessibles.cpp
Marco Zehe 194d876eb2 Bug 634004 - Implement accessibility API support for html:details and html:summary elements, r=surkov
This implements the roles, states, and action names, but omits the state change event part that is currently made impossible by us recreating the html:summary accessible once it toggles the html:details open state. This is probably due to some reframing causing us to recreate the accessible. Suggest to move that to a separate bug and implement the basics now and the event later.

MozReview-Commit-ID: FEi5RIXdkG0

--HG--
extra : rebase_source : 9b65bc28483238e2339561e6494ccc2884cb7c42
2016-06-01 17:07:56 +02:00

205 lines
4.6 KiB
C++

/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
#include "HTMLElementAccessibles.h"
#include "DocAccessible.h"
#include "nsAccUtils.h"
#include "nsIPersistentProperties2.h"
#include "nsTextEquivUtils.h"
#include "Relation.h"
#include "Role.h"
#include "States.h"
#include "mozilla/dom/HTMLLabelElement.h"
#include "mozilla/dom/HTMLDetailsElement.h"
#include "mozilla/dom/HTMLSummaryElement.h"
using namespace mozilla::a11y;
////////////////////////////////////////////////////////////////////////////////
// HTMLHRAccessible
////////////////////////////////////////////////////////////////////////////////
role
HTMLHRAccessible::NativeRole()
{
return roles::SEPARATOR;
}
////////////////////////////////////////////////////////////////////////////////
// HTMLBRAccessible
////////////////////////////////////////////////////////////////////////////////
role
HTMLBRAccessible::NativeRole()
{
return roles::WHITESPACE;
}
uint64_t
HTMLBRAccessible::NativeState()
{
return states::READONLY;
}
ENameValueFlag
HTMLBRAccessible::NativeName(nsString& aName)
{
aName = static_cast<char16_t>('\n'); // Newline char
return eNameOK;
}
////////////////////////////////////////////////////////////////////////////////
// HTMLLabelAccessible
////////////////////////////////////////////////////////////////////////////////
NS_IMPL_ISUPPORTS_INHERITED0(HTMLLabelAccessible, HyperTextAccessible)
ENameValueFlag
HTMLLabelAccessible::NativeName(nsString& aName)
{
nsTextEquivUtils::GetNameFromSubtree(this, aName);
return aName.IsEmpty() ? eNameOK : eNameFromSubtree;
}
Relation
HTMLLabelAccessible::RelationByType(RelationType aType)
{
Relation rel = AccessibleWrap::RelationByType(aType);
if (aType == RelationType::LABEL_FOR) {
dom::HTMLLabelElement* label = dom::HTMLLabelElement::FromContent(mContent);
rel.AppendTarget(mDoc, label->GetControl());
}
return rel;
}
uint8_t
HTMLLabelAccessible::ActionCount()
{
return nsCoreUtils::IsLabelWithControl(mContent) ? 1 : 0;
}
void
HTMLLabelAccessible::ActionNameAt(uint8_t aIndex, nsAString& aName)
{
if (aIndex == 0) {
if (nsCoreUtils::IsLabelWithControl(mContent))
aName.AssignLiteral("click");
}
}
bool
HTMLLabelAccessible::DoAction(uint8_t aIndex)
{
if (aIndex != 0)
return false;
DoCommand();
return true;
}
////////////////////////////////////////////////////////////////////////////////
// nsHTMLOuputAccessible
////////////////////////////////////////////////////////////////////////////////
NS_IMPL_ISUPPORTS_INHERITED0(HTMLOutputAccessible, HyperTextAccessible)
Relation
HTMLOutputAccessible::RelationByType(RelationType aType)
{
Relation rel = AccessibleWrap::RelationByType(aType);
if (aType == RelationType::CONTROLLED_BY)
rel.AppendIter(new IDRefsIterator(mDoc, mContent, nsGkAtoms::_for));
return rel;
}
////////////////////////////////////////////////////////////////////////////////
// HTMLSummaryAccessible
////////////////////////////////////////////////////////////////////////////////
HTMLSummaryAccessible::
HTMLSummaryAccessible(nsIContent* aContent, DocAccessible* aDoc) :
HyperTextAccessibleWrap(aContent, aDoc)
{
mGenericTypes |= eButton;
}
uint8_t
HTMLSummaryAccessible::ActionCount()
{
return 1;
}
void
HTMLSummaryAccessible::ActionNameAt(uint8_t aIndex, nsAString& aName)
{
if (aIndex != eAction_Click) {
return;
}
dom::HTMLSummaryElement* summary = dom::HTMLSummaryElement::FromContent(mContent);
if (!summary) {
return;
}
dom::HTMLDetailsElement* details = summary->GetDetails();
if (!details) {
return;
}
if (details->Open()) {
aName.AssignLiteral("collapse");
} else {
aName.AssignLiteral("expand");
}
}
bool
HTMLSummaryAccessible::DoAction(uint8_t aIndex)
{
if (aIndex != eAction_Click)
return false;
DoCommand();
return true;
}
uint64_t
HTMLSummaryAccessible::NativeState()
{
uint64_t state = HyperTextAccessibleWrap::NativeState();
dom::HTMLSummaryElement* summary = dom::HTMLSummaryElement::FromContent(mContent);
if (!summary) {
return state;
}
dom::HTMLDetailsElement* details = summary->GetDetails();
if (!details) {
return state;
}
if (details->Open()) {
state |= states::EXPANDED;
} else {
state |= states::COLLAPSED;
}
return state;
}
////////////////////////////////////////////////////////////////////////////////
// HTMLSummaryAccessible: Widgets
bool
HTMLSummaryAccessible::IsWidget() const
{
return true;
}