/* -*- 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 "nsAccessibilityService.h" // NOTE: alphabetically ordered #include "ApplicationAccessibleWrap.h" #include "ARIAGridAccessibleWrap.h" #include "ARIAMap.h" #include "DocAccessible-inl.h" #include "FocusManager.h" #include "HTMLCanvasAccessible.h" #include "HTMLElementAccessibles.h" #include "HTMLImageMapAccessible.h" #include "HTMLLinkAccessible.h" #include "HTMLListAccessible.h" #include "HTMLSelectAccessible.h" #include "HTMLTableAccessibleWrap.h" #include "HyperTextAccessibleWrap.h" #include "RootAccessible.h" #include "StyleInfo.h" #include "nsAccUtils.h" #include "nsArrayUtils.h" #include "nsAttrName.h" #include "nsDOMTokenList.h" #include "nsEventShell.h" #include "nsIURI.h" #include "nsTextFormatter.h" #include "OuterDocAccessible.h" #include "Role.h" #ifdef MOZ_ACCESSIBILITY_ATK # include "RootAccessibleWrap.h" #endif #include "States.h" #include "Statistics.h" #include "TextLeafAccessibleWrap.h" #include "TreeWalker.h" #include "xpcAccessibleApplication.h" #include "xpcAccessibleDocument.h" #ifdef MOZ_ACCESSIBILITY_ATK # include "AtkSocketAccessible.h" #endif #ifdef XP_WIN # include "mozilla/a11y/Compatibility.h" # include "mozilla/dom/ContentChild.h" # include "HTMLWin32ObjectAccessible.h" # include "mozilla/StaticPtr.h" #endif #ifdef A11Y_LOG # include "Logging.h" #endif #include "nsExceptionHandler.h" #include "nsImageFrame.h" #include "nsINamed.h" #include "nsIObserverService.h" #include "nsLayoutUtils.h" #include "nsPluginFrame.h" #include "SVGGeometryFrame.h" #include "nsTreeBodyFrame.h" #include "nsTreeColumns.h" #include "nsTreeUtils.h" #include "nsXBLPrototypeBinding.h" #include "nsXBLBinding.h" #include "mozilla/ArrayUtils.h" #include "mozilla/dom/DOMStringList.h" #include "mozilla/dom/EventTarget.h" #include "mozilla/dom/HTMLTableElement.h" #include "mozilla/Preferences.h" #include "mozilla/PresShell.h" #include "mozilla/Services.h" #include "nsDeckFrame.h" #ifdef MOZ_XUL # include "XULAlertAccessible.h" # include "XULComboboxAccessible.h" # include "XULElementAccessibles.h" # include "XULFormControlAccessible.h" # include "XULListboxAccessibleWrap.h" # include "XULMenuAccessibleWrap.h" # include "XULTabAccessible.h" # include "XULTreeGridAccessibleWrap.h" #endif #if defined(XP_WIN) || defined(MOZ_ACCESSIBILITY_ATK) # include "nsNPAPIPluginInstance.h" #endif using namespace mozilla; using namespace mozilla::a11y; using namespace mozilla::dom; /** * Accessibility service force enable/disable preference. * Supported values: * Accessibility is force enabled (accessibility should always be enabled): -1 * Accessibility is enabled (will be started upon a request, default value): 0 * Accessibility is force disabled (never enable accessibility): 1 */ #define PREF_ACCESSIBILITY_FORCE_DISABLED "accessibility.force_disabled" //////////////////////////////////////////////////////////////////////////////// // Statics //////////////////////////////////////////////////////////////////////////////// /** * Return true if the element must be accessible. */ static bool MustBeAccessible(nsIContent* aContent, DocAccessible* aDocument) { if (aContent->GetPrimaryFrame()->IsFocusable()) return true; if (aContent->IsElement()) { uint32_t attrCount = aContent->AsElement()->GetAttrCount(); for (uint32_t attrIdx = 0; attrIdx < attrCount; attrIdx++) { const nsAttrName* attr = aContent->AsElement()->GetAttrNameAt(attrIdx); if (attr->NamespaceEquals(kNameSpaceID_None)) { nsAtom* attrAtom = attr->Atom(); if (attrAtom == nsGkAtoms::title && aContent->IsHTMLElement()) { // If the author provided a title on an element that would not // be accessible normally, assume an intent and make it accessible. return true; } nsDependentAtomString attrStr(attrAtom); if (!StringBeginsWith(attrStr, NS_LITERAL_STRING("aria-"))) continue; // not ARIA // A global state or a property and in case of token defined. uint8_t attrFlags = aria::AttrCharacteristicsFor(attrAtom); if ((attrFlags & ATTR_GLOBAL) && (!(attrFlags & ATTR_VALTOKEN) || nsAccUtils::HasDefinedARIAToken(aContent, attrAtom))) { return true; } } } // If the given ID is referred by relation attribute then create an // accessible for it. nsAutoString id; if (nsCoreUtils::GetID(aContent, id) && !id.IsEmpty()) { return aDocument->IsDependentID(aContent->AsElement(), id); } } return false; } /** * Used by XULMap.h to map both menupopup and popup elements */ #ifdef MOZ_XUL Accessible* CreateMenupopupAccessible(Element* aElement, Accessible* aContext) { # ifdef MOZ_ACCESSIBILITY_ATK // ATK considers this node to be redundant when within menubars, and it makes // menu navigation with assistive technologies more difficult // XXX In the future we will should this for consistency across the // nsIAccessible implementations on each platform for a consistent scripting // environment, but then strip out redundant accessibles in the AccessibleWrap // class for each platform. nsIContent* parent = aElement->GetParent(); if (parent && parent->IsXULElement(nsGkAtoms::menu)) return nullptr; # endif return new XULMenupopupAccessible(aElement, aContext->Document()); } #endif //////////////////////////////////////////////////////////////////////////////// // Accessible constructors static Accessible* New_HyperText(Element* aElement, Accessible* aContext) { return new HyperTextAccessibleWrap(aElement, aContext->Document()); } template static Accessible* New_HTMLDtOrDd(Element* aElement, Accessible* aContext) { nsIContent* parent = aContext->GetContent(); if (parent->IsHTMLElement(nsGkAtoms::div)) { // It is conforming in HTML to use a div to group dt/dd elements. parent = parent->GetParent(); } if (parent && parent->IsHTMLElement(nsGkAtoms::dl)) { return new AccClass(aElement, aContext->Document()); } return nullptr; } /** * Cached value of the PREF_ACCESSIBILITY_FORCE_DISABLED preference. */ static int32_t sPlatformDisabledState = 0; //////////////////////////////////////////////////////////////////////////////// // Markup maps array. #define Attr(name, value) \ { nsGkAtoms::name, nsGkAtoms::value } #define AttrFromDOM(name, DOMAttrName) \ { nsGkAtoms::name, nullptr, nsGkAtoms::DOMAttrName } #define AttrFromDOMIf(name, DOMAttrName, DOMAttrValue) \ { nsGkAtoms::name, nullptr, nsGkAtoms::DOMAttrName, nsGkAtoms::DOMAttrValue } #define MARKUPMAP(atom, new_func, r, ...) \ {nsGkAtoms::atom, new_func, static_cast(r), {__VA_ARGS__}}, static const HTMLMarkupMapInfo sHTMLMarkupMapList[] = { #include "MarkupMap.h" }; #undef MARKUPMAP #ifdef MOZ_XUL # define XULMAP(atom, ...) {nsGkAtoms::atom, __VA_ARGS__}, # define XULMAP_TYPE(atom, new_type) \ XULMAP(atom, [](Element* aElement, Accessible* aContext) -> Accessible* { \ return new new_type(aElement, aContext->Document()); \ }) static const XULMarkupMapInfo sXULMarkupMapList[] = { # include "XULMap.h" }; # undef XULMAP_TYPE # undef XULMAP #endif #undef Attr #undef AttrFromDOM #undef AttrFromDOMIf //////////////////////////////////////////////////////////////////////////////// // nsAccessibilityService //////////////////////////////////////////////////////////////////////////////// nsAccessibilityService* nsAccessibilityService::gAccessibilityService = nullptr; ApplicationAccessible* nsAccessibilityService::gApplicationAccessible = nullptr; xpcAccessibleApplication* nsAccessibilityService::gXPCApplicationAccessible = nullptr; uint32_t nsAccessibilityService::gConsumers = 0; nsAccessibilityService::nsAccessibilityService() : DocManager(), FocusManager(), mHTMLMarkupMap(ArrayLength(sHTMLMarkupMapList)) #ifdef MOZ_XUL , mXULMarkupMap(ArrayLength(sXULMarkupMapList)) #endif { } nsAccessibilityService::~nsAccessibilityService() { NS_ASSERTION(IsShutdown(), "Accessibility wasn't shutdown!"); gAccessibilityService = nullptr; } //////////////////////////////////////////////////////////////////////////////// // nsIListenerChangeListener NS_IMETHODIMP nsAccessibilityService::ListenersChanged(nsIArray* aEventChanges) { uint32_t targetCount; nsresult rv = aEventChanges->GetLength(&targetCount); NS_ENSURE_SUCCESS(rv, rv); for (uint32_t i = 0; i < targetCount; i++) { nsCOMPtr change = do_QueryElementAt(aEventChanges, i); RefPtr target; change->GetTarget(getter_AddRefs(target)); nsCOMPtr node(do_QueryInterface(target)); if (!node || !node->IsHTMLElement()) { continue; } uint32_t changeCount; change->GetCountOfEventListenerChangesAffectingAccessibility(&changeCount); NS_ENSURE_SUCCESS(rv, rv); for (uint32_t i = 0; i < changeCount; i++) { Document* ownerDoc = node->OwnerDoc(); DocAccessible* document = GetExistingDocAccessible(ownerDoc); // Create an accessible for a inaccessible element having click event // handler. if (document && !document->HasAccessible(node) && nsCoreUtils::HasClickListener(node)) { document->ContentInserted(node, node->GetNextSibling()); break; } } } return NS_OK; } //////////////////////////////////////////////////////////////////////////////// // nsISupports NS_IMPL_ISUPPORTS_INHERITED(nsAccessibilityService, DocManager, nsIObserver, nsIListenerChangeListener, nsISelectionListener) // from SelectionManager //////////////////////////////////////////////////////////////////////////////// // nsIObserver NS_IMETHODIMP nsAccessibilityService::Observe(nsISupports* aSubject, const char* aTopic, const char16_t* aData) { if (!nsCRT::strcmp(aTopic, NS_XPCOM_SHUTDOWN_OBSERVER_ID)) { Shutdown(); } return NS_OK; } void nsAccessibilityService::NotifyOfAnchorJumpTo(nsIContent* aTargetNode) { Document* documentNode = aTargetNode->GetUncomposedDoc(); if (documentNode) { DocAccessible* document = GetDocAccessible(documentNode); if (document) document->SetAnchorJump(aTargetNode); } } void nsAccessibilityService::FireAccessibleEvent(uint32_t aEvent, Accessible* aTarget) { nsEventShell::FireEvent(aEvent, aTarget); } Accessible* nsAccessibilityService::GetRootDocumentAccessible( PresShell* aPresShell, bool aCanCreate) { PresShell* presShell = aPresShell; Document* documentNode = aPresShell->GetDocument(); if (documentNode) { nsCOMPtr treeItem(documentNode->GetDocShell()); if (treeItem) { nsCOMPtr rootTreeItem; treeItem->GetRootTreeItem(getter_AddRefs(rootTreeItem)); if (treeItem != rootTreeItem) { nsCOMPtr docShell(do_QueryInterface(rootTreeItem)); presShell = docShell->GetPresShell(); } return aCanCreate ? GetDocAccessible(presShell) : presShell->GetDocAccessible(); } } return nullptr; } #ifdef XP_WIN static StaticAutoPtr > > sPendingPlugins; static StaticAutoPtr > > sPluginTimers; class PluginTimerCallBack final : public nsITimerCallback, public nsINamed { ~PluginTimerCallBack() {} public: explicit PluginTimerCallBack(nsIContent* aContent) : mContent(aContent) {} NS_DECL_ISUPPORTS NS_IMETHOD Notify(nsITimer* aTimer) final { if (!mContent->IsInUncomposedDoc()) return NS_OK; PresShell* presShell = mContent->OwnerDoc()->GetPresShell(); if (presShell) { DocAccessible* doc = presShell->GetDocAccessible(); if (doc) { // Make sure that if we created an accessible for the plugin that wasn't // a plugin accessible we remove it before creating the right // accessible. doc->RecreateAccessible(mContent); sPluginTimers->RemoveElement(aTimer); return NS_OK; } } // We couldn't get a doc accessible so presumably the document went away. // In this case don't leak our ref to the content or timer. sPendingPlugins->RemoveElement(mContent); sPluginTimers->RemoveElement(aTimer); return NS_OK; } NS_IMETHOD GetName(nsACString& aName) final { aName.AssignLiteral("PluginTimerCallBack"); return NS_OK; } private: nsCOMPtr mContent; }; NS_IMPL_ISUPPORTS(PluginTimerCallBack, nsITimerCallback, nsINamed) #endif already_AddRefed nsAccessibilityService::CreatePluginAccessible( nsPluginFrame* aFrame, nsIContent* aContent, Accessible* aContext) { // nsPluginFrame means a plugin, so we need to use the accessibility support // of the plugin. if (aFrame->GetRect().IsEmpty()) return nullptr; #if defined(XP_WIN) || defined(MOZ_ACCESSIBILITY_ATK) RefPtr pluginInstance = aFrame->GetPluginInstance(); if (pluginInstance) { # ifdef XP_WIN if (!sPendingPlugins->Contains(aContent) && (Preferences::GetBool("accessibility.delay_plugins") || Compatibility::IsJAWS() || Compatibility::IsWE())) { RefPtr cb = new PluginTimerCallBack(aContent); nsCOMPtr timer; NS_NewTimerWithCallback( getter_AddRefs(timer), cb, Preferences::GetUint("accessibility.delay_plugin_time"), nsITimer::TYPE_ONE_SHOT); sPluginTimers->AppendElement(timer); sPendingPlugins->AppendElement(aContent); return nullptr; } // We need to remove aContent from the pending plugins here to avoid // reentrancy. When the timer fires it calls // DocAccessible::ContentInserted() which does the work async. sPendingPlugins->RemoveElement(aContent); // Note: pluginPort will be null if windowless. HWND pluginPort = nullptr; aFrame->GetPluginPort(&pluginPort); RefPtr accessible = new HTMLWin32ObjectOwnerAccessible( aContent, aContext->Document(), pluginPort); return accessible.forget(); # elif MOZ_ACCESSIBILITY_ATK if (!AtkSocketAccessible::gCanEmbed) return nullptr; // Note this calls into the plugin, so crazy things may happen and aFrame // may go away. nsCString plugId; nsresult rv = pluginInstance->GetValueFromPlugin( NPPVpluginNativeAccessibleAtkPlugId, &plugId); if (NS_SUCCEEDED(rv) && !plugId.IsEmpty()) { RefPtr socketAccessible = new AtkSocketAccessible(aContent, aContext->Document(), plugId); return socketAccessible.forget(); } # endif } #endif return nullptr; } void nsAccessibilityService::DeckPanelSwitched(PresShell* aPresShell, nsIContent* aDeckNode, nsIFrame* aPrevBoxFrame, nsIFrame* aCurrentBoxFrame) { // Ignore tabpanels elements (a deck having an accessible) since their // children are accessible not depending on selected tab. DocAccessible* document = GetDocAccessible(aPresShell); if (!document || document->HasAccessible(aDeckNode)) return; if (aPrevBoxFrame) { nsIContent* panelNode = aPrevBoxFrame->GetContent(); #ifdef A11Y_LOG if (logging::IsEnabled(logging::eTree)) { logging::MsgBegin("TREE", "deck panel unselected"); logging::Node("container", panelNode); logging::Node("content", aDeckNode); logging::MsgEnd(); } #endif document->ContentRemoved(panelNode); } if (aCurrentBoxFrame) { nsIContent* panelNode = aCurrentBoxFrame->GetContent(); #ifdef A11Y_LOG if (logging::IsEnabled(logging::eTree)) { logging::MsgBegin("TREE", "deck panel selected"); logging::Node("container", panelNode); logging::Node("content", aDeckNode); logging::MsgEnd(); } #endif document->ContentInserted(panelNode, panelNode->GetNextSibling()); } } void nsAccessibilityService::ContentRangeInserted(PresShell* aPresShell, nsIContent* aStartChild, nsIContent* aEndChild) { DocAccessible* document = GetDocAccessible(aPresShell); #ifdef A11Y_LOG if (logging::IsEnabled(logging::eTree)) { logging::MsgBegin("TREE", "content inserted; doc: %p", document); logging::Node("container", aStartChild->GetParent()); for (nsIContent* child = aStartChild; child != aEndChild; child = child->GetNextSibling()) { logging::Node("content", child); } logging::MsgEnd(); logging::Stack(); } #endif if (document) { document->ContentInserted(aStartChild, aEndChild); } } void nsAccessibilityService::ContentRemoved(PresShell* aPresShell, nsIContent* aChildNode) { DocAccessible* document = GetDocAccessible(aPresShell); #ifdef A11Y_LOG if (logging::IsEnabled(logging::eTree)) { logging::MsgBegin("TREE", "content removed; doc: %p", document); logging::Node("container node", aChildNode->GetFlattenedTreeParent()); logging::Node("content node", aChildNode); logging::MsgEnd(); } #endif if (document) { document->ContentRemoved(aChildNode); } #ifdef A11Y_LOG if (logging::IsEnabled(logging::eTree)) { logging::MsgEnd(); logging::Stack(); } #endif } void nsAccessibilityService::UpdateText(PresShell* aPresShell, nsIContent* aContent) { DocAccessible* document = GetDocAccessible(aPresShell); if (document) document->UpdateText(aContent); } void nsAccessibilityService::TreeViewChanged(PresShell* aPresShell, nsIContent* aContent, nsITreeView* aView) { DocAccessible* document = GetDocAccessible(aPresShell); if (document) { Accessible* accessible = document->GetAccessible(aContent); if (accessible) { XULTreeAccessible* treeAcc = accessible->AsXULTree(); if (treeAcc) treeAcc->TreeViewChanged(aView); } } } void nsAccessibilityService::RangeValueChanged(PresShell* aPresShell, nsIContent* aContent) { DocAccessible* document = GetDocAccessible(aPresShell); if (document) { Accessible* accessible = document->GetAccessible(aContent); if (accessible) { document->FireDelayedEvent(nsIAccessibleEvent::EVENT_VALUE_CHANGE, accessible); } } } void nsAccessibilityService::UpdateListBullet(PresShell* aPresShell, nsIContent* aHTMLListItemContent, bool aHasBullet) { DocAccessible* document = GetDocAccessible(aPresShell); if (document) { Accessible* accessible = document->GetAccessible(aHTMLListItemContent); if (accessible) { HTMLLIAccessible* listItem = accessible->AsHTMLListItem(); if (listItem) listItem->UpdateBullet(aHasBullet); } } } void nsAccessibilityService::UpdateImageMap(nsImageFrame* aImageFrame) { PresShell* presShell = aImageFrame->PresShell(); DocAccessible* document = GetDocAccessible(presShell); if (document) { Accessible* accessible = document->GetAccessible(aImageFrame->GetContent()); if (accessible) { HTMLImageMapAccessible* imageMap = accessible->AsImageMap(); if (imageMap) { imageMap->UpdateChildAreas(); return; } // If image map was initialized after we created an accessible (that'll // be an image accessible) then recreate it. RecreateAccessible(presShell, aImageFrame->GetContent()); } } } void nsAccessibilityService::UpdateLabelValue(PresShell* aPresShell, nsIContent* aLabelElm, const nsString& aNewValue) { DocAccessible* document = GetDocAccessible(aPresShell); if (document) { Accessible* accessible = document->GetAccessible(aLabelElm); if (accessible) { XULLabelAccessible* xulLabel = accessible->AsXULLabel(); NS_ASSERTION(xulLabel, "UpdateLabelValue was called for wrong accessible!"); if (xulLabel) xulLabel->UpdateLabelValue(aNewValue); } } } void nsAccessibilityService::PresShellActivated(PresShell* aPresShell) { DocAccessible* document = aPresShell->GetDocAccessible(); if (document) { RootAccessible* rootDocument = document->RootAccessible(); NS_ASSERTION(rootDocument, "Entirely broken tree: no root document!"); if (rootDocument) rootDocument->DocumentActivated(document); } } void nsAccessibilityService::RecreateAccessible(PresShell* aPresShell, nsIContent* aContent) { DocAccessible* document = GetDocAccessible(aPresShell); if (document) document->RecreateAccessible(aContent); } void nsAccessibilityService::GetStringRole(uint32_t aRole, nsAString& aString) { #define ROLE(geckoRole, stringRole, atkRole, macRole, msaaRole, ia2Role, \ androidClass, nameRule) \ case roles::geckoRole: \ aString.AssignLiteral(stringRole); \ return; switch (aRole) { #include "RoleMap.h" default: aString.AssignLiteral("unknown"); return; } #undef ROLE } void nsAccessibilityService::GetStringStates(uint32_t aState, uint32_t aExtraState, nsISupports** aStringStates) { RefPtr stringStates = GetStringStates(nsAccUtils::To64State(aState, aExtraState)); // unknown state if (!stringStates->Length()) { stringStates->Add(NS_LITERAL_STRING("unknown")); } stringStates.forget(aStringStates); } already_AddRefed nsAccessibilityService::GetStringStates( uint64_t aStates) const { RefPtr stringStates = new DOMStringList(); if (aStates & states::UNAVAILABLE) { stringStates->Add(NS_LITERAL_STRING("unavailable")); } if (aStates & states::SELECTED) { stringStates->Add(NS_LITERAL_STRING("selected")); } if (aStates & states::FOCUSED) { stringStates->Add(NS_LITERAL_STRING("focused")); } if (aStates & states::PRESSED) { stringStates->Add(NS_LITERAL_STRING("pressed")); } if (aStates & states::CHECKED) { stringStates->Add(NS_LITERAL_STRING("checked")); } if (aStates & states::MIXED) { stringStates->Add(NS_LITERAL_STRING("mixed")); } if (aStates & states::READONLY) { stringStates->Add(NS_LITERAL_STRING("readonly")); } if (aStates & states::HOTTRACKED) { stringStates->Add(NS_LITERAL_STRING("hottracked")); } if (aStates & states::DEFAULT) { stringStates->Add(NS_LITERAL_STRING("default")); } if (aStates & states::EXPANDED) { stringStates->Add(NS_LITERAL_STRING("expanded")); } if (aStates & states::COLLAPSED) { stringStates->Add(NS_LITERAL_STRING("collapsed")); } if (aStates & states::BUSY) { stringStates->Add(NS_LITERAL_STRING("busy")); } if (aStates & states::FLOATING) { stringStates->Add(NS_LITERAL_STRING("floating")); } if (aStates & states::ANIMATED) { stringStates->Add(NS_LITERAL_STRING("animated")); } if (aStates & states::INVISIBLE) { stringStates->Add(NS_LITERAL_STRING("invisible")); } if (aStates & states::OFFSCREEN) { stringStates->Add(NS_LITERAL_STRING("offscreen")); } if (aStates & states::SIZEABLE) { stringStates->Add(NS_LITERAL_STRING("sizeable")); } if (aStates & states::MOVEABLE) { stringStates->Add(NS_LITERAL_STRING("moveable")); } if (aStates & states::SELFVOICING) { stringStates->Add(NS_LITERAL_STRING("selfvoicing")); } if (aStates & states::FOCUSABLE) { stringStates->Add(NS_LITERAL_STRING("focusable")); } if (aStates & states::SELECTABLE) { stringStates->Add(NS_LITERAL_STRING("selectable")); } if (aStates & states::LINKED) { stringStates->Add(NS_LITERAL_STRING("linked")); } if (aStates & states::TRAVERSED) { stringStates->Add(NS_LITERAL_STRING("traversed")); } if (aStates & states::MULTISELECTABLE) { stringStates->Add(NS_LITERAL_STRING("multiselectable")); } if (aStates & states::EXTSELECTABLE) { stringStates->Add(NS_LITERAL_STRING("extselectable")); } if (aStates & states::PROTECTED) { stringStates->Add(NS_LITERAL_STRING("protected")); } if (aStates & states::HASPOPUP) { stringStates->Add(NS_LITERAL_STRING("haspopup")); } if (aStates & states::REQUIRED) { stringStates->Add(NS_LITERAL_STRING("required")); } if (aStates & states::ALERT) { stringStates->Add(NS_LITERAL_STRING("alert")); } if (aStates & states::INVALID) { stringStates->Add(NS_LITERAL_STRING("invalid")); } if (aStates & states::CHECKABLE) { stringStates->Add(NS_LITERAL_STRING("checkable")); } if (aStates & states::SUPPORTS_AUTOCOMPLETION) { stringStates->Add(NS_LITERAL_STRING("autocompletion")); } if (aStates & states::DEFUNCT) { stringStates->Add(NS_LITERAL_STRING("defunct")); } if (aStates & states::SELECTABLE_TEXT) { stringStates->Add(NS_LITERAL_STRING("selectable text")); } if (aStates & states::EDITABLE) { stringStates->Add(NS_LITERAL_STRING("editable")); } if (aStates & states::ACTIVE) { stringStates->Add(NS_LITERAL_STRING("active")); } if (aStates & states::MODAL) { stringStates->Add(NS_LITERAL_STRING("modal")); } if (aStates & states::MULTI_LINE) { stringStates->Add(NS_LITERAL_STRING("multi line")); } if (aStates & states::HORIZONTAL) { stringStates->Add(NS_LITERAL_STRING("horizontal")); } if (aStates & states::OPAQUE1) { stringStates->Add(NS_LITERAL_STRING("opaque")); } if (aStates & states::SINGLE_LINE) { stringStates->Add(NS_LITERAL_STRING("single line")); } if (aStates & states::TRANSIENT) { stringStates->Add(NS_LITERAL_STRING("transient")); } if (aStates & states::VERTICAL) { stringStates->Add(NS_LITERAL_STRING("vertical")); } if (aStates & states::STALE) { stringStates->Add(NS_LITERAL_STRING("stale")); } if (aStates & states::ENABLED) { stringStates->Add(NS_LITERAL_STRING("enabled")); } if (aStates & states::SENSITIVE) { stringStates->Add(NS_LITERAL_STRING("sensitive")); } if (aStates & states::EXPANDABLE) { stringStates->Add(NS_LITERAL_STRING("expandable")); } return stringStates.forget(); } void nsAccessibilityService::GetStringEventType(uint32_t aEventType, nsAString& aString) { NS_ASSERTION( nsIAccessibleEvent::EVENT_LAST_ENTRY == ArrayLength(kEventTypeNames), "nsIAccessibleEvent constants are out of sync to kEventTypeNames"); if (aEventType >= ArrayLength(kEventTypeNames)) { aString.AssignLiteral("unknown"); return; } aString.AssignASCII(kEventTypeNames[aEventType]); } void nsAccessibilityService::GetStringEventType(uint32_t aEventType, nsACString& aString) { MOZ_ASSERT( nsIAccessibleEvent::EVENT_LAST_ENTRY == ArrayLength(kEventTypeNames), "nsIAccessibleEvent constants are out of sync to kEventTypeNames"); if (aEventType >= ArrayLength(kEventTypeNames)) { aString.AssignLiteral("unknown"); return; } aString = nsDependentCString(kEventTypeNames[aEventType]); } void nsAccessibilityService::GetStringRelationType(uint32_t aRelationType, nsAString& aString) { NS_ENSURE_TRUE_VOID(aRelationType <= static_cast(RelationType::LAST)); #define RELATIONTYPE(geckoType, geckoTypeName, atkType, msaaType, ia2Type) \ case RelationType::geckoType: \ aString.AssignLiteral(geckoTypeName); \ return; RelationType relationType = static_cast(aRelationType); switch (relationType) { #include "RelationTypeMap.h" default: aString.AssignLiteral("unknown"); return; } #undef RELATIONTYPE } //////////////////////////////////////////////////////////////////////////////// // nsAccessibilityService public Accessible* nsAccessibilityService::CreateAccessible(nsINode* aNode, Accessible* aContext, bool* aIsSubtreeHidden) { MOZ_ASSERT(aContext, "No context provided"); MOZ_ASSERT(aNode, "No node to create an accessible for"); MOZ_ASSERT(gConsumers, "No creation after shutdown"); if (aIsSubtreeHidden) *aIsSubtreeHidden = false; DocAccessible* document = aContext->Document(); MOZ_ASSERT(!document->GetAccessible(aNode), "We already have an accessible for this node."); if (aNode->IsDocument()) { // If it's document node then ask accessible document loader for // document accessible, otherwise return null. return GetDocAccessible(aNode->AsDocument()); } // We have a content node. if (!aNode->GetComposedDoc()) { NS_WARNING("Creating accessible for node with no document"); return nullptr; } if (aNode->OwnerDoc() != document->DocumentNode()) { NS_ERROR("Creating accessible for wrong document"); return nullptr; } if (!aNode->IsContent()) return nullptr; nsIContent* content = aNode->AsContent(); if (aria::HasDefinedARIAHidden(content)) { if (aIsSubtreeHidden) { *aIsSubtreeHidden = true; } return nullptr; } // Check frame and its visibility. Note, hidden frame allows visible // elements in subtree. nsIFrame* frame = content->GetPrimaryFrame(); if (!frame || !frame->StyleVisibility()->IsVisible()) { // display:contents element doesn't have a frame, but retains the semantics. // All its children are unaffected. if (content->IsElement() && content->AsElement()->IsDisplayContents()) { const HTMLMarkupMapInfo* markupMap = mHTMLMarkupMap.Get(content->NodeInfo()->NameAtom()); if (markupMap && markupMap->new_func) { RefPtr newAcc = markupMap->new_func(content->AsElement(), aContext); if (newAcc) { document->BindToDocument(newAcc, aria::GetRoleMap(content->AsElement())); } return newAcc; } return nullptr; } if (aIsSubtreeHidden && !frame) *aIsSubtreeHidden = true; return nullptr; } if (frame->GetContent() != content) { // Not the main content for this frame. This happens because // elements return the image frame as their primary frame. The main content // for the image frame is the image content. If the frame is not an image // frame or the node is not an area element then null is returned. // This setup will change when bug 135040 is fixed. Make sure we don't // create area accessible here. Hopefully assertion below will handle that. #ifdef DEBUG nsImageFrame* imageFrame = do_QueryFrame(frame); NS_ASSERTION(imageFrame && content->IsHTMLElement(nsGkAtoms::area), "Unknown case of not main content for the frame!"); #endif return nullptr; } #ifdef DEBUG nsImageFrame* imageFrame = do_QueryFrame(frame); NS_ASSERTION(!imageFrame || !content->IsHTMLElement(nsGkAtoms::area), "Image map manages the area accessible creation!"); #endif // Attempt to create an accessible based on what we know. RefPtr newAcc; // Create accessible for visible text frames. if (content->IsText()) { nsIFrame::RenderedText text = frame->GetRenderedText( 0, UINT32_MAX, nsIFrame::TextOffsetType::OffsetsInContentText, nsIFrame::TrailingWhitespace::DontTrim); // Ignore not rendered text nodes and whitespace text nodes between table // cells. if (text.mString.IsEmpty() || (aContext->IsTableRow() && nsCoreUtils::IsWhitespaceString(text.mString))) { if (aIsSubtreeHidden) *aIsSubtreeHidden = true; return nullptr; } newAcc = CreateAccessibleByFrameType(frame, content, aContext); document->BindToDocument(newAcc, nullptr); newAcc->AsTextLeaf()->SetText(text.mString); return newAcc; } if (content->IsHTMLElement(nsGkAtoms::map)) { // Create hyper text accessible for HTML map if it is used to group links // (see http://www.w3.org/TR/WCAG10-HTML-TECHS/#group-bypass). If the HTML // map rect is empty then it is used for links grouping. Otherwise it should // be used in conjunction with HTML image element and in this case we don't // create any accessible for it and don't walk into it. The accessibles for // HTML area (HTMLAreaAccessible) the map contains are attached as // children of the appropriate accessible for HTML image // (ImageAccessible). if (nsLayoutUtils::GetAllInFlowRectsUnion(frame, frame->GetParent()) .IsEmpty()) { if (aIsSubtreeHidden) *aIsSubtreeHidden = true; return nullptr; } newAcc = new HyperTextAccessibleWrap(content, document); document->BindToDocument(newAcc, aria::GetRoleMap(content->AsElement())); return newAcc; } const nsRoleMapEntry* roleMapEntry = aria::GetRoleMap(content->AsElement()); // If the element is focusable or global ARIA attribute is applied to it or // it is referenced by ARIA relationship then treat role="presentation" on // the element as the role is not there. if (roleMapEntry && (roleMapEntry->Is(nsGkAtoms::presentation) || roleMapEntry->Is(nsGkAtoms::none))) { if (!MustBeAccessible(content, document)) return nullptr; roleMapEntry = nullptr; } if (!newAcc && content->IsHTMLElement()) { // HTML accessibles bool isARIATablePart = roleMapEntry && (roleMapEntry->accTypes & (eTableCell | eTableRow | eTable)); if (!isARIATablePart || frame->AccessibleType() == eHTMLTableCellType || frame->AccessibleType() == eHTMLTableRowType || frame->AccessibleType() == eHTMLTableType) { // Prefer to use markup to decide if and what kind of accessible to // create, const HTMLMarkupMapInfo* markupMap = mHTMLMarkupMap.Get(content->NodeInfo()->NameAtom()); if (markupMap && markupMap->new_func) newAcc = markupMap->new_func(content->AsElement(), aContext); if (!newAcc) // try by frame accessible type. newAcc = CreateAccessibleByFrameType(frame, content, aContext); } // In case of ARIA grid or table use table-specific classes if it's not // native table based. if (isARIATablePart && (!newAcc || newAcc->IsGenericHyperText())) { if ((roleMapEntry->accTypes & eTableCell)) { if (aContext->IsTableRow()) newAcc = new ARIAGridCellAccessibleWrap(content, document); } else if (roleMapEntry->IsOfType(eTableRow)) { if (aContext->IsTable() || (aContext->Parent() && aContext->Parent()->IsTable())) { newAcc = new ARIARowAccessible(content, document); } } else if (roleMapEntry->IsOfType(eTable)) { newAcc = new ARIAGridAccessibleWrap(content, document); } } // If table has strong ARIA role then all table descendants shouldn't // expose their native roles. if (!roleMapEntry && newAcc && aContext->HasStrongARIARole()) { if (frame->AccessibleType() == eHTMLTableRowType) { const nsRoleMapEntry* contextRoleMap = aContext->ARIARoleMap(); if (!contextRoleMap->IsOfType(eTable)) roleMapEntry = &aria::gEmptyRoleMap; } else if (frame->AccessibleType() == eHTMLTableCellType && aContext->ARIARoleMap() == &aria::gEmptyRoleMap) { roleMapEntry = &aria::gEmptyRoleMap; } else if (content->IsAnyOfHTMLElements(nsGkAtoms::dt, nsGkAtoms::li, nsGkAtoms::dd) || frame->AccessibleType() == eHTMLLiType) { const nsRoleMapEntry* contextRoleMap = aContext->ARIARoleMap(); if (!contextRoleMap->IsOfType(eList)) roleMapEntry = &aria::gEmptyRoleMap; } } } // Accessible XBL types and deck stuff are used in XUL only currently. if (!newAcc && content->IsXULElement()) { // No accessible for not selected deck panel and its children. if (!aContext->IsXULTabpanels()) { nsDeckFrame* deckFrame = do_QueryFrame(frame->GetParent()); if (deckFrame && deckFrame->GetSelectedBox() != frame) { if (aIsSubtreeHidden) *aIsSubtreeHidden = true; return nullptr; } } #ifdef MOZ_XUL // Prefer to use XUL to decide if and what kind of accessible to create. const XULMarkupMapInfo* xulMap = mXULMarkupMap.Get(content->NodeInfo()->NameAtom()); if (xulMap && xulMap->new_func) { newAcc = xulMap->new_func(content->AsElement(), aContext); } #endif // Any XUL box can be used as tabpanel, make sure we create a proper // accessible for it. if (!newAcc && aContext->IsXULTabpanels() && content->GetParent() == aContext->GetContent()) { LayoutFrameType frameType = frame->Type(); if (frameType == LayoutFrameType::Box || frameType == LayoutFrameType::Scroll) { newAcc = new XULTabpanelAccessible(content, document); } } } if (!newAcc) { if (content->IsSVGElement()) { SVGGeometryFrame* geometryFrame = do_QueryFrame(frame); if (geometryFrame) { // A graphic elements: rect, circle, ellipse, line, path, polygon, // polyline and image. A 'use' and 'text' graphic elements require // special support. newAcc = new EnumRoleAccessible(content, document); } else if (content->IsSVGElement(nsGkAtoms::svg)) { newAcc = new EnumRoleAccessible(content, document); } } else if (content->IsMathMLElement()) { const HTMLMarkupMapInfo* markupMap = mHTMLMarkupMap.Get(content->NodeInfo()->NameAtom()); if (markupMap && markupMap->new_func) newAcc = markupMap->new_func(content->AsElement(), aContext); // Fall back to text when encountering Content MathML. if (!newAcc && !content->IsAnyOfMathMLElements( nsGkAtoms::annotation_, nsGkAtoms::annotation_xml_, nsGkAtoms::mpadded_, nsGkAtoms::mphantom_, nsGkAtoms::maligngroup_, nsGkAtoms::malignmark_, nsGkAtoms::mspace_, nsGkAtoms::semantics_)) { newAcc = new HyperTextAccessible(content, document); } } } // If no accessible, see if we need to create a generic accessible because // of some property that makes this object interesting // We don't do this for , , , etc. which // correspond to the doc accessible and will be created in any case if (!newAcc && !content->IsHTMLElement(nsGkAtoms::body) && content->GetParent() && (roleMapEntry || MustBeAccessible(content, document) || (content->IsHTMLElement() && nsCoreUtils::HasClickListener(content)))) { // This content is focusable or has an interesting dynamic content // accessibility property. If it's interesting we need it in the // accessibility hierarchy so that events or other accessibles can point to // it, or so that it can hold a state, etc. if (content->IsHTMLElement()) { // Interesting HTML container which may have selectable text and/or // embedded objects newAcc = new HyperTextAccessibleWrap(content, document); } else { // XUL, SVG, MathML etc. // Interesting generic non-HTML container newAcc = new AccessibleWrap(content, document); } } if (newAcc) { document->BindToDocument(newAcc, roleMapEntry); } return newAcc; } //////////////////////////////////////////////////////////////////////////////// // nsAccessibilityService private bool nsAccessibilityService::Init() { // Initialize accessible document manager. if (!DocManager::Init()) return false; // Add observers. nsCOMPtr observerService = mozilla::services::GetObserverService(); if (!observerService) return false; observerService->AddObserver(this, NS_XPCOM_SHUTDOWN_OBSERVER_ID, false); #if defined(XP_WIN) // This information needs to be initialized before the observer fires. if (XRE_IsParentProcess()) { Compatibility::Init(); } #endif // defined(XP_WIN) // Subscribe to EventListenerService. nsCOMPtr eventListenerService = do_GetService("@mozilla.org/eventlistenerservice;1"); if (!eventListenerService) return false; eventListenerService->AddListenerChangeListener(this); for (uint32_t i = 0; i < ArrayLength(sHTMLMarkupMapList); i++) mHTMLMarkupMap.Put(sHTMLMarkupMapList[i].tag, &sHTMLMarkupMapList[i]); #ifdef MOZ_XUL for (uint32_t i = 0; i < ArrayLength(sXULMarkupMapList); i++) mXULMarkupMap.Put(sXULMarkupMapList[i].tag, &sXULMarkupMapList[i]); #endif #ifdef A11Y_LOG logging::CheckEnv(); #endif gAccessibilityService = this; NS_ADDREF(gAccessibilityService); // will release in Shutdown() if (XRE_IsParentProcess()) { gApplicationAccessible = new ApplicationAccessibleWrap(); } else { #if defined(XP_WIN) dom::ContentChild* contentChild = dom::ContentChild::GetSingleton(); MOZ_ASSERT(contentChild); // If we were instantiated by the chrome process, GetMsaaID() will return // a non-zero value and we may safely continue with initialization. if (!contentChild->GetMsaaID()) { // Since we were not instantiated by chrome, we need to synchronously // obtain a MSAA content process id. contentChild->SendGetA11yContentId(); } gApplicationAccessible = new ApplicationAccessibleWrap(); #else gApplicationAccessible = new ApplicationAccessible(); #endif // defined(XP_WIN) } NS_ADDREF(gApplicationAccessible); // will release in Shutdown() gApplicationAccessible->Init(); CrashReporter::AnnotateCrashReport(CrashReporter::Annotation::Accessibility, NS_LITERAL_CSTRING("Active")); #ifdef XP_WIN sPendingPlugins = new nsTArray >; sPluginTimers = new nsTArray >; #endif // Now its safe to start platform accessibility. if (XRE_IsParentProcess()) PlatformInit(); statistics::A11yInitialized(); static const char16_t kInitIndicator[] = {'1', 0}; observerService->NotifyObservers(nullptr, "a11y-init-or-shutdown", kInitIndicator); return true; } void nsAccessibilityService::Shutdown() { // Application is going to be closed, shutdown accessibility and mark // accessibility service as shutdown to prevent calls of its methods. // Don't null accessibility service static member at this point to be safe // if someone will try to operate with it. MOZ_ASSERT(gConsumers, "Accessibility was shutdown already"); UnsetConsumers(eXPCOM | eMainProcess | ePlatformAPI); // Remove observers. nsCOMPtr observerService = mozilla::services::GetObserverService(); if (observerService) { observerService->RemoveObserver(this, NS_XPCOM_SHUTDOWN_OBSERVER_ID); } // Stop accessible document loader. DocManager::Shutdown(); SelectionManager::Shutdown(); #ifdef XP_WIN sPendingPlugins = nullptr; uint32_t timerCount = sPluginTimers->Length(); for (uint32_t i = 0; i < timerCount; i++) sPluginTimers->ElementAt(i)->Cancel(); sPluginTimers = nullptr; #endif if (XRE_IsParentProcess()) PlatformShutdown(); gApplicationAccessible->Shutdown(); NS_RELEASE(gApplicationAccessible); gApplicationAccessible = nullptr; NS_IF_RELEASE(gXPCApplicationAccessible); gXPCApplicationAccessible = nullptr; NS_RELEASE(gAccessibilityService); gAccessibilityService = nullptr; if (observerService) { static const char16_t kShutdownIndicator[] = {'0', 0}; observerService->NotifyObservers(nullptr, "a11y-init-or-shutdown", kShutdownIndicator); } } already_AddRefed nsAccessibilityService::CreateAccessibleByFrameType(nsIFrame* aFrame, nsIContent* aContent, Accessible* aContext) { DocAccessible* document = aContext->Document(); RefPtr newAcc; switch (aFrame->AccessibleType()) { case eNoType: return nullptr; case eHTMLBRType: newAcc = new HTMLBRAccessible(aContent, document); break; case eHTMLButtonType: newAcc = new HTMLButtonAccessible(aContent, document); break; case eHTMLCanvasType: newAcc = new HTMLCanvasAccessible(aContent, document); break; case eHTMLCaptionType: if (aContext->IsTable() && aContext->GetContent() == aContent->GetParent()) { newAcc = new HTMLCaptionAccessible(aContent, document); } break; case eHTMLCheckboxType: newAcc = new CheckboxAccessible(aContent, document); break; case eHTMLComboboxType: newAcc = new HTMLComboboxAccessible(aContent, document); break; case eHTMLFileInputType: newAcc = new HTMLFileInputAccessible(aContent, document); break; case eHTMLGroupboxType: newAcc = new HTMLGroupboxAccessible(aContent, document); break; case eHTMLHRType: newAcc = new HTMLHRAccessible(aContent, document); break; case eHTMLImageMapType: newAcc = new HTMLImageMapAccessible(aContent, document); break; case eHTMLLiType: if (aContext->IsList() && aContext->GetContent() == aContent->GetParent()) { newAcc = new HTMLLIAccessible(aContent, document); } else { // Otherwise create a generic text accessible to avoid text jamming. newAcc = new HyperTextAccessibleWrap(aContent, document); } break; case eHTMLSelectListType: newAcc = new HTMLSelectListAccessible(aContent, document); break; case eHTMLMediaType: newAcc = new EnumRoleAccessible(aContent, document); break; case eHTMLRadioButtonType: newAcc = new HTMLRadioButtonAccessible(aContent, document); break; case eHTMLRangeType: newAcc = new HTMLRangeAccessible(aContent, document); break; case eHTMLSpinnerType: newAcc = new HTMLSpinnerAccessible(aContent, document); break; case eHTMLTableType: if (aContent->IsHTMLElement(nsGkAtoms::table)) newAcc = new HTMLTableAccessibleWrap(aContent, document); else newAcc = new HyperTextAccessibleWrap(aContent, document); break; case eHTMLTableCellType: // Accessible HTML table cell should be a child of accessible HTML table // or its row (CSS HTML tables are polite to the used markup at // certain degree). // Otherwise create a generic text accessible to avoid text jamming // when reading by AT. if (aContext->IsHTMLTableRow() || aContext->IsHTMLTable()) newAcc = new HTMLTableCellAccessibleWrap(aContent, document); else newAcc = new HyperTextAccessibleWrap(aContent, document); break; case eHTMLTableRowType: { // Accessible HTML table row may be a child of tbody/tfoot/thead of // accessible HTML table or a direct child of accessible of HTML table. Accessible* table = aContext->IsTable() ? aContext : nullptr; if (!table && aContext->Parent() && aContext->Parent()->IsTable()) table = aContext->Parent(); if (table) { nsIContent* parentContent = aContent->GetParentOrHostNode()->AsContent(); nsIFrame* parentFrame = nullptr; if (parentContent) { parentFrame = parentContent->GetPrimaryFrame(); if (!parentFrame || !parentFrame->IsTableWrapperFrame()) { parentContent = parentContent->GetParentOrHostNode()->AsContent(); if (parentContent) { parentFrame = parentContent->GetPrimaryFrame(); } } } if (parentFrame && parentFrame->IsTableWrapperFrame() && table->GetContent() == parentContent) { newAcc = new HTMLTableRowAccessible(aContent, document); } } break; } case eHTMLTextFieldType: newAcc = new HTMLTextFieldAccessible(aContent, document); break; case eHyperTextType: if (!aContent->IsAnyOfHTMLElements(nsGkAtoms::dt, nsGkAtoms::dd, nsGkAtoms::div)) { newAcc = new HyperTextAccessibleWrap(aContent, document); } break; case eImageType: newAcc = new ImageAccessibleWrap(aContent, document); break; case eOuterDocType: newAcc = new OuterDocAccessible(aContent, document); break; case ePluginType: { nsPluginFrame* pluginFrame = do_QueryFrame(aFrame); newAcc = CreatePluginAccessible(pluginFrame, aContent, aContext); break; } case eTextLeafType: newAcc = new TextLeafAccessibleWrap(aContent, document); break; default: MOZ_ASSERT(false); break; } return newAcc.forget(); } void nsAccessibilityService::MarkupAttributes( const nsIContent* aContent, nsIPersistentProperties* aAttributes) const { const mozilla::a11y::HTMLMarkupMapInfo* markupMap = mHTMLMarkupMap.Get(aContent->NodeInfo()->NameAtom()); if (!markupMap) return; for (uint32_t i = 0; i < ArrayLength(markupMap->attrs); i++) { const MarkupAttrInfo* info = markupMap->attrs + i; if (!info->name) break; if (info->DOMAttrName) { if (info->DOMAttrValue) { if (aContent->IsElement() && aContent->AsElement()->AttrValueIs( kNameSpaceID_None, info->DOMAttrName, info->DOMAttrValue, eCaseMatters)) { nsAccUtils::SetAccAttr(aAttributes, info->name, info->DOMAttrValue); } continue; } nsAutoString value; if (aContent->IsElement()) { aContent->AsElement()->GetAttr(kNameSpaceID_None, info->DOMAttrName, value); } if (!value.IsEmpty()) nsAccUtils::SetAccAttr(aAttributes, info->name, value); continue; } nsAccUtils::SetAccAttr(aAttributes, info->name, info->value); } } Accessible* nsAccessibilityService::AddNativeRootAccessible( void* aAtkAccessible) { #ifdef MOZ_ACCESSIBILITY_ATK ApplicationAccessible* applicationAcc = ApplicationAcc(); if (!applicationAcc) return nullptr; GtkWindowAccessible* nativeWnd = new GtkWindowAccessible(static_cast(aAtkAccessible)); if (applicationAcc->AppendChild(nativeWnd)) return nativeWnd; #endif return nullptr; } void nsAccessibilityService::RemoveNativeRootAccessible( Accessible* aAccessible) { #ifdef MOZ_ACCESSIBILITY_ATK ApplicationAccessible* applicationAcc = ApplicationAcc(); if (applicationAcc) applicationAcc->RemoveChild(aAccessible); #endif } bool nsAccessibilityService::HasAccessible(nsINode* aDOMNode) { if (!aDOMNode) return false; DocAccessible* document = GetDocAccessible(aDOMNode->OwnerDoc()); if (!document) return false; return document->HasAccessible(aDOMNode); } //////////////////////////////////////////////////////////////////////////////// // nsAccessibilityService private (DON'T put methods here) void nsAccessibilityService::SetConsumers(uint32_t aConsumers, bool aNotify) { if (gConsumers & aConsumers) { return; } gConsumers |= aConsumers; if (aNotify) { NotifyOfConsumersChange(); } } void nsAccessibilityService::UnsetConsumers(uint32_t aConsumers) { if (!(gConsumers & aConsumers)) { return; } gConsumers &= ~aConsumers; NotifyOfConsumersChange(); } void nsAccessibilityService::GetConsumers(nsAString& aString) { const char16_t* kJSONFmt = u"{ \"XPCOM\": %s, \"MainProcess\": %s, \"PlatformAPI\": %s }"; nsString json; nsTextFormatter::ssprintf(json, kJSONFmt, gConsumers & eXPCOM ? "true" : "false", gConsumers & eMainProcess ? "true" : "false", gConsumers & ePlatformAPI ? "true" : "false"); aString.Assign(json); } void nsAccessibilityService::NotifyOfConsumersChange() { nsCOMPtr observerService = mozilla::services::GetObserverService(); if (!observerService) { return; } nsAutoString consumers; GetConsumers(consumers); observerService->NotifyObservers(nullptr, "a11y-consumers-changed", consumers.get()); } nsAccessibilityService* GetOrCreateAccService(uint32_t aNewConsumer) { // Do not initialize accessibility if it is force disabled. if (PlatformDisabledState() == ePlatformIsDisabled) { return nullptr; } if (!nsAccessibilityService::gAccessibilityService) { RefPtr service = new nsAccessibilityService(); if (!service->Init()) { service->Shutdown(); return nullptr; } } MOZ_ASSERT(nsAccessibilityService::gAccessibilityService, "Accessible service is not initialized."); nsAccessibilityService::gAccessibilityService->SetConsumers(aNewConsumer); return nsAccessibilityService::gAccessibilityService; } void MaybeShutdownAccService(uint32_t aFormerConsumer) { nsAccessibilityService* accService = nsAccessibilityService::gAccessibilityService; if (!accService || nsAccessibilityService::IsShutdown()) { return; } // Still used by XPCOM if (nsCoreUtils::AccEventObserversExist() || xpcAccessibilityService::IsInUse() || accService->HasXPCDocuments()) { // In case the XPCOM flag was unset (possibly because of the shutdown // timer in the xpcAccessibilityService) ensure it is still present. Note: // this should be fixed when all the consumer logic is taken out as a // separate class. accService->SetConsumers(nsAccessibilityService::eXPCOM, false); if (aFormerConsumer != nsAccessibilityService::eXPCOM) { // Only unset non-XPCOM consumers. accService->UnsetConsumers(aFormerConsumer); } return; } if (nsAccessibilityService::gConsumers & ~aFormerConsumer) { accService->UnsetConsumers(aFormerConsumer); } else { accService ->Shutdown(); // Will unset all nsAccessibilityService::gConsumers } } //////////////////////////////////////////////////////////////////////////////// // Services //////////////////////////////////////////////////////////////////////////////// namespace mozilla { namespace a11y { FocusManager* FocusMgr() { return nsAccessibilityService::gAccessibilityService; } SelectionManager* SelectionMgr() { return nsAccessibilityService::gAccessibilityService; } ApplicationAccessible* ApplicationAcc() { return nsAccessibilityService::gApplicationAccessible; } xpcAccessibleApplication* XPCApplicationAcc() { if (!nsAccessibilityService::gXPCApplicationAccessible && nsAccessibilityService::gApplicationAccessible) { nsAccessibilityService::gXPCApplicationAccessible = new xpcAccessibleApplication( nsAccessibilityService::gApplicationAccessible); NS_ADDREF(nsAccessibilityService::gXPCApplicationAccessible); } return nsAccessibilityService::gXPCApplicationAccessible; } EPlatformDisabledState PlatformDisabledState() { static bool platformDisabledStateCached = false; if (platformDisabledStateCached) { return static_cast(sPlatformDisabledState); } platformDisabledStateCached = true; Preferences::RegisterCallback(PrefChanged, PREF_ACCESSIBILITY_FORCE_DISABLED); return ReadPlatformDisabledState(); } EPlatformDisabledState ReadPlatformDisabledState() { sPlatformDisabledState = Preferences::GetInt(PREF_ACCESSIBILITY_FORCE_DISABLED, 0); if (sPlatformDisabledState < ePlatformIsForceEnabled) { sPlatformDisabledState = ePlatformIsForceEnabled; } else if (sPlatformDisabledState > ePlatformIsDisabled) { sPlatformDisabledState = ePlatformIsDisabled; } return static_cast(sPlatformDisabledState); } void PrefChanged(const char* aPref, void* aClosure) { if (ReadPlatformDisabledState() == ePlatformIsDisabled) { // Force shut down accessibility. nsAccessibilityService* accService = nsAccessibilityService::gAccessibilityService; if (accService && !nsAccessibilityService::IsShutdown()) { accService->Shutdown(); } } } } // namespace a11y } // namespace mozilla