diff -r 000000000000 -r 6474c204b198 accessible/src/base/nsCoreUtils.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/accessible/src/base/nsCoreUtils.h Wed Dec 31 06:09:35 2014 +0100 @@ -0,0 +1,317 @@ +/* -*- 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/. */ + +#ifndef nsCoreUtils_h_ +#define nsCoreUtils_h_ + +#include "nsIContent.h" +#include "nsIDocument.h" +#include "nsIPresShell.h" + +#include "nsPoint.h" +#include "nsTArray.h" + +class nsRange; +class nsIBoxObject; +class nsIFrame; +class nsIDocShell; +class nsITreeColumn; +class nsITreeBoxObject; +class nsIWidget; + +/** + * Core utils. + */ +class nsCoreUtils +{ +public: + /** + * Return true if the given node has registered click, mousedown or mouseup + * event listeners. + */ + static bool HasClickListener(nsIContent *aContent); + + /** + * Dispatch click event to XUL tree cell. + * + * @param aTreeBoxObj [in] tree box object + * @param aRowIndex [in] row index + * @param aColumn [in] column object + * @param aPseudoElm [in] pseudo elemenet inside the cell, see + * nsITreeBoxObject for available values + */ + static void DispatchClickEvent(nsITreeBoxObject *aTreeBoxObj, + int32_t aRowIndex, nsITreeColumn *aColumn, + const nsCString& aPseudoElt = EmptyCString()); + + /** + * Send mouse event to the given element. + * + * @param aEventType [in] an event type (see BasicEvents.h for constants) + * @param aX [in] x coordinate in dev pixels + * @param aY [in] y coordinate in dev pixels + * @param aContent [in] the element + * @param aFrame [in] frame of the element + * @param aPresShell [in] the presshell for the element + * @param aRootWidget [in] the root widget of the element + */ + static void DispatchMouseEvent(uint32_t aEventType, int32_t aX, int32_t aY, + nsIContent *aContent, nsIFrame *aFrame, + nsIPresShell *aPresShell, nsIWidget *aRootWidget); + + /** + * Send a touch event with a single touch point to the given element. + * + * @param aEventType [in] an event type (see BasicEvents.h for constants) + * @param aX [in] x coordinate in dev pixels + * @param aY [in] y coordinate in dev pixels + * @param aContent [in] the element + * @param aFrame [in] frame of the element + * @param aPresShell [in] the presshell for the element + * @param aRootWidget [in] the root widget of the element + */ + static void DispatchTouchEvent(uint32_t aEventType, int32_t aX, int32_t aY, + nsIContent* aContent, nsIFrame* aFrame, + nsIPresShell* aPresShell, nsIWidget* aRootWidget); + + /** + * Return an accesskey registered on the given element by + * EventStateManager or 0 if there is no registered accesskey. + * + * @param aContent - the given element. + */ + static uint32_t GetAccessKeyFor(nsIContent *aContent); + + /** + * Return DOM element related with the given node, i.e. + * a) itself if it is DOM element + * b) parent element if it is text node + * c) otherwise nullptr + * + * @param aNode [in] the given DOM node + */ + static nsIContent* GetDOMElementFor(nsIContent *aContent); + + /** + * Return DOM node for the given DOM point. + */ + static nsINode *GetDOMNodeFromDOMPoint(nsINode *aNode, uint32_t aOffset); + + /** + * Return the nsIContent* to check for ARIA attributes on -- this may not + * always be the DOM node for the accessible. Specifically, for doc + * accessibles, it is not the document node, but either the root element or + * in HTML. + * + * @param aNode [in] DOM node for the accessible that may be affected by ARIA + * @return the nsIContent which may have ARIA markup + */ + static nsIContent* GetRoleContent(nsINode *aNode); + + /** + * Is the first passed in node an ancestor of the second? + * Note: A node is not considered to be the ancestor of itself. + * + * @param aPossibleAncestorNode [in] node to test for ancestor-ness of + * aPossibleDescendantNode + * @param aPossibleDescendantNode [in] node to test for descendant-ness of + * aPossibleAncestorNode + * @param aRootNode [in, optional] the root node that search + * search should be performed within + * @return true if aPossibleAncestorNode is an ancestor of + * aPossibleDescendantNode + */ + static bool IsAncestorOf(nsINode *aPossibleAncestorNode, + nsINode *aPossibleDescendantNode, + nsINode *aRootNode = nullptr); + + /** + * Helper method to scroll range into view, used for implementation of + * nsIAccessibleText::scrollSubstringTo(). + * + * @param aFrame the frame for accessible the range belongs to. + * @param aRange the range to scroll to + * @param aScrollType the place a range should be scrolled to + */ + static nsresult ScrollSubstringTo(nsIFrame* aFrame, nsRange* aRange, + uint32_t aScrollType); + + /** Helper method to scroll range into view, used for implementation of + * nsIAccessibleText::scrollSubstringTo[Point](). + * + * @param aFrame the frame for accessible the range belongs to. + * @param aRange the range to scroll to + * @param aVertical how to align vertically, specified in percents, and when. + * @param aHorizontal how to align horizontally, specified in percents, and when. + */ + static nsresult ScrollSubstringTo(nsIFrame* aFrame, nsRange* aRange, + nsIPresShell::ScrollAxis aVertical, + nsIPresShell::ScrollAxis aHorizontal); + + /** + * Scrolls the given frame to the point, used for implememntation of + * nsIAccessible::scrollToPoint and nsIAccessibleText::scrollSubstringToPoint. + * + * @param aScrollableFrame the scrollable frame + * @param aFrame the frame to scroll + * @param aPoint the point scroll to + */ + static void ScrollFrameToPoint(nsIFrame *aScrollableFrame, + nsIFrame *aFrame, const nsIntPoint& aPoint); + + /** + * Converts scroll type constant defined in nsIAccessibleScrollType to + * vertical and horizontal parameters. + */ + static void ConvertScrollTypeToPercents(uint32_t aScrollType, + nsIPresShell::ScrollAxis *aVertical, + nsIPresShell::ScrollAxis *aHorizontal); + + /** + * Returns coordinates in device pixels relative screen for the top level + * window. + * + * @param aNode the DOM node hosted in the window. + */ + static nsIntPoint GetScreenCoordsForWindow(nsINode *aNode); + + /** + * Return document shell for the given DOM node. + */ + static already_AddRefed GetDocShellFor(nsINode *aNode); + + /** + * Return true if the given document is root document. + */ + static bool IsRootDocument(nsIDocument *aDocument); + + /** + * Return true if the given document is content document (not chrome). + */ + static bool IsContentDocument(nsIDocument *aDocument); + + /** + * Return true if the given document node is for tab document accessible. + */ + static bool IsTabDocument(nsIDocument* aDocumentNode); + + /** + * Return true if the given document is an error page. + */ + static bool IsErrorPage(nsIDocument *aDocument); + + /** + * Return presShell for the document containing the given DOM node. + */ + static nsIPresShell *GetPresShellFor(nsINode *aNode) + { + return aNode->OwnerDoc()->GetShell(); + } + + /** + * Get the ID for an element, in some types of XML this may not be the ID attribute + * @param aContent Node to get the ID for + * @param aID Where to put ID string + * @return true if there is an ID set for this node + */ + static bool GetID(nsIContent *aContent, nsAString& aID); + + /** + * Convert attribute value of the given node to positive integer. If no + * attribute or wrong value then false is returned. + */ + static bool GetUIntAttr(nsIContent *aContent, nsIAtom *aAttr, + int32_t *aUInt); + + /** + * Returns language for the given node. + * + * @param aContent [in] the given node + * @param aRootContent [in] container of the given node + * @param aLanguage [out] language + */ + static void GetLanguageFor(nsIContent *aContent, nsIContent *aRootContent, + nsAString& aLanguage); + + /** + * Return box object for XUL treechildren element by tree box object. + */ + static already_AddRefed + GetTreeBodyBoxObject(nsITreeBoxObject *aTreeBoxObj); + + /** + * Return tree box object from any levels DOMNode under the XUL tree. + */ + static already_AddRefed + GetTreeBoxObject(nsIContent* aContent); + + /** + * Return first sensible column for the given tree box object. + */ + static already_AddRefed + GetFirstSensibleColumn(nsITreeBoxObject *aTree); + + /** + * Return sensible columns count for the given tree box object. + */ + static uint32_t GetSensibleColumnCount(nsITreeBoxObject *aTree); + + /** + * Return sensible column at the given index for the given tree box object. + */ + static already_AddRefed + GetSensibleColumnAt(nsITreeBoxObject *aTree, uint32_t aIndex); + + /** + * Return next sensible column for the given column. + */ + static already_AddRefed + GetNextSensibleColumn(nsITreeColumn *aColumn); + + /** + * Return previous sensible column for the given column. + */ + static already_AddRefed + GetPreviousSensibleColumn(nsITreeColumn *aColumn); + + /** + * Return true if the given column is hidden (i.e. not sensible). + */ + static bool IsColumnHidden(nsITreeColumn *aColumn); + + /** + * Scroll content into view. + */ + static void ScrollTo(nsIPresShell* aPresShell, nsIContent* aContent, + uint32_t aScrollType); + + /** + * Return true if the given node is table header element. + */ + static bool IsHTMLTableHeader(nsIContent *aContent) + { + return aContent->NodeInfo()->Equals(nsGkAtoms::th) || + aContent->HasAttr(kNameSpaceID_None, nsGkAtoms::scope); + } + + /** + * Returns true if the given string is empty or contains whitespace symbols + * only. In contrast to nsWhitespaceTokenizer class it takes into account + * non-breaking space (0xa0). + */ + static bool IsWhitespaceString(const nsSubstring& aString); + + /** + * Returns true if the given character is whitespace symbol. + */ + static bool IsWhitespace(char16_t aChar) + { + return aChar == ' ' || aChar == '\n' || + aChar == '\r' || aChar == '\t' || aChar == 0xa0; + } +}; + +#endif +