1 /* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
2 /* This Source Code Form is subject to the terms of the Mozilla Public
3 * License, v. 2.0. If a copy of the MPL was not distributed with this
4 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
6 #ifndef mozilla_a11y_Pivot_h_
7 #define mozilla_a11y_Pivot_h_
11 #include "mozilla/dom/ChildIterator.h"
16 class LocalAccessible
;
17 class HyperTextAccessible
;
23 // A filtering function that returns a bitmask from
24 // nsIAccessibleTraversalRule: FILTER_IGNORE (0x0): Don't match this
25 // accessible. FILTER_MATCH (0x1): Match this accessible FILTER_IGNORE_SUBTREE
26 // (0x2): Ignore accessible's subtree.
27 virtual uint16_t Match(Accessible
* aAcc
) = 0;
30 // The Pivot class is used for searching for accessible nodes in a given subtree
31 // with a given criteria. Since it only holds a weak reference to the root,
32 // this class is meant to be used primarily on the stack.
35 explicit Pivot(Accessible
* aRoot
);
37 Pivot(const Pivot
&) = delete;
38 Pivot
& operator=(const Pivot
&) = delete;
42 // Return the next accessible after aAnchor in pre-order that matches the
43 // given rule. If aIncludeStart, return aAnchor if it matches the rule.
44 Accessible
* Next(Accessible
* aAnchor
, PivotRule
& aRule
,
45 bool aIncludeStart
= false);
47 // Return the previous accessible before aAnchor in pre-order that matches the
48 // given rule. If aIncludeStart, return aAnchor if it matches the rule.
49 Accessible
* Prev(Accessible
* aAnchor
, PivotRule
& aRule
,
50 bool aIncludeStart
= false);
52 // Return the first accessible within the root that matches the pivot rule.
53 Accessible
* First(PivotRule
& aRule
);
55 // Return the last accessible within the root that matches the pivot rule.
56 Accessible
* Last(PivotRule
& aRule
);
58 // Return the next range of text according to the boundary type.
59 LocalAccessible
* NextText(LocalAccessible
* aAnchor
, int32_t* aStartOffset
,
60 int32_t* aEndOffset
, int32_t aBoundaryType
);
62 // Return the previous range of text according to the boundary type.
63 LocalAccessible
* PrevText(LocalAccessible
* aAnchor
, int32_t* aStartOffset
,
64 int32_t* aEndOffset
, int32_t aBoundaryType
);
66 // Return the accessible at the given screen coordinate if it matches the
68 Accessible
* AtPoint(int32_t aX
, int32_t aY
, PivotRule
& aRule
);
71 Accessible
* AdjustStartPosition(Accessible
* aAnchor
, PivotRule
& aRule
,
72 uint16_t* aFilterResult
);
74 // Search in preorder for the first accessible to match the rule.
75 Accessible
* SearchForward(Accessible
* aAnchor
, PivotRule
& aRule
,
78 // Reverse search in preorder for the first accessible to match the rule.
79 Accessible
* SearchBackward(Accessible
* aAnchor
, PivotRule
& aRule
,
82 // Search in preorder for the first text accessible.
83 HyperTextAccessible
* SearchForText(LocalAccessible
* aAnchor
, bool aBackward
);
89 * This rule matches accessibles on a given role, filtering out non-direct
90 * descendants if necessary.
92 class PivotRoleRule
: public PivotRule
{
94 explicit PivotRoleRule(role aRole
);
95 explicit PivotRoleRule(role aRole
, Accessible
* aDirectDescendantsFrom
);
97 virtual uint16_t Match(Accessible
* aAcc
) override
;
101 Accessible
* mDirectDescendantsFrom
;
105 * This rule matches any local LocalAccessible (i.e. not RemoteAccessible) in
106 * the same document as the anchor. That is, it includes any descendant
107 * OuterDocAccessible, but not its descendants.
109 class LocalAccInSameDocRule
: public PivotRule
{
111 virtual uint16_t Match(Accessible
* aAcc
) override
;
115 } // namespace mozilla
117 #endif // mozilla_a11y_Pivot_h_