AX: no accessibility support for details element
[WebKit-https.git] / Source / WebCore / accessibility / AccessibilityRenderObject.cpp
1 /*
2 * Copyright (C) 2008 Apple Inc. All rights reserved.
3 *
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
6 * are met:
7 *
8 * 1.  Redistributions of source code must retain the above copyright
9 *     notice, this list of conditions and the following disclaimer.
10 * 2.  Redistributions in binary form must reproduce the above copyright
11 *     notice, this list of conditions and the following disclaimer in the
12 *     documentation and/or other materials provided with the distribution.
13 * 3.  Neither the name of Apple Inc. ("Apple") nor the names of
14 *     its contributors may be used to endorse or promote products derived
15 *     from this software without specific prior written permission.
16 *
17 * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY
18 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
19 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
20 * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY
21 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
22 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
23 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
24 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 */
28
29 #include "config.h"
30 #include "AccessibilityRenderObject.h"
31
32 #include "AXObjectCache.h"
33 #include "AccessibilityImageMapLink.h"
34 #include "AccessibilityListBox.h"
35 #include "AccessibilitySVGRoot.h"
36 #include "AccessibilitySpinButton.h"
37 #include "AccessibilityTable.h"
38 #include "CachedImage.h"
39 #include "Chrome.h"
40 #include "ElementIterator.h"
41 #include "EventNames.h"
42 #include "FloatRect.h"
43 #include "Frame.h"
44 #include "FrameLoader.h"
45 #include "FrameSelection.h"
46 #include "HTMLAreaElement.h"
47 #include "HTMLAudioElement.h"
48 #include "HTMLFormElement.h"
49 #include "HTMLFrameElementBase.h"
50 #include "HTMLImageElement.h"
51 #include "HTMLInputElement.h"
52 #include "HTMLLabelElement.h"
53 #include "HTMLMapElement.h"
54 #include "HTMLNames.h"
55 #include "HTMLOptGroupElement.h"
56 #include "HTMLOptionElement.h"
57 #include "HTMLOptionsCollection.h"
58 #include "HTMLSelectElement.h"
59 #include "HTMLTableElement.h"
60 #include "HTMLTextAreaElement.h"
61 #include "HTMLVideoElement.h"
62 #include "HitTestRequest.h"
63 #include "HitTestResult.h"
64 #include "Image.h"
65 #include "LocalizedStrings.h"
66 #include "MathMLNames.h"
67 #include "NodeList.h"
68 #include "Page.h"
69 #include "ProgressTracker.h"
70 #include "RenderButton.h"
71 #include "RenderFieldset.h"
72 #include "RenderFileUploadControl.h"
73 #include "RenderHTMLCanvas.h"
74 #include "RenderImage.h"
75 #include "RenderInline.h"
76 #include "RenderIterator.h"
77 #include "RenderLayer.h"
78 #include "RenderLineBreak.h"
79 #include "RenderListBox.h"
80 #include "RenderListItem.h"
81 #include "RenderListMarker.h"
82 #include "RenderMathMLBlock.h"
83 #include "RenderMathMLFraction.h"
84 #include "RenderMathMLOperator.h"
85 #include "RenderMathMLRoot.h"
86 #include "RenderMenuList.h"
87 #include "RenderSVGRoot.h"
88 #include "RenderSVGShape.h"
89 #include "RenderText.h"
90 #include "RenderTextControl.h"
91 #include "RenderTextControlSingleLine.h"
92 #include "RenderTextFragment.h"
93 #include "RenderTheme.h"
94 #include "RenderView.h"
95 #include "RenderWidget.h"
96 #include "RenderedPosition.h"
97 #include "SVGDocument.h"
98 #include "SVGImage.h"
99 #include "SVGNames.h"
100 #include "SVGSVGElement.h"
101 #include "Text.h"
102 #include "TextControlInnerElements.h"
103 #include "TextIterator.h"
104 #include "VisibleUnits.h"
105 #include "htmlediting.h"
106 #include <wtf/NeverDestroyed.h>
107 #include <wtf/StdLibExtras.h>
108 #include <wtf/text/StringBuilder.h>
109 #include <wtf/unicode/CharacterNames.h>
110
111 namespace WebCore {
112
113 using namespace HTMLNames;
114
115 AccessibilityRenderObject::AccessibilityRenderObject(RenderObject* renderer)
116     : AccessibilityNodeObject(renderer->node())
117     , m_renderer(renderer)
118 {
119 #ifndef NDEBUG
120     m_renderer->setHasAXObject(true);
121 #endif
122 }
123
124 AccessibilityRenderObject::~AccessibilityRenderObject()
125 {
126     ASSERT(isDetached());
127 }
128
129 void AccessibilityRenderObject::init()
130 {
131     AccessibilityNodeObject::init();
132 }
133
134 Ref<AccessibilityRenderObject> AccessibilityRenderObject::create(RenderObject* renderer)
135 {
136     return adoptRef(*new AccessibilityRenderObject(renderer));
137 }
138
139 void AccessibilityRenderObject::detach(AccessibilityDetachmentType detachmentType, AXObjectCache* cache)
140 {
141     AccessibilityNodeObject::detach(detachmentType, cache);
142     
143     detachRemoteSVGRoot();
144     
145 #ifndef NDEBUG
146     if (m_renderer)
147         m_renderer->setHasAXObject(false);
148 #endif
149     m_renderer = nullptr;
150 }
151
152 RenderBoxModelObject* AccessibilityRenderObject::renderBoxModelObject() const
153 {
154     if (!is<RenderBoxModelObject>(m_renderer))
155         return nullptr;
156     return downcast<RenderBoxModelObject>(m_renderer);
157 }
158
159 void AccessibilityRenderObject::setRenderer(RenderObject* renderer)
160 {
161     m_renderer = renderer;
162     setNode(renderer->node());
163 }
164
165 static inline bool isInlineWithContinuation(RenderObject& object)
166 {
167     return is<RenderInline>(object) && downcast<RenderInline>(object).continuation();
168 }
169
170 static inline RenderObject* firstChildInContinuation(RenderInline& renderer)
171 {
172     auto continuation = renderer.continuation();
173
174     while (continuation) {
175         if (is<RenderBlock>(*continuation))
176             return continuation;
177         if (RenderObject* child = continuation->firstChild())
178             return child;
179         continuation = downcast<RenderInline>(*continuation).continuation();
180     }
181
182     return nullptr;
183 }
184
185 static inline RenderObject* firstChildConsideringContinuation(RenderObject& renderer)
186 {
187     RenderObject* firstChild = renderer.firstChildSlow();
188
189     if (!firstChild && isInlineWithContinuation(renderer))
190         firstChild = firstChildInContinuation(downcast<RenderInline>(renderer));
191
192     return firstChild;
193 }
194
195
196 static inline RenderObject* lastChildConsideringContinuation(RenderObject& renderer)
197 {
198     if (!is<RenderInline>(renderer) && !is<RenderBlock>(renderer))
199         return &renderer;
200
201     RenderObject* lastChild = downcast<RenderBoxModelObject>(renderer).lastChild();
202     RenderBoxModelObject* previous;
203     for (auto* current = &downcast<RenderBoxModelObject>(renderer); current; ) {
204         previous = current;
205
206         if (RenderObject* newLastChild = current->lastChild())
207             lastChild = newLastChild;
208
209         if (is<RenderInline>(*current)) {
210             current = downcast<RenderInline>(*current).inlineElementContinuation();
211             ASSERT_UNUSED(previous, current || !downcast<RenderInline>(*previous).continuation());
212         } else
213             current = downcast<RenderBlock>(*current).inlineElementContinuation();
214     }
215
216     return lastChild;
217 }
218
219 AccessibilityObject* AccessibilityRenderObject::firstChild() const
220 {
221     if (!m_renderer)
222         return nullptr;
223     
224     RenderObject* firstChild = firstChildConsideringContinuation(*m_renderer);
225
226     // If an object can't have children, then it is using this method to help
227     // calculate some internal property (like its description).
228     // In this case, it should check the Node level for children in case they're
229     // not rendered (like a <meter> element).
230     if (!firstChild && !canHaveChildren())
231         return AccessibilityNodeObject::firstChild();
232
233     return axObjectCache()->getOrCreate(firstChild);
234 }
235
236 AccessibilityObject* AccessibilityRenderObject::lastChild() const
237 {
238     if (!m_renderer)
239         return nullptr;
240
241     RenderObject* lastChild = lastChildConsideringContinuation(*m_renderer);
242
243     if (!lastChild && !canHaveChildren())
244         return AccessibilityNodeObject::lastChild();
245
246     return axObjectCache()->getOrCreate(lastChild);
247 }
248
249 static inline RenderInline* startOfContinuations(RenderObject& renderer)
250 {
251     if (renderer.isInlineElementContinuation() && is<RenderInline>(renderer.node()->renderer()))
252         return downcast<RenderInline>(renderer.node()->renderer());
253
254     // Blocks with a previous continuation always have a next continuation
255     if (is<RenderBlock>(renderer) && downcast<RenderBlock>(renderer).inlineElementContinuation())
256         return downcast<RenderInline>(downcast<RenderBlock>(renderer).inlineElementContinuation()->element()->renderer());
257
258     return nullptr;
259 }
260
261 static inline RenderObject* endOfContinuations(RenderObject& renderer)
262 {
263     if (!is<RenderInline>(renderer) && !is<RenderBlock>(renderer))
264         return &renderer;
265
266     auto* previous = &downcast<RenderBoxModelObject>(renderer);
267     for (auto* current = previous; current; ) {
268         previous = current;
269         if (is<RenderInline>(*current)) {
270             current = downcast<RenderInline>(*current).inlineElementContinuation();
271             ASSERT(current || !downcast<RenderInline>(*previous).continuation());
272         } else 
273             current = downcast<RenderBlock>(*current).inlineElementContinuation();
274     }
275
276     return previous;
277 }
278
279
280 static inline RenderObject* childBeforeConsideringContinuations(RenderInline* renderer, RenderObject* child)
281 {
282     RenderObject* previous = nullptr;
283     for (RenderBoxModelObject* currentContainer = renderer; currentContainer; ) {
284         if (is<RenderInline>(*currentContainer)) {
285             auto* current = currentContainer->firstChild();
286             while (current) {
287                 if (current == child)
288                     return previous;
289                 previous = current;
290                 current = current->nextSibling();
291             }
292
293             currentContainer = downcast<RenderInline>(*currentContainer).continuation();
294         } else if (is<RenderBlock>(*currentContainer)) {
295             if (currentContainer == child)
296                 return previous;
297
298             previous = currentContainer;
299             currentContainer = downcast<RenderBlock>(*currentContainer).inlineElementContinuation();
300         }
301     }
302
303     ASSERT_NOT_REACHED();
304     return nullptr;
305 }
306
307 static inline bool firstChildIsInlineContinuation(RenderElement& renderer)
308 {
309     RenderObject* child = renderer.firstChild();
310     return child && child->isInlineElementContinuation();
311 }
312
313 AccessibilityObject* AccessibilityRenderObject::previousSibling() const
314 {
315     if (!m_renderer)
316         return nullptr;
317
318     RenderObject* previousSibling = nullptr;
319
320     // Case 1: The node is a block and is an inline's continuation. In that case, the inline's
321     // last child is our previous sibling (or further back in the continuation chain)
322     RenderInline* startOfConts;
323     if (is<RenderBox>(*m_renderer) && (startOfConts = startOfContinuations(*m_renderer)))
324         previousSibling = childBeforeConsideringContinuations(startOfConts, m_renderer);
325
326     // Case 2: Anonymous block parent of the end of a continuation - skip all the way to before
327     // the parent of the start, since everything in between will be linked up via the continuation.
328     else if (m_renderer->isAnonymousBlock() && firstChildIsInlineContinuation(downcast<RenderBlock>(*m_renderer))) {
329         RenderBlock& renderBlock = downcast<RenderBlock>(*m_renderer);
330         auto* firstParent = startOfContinuations(*renderBlock.firstChild())->parent();
331         ASSERT(firstParent);
332         while (firstChildIsInlineContinuation(*firstParent))
333             firstParent = startOfContinuations(*firstParent->firstChild())->parent();
334         previousSibling = firstParent->previousSibling();
335     }
336
337     // Case 3: The node has an actual previous sibling
338     else if (RenderObject* ps = m_renderer->previousSibling())
339         previousSibling = ps;
340
341     // Case 4: This node has no previous siblings, but its parent is an inline,
342     // and is another node's inline continutation. Follow the continuation chain.
343     else if (is<RenderInline>(*m_renderer->parent()) && (startOfConts = startOfContinuations(*m_renderer->parent())))
344         previousSibling = childBeforeConsideringContinuations(startOfConts, m_renderer->parent()->firstChild());
345
346     if (!previousSibling)
347         return nullptr;
348     
349     return axObjectCache()->getOrCreate(previousSibling);
350 }
351
352 static inline bool lastChildHasContinuation(RenderElement& renderer)
353 {
354     RenderObject* child = renderer.lastChild();
355     return child && isInlineWithContinuation(*child);
356 }
357
358 AccessibilityObject* AccessibilityRenderObject::nextSibling() const
359 {
360     if (!m_renderer)
361         return nullptr;
362
363     RenderObject* nextSibling = nullptr;
364
365     // Case 1: node is a block and has an inline continuation. Next sibling is the inline continuation's
366     // first child.
367     RenderInline* inlineContinuation;
368     if (is<RenderBlock>(*m_renderer) && (inlineContinuation = downcast<RenderBlock>(*m_renderer).inlineElementContinuation()))
369         nextSibling = firstChildConsideringContinuation(*inlineContinuation);
370
371     // Case 2: Anonymous block parent of the start of a continuation - skip all the way to
372     // after the parent of the end, since everything in between will be linked up via the continuation.
373     else if (m_renderer->isAnonymousBlock() && lastChildHasContinuation(downcast<RenderBlock>(*m_renderer))) {
374         RenderElement* lastParent = endOfContinuations(*downcast<RenderBlock>(*m_renderer).lastChild())->parent();
375         ASSERT(lastParent);
376         while (lastChildHasContinuation(*lastParent))
377             lastParent = endOfContinuations(*lastParent->lastChild())->parent();
378         nextSibling = lastParent->nextSibling();
379     }
380
381     // Case 3: node has an actual next sibling
382     else if (RenderObject* ns = m_renderer->nextSibling())
383         nextSibling = ns;
384
385     // Case 4: node is an inline with a continuation. Next sibling is the next sibling of the end 
386     // of the continuation chain.
387     else if (isInlineWithContinuation(*m_renderer))
388         nextSibling = endOfContinuations(*m_renderer)->nextSibling();
389
390     // Case 5: node has no next sibling, and its parent is an inline with a continuation.
391     else if (isInlineWithContinuation(*m_renderer->parent())) {
392         auto& continuation = *downcast<RenderInline>(*m_renderer->parent()).continuation();
393         
394         // Case 5a: continuation is a block - in this case the block itself is the next sibling.
395         if (is<RenderBlock>(continuation))
396             nextSibling = &continuation;
397         // Case 5b: continuation is an inline - in this case the inline's first child is the next sibling
398         else
399             nextSibling = firstChildConsideringContinuation(continuation);
400     }
401
402     if (!nextSibling)
403         return nullptr;
404     
405     return axObjectCache()->getOrCreate(nextSibling);
406 }
407
408 static RenderBoxModelObject* nextContinuation(RenderObject& renderer)
409 {
410     if (is<RenderInline>(renderer) && !renderer.isReplaced())
411         return downcast<RenderInline>(renderer).continuation();
412     if (is<RenderBlock>(renderer))
413         return downcast<RenderBlock>(renderer).inlineElementContinuation();
414     return nullptr;
415 }
416     
417 RenderObject* AccessibilityRenderObject::renderParentObject() const
418 {
419     if (!m_renderer)
420         return nullptr;
421
422     RenderElement* parent = m_renderer->parent();
423
424     // Case 1: node is a block and is an inline's continuation. Parent
425     // is the start of the continuation chain.
426     RenderInline* startOfConts = nullptr;
427     RenderObject* firstChild = nullptr;
428     if (is<RenderBlock>(*m_renderer) && (startOfConts = startOfContinuations(*m_renderer)))
429         parent = startOfConts;
430
431     // Case 2: node's parent is an inline which is some node's continuation; parent is 
432     // the earliest node in the continuation chain.
433     else if (is<RenderInline>(parent) && (startOfConts = startOfContinuations(*parent)))
434         parent = startOfConts;
435     
436     // Case 3: The first sibling is the beginning of a continuation chain. Find the origin of that continuation.
437     else if (parent && (firstChild = parent->firstChild()) && firstChild->node()) {
438         // Get the node's renderer and follow that continuation chain until the first child is found
439         RenderObject* nodeRenderFirstChild = firstChild->node()->renderer();
440         while (nodeRenderFirstChild != firstChild) {
441             for (RenderObject* contsTest = nodeRenderFirstChild; contsTest; contsTest = nextContinuation(*contsTest)) {
442                 if (contsTest == firstChild) {
443                     parent = nodeRenderFirstChild->parent();
444                     break;
445                 }
446             }
447             RenderObject* parentFirstChild = parent->firstChild();
448             if (firstChild == parentFirstChild)
449                 break;
450             firstChild = parentFirstChild;
451             if (!firstChild->node())
452                 break;
453             nodeRenderFirstChild = firstChild->node()->renderer();
454         }
455     }
456         
457     return parent;
458 }
459     
460 AccessibilityObject* AccessibilityRenderObject::parentObjectIfExists() const
461 {
462     AXObjectCache* cache = axObjectCache();
463     if (!cache)
464         return nullptr;
465     
466     // WebArea's parent should be the scroll view containing it.
467     if (isWebArea())
468         return cache->get(&m_renderer->view().frameView());
469
470     return cache->get(renderParentObject());
471 }
472     
473 AccessibilityObject* AccessibilityRenderObject::parentObject() const
474 {
475     if (!m_renderer)
476         return nullptr;
477     
478     if (ariaRoleAttribute() == MenuBarRole)
479         return axObjectCache()->getOrCreate(m_renderer->parent());
480
481     // menuButton and its corresponding menu are DOM siblings, but Accessibility needs them to be parent/child
482     if (ariaRoleAttribute() == MenuRole) {
483         AccessibilityObject* parent = menuButtonForMenu();
484         if (parent)
485             return parent;
486     }
487     
488     AXObjectCache* cache = axObjectCache();
489     if (!cache)
490         return nullptr;
491     
492     RenderObject* parentObj = renderParentObject();
493     if (parentObj)
494         return cache->getOrCreate(parentObj);
495     
496     // WebArea's parent should be the scroll view containing it.
497     if (isWebArea())
498         return cache->getOrCreate(&m_renderer->view().frameView());
499     
500     return nullptr;
501 }
502     
503 bool AccessibilityRenderObject::isAttachment() const
504 {
505     RenderBoxModelObject* renderer = renderBoxModelObject();
506     if (!renderer)
507         return false;
508     // Widgets are the replaced elements that we represent to AX as attachments
509     bool isWidget = renderer->isWidget();
510
511     return isWidget && ariaRoleAttribute() == UnknownRole;
512 }
513
514 bool AccessibilityRenderObject::isFileUploadButton() const
515 {
516     if (m_renderer && is<HTMLInputElement>(m_renderer->node())) {
517         HTMLInputElement& input = downcast<HTMLInputElement>(*m_renderer->node());
518         return input.isFileUpload();
519     }
520     
521     return false;
522 }
523     
524 bool AccessibilityRenderObject::isReadOnly() const
525 {
526     ASSERT(m_renderer);
527     
528     if (isWebArea()) {
529         if (HTMLElement* body = m_renderer->document().bodyOrFrameset()) {
530             if (body->hasEditableStyle())
531                 return false;
532         }
533
534         return !m_renderer->document().hasEditableStyle();
535     }
536
537     return AccessibilityNodeObject::isReadOnly();
538 }
539
540 bool AccessibilityRenderObject::isOffScreen() const
541 {
542     ASSERT(m_renderer);
543     IntRect contentRect = snappedIntRect(m_renderer->absoluteClippedOverflowRect());
544     // FIXME: unclear if we need LegacyIOSDocumentVisibleRect.
545     IntRect viewRect = m_renderer->view().frameView().visibleContentRect(ScrollableArea::LegacyIOSDocumentVisibleRect);
546     viewRect.intersect(contentRect);
547     return viewRect.isEmpty();
548 }
549
550 Element* AccessibilityRenderObject::anchorElement() const
551 {
552     if (!m_renderer)
553         return nullptr;
554     
555     AXObjectCache* cache = axObjectCache();
556     if (!cache)
557         return nullptr;
558     
559     RenderObject* currentRenderer;
560     
561     // Search up the render tree for a RenderObject with a DOM node.  Defer to an earlier continuation, though.
562     for (currentRenderer = m_renderer; currentRenderer && !currentRenderer->node(); currentRenderer = currentRenderer->parent()) {
563         if (currentRenderer->isAnonymousBlock()) {
564             if (RenderObject* continuation = downcast<RenderBlock>(*currentRenderer).continuation())
565                 return cache->getOrCreate(continuation)->anchorElement();
566         }
567     }
568     
569     // bail if none found
570     if (!currentRenderer)
571         return nullptr;
572     
573     // search up the DOM tree for an anchor element
574     // NOTE: this assumes that any non-image with an anchor is an HTMLAnchorElement
575     for (Node* node = currentRenderer->node(); node; node = node->parentNode()) {
576         if (is<HTMLAnchorElement>(*node) || (node->renderer() && cache->getOrCreate(node->renderer())->isLink()))
577             return downcast<Element>(node);
578     }
579     
580     return nullptr;
581 }
582
583 String AccessibilityRenderObject::helpText() const
584 {
585     if (!m_renderer)
586         return String();
587     
588     const AtomicString& ariaHelp = getAttribute(aria_helpAttr);
589     if (!ariaHelp.isEmpty())
590         return ariaHelp;
591     
592     String describedBy = ariaDescribedByAttribute();
593     if (!describedBy.isEmpty())
594         return describedBy;
595     
596     String description = accessibilityDescription();
597     for (RenderObject* ancestor = m_renderer; ancestor; ancestor = ancestor->parent()) {
598         if (is<HTMLElement>(ancestor->node())) {
599             HTMLElement& element = downcast<HTMLElement>(*ancestor->node());
600             const AtomicString& summary = element.getAttribute(summaryAttr);
601             if (!summary.isEmpty())
602                 return summary;
603             
604             // The title attribute should be used as help text unless it is already being used as descriptive text.
605             const AtomicString& title = element.getAttribute(titleAttr);
606             if (!title.isEmpty() && description != title)
607                 return title;
608         }
609         
610         // Only take help text from an ancestor element if its a group or an unknown role. If help was 
611         // added to those kinds of elements, it is likely it was meant for a child element.
612         AccessibilityObject* axObj = axObjectCache()->getOrCreate(ancestor);
613         if (axObj) {
614             AccessibilityRole role = axObj->roleValue();
615             if (role != GroupRole && role != UnknownRole)
616                 break;
617         }
618     }
619     
620     return String();
621 }
622
623 String AccessibilityRenderObject::textUnderElement(AccessibilityTextUnderElementMode mode) const
624 {
625     if (!m_renderer)
626         return String();
627
628     if (is<RenderFileUploadControl>(*m_renderer))
629         return downcast<RenderFileUploadControl>(*m_renderer).buttonValue();
630     
631     // Reflect when a content author has explicitly marked a line break.
632     if (m_renderer->isBR())
633         return ASCIILiteral("\n");
634
635 #if ENABLE(MATHML)
636     // Math operators create RenderText nodes on the fly that are not tied into the DOM in a reasonable way,
637     // so rangeOfContents does not work for them (nor does regular text selection).
638     if (is<RenderText>(*m_renderer) && m_renderer->isAnonymous() && ancestorsOfType<RenderMathMLOperator>(*m_renderer).first())
639         return downcast<RenderText>(*m_renderer).text();
640     if (is<RenderMathMLOperator>(*m_renderer) && !m_renderer->isAnonymous())
641         return downcast<RenderMathMLOperator>(*m_renderer).element().textContent();
642 #endif
643
644     // rangeOfContents does not include CSS-generated content.
645     if (m_renderer->isBeforeOrAfterContent())
646         return AccessibilityNodeObject::textUnderElement(mode);
647
648     // We use a text iterator for text objects AND for those cases where we are
649     // explicitly asking for the full text under a given element.
650     if (is<RenderText>(*m_renderer) || mode.childrenInclusion == AccessibilityTextUnderElementMode::TextUnderElementModeIncludeAllChildren) {
651         // If possible, use a text iterator to get the text, so that whitespace
652         // is handled consistently.
653         Document* nodeDocument = nullptr;
654         RefPtr<Range> textRange;
655         if (Node* node = m_renderer->node()) {
656             // rangeOfContents does not include CSS-generated content.
657             Node* firstChild = node->pseudoAwareFirstChild();
658             Node* lastChild = node->pseudoAwareLastChild();
659             if ((firstChild && firstChild->isPseudoElement()) || (lastChild && lastChild->isPseudoElement()))
660                 return AccessibilityNodeObject::textUnderElement(mode);
661
662             nodeDocument = &node->document();
663             textRange = rangeOfContents(*node);
664         } else {
665             // For anonymous blocks, we work around not having a direct node to create a range from
666             // defining one based in the two external positions defining the boundaries of the subtree.
667             RenderObject* firstChildRenderer = m_renderer->firstChildSlow();
668             RenderObject* lastChildRenderer = m_renderer->lastChildSlow();
669             if (firstChildRenderer && lastChildRenderer) {
670                 ASSERT(firstChildRenderer->node());
671                 ASSERT(lastChildRenderer->node());
672
673                 // We define the start and end positions for the range as the ones right before and after
674                 // the first and the last nodes in the DOM tree that is wrapped inside the anonymous block.
675                 Node* firstNodeInBlock = firstChildRenderer->node();
676                 Position startPosition = positionInParentBeforeNode(firstNodeInBlock);
677                 Position endPosition = positionInParentAfterNode(lastChildRenderer->node());
678
679                 nodeDocument = &firstNodeInBlock->document();
680                 textRange = Range::create(*nodeDocument, startPosition, endPosition);
681             }
682         }
683
684         if (nodeDocument && textRange) {
685             if (Frame* frame = nodeDocument->frame()) {
686                 // catch stale WebCoreAXObject (see <rdar://problem/3960196>)
687                 if (frame->document() != nodeDocument)
688                     return String();
689                 return plainText(textRange.get(), textIteratorBehaviorForTextRange());
690             }
691         }
692     
693         // Sometimes text fragments don't have Nodes associated with them (like when
694         // CSS content is used to insert text or when a RenderCounter is used.)
695         if (is<RenderText>(*m_renderer)) {
696             RenderText& renderTextObject = downcast<RenderText>(*m_renderer);
697             if (is<RenderTextFragment>(renderTextObject)) {
698                 RenderTextFragment& renderTextFragment = downcast<RenderTextFragment>(renderTextObject);
699                 // The alt attribute may be set on a text fragment through CSS, which should be honored.
700                 const String& altText = renderTextFragment.altText();
701                 if (!altText.isEmpty())
702                     return altText;
703                 return renderTextFragment.contentString();
704             }
705
706             return renderTextObject.text();
707         }
708     }
709     
710     return AccessibilityNodeObject::textUnderElement(mode);
711 }
712
713 Node* AccessibilityRenderObject::node() const
714 {
715     if (!m_renderer)
716         return nullptr;
717     if (m_renderer->isRenderView())
718         return &m_renderer->document();
719     return m_renderer->node();
720 }    
721
722 String AccessibilityRenderObject::stringValue() const
723 {
724     if (!m_renderer)
725         return String();
726
727     if (isPasswordField())
728         return passwordFieldValue();
729
730     RenderBoxModelObject* cssBox = renderBoxModelObject();
731
732     if (ariaRoleAttribute() == StaticTextRole) {
733         String staticText = text();
734         if (!staticText.length())
735             staticText = textUnderElement();
736         return staticText;
737     }
738         
739     if (is<RenderText>(*m_renderer))
740         return textUnderElement();
741     
742     if (is<RenderMenuList>(cssBox)) {
743         // RenderMenuList will go straight to the text() of its selected item.
744         // This has to be overridden in the case where the selected item has an ARIA label.
745         HTMLSelectElement& selectElement = downcast<HTMLSelectElement>(*m_renderer->node());
746         int selectedIndex = selectElement.selectedIndex();
747         const Vector<HTMLElement*>& listItems = selectElement.listItems();
748         if (selectedIndex >= 0 && static_cast<size_t>(selectedIndex) < listItems.size()) {
749             const AtomicString& overriddenDescription = listItems[selectedIndex]->fastGetAttribute(aria_labelAttr);
750             if (!overriddenDescription.isNull())
751                 return overriddenDescription;
752         }
753         return downcast<RenderMenuList>(*m_renderer).text();
754     }
755     
756     if (is<RenderListMarker>(*m_renderer))
757         return downcast<RenderListMarker>(*m_renderer).text();
758     
759     if (isWebArea())
760         return String();
761     
762     if (isTextControl())
763         return text();
764     
765     if (is<RenderFileUploadControl>(*m_renderer))
766         return downcast<RenderFileUploadControl>(*m_renderer).fileTextValue();
767     
768     // FIXME: We might need to implement a value here for more types
769     // FIXME: It would be better not to advertise a value at all for the types for which we don't implement one;
770     // this would require subclassing or making accessibilityAttributeNames do something other than return a
771     // single static array.
772     return String();
773 }
774
775 HTMLLabelElement* AccessibilityRenderObject::labelElementContainer() const
776 {
777     if (!m_renderer)
778         return nullptr;
779
780     // the control element should not be considered part of the label
781     if (isControl())
782         return nullptr;
783     
784     // find if this has a parent that is a label
785     for (Node* parentNode = m_renderer->node(); parentNode; parentNode = parentNode->parentNode()) {
786         if (is<HTMLLabelElement>(*parentNode))
787             return downcast<HTMLLabelElement>(parentNode);
788     }
789     
790     return nullptr;
791 }
792
793 // The boundingBox for elements within the remote SVG element needs to be offset by its position
794 // within the parent page, otherwise they are in relative coordinates only.
795 void AccessibilityRenderObject::offsetBoundingBoxForRemoteSVGElement(LayoutRect& rect) const
796 {
797     for (AccessibilityObject* parent = parentObject(); parent; parent = parent->parentObject()) {
798         if (parent->isAccessibilitySVGRoot()) {
799             rect.moveBy(parent->parentObject()->boundingBoxRect().location());
800             break;
801         }
802     }
803 }
804     
805 LayoutRect AccessibilityRenderObject::boundingBoxRect() const
806 {
807     RenderObject* obj = m_renderer;
808     
809     if (!obj)
810         return LayoutRect();
811     
812     if (obj->node()) // If we are a continuation, we want to make sure to use the primary renderer.
813         obj = obj->node()->renderer();
814     
815     // absoluteFocusRingQuads will query the hierarchy below this element, which for large webpages can be very slow.
816     // For a web area, which will have the most elements of any element, absoluteQuads should be used.
817     // We should also use absoluteQuads for SVG elements, otherwise transforms won't be applied.
818     Vector<FloatQuad> quads;
819     bool isSVGRoot = false;
820
821     if (obj->isSVGRoot())
822         isSVGRoot = true;
823
824     if (is<RenderText>(*obj))
825         quads = downcast<RenderText>(*obj).absoluteQuadsClippedToEllipsis();
826     else if (isWebArea() || isSVGRoot)
827         obj->absoluteQuads(quads);
828     else
829         obj->absoluteFocusRingQuads(quads);
830     
831     LayoutRect result = boundingBoxForQuads(obj, quads);
832
833     Document* document = this->document();
834     if (document && document->isSVGDocument())
835         offsetBoundingBoxForRemoteSVGElement(result);
836     
837     // The size of the web area should be the content size, not the clipped size.
838     if (isWebArea())
839         result.setSize(obj->view().frameView().contentsSize());
840     
841     return result;
842 }
843     
844 LayoutRect AccessibilityRenderObject::checkboxOrRadioRect() const
845 {
846     if (!m_renderer)
847         return LayoutRect();
848     
849     HTMLLabelElement* label = labelForElement(downcast<Element>(m_renderer->node()));
850     if (!label || !label->renderer())
851         return boundingBoxRect();
852     
853     LayoutRect labelRect = axObjectCache()->getOrCreate(label)->elementRect();
854     labelRect.unite(boundingBoxRect());
855     return labelRect;
856 }
857
858 LayoutRect AccessibilityRenderObject::elementRect() const
859 {
860     // a checkbox or radio button should encompass its label
861     if (isCheckboxOrRadio())
862         return checkboxOrRadioRect();
863     
864     return boundingBoxRect();
865 }
866     
867 bool AccessibilityRenderObject::supportsPath() const
868 {
869     return is<RenderSVGShape>(m_renderer);
870 }
871
872 Path AccessibilityRenderObject::elementPath() const
873 {
874     if (is<RenderSVGShape>(m_renderer) && downcast<RenderSVGShape>(*m_renderer).hasPath()) {
875         Path path = downcast<RenderSVGShape>(*m_renderer).path();
876         
877         // The SVG path is in terms of the parent's bounding box. The path needs to be offset to frame coordinates.
878         if (auto svgRoot = ancestorsOfType<RenderSVGRoot>(*m_renderer).first()) {
879             LayoutPoint parentOffset = axObjectCache()->getOrCreate(&*svgRoot)->elementRect().location();
880             path.transform(AffineTransform().translate(parentOffset.x(), parentOffset.y()));
881         }
882         
883         return path;
884     }
885     
886     return Path();
887 }
888
889 IntPoint AccessibilityRenderObject::clickPoint()
890 {
891     // Headings are usually much wider than their textual content. If the mid point is used, often it can be wrong.
892     if (isHeading() && children().size() == 1)
893         return children()[0]->clickPoint();
894
895     // use the default position unless this is an editable web area, in which case we use the selection bounds.
896     if (!isWebArea() || isReadOnly())
897         return AccessibilityObject::clickPoint();
898     
899     VisibleSelection visSelection = selection();
900     VisiblePositionRange range = VisiblePositionRange(visSelection.visibleStart(), visSelection.visibleEnd());
901     IntRect bounds = boundsForVisiblePositionRange(range);
902 #if PLATFORM(COCOA)
903     bounds.setLocation(m_renderer->view().frameView().screenToContents(bounds.location()));
904 #endif        
905     return IntPoint(bounds.x() + (bounds.width() / 2), bounds.y() - (bounds.height() / 2));
906 }
907     
908 AccessibilityObject* AccessibilityRenderObject::internalLinkElement() const
909 {
910     Element* element = anchorElement();
911     // Right now, we do not support ARIA links as internal link elements
912     if (!is<HTMLAnchorElement>(element))
913         return nullptr;
914     HTMLAnchorElement& anchor = downcast<HTMLAnchorElement>(*element);
915     
916     URL linkURL = anchor.href();
917     String fragmentIdentifier = linkURL.fragmentIdentifier();
918     if (fragmentIdentifier.isEmpty())
919         return nullptr;
920     
921     // check if URL is the same as current URL
922     URL documentURL = m_renderer->document().url();
923     if (!equalIgnoringFragmentIdentifier(documentURL, linkURL))
924         return nullptr;
925     
926     Node* linkedNode = m_renderer->document().findAnchor(fragmentIdentifier);
927     if (!linkedNode)
928         return nullptr;
929     
930     // The element we find may not be accessible, so find the first accessible object.
931     return firstAccessibleObjectFromNode(linkedNode);
932 }
933
934 ESpeak AccessibilityRenderObject::speakProperty() const
935 {
936     if (!m_renderer)
937         return AccessibilityObject::speakProperty();
938     
939     return m_renderer->style().speak();
940 }
941     
942 void AccessibilityRenderObject::addRadioButtonGroupMembers(AccessibilityChildrenVector& linkedUIElements) const
943 {
944     if (!m_renderer || roleValue() != RadioButtonRole)
945         return;
946     
947     Node* node = m_renderer->node();
948     if (!is<HTMLInputElement>(node))
949         return;
950     
951     HTMLInputElement& input = downcast<HTMLInputElement>(*node);
952     // if there's a form, then this is easy
953     if (input.form()) {
954         for (auto& associateElement : input.form()->namedElements(input.name())) {
955             if (AccessibilityObject* object = axObjectCache()->getOrCreate(&associateElement.get()))
956                 linkedUIElements.append(object);        
957         } 
958     } else {
959         RefPtr<NodeList> list = node->document().getElementsByTagName(inputTag.localName());
960         unsigned length = list->length();
961         for (unsigned i = 0; i < length; ++i) {
962             Node* item = list->item(i);
963             if (is<HTMLInputElement>(*item)) {
964                 HTMLInputElement& associateElement = downcast<HTMLInputElement>(*item);
965                 if (associateElement.isRadioButton() && associateElement.name() == input.name()) {
966                     if (AccessibilityObject* object = axObjectCache()->getOrCreate(&associateElement))
967                         linkedUIElements.append(object);
968                 }
969             }
970         }
971     }
972 }
973     
974 // linked ui elements could be all the related radio buttons in a group
975 // or an internal anchor connection
976 void AccessibilityRenderObject::linkedUIElements(AccessibilityChildrenVector& linkedUIElements) const
977 {
978     ariaFlowToElements(linkedUIElements);
979
980     if (isLink()) {
981         AccessibilityObject* linkedAXElement = internalLinkElement();
982         if (linkedAXElement)
983             linkedUIElements.append(linkedAXElement);
984     }
985
986     if (roleValue() == RadioButtonRole)
987         addRadioButtonGroupMembers(linkedUIElements);
988 }
989
990 bool AccessibilityRenderObject::hasTextAlternative() const
991 {
992     // ARIA: section 2A, bullet #3 says if aria-labeledby or aria-label appears, it should
993     // override the "label" element association.
994     return ariaAccessibilityDescription().length();
995 }
996     
997 bool AccessibilityRenderObject::ariaHasPopup() const
998 {
999     return elementAttributeValue(aria_haspopupAttr);
1000 }
1001
1002 void AccessibilityRenderObject::ariaElementsFromAttribute(AccessibilityChildrenVector& children, const QualifiedName& attributeName) const
1003 {
1004     Vector<Element*> elements;
1005     elementsFromAttribute(elements, attributeName);
1006     AXObjectCache* cache = axObjectCache();
1007     for (const auto& element : elements) {
1008         if (AccessibilityObject* axObject = cache->getOrCreate(element))
1009             children.append(axObject);
1010     }
1011 }
1012
1013 bool AccessibilityRenderObject::supportsARIAFlowTo() const
1014 {
1015     return !getAttribute(aria_flowtoAttr).isEmpty();
1016 }
1017     
1018 void AccessibilityRenderObject::ariaFlowToElements(AccessibilityChildrenVector& flowTo) const
1019 {
1020     ariaElementsFromAttribute(flowTo, aria_flowtoAttr);
1021 }
1022
1023 bool AccessibilityRenderObject::supportsARIADescribedBy() const
1024 {
1025     return !getAttribute(aria_describedbyAttr).isEmpty();
1026 }
1027
1028 void AccessibilityRenderObject::ariaDescribedByElements(AccessibilityChildrenVector& ariaDescribedBy) const
1029 {
1030     ariaElementsFromAttribute(ariaDescribedBy, aria_describedbyAttr);
1031 }
1032
1033 bool AccessibilityRenderObject::supportsARIAControls() const
1034 {
1035     return !getAttribute(aria_controlsAttr).isEmpty();
1036 }
1037
1038 void AccessibilityRenderObject::ariaControlsElements(AccessibilityChildrenVector& ariaControls) const
1039 {
1040     ariaElementsFromAttribute(ariaControls, aria_controlsAttr);
1041 }
1042
1043 bool AccessibilityRenderObject::supportsARIADropping() const 
1044 {
1045     const AtomicString& dropEffect = getAttribute(aria_dropeffectAttr);
1046     return !dropEffect.isEmpty();
1047 }
1048
1049 bool AccessibilityRenderObject::supportsARIADragging() const
1050 {
1051     const AtomicString& grabbed = getAttribute(aria_grabbedAttr);
1052     return equalIgnoringCase(grabbed, "true") || equalIgnoringCase(grabbed, "false");   
1053 }
1054
1055 bool AccessibilityRenderObject::isARIAGrabbed()
1056 {
1057     return elementAttributeValue(aria_grabbedAttr);
1058 }
1059
1060 void AccessibilityRenderObject::determineARIADropEffects(Vector<String>& effects)
1061 {
1062     const AtomicString& dropEffects = getAttribute(aria_dropeffectAttr);
1063     if (dropEffects.isEmpty()) {
1064         effects.clear();
1065         return;
1066     }
1067     
1068     String dropEffectsString = dropEffects.string();
1069     dropEffectsString.replace('\n', ' ');
1070     dropEffectsString.split(' ', effects);
1071 }
1072     
1073 bool AccessibilityRenderObject::exposesTitleUIElement() const
1074 {
1075     if (!isControl())
1076         return false;
1077
1078     // If this control is ignored (because it's invisible), 
1079     // then the label needs to be exposed so it can be visible to accessibility.
1080     if (accessibilityIsIgnored())
1081         return true;
1082     
1083     // When controls have their own descriptions, the title element should be ignored.
1084     if (hasTextAlternative())
1085         return false;
1086     
1087     return true;
1088 }
1089     
1090 AccessibilityObject* AccessibilityRenderObject::titleUIElement() const
1091 {
1092     if (!m_renderer)
1093         return nullptr;
1094     
1095     // if isFieldset is true, the renderer is guaranteed to be a RenderFieldset
1096     if (isFieldset())
1097         return axObjectCache()->getOrCreate(downcast<RenderFieldset>(*m_renderer).findLegend(RenderFieldset::IncludeFloatingOrOutOfFlow));
1098     
1099     Node* node = m_renderer->node();
1100     if (!is<Element>(node))
1101         return nullptr;
1102     HTMLLabelElement* label = labelForElement(downcast<Element>(node));
1103     if (label && label->renderer())
1104         return axObjectCache()->getOrCreate(label);
1105
1106     return nullptr;
1107 }
1108     
1109 bool AccessibilityRenderObject::isAllowedChildOfTree() const
1110 {
1111     // Determine if this is in a tree. If so, we apply special behavior to make it work like an AXOutline.
1112     AccessibilityObject* axObj = parentObject();
1113     bool isInTree = false;
1114     bool isTreeItemDescendant = false;
1115     while (axObj) {
1116         if (axObj->roleValue() == TreeItemRole)
1117             isTreeItemDescendant = true;
1118         if (axObj->isTree()) {
1119             isInTree = true;
1120             break;
1121         }
1122         axObj = axObj->parentObject();
1123     }
1124     
1125     // If the object is in a tree, only tree items should be exposed (and the children of tree items).
1126     if (isInTree) {
1127         AccessibilityRole role = roleValue();
1128         if (role != TreeItemRole && role != StaticTextRole && !isTreeItemDescendant)
1129             return false;
1130     }
1131     return true;
1132 }
1133     
1134 static AccessibilityObjectInclusion objectInclusionFromAltText(const String& altText)
1135 {
1136     // Don't ignore an image that has an alt tag.
1137     if (!altText.containsOnlyWhitespace())
1138         return IncludeObject;
1139     
1140     // The informal standard is to ignore images with zero-length alt strings.
1141     if (!altText.isNull())
1142         return IgnoreObject;
1143     
1144     return DefaultBehavior;
1145 }
1146
1147 AccessibilityObjectInclusion AccessibilityRenderObject::defaultObjectInclusion() const
1148 {
1149     // The following cases can apply to any element that's a subclass of AccessibilityRenderObject.
1150     
1151     if (!m_renderer)
1152         return IgnoreObject;
1153
1154     if (m_renderer->style().visibility() != VISIBLE) {
1155         // aria-hidden is meant to override visibility as the determinant in AX hierarchy inclusion.
1156         if (equalIgnoringCase(getAttribute(aria_hiddenAttr), "false"))
1157             return DefaultBehavior;
1158         
1159         return IgnoreObject;
1160     }
1161
1162     return AccessibilityObject::defaultObjectInclusion();
1163 }
1164
1165 bool AccessibilityRenderObject::computeAccessibilityIsIgnored() const
1166 {
1167 #ifndef NDEBUG
1168     ASSERT(m_initialized);
1169 #endif
1170
1171     if (!m_renderer)
1172         return true;
1173     
1174     // Check first if any of the common reasons cause this element to be ignored.
1175     // Then process other use cases that need to be applied to all the various roles
1176     // that AccessibilityRenderObjects take on.
1177     AccessibilityObjectInclusion decision = defaultObjectInclusion();
1178     if (decision == IncludeObject)
1179         return false;
1180     if (decision == IgnoreObject)
1181         return true;
1182     
1183     // If this element is within a parent that cannot have children, it should not be exposed.
1184     if (isDescendantOfBarrenParent())
1185         return true;    
1186     
1187     if (roleValue() == IgnoredRole)
1188         return true;
1189     
1190     if (roleValue() == PresentationalRole || inheritsPresentationalRole())
1191         return true;
1192     
1193     // An ARIA tree can only have tree items and static text as children.
1194     if (!isAllowedChildOfTree())
1195         return true;
1196
1197     // Allow the platform to decide if the attachment is ignored or not.
1198     if (isAttachment())
1199         return accessibilityIgnoreAttachment();
1200     
1201     // ignore popup menu items because AppKit does
1202     if (m_renderer && ancestorsOfType<RenderMenuList>(*m_renderer).first())
1203         return true;
1204
1205     // find out if this element is inside of a label element.
1206     // if so, it may be ignored because it's the label for a checkbox or radio button
1207     AccessibilityObject* controlObject = correspondingControlForLabelElement();
1208     if (controlObject && !controlObject->exposesTitleUIElement() && controlObject->isCheckboxOrRadio())
1209         return true;
1210
1211     if (m_renderer->isBR())
1212         return true;
1213
1214     if (is<RenderText>(*m_renderer)) {
1215         // static text beneath MenuItems and MenuButtons are just reported along with the menu item, so it's ignored on an individual level
1216         AccessibilityObject* parent = parentObjectUnignored();
1217         if (parent && (parent->isMenuItem() || parent->ariaRoleAttribute() == MenuButtonRole))
1218             return true;
1219         auto& renderText = downcast<RenderText>(*m_renderer);
1220         if (!renderText.hasRenderedText())
1221             return true;
1222
1223         // static text beneath TextControls is reported along with the text control text so it's ignored.
1224         for (AccessibilityObject* parent = parentObject(); parent; parent = parent->parentObject()) { 
1225             if (parent->roleValue() == TextFieldRole)
1226                 return true;
1227         }
1228         
1229         // The alt attribute may be set on a text fragment through CSS, which should be honored.
1230         if (is<RenderTextFragment>(renderText)) {
1231             AccessibilityObjectInclusion altTextInclusion = objectInclusionFromAltText(downcast<RenderTextFragment>(renderText).altText());
1232             if (altTextInclusion == IgnoreObject)
1233                 return true;
1234             if (altTextInclusion == IncludeObject)
1235                 return false;
1236         }
1237
1238         // text elements that are just empty whitespace should not be returned
1239         return renderText.text()->containsOnlyWhitespace();
1240     }
1241     
1242     if (isHeading())
1243         return false;
1244     
1245     if (isLink())
1246         return false;
1247     
1248     if (isLandmark())
1249         return false;
1250
1251     // all controls are accessible
1252     if (isControl())
1253         return false;
1254
1255     switch (roleValue()) {
1256     case AudioRole:
1257     case DescriptionListTermRole:
1258     case DescriptionListDetailRole:
1259     case DetailsRole:
1260     case DocumentArticleRole:
1261     case DocumentRegionRole:
1262     case ListItemRole:
1263     case VideoRole:
1264         return false;
1265     default:
1266         break;
1267     }
1268     
1269     if (ariaRoleAttribute() != UnknownRole)
1270         return false;
1271     
1272     if (roleValue() == HorizontalRuleRole)
1273         return false;
1274     
1275     // don't ignore labels, because they serve as TitleUIElements
1276     Node* node = m_renderer->node();
1277     if (is<HTMLLabelElement>(node))
1278         return false;
1279     
1280     // Anything that is content editable should not be ignored.
1281     // However, one cannot just call node->hasEditableStyle() since that will ask if its parents
1282     // are also editable. Only the top level content editable region should be exposed.
1283     if (hasContentEditableAttributeSet())
1284         return false;
1285     
1286     
1287     // if this element has aria attributes on it, it should not be ignored.
1288     if (supportsARIAAttributes())
1289         return false;
1290
1291 #if ENABLE(MATHML)
1292     // First check if this is a special case within the math tree that needs to be ignored.
1293     if (isIgnoredElementWithinMathTree())
1294         return true;
1295     // Otherwise all other math elements are in the tree.
1296     if (isMathElement())
1297         return false;
1298 #endif
1299     
1300     if (is<RenderBlockFlow>(*m_renderer) && m_renderer->childrenInline() && !canSetFocusAttribute())
1301         return !downcast<RenderBlockFlow>(*m_renderer).hasLines() && !mouseButtonListener();
1302     
1303     // ignore images seemingly used as spacers
1304     if (isImage()) {
1305         
1306         // If the image can take focus, it should not be ignored, lest the user not be able to interact with something important.
1307         if (canSetFocusAttribute())
1308             return false;
1309         
1310         // First check the RenderImage's altText (which can be set through a style sheet, or come from the Element).
1311         // However, if this is not a native image, fallback to the attribute on the Element.
1312         AccessibilityObjectInclusion altTextInclusion = DefaultBehavior;
1313         bool isRenderImage = is<RenderImage>(m_renderer);
1314         if (isRenderImage)
1315             altTextInclusion = objectInclusionFromAltText(downcast<RenderImage>(*m_renderer).altText());
1316         else
1317             altTextInclusion = objectInclusionFromAltText(getAttribute(altAttr).string());
1318
1319         if (altTextInclusion == IgnoreObject)
1320             return true;
1321         if (altTextInclusion == IncludeObject)
1322             return false;
1323         
1324         // If an image has a title attribute on it, accessibility should be lenient and allow it to appear in the hierarchy (according to WAI-ARIA).
1325         if (!getAttribute(titleAttr).isEmpty())
1326             return false;
1327     
1328         if (isRenderImage) {
1329             // check for one-dimensional image
1330             RenderImage& image = downcast<RenderImage>(*m_renderer);
1331             if (image.height() <= 1 || image.width() <= 1)
1332                 return true;
1333             
1334             // check whether rendered image was stretched from one-dimensional file image
1335             if (image.cachedImage()) {
1336                 LayoutSize imageSize = image.cachedImage()->imageSizeForRenderer(&image, image.view().zoomFactor());
1337                 return imageSize.height() <= 1 || imageSize.width() <= 1;
1338             }
1339         }
1340         return false;
1341     }
1342
1343     if (isCanvas()) {
1344         if (canvasHasFallbackContent())
1345             return false;
1346
1347         if (is<RenderBox>(*m_renderer)) {
1348             auto& canvasBox = downcast<RenderBox>(*m_renderer);
1349             if (canvasBox.height() <= 1 || canvasBox.width() <= 1)
1350                 return true;
1351         }
1352         // Otherwise fall through; use presence of help text, title, or description to decide.
1353     }
1354
1355     if (m_renderer->isListMarker()) {
1356         AccessibilityObject* parent = parentObjectUnignored();
1357         return parent && !parent->isListItem();
1358     }
1359
1360     if (isWebArea())
1361         return false;
1362     
1363     // Using the presence of an accessible name to decide an element's visibility is not
1364     // as definitive as previous checks, so this should remain as one of the last.
1365     if (hasAttributesRequiredForInclusion())
1366         return false;
1367
1368     // Don't ignore generic focusable elements like <div tabindex=0>
1369     // unless they're completely empty, with no children.
1370     if (isGenericFocusableElement() && node->firstChild())
1371         return false;
1372
1373     // <span> tags are inline tags and not meant to convey information if they have no other aria
1374     // information on them. If we don't ignore them, they may emit signals expected to come from
1375     // their parent. In addition, because included spans are GroupRole objects, and GroupRole
1376     // objects are often containers with meaningful information, the inclusion of a span can have
1377     // the side effect of causing the immediate parent accessible to be ignored. This is especially
1378     // problematic for platforms which have distinct roles for textual block elements.
1379     if (node && node->hasTagName(spanTag))
1380         return true;
1381
1382     // Other non-ignored host language elements
1383     if (node && node->hasTagName(dfnTag))
1384         return false;
1385     
1386     // Make sure that ruby containers are not ignored.
1387     if (m_renderer->isRubyRun() || m_renderer->isRubyBlock() || m_renderer->isRubyInline())
1388         return false;
1389
1390     // By default, objects should be ignored so that the AX hierarchy is not
1391     // filled with unnecessary items.
1392     return true;
1393 }
1394
1395 bool AccessibilityRenderObject::isLoaded() const
1396 {
1397     return !m_renderer->document().parser();
1398 }
1399
1400 double AccessibilityRenderObject::estimatedLoadingProgress() const
1401 {
1402     if (!m_renderer)
1403         return 0;
1404     
1405     if (isLoaded())
1406         return 1.0;
1407     
1408     Page* page = m_renderer->document().page();
1409     if (!page)
1410         return 0;
1411     
1412     return page->progress().estimatedProgress();
1413 }
1414     
1415 int AccessibilityRenderObject::layoutCount() const
1416 {
1417     if (!is<RenderView>(*m_renderer))
1418         return 0;
1419     return downcast<RenderView>(*m_renderer).frameView().layoutCount();
1420 }
1421
1422 String AccessibilityRenderObject::text() const
1423 {
1424     if (isPasswordField())
1425         return passwordFieldValue();
1426
1427     return AccessibilityNodeObject::text();
1428 }
1429     
1430 int AccessibilityRenderObject::textLength() const
1431 {
1432     ASSERT(isTextControl());
1433     
1434     if (isPasswordField())
1435         return passwordFieldValue().length();
1436
1437     return text().length();
1438 }
1439
1440 PlainTextRange AccessibilityRenderObject::documentBasedSelectedTextRange() const
1441 {
1442     Node* node = m_renderer->node();
1443     if (!node)
1444         return PlainTextRange();
1445     
1446     VisibleSelection visibleSelection = selection();
1447     RefPtr<Range> currentSelectionRange = visibleSelection.toNormalizedRange();
1448     if (!currentSelectionRange || !currentSelectionRange->intersectsNode(node, IGNORE_EXCEPTION))
1449         return PlainTextRange();
1450     
1451     int start = indexForVisiblePosition(visibleSelection.start());
1452     int end = indexForVisiblePosition(visibleSelection.end());
1453     
1454     return PlainTextRange(start, end - start);
1455 }
1456
1457 String AccessibilityRenderObject::selectedText() const
1458 {
1459     ASSERT(isTextControl());
1460     
1461     if (isPasswordField())
1462         return String(); // need to return something distinct from empty string
1463     
1464     if (isNativeTextControl()) {
1465         HTMLTextFormControlElement& textControl = downcast<RenderTextControl>(*m_renderer).textFormControlElement();
1466         return textControl.selectedText();
1467     }
1468     
1469     return doAXStringForRange(documentBasedSelectedTextRange());
1470 }
1471
1472 const AtomicString& AccessibilityRenderObject::accessKey() const
1473 {
1474     Node* node = m_renderer->node();
1475     if (!is<Element>(node))
1476         return nullAtom;
1477     return downcast<Element>(*node).getAttribute(accesskeyAttr);
1478 }
1479
1480 VisibleSelection AccessibilityRenderObject::selection() const
1481 {
1482     return m_renderer->frame().selection().selection();
1483 }
1484
1485 PlainTextRange AccessibilityRenderObject::selectedTextRange() const
1486 {
1487     ASSERT(isTextControl());
1488     
1489     if (isPasswordField())
1490         return PlainTextRange();
1491     
1492     AccessibilityRole ariaRole = ariaRoleAttribute();
1493     if (isNativeTextControl() && ariaRole == UnknownRole) {
1494         HTMLTextFormControlElement& textControl = downcast<RenderTextControl>(*m_renderer).textFormControlElement();
1495         return PlainTextRange(textControl.selectionStart(), textControl.selectionEnd() - textControl.selectionStart());
1496     }
1497     
1498     return documentBasedSelectedTextRange();
1499 }
1500
1501 static void setTextSelectionIntent(const AccessibilityRenderObject& renderObject, AXTextStateChangeType type)
1502 {
1503     AXObjectCache* cache = renderObject.axObjectCache();
1504     if (!cache)
1505         return;
1506     AXTextStateChangeIntent intent(type, AXTextSelection { AXTextSelectionDirectionDiscontiguous, AXTextSelectionGranularityUnknown });
1507     cache->setTextSelectionIntent(intent);
1508     cache->setIsSynchronizingSelection(true);
1509 }
1510
1511 void AccessibilityRenderObject::setSelectedTextRange(const PlainTextRange& range)
1512 {
1513     if (isNativeTextControl()) {
1514         setTextSelectionIntent(*this, range.length ? AXTextStateChangeTypeSelectionExtend : AXTextStateChangeTypeSelectionMove);
1515         HTMLTextFormControlElement& textControl = downcast<RenderTextControl>(*m_renderer).textFormControlElement();
1516         textControl.setSelectionRange(range.start, range.start + range.length);
1517         return;
1518     }
1519
1520     Node* node = m_renderer->node();
1521     VisibleSelection newSelection(Position(node, range.start, Position::PositionIsOffsetInAnchor), Position(node, range.start + range.length, Position::PositionIsOffsetInAnchor), DOWNSTREAM);
1522     setTextSelectionIntent(*this, range.length ? AXTextStateChangeTypeSelectionExtend : AXTextStateChangeTypeSelectionMove);
1523     m_renderer->frame().selection().setSelection(newSelection, FrameSelection::defaultSetSelectionOptions());
1524 }
1525
1526 URL AccessibilityRenderObject::url() const
1527 {
1528     if (isLink() && is<HTMLAnchorElement>(*m_renderer->node())) {
1529         if (HTMLAnchorElement* anchor = downcast<HTMLAnchorElement>(anchorElement()))
1530             return anchor->href();
1531     }
1532     
1533     if (isWebArea())
1534         return m_renderer->document().url();
1535     
1536     if (isImage() && is<HTMLImageElement>(m_renderer->node()))
1537         return downcast<HTMLImageElement>(*m_renderer->node()).src();
1538     
1539     if (isInputImage())
1540         return downcast<HTMLInputElement>(*m_renderer->node()).src();
1541     
1542     return URL();
1543 }
1544
1545 bool AccessibilityRenderObject::isUnvisited() const
1546 {
1547     // FIXME: Is it a privacy violation to expose unvisited information to accessibility APIs?
1548     return m_renderer->style().isLink() && m_renderer->style().insideLink() == InsideUnvisitedLink;
1549 }
1550
1551 bool AccessibilityRenderObject::isVisited() const
1552 {
1553     // FIXME: Is it a privacy violation to expose visited information to accessibility APIs?
1554     return m_renderer->style().isLink() && m_renderer->style().insideLink() == InsideVisitedLink;
1555 }
1556
1557 void AccessibilityRenderObject::setElementAttributeValue(const QualifiedName& attributeName, bool value)
1558 {
1559     if (!m_renderer)
1560         return;
1561     
1562     Node* node = m_renderer->node();
1563     if (!is<Element>(node))
1564         return;
1565     
1566     downcast<Element>(*node).setAttribute(attributeName, (value) ? "true" : "false");
1567 }
1568     
1569 bool AccessibilityRenderObject::elementAttributeValue(const QualifiedName& attributeName) const
1570 {
1571     if (!m_renderer)
1572         return false;
1573     
1574     return equalIgnoringCase(getAttribute(attributeName), "true");
1575 }
1576     
1577 bool AccessibilityRenderObject::isSelected() const
1578 {
1579     if (!m_renderer)
1580         return false;
1581     
1582     Node* node = m_renderer->node();
1583     if (!node)
1584         return false;
1585     
1586     const AtomicString& ariaSelected = getAttribute(aria_selectedAttr);
1587     if (equalIgnoringCase(ariaSelected, "true"))
1588         return true;    
1589     
1590     if (isTabItem() && isTabItemSelected())
1591         return true;
1592
1593     return false;
1594 }
1595
1596 bool AccessibilityRenderObject::isTabItemSelected() const
1597 {
1598     if (!isTabItem() || !m_renderer)
1599         return false;
1600     
1601     Node* node = m_renderer->node();
1602     if (!node || !node->isElementNode())
1603         return false;
1604     
1605     // The ARIA spec says a tab item can also be selected if it is aria-labeled by a tabpanel
1606     // that has keyboard focus inside of it, or if a tabpanel in its aria-controls list has KB
1607     // focus inside of it.
1608     AccessibilityObject* focusedElement = focusedUIElement();
1609     if (!focusedElement)
1610         return false;
1611     
1612     Vector<Element*> elements;
1613     elementsFromAttribute(elements, aria_controlsAttr);
1614     
1615     AXObjectCache* cache = axObjectCache();
1616     if (!cache)
1617         return false;
1618     
1619     for (const auto& element : elements) {
1620         AccessibilityObject* tabPanel = cache->getOrCreate(element);
1621
1622         // A tab item should only control tab panels.
1623         if (!tabPanel || tabPanel->roleValue() != TabPanelRole)
1624             continue;
1625         
1626         AccessibilityObject* checkFocusElement = focusedElement;
1627         // Check if the focused element is a descendant of the element controlled by the tab item.
1628         while (checkFocusElement) {
1629             if (tabPanel == checkFocusElement)
1630                 return true;
1631             checkFocusElement = checkFocusElement->parentObject();
1632         }
1633     }
1634     
1635     return false;
1636 }
1637     
1638 bool AccessibilityRenderObject::isFocused() const
1639 {
1640     if (!m_renderer)
1641         return false;
1642     
1643     Document& document = m_renderer->document();
1644
1645     Element* focusedElement = document.focusedElement();
1646     if (!focusedElement)
1647         return false;
1648     
1649     // A web area is represented by the Document node in the DOM tree, which isn't focusable.
1650     // Check instead if the frame's selection controller is focused
1651     if (focusedElement == m_renderer->node()
1652         || (roleValue() == WebAreaRole && document.frame()->selection().isFocusedAndActive()))
1653         return true;
1654     
1655     return false;
1656 }
1657
1658 void AccessibilityRenderObject::setFocused(bool on)
1659 {
1660     if (!canSetFocusAttribute())
1661         return;
1662     
1663     Document* document = this->document();
1664     Node* node = this->node();
1665
1666     if (!on || !is<Element>(node)) {
1667         document->setFocusedElement(nullptr);
1668         return;
1669     }
1670
1671     // If this node is already the currently focused node, then calling focus() won't do anything.
1672     // That is a problem when focus is removed from the webpage to chrome, and then returns.
1673     // In these cases, we need to do what keyboard and mouse focus do, which is reset focus first.
1674     if (document->focusedElement() == node)
1675         document->setFocusedElement(nullptr);
1676
1677     setTextSelectionIntent(*this, AXTextStateChangeTypeSelectionMove);
1678     downcast<Element>(*node).focus();
1679 }
1680
1681 void AccessibilityRenderObject::setSelectedRows(AccessibilityChildrenVector& selectedRows)
1682 {
1683     // Setting selected only makes sense in trees and tables (and tree-tables).
1684     AccessibilityRole role = roleValue();
1685     if (role != TreeRole && role != TreeGridRole && role != TableRole)
1686         return;
1687     
1688     bool isMulti = isMultiSelectable();
1689     unsigned count = selectedRows.size();
1690     if (count > 1 && !isMulti)
1691         count = 1;
1692     
1693     for (const auto& selectedRow : selectedRows)
1694         selectedRow->setSelected(true);
1695 }
1696     
1697 void AccessibilityRenderObject::setValue(const String& string)
1698 {
1699     if (!m_renderer || !is<Element>(m_renderer->node()))
1700         return;
1701     Element& element = downcast<Element>(*m_renderer->node());
1702
1703     if (!is<RenderBoxModelObject>(*m_renderer))
1704         return;
1705     RenderBoxModelObject& renderer = downcast<RenderBoxModelObject>(*m_renderer);
1706
1707     // FIXME: Do we want to do anything here for ARIA textboxes?
1708     if (renderer.isTextField() && is<HTMLInputElement>(element))
1709         downcast<HTMLInputElement>(element).setValue(string);
1710     else if (renderer.isTextArea() && is<HTMLTextAreaElement>(element))
1711         downcast<HTMLTextAreaElement>(element).setValue(string);
1712 }
1713
1714 void AccessibilityRenderObject::ariaOwnsElements(AccessibilityChildrenVector& axObjects) const
1715 {
1716     ariaElementsFromAttribute(axObjects, aria_ownsAttr);
1717 }
1718
1719 bool AccessibilityRenderObject::supportsARIAOwns() const
1720 {
1721     if (!m_renderer)
1722         return false;
1723     const AtomicString& ariaOwns = getAttribute(aria_ownsAttr);
1724
1725     return !ariaOwns.isEmpty();
1726 }
1727     
1728 RenderView* AccessibilityRenderObject::topRenderer() const
1729 {
1730     Document* topDoc = topDocument();
1731     if (!topDoc)
1732         return nullptr;
1733     
1734     return topDoc->renderView();
1735 }
1736
1737 Document* AccessibilityRenderObject::document() const
1738 {
1739     if (!m_renderer)
1740         return nullptr;
1741     return &m_renderer->document();
1742 }
1743
1744 Widget* AccessibilityRenderObject::widget() const
1745 {
1746     if (!is<RenderWidget>(*m_renderer))
1747         return nullptr;
1748     return downcast<RenderWidget>(*m_renderer).widget();
1749 }
1750
1751 AccessibilityObject* AccessibilityRenderObject::accessibilityParentForImageMap(HTMLMapElement* map) const
1752 {
1753     // find an image that is using this map
1754     if (!map)
1755         return nullptr;
1756
1757     HTMLImageElement* imageElement = map->imageElement();
1758     if (!imageElement)
1759         return nullptr;
1760     
1761     if (AXObjectCache* cache = axObjectCache())
1762         return cache->getOrCreate(imageElement);
1763     
1764     return nullptr;
1765 }
1766     
1767 void AccessibilityRenderObject::getDocumentLinks(AccessibilityChildrenVector& result)
1768 {
1769     Document& document = m_renderer->document();
1770     Ref<HTMLCollection> links = document.links();
1771     for (unsigned i = 0; Node* curr = links->item(i); i++) {
1772         RenderObject* obj = curr->renderer();
1773         if (obj) {
1774             RefPtr<AccessibilityObject> axobj = document.axObjectCache()->getOrCreate(obj);
1775             ASSERT(axobj);
1776             if (!axobj->accessibilityIsIgnored() && axobj->isLink())
1777                 result.append(axobj);
1778         } else {
1779             Node* parent = curr->parentNode();
1780             if (is<HTMLAreaElement>(*curr) && is<HTMLMapElement>(parent)) {
1781                 auto& areaObject = downcast<AccessibilityImageMapLink>(*axObjectCache()->getOrCreate(ImageMapLinkRole));
1782                 HTMLMapElement& map = downcast<HTMLMapElement>(*parent);
1783                 areaObject.setHTMLAreaElement(downcast<HTMLAreaElement>(curr));
1784                 areaObject.setHTMLMapElement(&map);
1785                 areaObject.setParent(accessibilityParentForImageMap(&map));
1786
1787                 result.append(&areaObject);
1788             }
1789         }
1790     }
1791 }
1792
1793 FrameView* AccessibilityRenderObject::documentFrameView() const 
1794
1795     if (!m_renderer)
1796         return nullptr;
1797
1798     // this is the RenderObject's Document's Frame's FrameView 
1799     return &m_renderer->view().frameView();
1800 }
1801
1802 Widget* AccessibilityRenderObject::widgetForAttachmentView() const
1803 {
1804     if (!isAttachment())
1805         return nullptr;
1806     return downcast<RenderWidget>(*m_renderer).widget();
1807 }
1808
1809 // This function is like a cross-platform version of - (WebCoreTextMarkerRange*)textMarkerRange. It returns
1810 // a Range that we can convert to a WebCoreTextMarkerRange in the Obj-C file
1811 VisiblePositionRange AccessibilityRenderObject::visiblePositionRange() const
1812 {
1813     if (!m_renderer)
1814         return VisiblePositionRange();
1815     
1816     // construct VisiblePositions for start and end
1817     Node* node = m_renderer->node();
1818     if (!node)
1819         return VisiblePositionRange();
1820
1821     VisiblePosition startPos = firstPositionInOrBeforeNode(node);
1822     VisiblePosition endPos = lastPositionInOrAfterNode(node);
1823
1824     // the VisiblePositions are equal for nodes like buttons, so adjust for that
1825     // FIXME: Really?  [button, 0] and [button, 1] are distinct (before and after the button)
1826     // I expect this code is only hit for things like empty divs?  In which case I don't think
1827     // the behavior is correct here -- eseidel
1828     if (startPos == endPos) {
1829         endPos = endPos.next();
1830         if (endPos.isNull())
1831             endPos = startPos;
1832     }
1833
1834     return VisiblePositionRange(startPos, endPos);
1835 }
1836
1837 VisiblePositionRange AccessibilityRenderObject::visiblePositionRangeForLine(unsigned lineCount) const
1838 {
1839     if (!lineCount || !m_renderer)
1840         return VisiblePositionRange();
1841     
1842     // iterate over the lines
1843     // FIXME: this is wrong when lineNumber is lineCount+1,  because nextLinePosition takes you to the
1844     // last offset of the last line
1845     VisiblePosition visiblePos = m_renderer->view().positionForPoint(IntPoint(), nullptr);
1846     VisiblePosition savedVisiblePos;
1847     while (--lineCount) {
1848         savedVisiblePos = visiblePos;
1849         visiblePos = nextLinePosition(visiblePos, 0);
1850         if (visiblePos.isNull() || visiblePos == savedVisiblePos)
1851             return VisiblePositionRange();
1852     }
1853     
1854     // make a caret selection for the marker position, then extend it to the line
1855     // NOTE: ignores results of sel.modify because it returns false when
1856     // starting at an empty line.  The resulting selection in that case
1857     // will be a caret at visiblePos.
1858     FrameSelection selection;
1859     selection.setSelection(VisibleSelection(visiblePos));
1860     selection.modify(FrameSelection::AlterationExtend, DirectionRight, LineBoundary);
1861     
1862     return VisiblePositionRange(selection.selection().visibleStart(), selection.selection().visibleEnd());
1863 }
1864     
1865 VisiblePosition AccessibilityRenderObject::visiblePositionForIndex(int index) const
1866 {
1867     if (!m_renderer)
1868         return VisiblePosition();
1869
1870     if (isNativeTextControl())
1871         return downcast<RenderTextControl>(*m_renderer).textFormControlElement().visiblePositionForIndex(index);
1872
1873     if (!allowsTextRanges() && !is<RenderText>(*m_renderer))
1874         return VisiblePosition();
1875     
1876     Node* node = m_renderer->node();
1877     if (!node)
1878         return VisiblePosition();
1879
1880     return visiblePositionForIndexUsingCharacterIterator(node, index);
1881 }
1882     
1883 int AccessibilityRenderObject::indexForVisiblePosition(const VisiblePosition& pos) const
1884 {
1885     if (isNativeTextControl())
1886         return downcast<RenderTextControl>(*m_renderer).textFormControlElement().indexForVisiblePosition(pos);
1887
1888     if (!isTextControl())
1889         return 0;
1890     
1891     Node* node = m_renderer->node();
1892     if (!node)
1893         return 0;
1894
1895     Position indexPosition = pos.deepEquivalent();
1896     if (indexPosition.isNull() || highestEditableRoot(indexPosition, HasEditableAXRole) != node)
1897         return 0;
1898
1899 #if PLATFORM(GTK)
1900     // We need to consider replaced elements for GTK, as they will be
1901     // presented with the 'object replacement character' (0xFFFC).
1902     bool forSelectionPreservation = true;
1903 #else
1904     bool forSelectionPreservation = false;
1905 #endif
1906
1907     return WebCore::indexForVisiblePosition(node, pos, forSelectionPreservation);
1908 }
1909
1910 Element* AccessibilityRenderObject::rootEditableElementForPosition(const Position& position) const
1911 {
1912     // Find the root editable or pseudo-editable (i.e. having an editable ARIA role) element.
1913     Element* result = nullptr;
1914     
1915     Element* rootEditableElement = position.rootEditableElement();
1916
1917     for (Element* e = position.element(); e && e != rootEditableElement; e = e->parentElement()) {
1918         if (nodeIsTextControl(e))
1919             result = e;
1920         if (e->hasTagName(bodyTag))
1921             break;
1922     }
1923
1924     if (result)
1925         return result;
1926
1927     return rootEditableElement;
1928 }
1929
1930 bool AccessibilityRenderObject::nodeIsTextControl(const Node* node) const
1931 {
1932     if (!node)
1933         return false;
1934
1935     if (AXObjectCache* cache = axObjectCache()) {
1936         if (AccessibilityObject* axObjectForNode = cache->getOrCreate(const_cast<Node*>(node)))
1937             return axObjectForNode->isTextControl();
1938     }
1939
1940     return false;
1941 }
1942
1943 IntRect AccessibilityRenderObject::boundsForVisiblePositionRange(const VisiblePositionRange& visiblePositionRange) const
1944 {
1945     if (visiblePositionRange.isNull())
1946         return IntRect();
1947     
1948     // Create a mutable VisiblePositionRange.
1949     VisiblePositionRange range(visiblePositionRange);
1950     LayoutRect rect1 = range.start.absoluteCaretBounds();
1951     LayoutRect rect2 = range.end.absoluteCaretBounds();
1952     
1953     // readjust for position at the edge of a line.  This is to exclude line rect that doesn't need to be accounted in the range bounds
1954     if (rect2.y() != rect1.y()) {
1955         VisiblePosition endOfFirstLine = endOfLine(range.start);
1956         if (range.start == endOfFirstLine) {
1957             range.start.setAffinity(DOWNSTREAM);
1958             rect1 = range.start.absoluteCaretBounds();
1959         }
1960         if (range.end == endOfFirstLine) {
1961             range.end.setAffinity(UPSTREAM);
1962             rect2 = range.end.absoluteCaretBounds();
1963         }
1964     }
1965     
1966     LayoutRect ourrect = rect1;
1967     ourrect.unite(rect2);
1968     
1969     // if the rectangle spans lines and contains multiple text chars, use the range's bounding box intead
1970     if (rect1.maxY() != rect2.maxY()) {
1971         RefPtr<Range> dataRange = makeRange(range.start, range.end);
1972         LayoutRect boundingBox = dataRange->boundingBox();
1973         String rangeString = plainText(dataRange.get());
1974         if (rangeString.length() > 1 && !boundingBox.isEmpty())
1975             ourrect = boundingBox;
1976     }
1977     
1978 #if PLATFORM(MAC)
1979     return m_renderer->view().frameView().contentsToScreen(snappedIntRect(ourrect));
1980 #else
1981     return snappedIntRect(ourrect);
1982 #endif
1983 }
1984     
1985 void AccessibilityRenderObject::setSelectedVisiblePositionRange(const VisiblePositionRange& range) const
1986 {
1987     if (range.start.isNull() || range.end.isNull())
1988         return;
1989
1990     // make selection and tell the document to use it. if it's zero length, then move to that position
1991     if (range.start == range.end) {
1992         setTextSelectionIntent(*this, AXTextStateChangeTypeSelectionMove);
1993         m_renderer->frame().selection().moveTo(range.start, UserTriggered);
1994     }
1995     else {
1996         setTextSelectionIntent(*this, AXTextStateChangeTypeSelectionExtend);
1997         VisibleSelection newSelection = VisibleSelection(range.start, range.end);
1998         m_renderer->frame().selection().setSelection(newSelection, FrameSelection::defaultSetSelectionOptions());
1999     }
2000 }
2001
2002 VisiblePosition AccessibilityRenderObject::visiblePositionForPoint(const IntPoint& point) const
2003 {
2004     if (!m_renderer)
2005         return VisiblePosition();
2006
2007     // convert absolute point to view coordinates
2008     RenderView* renderView = topRenderer();
2009     if (!renderView)
2010         return VisiblePosition();
2011
2012 #if PLATFORM(COCOA)
2013     FrameView* frameView = &renderView->frameView();
2014 #endif
2015
2016     Node* innerNode = nullptr;
2017     
2018     // locate the node containing the point
2019     LayoutPoint pointResult;
2020     while (1) {
2021         LayoutPoint ourpoint;
2022 #if PLATFORM(MAC)
2023         ourpoint = frameView->screenToContents(point);
2024 #else
2025         ourpoint = point;
2026 #endif
2027         HitTestRequest request(HitTestRequest::ReadOnly |
2028                                HitTestRequest::Active);
2029         HitTestResult result(ourpoint);
2030         renderView->hitTest(request, result);
2031         innerNode = result.innerNode();
2032         if (!innerNode)
2033             return VisiblePosition();
2034         
2035         RenderObject* renderer = innerNode->renderer();
2036         if (!renderer)
2037             return VisiblePosition();
2038         
2039         pointResult = result.localPoint();
2040
2041         // done if hit something other than a widget
2042         if (!is<RenderWidget>(*renderer))
2043             break;
2044
2045         // descend into widget (FRAME, IFRAME, OBJECT...)
2046         Widget* widget = downcast<RenderWidget>(*renderer).widget();
2047         if (!is<FrameView>(widget))
2048             break;
2049         Frame& frame = downcast<FrameView>(*widget).frame();
2050         renderView = frame.document()->renderView();
2051 #if PLATFORM(COCOA)
2052         frameView = downcast<FrameView>(widget);
2053 #endif
2054     }
2055     
2056     return innerNode->renderer()->positionForPoint(pointResult, nullptr);
2057 }
2058
2059 // NOTE: Consider providing this utility method as AX API
2060 VisiblePosition AccessibilityRenderObject::visiblePositionForIndex(unsigned indexValue, bool lastIndexOK) const
2061 {
2062     if (!isTextControl())
2063         return VisiblePosition();
2064     
2065     // lastIndexOK specifies whether the position after the last character is acceptable
2066     if (indexValue >= text().length()) {
2067         if (!lastIndexOK || indexValue > text().length())
2068             return VisiblePosition();
2069     }
2070     VisiblePosition position = visiblePositionForIndex(indexValue);
2071     position.setAffinity(DOWNSTREAM);
2072     return position;
2073 }
2074
2075 // NOTE: Consider providing this utility method as AX API
2076 int AccessibilityRenderObject::index(const VisiblePosition& position) const
2077 {
2078     if (position.isNull() || !isTextControl())
2079         return -1;
2080
2081     if (renderObjectContainsPosition(m_renderer, position.deepEquivalent()))
2082         return indexForVisiblePosition(position);
2083     
2084     return -1;
2085 }
2086
2087 void AccessibilityRenderObject::lineBreaks(Vector<int>& lineBreaks) const
2088 {
2089     if (!isTextControl())
2090         return;
2091
2092     VisiblePosition visiblePos = visiblePositionForIndex(0);
2093     VisiblePosition savedVisiblePos = visiblePos;
2094     visiblePos = nextLinePosition(visiblePos, 0);
2095     while (!visiblePos.isNull() && visiblePos != savedVisiblePos) {
2096         lineBreaks.append(indexForVisiblePosition(visiblePos));
2097         savedVisiblePos = visiblePos;
2098         visiblePos = nextLinePosition(visiblePos, 0);
2099     }
2100 }
2101
2102 // Given a line number, the range of characters of the text associated with this accessibility
2103 // object that contains the line number.
2104 PlainTextRange AccessibilityRenderObject::doAXRangeForLine(unsigned lineNumber) const
2105 {
2106     if (!isTextControl())
2107         return PlainTextRange();
2108     
2109     // iterate to the specified line
2110     VisiblePosition visiblePos = visiblePositionForIndex(0);
2111     VisiblePosition savedVisiblePos;
2112     for (unsigned lineCount = lineNumber; lineCount; lineCount -= 1) {
2113         savedVisiblePos = visiblePos;
2114         visiblePos = nextLinePosition(visiblePos, 0);
2115         if (visiblePos.isNull() || visiblePos == savedVisiblePos)
2116             return PlainTextRange();
2117     }
2118
2119     // Get the end of the line based on the starting position.
2120     VisiblePosition endPosition = endOfLine(visiblePos);
2121
2122     int index1 = indexForVisiblePosition(visiblePos);
2123     int index2 = indexForVisiblePosition(endPosition);
2124     
2125     // add one to the end index for a line break not caused by soft line wrap (to match AppKit)
2126     if (endPosition.affinity() == DOWNSTREAM && endPosition.next().isNotNull())
2127         index2 += 1;
2128     
2129     // return nil rather than an zero-length range (to match AppKit)
2130     if (index1 == index2)
2131         return PlainTextRange();
2132     
2133     return PlainTextRange(index1, index2 - index1);
2134 }
2135
2136 // The composed character range in the text associated with this accessibility object that
2137 // is specified by the given index value. This parameterized attribute returns the complete
2138 // range of characters (including surrogate pairs of multi-byte glyphs) at the given index.
2139 PlainTextRange AccessibilityRenderObject::doAXRangeForIndex(unsigned index) const
2140 {
2141     if (!isTextControl())
2142         return PlainTextRange();
2143     
2144     String elementText = text();
2145     if (!elementText.length() || index > elementText.length() - 1)
2146         return PlainTextRange();
2147     
2148     return PlainTextRange(index, 1);
2149 }
2150
2151 // A substring of the text associated with this accessibility object that is
2152 // specified by the given character range.
2153 String AccessibilityRenderObject::doAXStringForRange(const PlainTextRange& range) const
2154 {
2155     if (!range.length)
2156         return String();
2157     
2158     if (!isTextControl())
2159         return String();
2160     
2161     String elementText = isPasswordField() ? passwordFieldValue() : text();
2162     return elementText.substring(range.start, range.length);
2163 }
2164
2165 // The bounding rectangle of the text associated with this accessibility object that is
2166 // specified by the given range. This is the bounding rectangle a sighted user would see
2167 // on the display screen, in pixels.
2168 IntRect AccessibilityRenderObject::doAXBoundsForRange(const PlainTextRange& range) const
2169 {
2170     if (allowsTextRanges())
2171         return boundsForVisiblePositionRange(visiblePositionRangeForRange(range));
2172     return IntRect();
2173 }
2174
2175 AccessibilityObject* AccessibilityRenderObject::accessibilityImageMapHitTest(HTMLAreaElement* area, const IntPoint& point) const
2176 {
2177     if (!area)
2178         return nullptr;
2179
2180     AccessibilityObject* parent = nullptr;
2181     for (Element* mapParent = area->parentElement(); mapParent; mapParent = mapParent->parentElement()) {
2182         if (is<HTMLMapElement>(*mapParent)) {
2183             parent = accessibilityParentForImageMap(downcast<HTMLMapElement>(mapParent));
2184             break;
2185         }
2186     }
2187     if (!parent)
2188         return nullptr;
2189     
2190     for (const auto& child : parent->children()) {
2191         if (child->elementRect().contains(point))
2192             return child.get();
2193     }
2194     
2195     return nullptr;
2196 }
2197
2198 AccessibilityObject* AccessibilityRenderObject::remoteSVGElementHitTest(const IntPoint& point) const
2199 {
2200     AccessibilityObject* remote = remoteSVGRootElement();
2201     if (!remote)
2202         return nullptr;
2203     
2204     IntSize offset = point - roundedIntPoint(boundingBoxRect().location());
2205     return remote->accessibilityHitTest(IntPoint(offset));
2206 }
2207
2208 AccessibilityObject* AccessibilityRenderObject::elementAccessibilityHitTest(const IntPoint& point) const
2209 {
2210     if (isSVGImage())
2211         return remoteSVGElementHitTest(point);
2212     
2213     return AccessibilityObject::elementAccessibilityHitTest(point);
2214 }
2215     
2216 AccessibilityObject* AccessibilityRenderObject::accessibilityHitTest(const IntPoint& point) const
2217 {
2218     if (!m_renderer || !m_renderer->hasLayer())
2219         return nullptr;
2220     
2221     m_renderer->document().updateLayout();
2222
2223     RenderLayer* layer = downcast<RenderBox>(*m_renderer).layer();
2224      
2225     HitTestRequest request(HitTestRequest::ReadOnly | HitTestRequest::Active | HitTestRequest::AccessibilityHitTest);
2226     HitTestResult hitTestResult = HitTestResult(point);
2227     layer->hitTest(request, hitTestResult);
2228     if (!hitTestResult.innerNode())
2229         return nullptr;
2230     Node* node = hitTestResult.innerNode()->deprecatedShadowAncestorNode();
2231     ASSERT(node);
2232
2233     if (is<HTMLAreaElement>(*node))
2234         return accessibilityImageMapHitTest(downcast<HTMLAreaElement>(node), point);
2235     
2236     if (is<HTMLOptionElement>(*node))
2237         node = downcast<HTMLOptionElement>(*node).ownerSelectElement();
2238     
2239     RenderObject* obj = node->renderer();
2240     if (!obj)
2241         return nullptr;
2242     
2243     AccessibilityObject* result = obj->document().axObjectCache()->getOrCreate(obj);
2244     result->updateChildrenIfNecessary();
2245
2246     // Allow the element to perform any hit-testing it might need to do to reach non-render children.
2247     result = result->elementAccessibilityHitTest(point);
2248     
2249     if (result && result->accessibilityIsIgnored()) {
2250         // If this element is the label of a control, a hit test should return the control.
2251         AccessibilityObject* controlObject = result->correspondingControlForLabelElement();
2252         if (controlObject && !controlObject->exposesTitleUIElement())
2253             return controlObject;
2254
2255         result = result->parentObjectUnignored();
2256     }
2257
2258     return result;
2259 }
2260
2261 bool AccessibilityRenderObject::shouldNotifyActiveDescendant() const
2262 {
2263     // We want to notify that the combo box has changed its active descendant,
2264     // but we do not want to change the focus, because focus should remain with the combo box.
2265     if (isComboBox())
2266         return true;
2267     
2268     return shouldFocusActiveDescendant();
2269 }
2270
2271 bool AccessibilityRenderObject::shouldFocusActiveDescendant() const
2272 {
2273     switch (ariaRoleAttribute()) {
2274     case GroupRole:
2275     case ListBoxRole:
2276     case MenuRole:
2277     case MenuBarRole:
2278     case RadioGroupRole:
2279     case RowRole:
2280     case PopUpButtonRole:
2281     case ProgressIndicatorRole:
2282     case ToolbarRole:
2283     case OutlineRole:
2284     case TreeRole:
2285     case GridRole:
2286     /* FIXME: replace these with actual roles when they are added to AccessibilityRole
2287     composite
2288     alert
2289     alertdialog
2290     status
2291     timer
2292     */
2293         return true;
2294     default:
2295         return false;
2296     }
2297 }
2298
2299 AccessibilityObject* AccessibilityRenderObject::activeDescendant() const
2300 {
2301     if (!m_renderer)
2302         return nullptr;
2303     
2304     const AtomicString& activeDescendantAttrStr = getAttribute(aria_activedescendantAttr);
2305     if (activeDescendantAttrStr.isNull() || activeDescendantAttrStr.isEmpty())
2306         return nullptr;
2307     
2308     Element* element = this->element();
2309     if (!element)
2310         return nullptr;
2311     
2312     Element* target = element->treeScope().getElementById(activeDescendantAttrStr);
2313     if (!target)
2314         return nullptr;
2315     
2316     if (AXObjectCache* cache = axObjectCache()) {
2317         AccessibilityObject* obj = cache->getOrCreate(target);
2318         if (obj && obj->isAccessibilityRenderObject())
2319             // an activedescendant is only useful if it has a renderer, because that's what's needed to post the notification
2320             return obj;
2321     }
2322     
2323     return nullptr;
2324 }
2325
2326 void AccessibilityRenderObject::handleAriaExpandedChanged()
2327 {
2328     // Find if a parent of this object should handle aria-expanded changes.
2329     AccessibilityObject* containerParent = this->parentObject();
2330     while (containerParent) {
2331         bool foundParent = false;
2332         
2333         switch (containerParent->roleValue()) {
2334         case TreeRole:
2335         case TreeGridRole:
2336         case GridRole:
2337         case TableRole:
2338         case BrowserRole:
2339             foundParent = true;
2340             break;
2341         default:
2342             break;
2343         }
2344         
2345         if (foundParent)
2346             break;
2347         
2348         containerParent = containerParent->parentObject();
2349     }
2350     
2351     // Post that the row count changed.
2352     AXObjectCache* cache = axObjectCache();
2353     if (!cache)
2354         return;
2355     
2356     if (containerParent)
2357         cache->postNotification(containerParent, document(), AXObjectCache::AXRowCountChanged);
2358
2359     // Post that the specific row either collapsed or expanded.
2360     if (roleValue() == RowRole || roleValue() == TreeItemRole)
2361         cache->postNotification(this, document(), isExpanded() ? AXObjectCache::AXRowExpanded : AXObjectCache::AXRowCollapsed);
2362     else
2363         cache->postNotification(this, document(), AXObjectCache::AXExpandedChanged);
2364 }
2365
2366 void AccessibilityRenderObject::handleActiveDescendantChanged()
2367 {
2368     Element* element = downcast<Element>(renderer()->node());
2369     if (!element)
2370         return;
2371     if (!renderer()->frame().selection().isFocusedAndActive() || renderer()->document().focusedElement() != element)
2372         return;
2373
2374     if (activeDescendant() && shouldNotifyActiveDescendant())
2375         renderer()->document().axObjectCache()->postNotification(m_renderer, AXObjectCache::AXActiveDescendantChanged);
2376 }
2377
2378 AccessibilityObject* AccessibilityRenderObject::correspondingControlForLabelElement() const
2379 {
2380     HTMLLabelElement* labelElement = labelElementContainer();
2381     if (!labelElement)
2382         return nullptr;
2383     
2384     HTMLElement* correspondingControl = labelElement->control();
2385     if (!correspondingControl)
2386         return nullptr;
2387
2388     // Make sure the corresponding control isn't a descendant of this label that's in the middle of being destroyed.
2389     if (correspondingControl->renderer() && !correspondingControl->renderer()->parent())
2390         return nullptr;
2391     
2392     return axObjectCache()->getOrCreate(correspondingControl);     
2393 }
2394
2395 AccessibilityObject* AccessibilityRenderObject::correspondingLabelForControlElement() const
2396 {
2397     if (!m_renderer)
2398         return nullptr;
2399
2400     // ARIA: section 2A, bullet #3 says if aria-labeledby or aria-label appears, it should
2401     // override the "label" element association.
2402     if (hasTextAlternative())
2403         return nullptr;
2404
2405     Node* node = m_renderer->node();
2406     if (is<HTMLElement>(node)) {
2407         if (HTMLLabelElement* label = labelForElement(downcast<HTMLElement>(node)))
2408             return axObjectCache()->getOrCreate(label);
2409     }
2410
2411     return nullptr;
2412 }
2413
2414 bool AccessibilityRenderObject::renderObjectIsObservable(RenderObject& renderer) const
2415 {
2416     // AX clients will listen for AXValueChange on a text control.
2417     if (is<RenderTextControl>(renderer))
2418         return true;
2419     
2420     // AX clients will listen for AXSelectedChildrenChanged on listboxes.
2421     Node* node = renderer.node();
2422     if (!node)
2423         return false;
2424     
2425     if (nodeHasRole(node, "listbox") || (is<RenderBoxModelObject>(renderer) && downcast<RenderBoxModelObject>(renderer).isListBox()))
2426         return true;
2427
2428     // Textboxes should send out notifications.
2429     if (nodeHasRole(node, "textbox") || (is<Element>(*node) && contentEditableAttributeIsEnabled(downcast<Element>(node))))
2430         return true;
2431     
2432     return false;
2433 }
2434     
2435 AccessibilityObject* AccessibilityRenderObject::observableObject() const
2436 {
2437     // Find the object going up the parent chain that is used in accessibility to monitor certain notifications.
2438     for (RenderObject* renderer = m_renderer; renderer && renderer->node(); renderer = renderer->parent()) {
2439         if (renderObjectIsObservable(*renderer)) {
2440             if (AXObjectCache* cache = axObjectCache())
2441                 return cache->getOrCreate(renderer);
2442         }
2443     }
2444     
2445     return nullptr;
2446 }
2447
2448 bool AccessibilityRenderObject::isDescendantOfElementType(const QualifiedName& tagName) const
2449 {
2450     for (auto& ancestor : ancestorsOfType<RenderElement>(*m_renderer)) {
2451         if (ancestor.element() && ancestor.element()->hasTagName(tagName))
2452             return true;
2453     }
2454     return false;
2455 }
2456     
2457 String AccessibilityRenderObject::expandedTextValue() const
2458 {
2459     if (AccessibilityObject* parent = parentObject()) {
2460         if (parent->hasTagName(abbrTag) || parent->hasTagName(acronymTag))
2461             return parent->getAttribute(titleAttr);
2462     }
2463     
2464     return String();
2465 }
2466
2467 bool AccessibilityRenderObject::supportsExpandedTextValue() const
2468 {
2469     if (roleValue() == StaticTextRole) {
2470         if (AccessibilityObject* parent = parentObject())
2471             return parent->hasTagName(abbrTag) || parent->hasTagName(acronymTag);
2472     }
2473     
2474     return false;
2475 }
2476
2477 AccessibilityRole AccessibilityRenderObject::determineAccessibilityRole()
2478 {
2479     if (!m_renderer)
2480         return UnknownRole;
2481
2482     if ((m_ariaRole = determineAriaRoleAttribute()) != UnknownRole)
2483         return m_ariaRole;
2484     
2485     Node* node = m_renderer->node();
2486     RenderBoxModelObject* cssBox = renderBoxModelObject();
2487
2488     if (node && node->isLink())
2489         return WebCoreLinkRole;
2490     if (node && is<HTMLImageElement>(*node) && downcast<HTMLImageElement>(*node).fastHasAttribute(usemapAttr))
2491         return ImageMapRole;
2492     if ((cssBox && cssBox->isListItem()) || (node && node->hasTagName(liTag)))
2493         return ListItemRole;
2494     if (m_renderer->isListMarker())
2495         return ListMarkerRole;
2496     if (node && node->hasTagName(buttonTag))
2497         return buttonRoleType();
2498     if (node && node->hasTagName(legendTag))
2499         return LegendRole;
2500     if (m_renderer->isText())
2501         return StaticTextRole;
2502     if (cssBox && cssBox->isImage()) {
2503         if (is<HTMLInputElement>(node))
2504             return ariaHasPopup() ? PopUpButtonRole : ButtonRole;
2505         if (isSVGImage())
2506             return SVGRootRole;
2507         return ImageRole;
2508     }
2509     
2510     if (node && node->hasTagName(canvasTag))
2511         return CanvasRole;
2512
2513     if (cssBox && cssBox->isRenderView())
2514         return WebAreaRole;
2515     
2516     if (cssBox && cssBox->isTextField()) {
2517         if (is<HTMLInputElement>(node))
2518             return downcast<HTMLInputElement>(*node).isSearchField() ? SearchFieldRole : TextFieldRole;
2519     }
2520     
2521     if (cssBox && cssBox->isTextArea())
2522         return TextAreaRole;
2523
2524     if (is<HTMLInputElement>(node)) {
2525         HTMLInputElement& input = downcast<HTMLInputElement>(*node);
2526         if (input.isCheckbox())
2527             return CheckBoxRole;
2528         if (input.isRadioButton())
2529             return RadioButtonRole;
2530         if (input.isTextButton())
2531             return buttonRoleType();
2532         // On iOS, the date field is a popup button. On other platforms this is a text field.
2533 #if PLATFORM(IOS)
2534         if (input.isDateField())
2535             return PopUpButtonRole;
2536 #endif
2537         
2538 #if ENABLE(INPUT_TYPE_COLOR)
2539         // FIXME: Shouldn't this use input.isColorControl()?
2540         const AtomicString& type = input.getAttribute(typeAttr);
2541         if (equalIgnoringCase(type, "color"))
2542             return ColorWellRole;
2543 #endif
2544     }
2545     
2546     if (hasContentEditableAttributeSet())
2547         return TextAreaRole;
2548     
2549     if (isFileUploadButton())
2550         return ButtonRole;
2551     
2552     if (cssBox && cssBox->isMenuList())
2553         return PopUpButtonRole;
2554     
2555     if (headingLevel())
2556         return HeadingRole;
2557     
2558     if (m_renderer->isSVGImage())
2559         return ImageRole;
2560     if (m_renderer->isSVGRoot())
2561         return SVGRootRole;
2562     if (node && node->hasTagName(SVGNames::gTag))
2563         return GroupRole;
2564
2565 #if ENABLE(MATHML)
2566     if (node && node->hasTagName(MathMLNames::mathTag))
2567         return DocumentMathRole;
2568 #endif
2569     // It's not clear which role a platform should choose for a math element.
2570     // Declaring a math element role should give flexibility to platforms to choose.
2571     if (isMathElement())
2572         return MathElementRole;
2573     
2574     if (node && node->hasTagName(ddTag))
2575         return DescriptionListDetailRole;
2576     
2577     if (node && node->hasTagName(dtTag))
2578         return DescriptionListTermRole;
2579
2580     if (node && node->hasTagName(dlTag))
2581         return DescriptionListRole;
2582
2583     // Check for Ruby elements
2584     if (m_renderer->isRubyText())
2585         return RubyTextRole;
2586     if (m_renderer->isRubyBase())
2587         return RubyBaseRole;
2588     if (m_renderer->isRubyRun())
2589         return RubyRunRole;
2590     if (m_renderer->isRubyBlock())
2591         return RubyBlockRole;
2592     if (m_renderer->isRubyInline())
2593         return RubyInlineRole;
2594     
2595     // This return value is what will be used if AccessibilityTableCell determines
2596     // the cell should not be treated as a cell (e.g. because it is a layout table.
2597     // In ATK, there is a distinction between generic text block elements and other
2598     // generic containers; AX API does not make this distinction.
2599     if (node && (node->hasTagName(tdTag) || node->hasTagName(thTag)))
2600 #if PLATFORM(GTK) || PLATFORM(EFL)
2601         return DivRole;
2602 #else
2603         return GroupRole;
2604 #endif
2605
2606     // Table sections should be ignored.
2607     if (m_renderer->isTableSection())
2608         return IgnoredRole;
2609
2610     if (m_renderer->isHR())
2611         return HorizontalRuleRole;
2612
2613     if (node && node->hasTagName(pTag))
2614         return ParagraphRole;
2615
2616     if (is<HTMLLabelElement>(node))
2617         return LabelRole;
2618
2619     if (node && node->hasTagName(dfnTag))
2620         return DefinitionRole;
2621
2622     if (node && node->hasTagName(divTag))
2623         return DivRole;
2624
2625     if (is<HTMLFormElement>(node))
2626         return FormRole;
2627
2628     if (node && node->hasTagName(articleTag))
2629         return DocumentArticleRole;
2630
2631     if (node && node->hasTagName(mainTag))
2632         return LandmarkMainRole;
2633
2634     if (node && node->hasTagName(navTag))
2635         return LandmarkNavigationRole;
2636
2637     if (node && node->hasTagName(asideTag))
2638         return LandmarkComplementaryRole;
2639
2640     if (node && node->hasTagName(sectionTag))
2641         return DocumentRegionRole;
2642
2643     if (node && node->hasTagName(addressTag))
2644         return LandmarkContentInfoRole;
2645
2646     if (node && node->hasTagName(blockquoteTag))
2647         return BlockquoteRole;
2648
2649     if (node && node->hasTagName(captionTag))
2650         return CaptionRole;
2651
2652     if (node && node->hasTagName(preTag))
2653         return PreRole;
2654
2655     if (is<HTMLDetailsElement>(node))
2656         return DetailsRole;
2657     if (is<HTMLSummaryElement>(node))
2658         return SummaryRole;
2659
2660 #if ENABLE(VIDEO)
2661     if (is<HTMLVideoElement>(node))
2662         return VideoRole;
2663     if (is<HTMLAudioElement>(node))
2664         return AudioRole;
2665 #endif
2666     
2667     // The HTML element should not be exposed as an element. That's what the RenderView element does.
2668     if (node && node->hasTagName(htmlTag))
2669         return IgnoredRole;
2670
2671     // There should only be one banner/contentInfo per page. If header/footer are being used within an article or section
2672     // then it should not be exposed as whole page's banner/contentInfo
2673     if (node && node->hasTagName(headerTag) && !isDescendantOfElementType(articleTag) && !isDescendantOfElementType(sectionTag))
2674         return LandmarkBannerRole;
2675     if (node && node->hasTagName(footerTag) && !isDescendantOfElementType(articleTag) && !isDescendantOfElementType(sectionTag))
2676         return FooterRole;
2677
2678     if (m_renderer->isRenderBlockFlow())
2679         return GroupRole;
2680     
2681     // If the element does not have role, but it has ARIA attributes, or accepts tab focus, accessibility should fallback to exposing it as a group.
2682     if (supportsARIAAttributes() || canSetFocusAttribute())
2683         return GroupRole;
2684     
2685     // InlineRole is the final fallback before assigning UnknownRole to an object. It makes it
2686     // possible to distinguish truly unknown objects from non-focusable inline text elements
2687     // which have an event handler or attribute suggesting possible inclusion by the platform.
2688     if (is<RenderInline>(*m_renderer)
2689         && (hasAttributesRequiredForInclusion()
2690             || (node && node->hasEventListeners())
2691             || (supportsDatetimeAttribute() && !getAttribute(datetimeAttr).isEmpty())))
2692         return InlineRole;
2693
2694     return UnknownRole;
2695 }
2696
2697 AccessibilityOrientation AccessibilityRenderObject::orientation() const
2698 {
2699     const AtomicString& ariaOrientation = getAttribute(aria_orientationAttr);
2700     if (equalIgnoringCase(ariaOrientation, "horizontal"))
2701         return AccessibilityOrientationHorizontal;
2702     if (equalIgnoringCase(ariaOrientation, "vertical"))
2703         return AccessibilityOrientationVertical;
2704
2705     if (isScrollbar())
2706         return AccessibilityOrientationVertical;
2707     
2708     return AccessibilityObject::orientation();
2709 }
2710     
2711 bool AccessibilityRenderObject::inheritsPresentationalRole() const
2712 {
2713     // ARIA states if an item can get focus, it should not be presentational.
2714     if (canSetFocusAttribute())
2715         return false;
2716     
2717     // ARIA spec says that when a parent object is presentational, and it has required child elements,
2718     // those child elements are also presentational. For example, <li> becomes presentational from <ul>.
2719     // http://www.w3.org/WAI/PF/aria/complete#presentation
2720     static NeverDestroyed<HashSet<QualifiedName>> listItemParents;
2721     static NeverDestroyed<HashSet<QualifiedName>> tableCellParents;
2722
2723     HashSet<QualifiedName>* possibleParentTagNames = nullptr;
2724     switch (roleValue()) {
2725     case ListItemRole:
2726     case ListMarkerRole:
2727         if (listItemParents.get().isEmpty()) {
2728             listItemParents.get().add(ulTag);
2729             listItemParents.get().add(olTag);
2730             listItemParents.get().add(dlTag);
2731         }
2732         possibleParentTagNames = &listItemParents.get();
2733         break;
2734     case CellRole:
2735         if (tableCellParents.get().isEmpty())
2736             tableCellParents.get().add(tableTag);
2737         possibleParentTagNames = &tableCellParents.get();
2738         break;
2739     default:
2740         break;
2741     }
2742     
2743     // Not all elements need to check for this, only ones that are required children.
2744     if (!possibleParentTagNames)
2745         return false;
2746     
2747     for (AccessibilityObject* parent = parentObject(); parent; parent = parent->parentObject()) { 
2748         if (!is<AccessibilityRenderObject>(*parent))
2749             continue;
2750         
2751         Node* node = downcast<AccessibilityRenderObject>(*parent).node();
2752         if (!is<Element>(node))
2753             continue;
2754         
2755         // If native tag of the parent element matches an acceptable name, then return
2756         // based on its presentational status.
2757         if (possibleParentTagNames->contains(downcast<Element>(node)->tagQName()))
2758             return parent->roleValue() == PresentationalRole;
2759     }
2760     
2761     return false;
2762 }
2763     
2764 bool AccessibilityRenderObject::isPresentationalChildOfAriaRole() const
2765 {
2766     // Walk the parent chain looking for a parent that has presentational children
2767     AccessibilityObject* parent;
2768     for (parent = parentObject(); parent && !parent->ariaRoleHasPresentationalChildren(); parent = parent->parentObject())
2769     { }
2770     
2771     return parent;
2772 }
2773     
2774 bool AccessibilityRenderObject::ariaRoleHasPresentationalChildren() const
2775 {
2776     switch (m_ariaRole) {
2777     case ButtonRole:
2778     case SliderRole:
2779     case ImageRole:
2780     case ProgressIndicatorRole:
2781     case SpinButtonRole:
2782     // case SeparatorRole:
2783         return true;
2784     default:
2785         return false;
2786     }
2787 }
2788
2789 bool AccessibilityRenderObject::canSetExpandedAttribute() const
2790 {
2791     // An object can be expanded if it aria-expanded is true or false.
2792     const AtomicString& ariaExpanded = getAttribute(aria_expandedAttr);
2793     return equalIgnoringCase(ariaExpanded, "true") || equalIgnoringCase(ariaExpanded, "false");
2794 }
2795
2796 bool AccessibilityRenderObject::canSetValueAttribute() const
2797 {
2798
2799     // In the event of a (Boolean)@readonly and (True/False/Undefined)@aria-readonly
2800     // value mismatch, the host language native attribute value wins.    
2801     if (isNativeTextControl())
2802         return !isReadOnly();
2803
2804     if (isMeter())
2805         return false;
2806
2807     if (equalIgnoringCase(getAttribute(aria_readonlyAttr), "true"))
2808         return false;
2809     
2810     if (equalIgnoringCase(getAttribute(aria_readonlyAttr), "false"))
2811         return true;
2812
2813     if (isProgressIndicator() || isSlider())
2814         return true;
2815
2816     if (isTextControl() && !isNativeTextControl())
2817         return true;
2818
2819     // Any node could be contenteditable, so isReadOnly should be relied upon
2820     // for this information for all elements.
2821     return !isReadOnly();
2822 }
2823
2824 bool AccessibilityRenderObject::canSetTextRangeAttributes() const
2825 {
2826     return isTextControl();
2827 }
2828
2829 void AccessibilityRenderObject::textChanged()
2830 {
2831     // If this element supports ARIA live regions, or is part of a region with an ARIA editable role,
2832     // then notify the AT of changes.
2833     AXObjectCache* cache = axObjectCache();
2834     if (!cache)
2835         return;
2836     
2837     for (RenderObject* renderParent = m_renderer; renderParent; renderParent = renderParent->parent()) {
2838         AccessibilityObject* parent = cache->get(renderParent);
2839         if (!parent)
2840             continue;
2841         
2842         if (parent->supportsARIALiveRegion())
2843             cache->postNotification(renderParent, AXObjectCache::AXLiveRegionChanged);
2844
2845         if ((parent->isARIATextControl() || parent->hasContentEditableAttributeSet()) && !parent->isNativeTextControl())
2846             cache->postNotification(renderParent, AXObjectCache::AXValueChanged);
2847     }
2848 }
2849
2850 void AccessibilityRenderObject::clearChildren()
2851 {
2852     AccessibilityObject::clearChildren();
2853     m_childrenDirty = false;
2854 }
2855
2856 void AccessibilityRenderObject::addImageMapChildren()
2857 {
2858     RenderBoxModelObject* cssBox = renderBoxModelObject();
2859     if (!is<RenderImage>(cssBox))
2860         return;
2861     
2862     HTMLMapElement* map = downcast<RenderImage>(*cssBox).imageMap();
2863     if (!map)
2864         return;
2865
2866     for (auto& area : descendantsOfType<HTMLAreaElement>(*map)) {
2867         // add an <area> element for this child if it has a link
2868         if (!area.isLink())
2869             continue;
2870         auto& areaObject = downcast<AccessibilityImageMapLink>(*axObjectCache()->getOrCreate(ImageMapLinkRole));
2871         areaObject.setHTMLAreaElement(&area);
2872         areaObject.setHTMLMapElement(map);
2873         areaObject.setParent(this);
2874         if (!areaObject.accessibilityIsIgnored())
2875             m_children.append(&areaObject);
2876         else
2877             axObjectCache()->remove(areaObject.axObjectID());
2878     }
2879 }
2880
2881 void AccessibilityRenderObject::updateChildrenIfNecessary()
2882 {
2883     if (needsToUpdateChildren())
2884         clearChildren();        
2885     
2886     AccessibilityObject::updateChildrenIfNecessary();
2887 }
2888     
2889 void AccessibilityRenderObject::addTextFieldChildren()
2890 {
2891     Node* node = this->node();
2892     if (!is<HTMLInputElement>(node))
2893         return;
2894     
2895     HTMLInputElement& input = downcast<HTMLInputElement>(*node);
2896     HTMLElement* spinButtonElement = input.innerSpinButtonElement();
2897     if (!is<SpinButtonElement>(spinButtonElement))
2898         return;
2899
2900     auto& axSpinButton = downcast<AccessibilitySpinButton>(*axObjectCache()->getOrCreate(SpinButtonRole));
2901     axSpinButton.setSpinButtonElement(downcast<SpinButtonElement>(spinButtonElement));
2902     axSpinButton.setParent(this);
2903     m_children.append(&axSpinButton);
2904 }
2905     
2906 bool AccessibilityRenderObject::isSVGImage() const
2907 {
2908     return remoteSVGRootElement();
2909 }
2910     
2911 void AccessibilityRenderObject::detachRemoteSVGRoot()
2912 {
2913     if (AccessibilitySVGRoot* root = remoteSVGRootElement())
2914         root->setParent(nullptr);
2915 }
2916
2917 AccessibilitySVGRoot* AccessibilityRenderObject::remoteSVGRootElement() const
2918 {
2919     if (!is<RenderImage>(m_renderer))
2920         return nullptr;
2921     
2922     CachedImage* cachedImage = downcast<RenderImage>(*m_renderer).cachedImage();
2923     if (!cachedImage)
2924         return nullptr;
2925     
2926     Image* image = cachedImage->image();
2927     if (!is<SVGImage>(image))
2928         return nullptr;
2929     
2930     FrameView* frameView = downcast<SVGImage>(*image).frameView();
2931     if (!frameView)
2932         return nullptr;
2933     Frame& frame = frameView->frame();
2934     
2935     Document* document = frame.document();
2936     if (!is<SVGDocument>(document))
2937         return nullptr;
2938     
2939     SVGSVGElement* rootElement = downcast<SVGDocument>(*document).rootElement();
2940     if (!rootElement)
2941         return nullptr;
2942     RenderObject* rendererRoot = rootElement->renderer();
2943     if (!rendererRoot)
2944         return nullptr;
2945     
2946     AXObjectCache* cache = frame.document()->axObjectCache();
2947     if (!cache)
2948         return nullptr;
2949     AccessibilityObject* rootSVGObject = cache->getOrCreate(rendererRoot);
2950
2951     // In order to connect the AX hierarchy from the SVG root element from the loaded resource
2952     // the parent must be set, because there's no other way to get back to who created the image.
2953     ASSERT(rootSVGObject);
2954     if (!is<AccessibilitySVGRoot>(*rootSVGObject))
2955         return nullptr;
2956     
2957     return downcast<AccessibilitySVGRoot>(rootSVGObject);
2958 }
2959     
2960 void AccessibilityRenderObject::addRemoteSVGChildren()
2961 {
2962     AccessibilitySVGRoot* root = remoteSVGRootElement();
2963     if (!root)
2964         return;
2965     
2966     root->setParent(this);
2967     
2968     if (root->accessibilityIsIgnored()) {
2969         for (const auto& child : root->children())
2970             m_children.append(child);
2971     } else
2972         m_children.append(root);
2973 }
2974
2975 void AccessibilityRenderObject::addCanvasChildren()
2976 {
2977     // Add the unrendered canvas children as AX nodes, unless we're not using a canvas renderer
2978     // because JS is disabled for example.
2979     if (!node() || !node()->hasTagName(canvasTag) || (renderer() && !renderer()->isCanvas()))
2980         return;
2981
2982     // If it's a canvas, it won't have rendered children, but it might have accessible fallback content.
2983     // Clear m_haveChildren because AccessibilityNodeObject::addChildren will expect it to be false.
2984     ASSERT(!m_children.size());
2985     m_haveChildren = false;
2986     AccessibilityNodeObject::addChildren();
2987 }
2988
2989 void AccessibilityRenderObject::addAttachmentChildren()
2990 {
2991     if (!isAttachment())
2992         return;
2993
2994     // FrameView's need to be inserted into the AX hierarchy when encountered.
2995     Widget* widget = widgetForAttachmentView();
2996     if (!widget || !widget->isFrameView())
2997         return;
2998     
2999     AccessibilityObject* axWidget = axObjectCache()->getOrCreate(widget);
3000     if (!axWidget->accessibilityIsIgnored())
3001         m_children.append(axWidget);
3002 }
3003
3004 #if PLATFORM(COCOA)
3005 void AccessibilityRenderObject::updateAttachmentViewParents()
3006 {
3007     // Only the unignored parent should set the attachment parent, because that's what is reflected in the AX 
3008     // hierarchy to the client.
3009     if (accessibilityIsIgnored())
3010         return;
3011     
3012     for (const auto& child : m_children) {
3013         if (child->isAttachment())
3014             child->overrideAttachmentParent(this);
3015     }
3016 }
3017 #endif
3018
3019 // Hidden children are those that are not rendered or visible, but are specifically marked as aria-hidden=false,
3020 // meaning that they should be exposed to the AX hierarchy.
3021 void AccessibilityRenderObject::addHiddenChildren()
3022 {
3023     Node* node = this->node();
3024     if (!node)
3025         return;
3026     
3027     // First do a quick run through to determine if we have any hidden nodes (most often we will not).
3028     // If we do have hidden nodes, we need to determine where to insert them so they match DOM order as close as possible.
3029     bool shouldInsertHiddenNodes = false;
3030     for (Node* child = node->firstChild(); child; child = child->nextSibling()) {
3031         if (!child->renderer() && isNodeAriaVisible(child)) {
3032             shouldInsertHiddenNodes = true;
3033             break;
3034         }
3035     }
3036     
3037     if (!shouldInsertHiddenNodes)
3038         return;
3039     
3040     // Iterate through all of the children, including those that may have already been added, and
3041     // try to insert hidden nodes in the correct place in the DOM order.
3042     unsigned insertionIndex = 0;
3043     for (Node* child = node->firstChild(); child; child = child->nextSibling()) {
3044         if (child->renderer()) {
3045             // Find out where the last render sibling is located within m_children.
3046             AccessibilityObject* childObject = axObjectCache()->get(child->renderer());
3047             if (childObject && childObject->accessibilityIsIgnored()) {
3048                 auto& children = childObject->children();
3049                 if (children.size())
3050                     childObject = children.last().get();
3051                 else
3052                     childObject = nullptr;
3053             }
3054
3055             if (childObject)
3056                 insertionIndex = m_children.find(childObject) + 1;
3057             continue;
3058         }
3059
3060         if (!isNodeAriaVisible(child))
3061             continue;
3062         
3063         unsigned previousSize = m_children.size();
3064         if (insertionIndex > previousSize)
3065             insertionIndex = previousSize;
3066         
3067         insertChild(axObjectCache()->getOrCreate(child), insertionIndex);
3068         insertionIndex += (m_children.size() - previousSize);
3069     }
3070 }
3071     
3072 void AccessibilityRenderObject::updateRoleAfterChildrenCreation()
3073 {
3074     // If a menu does not have valid menuitem children, it should not be exposed as a menu.
3075     if (roleValue() == MenuRole) {
3076         // Elements marked as menus must have at least one menu item child.
3077         size_t menuItemCount = 0;
3078         for (const auto& child : children()) {
3079             if (child->isMenuItem()) {
3080                 menuItemCount++;
3081                 break;
3082             }
3083         }
3084
3085         if (!menuItemCount)
3086             m_role = GroupRole;
3087     }
3088 }
3089     
3090 void AccessibilityRenderObject::addChildren()
3091 {
3092     // If the need to add more children in addition to existing children arises, 
3093     // childrenChanged should have been called, leaving the object with no children.
3094     ASSERT(!m_haveChildren); 
3095
3096     m_haveChildren = true;
3097     
3098     if (!canHaveChildren())
3099         return;
3100     
3101     for (RefPtr<AccessibilityObject> obj = firstChild(); obj; obj = obj->nextSibling())
3102         addChild(obj.get());
3103     
3104     addHiddenChildren();
3105     addAttachmentChildren();
3106     addImageMapChildren();
3107     addTextFieldChildren();
3108     addCanvasChildren();
3109     addRemoteSVGChildren();
3110     
3111 #if PLATFORM(COCOA)
3112     updateAttachmentViewParents();
3113 #endif
3114     
3115     updateRoleAfterChildrenCreation();
3116 }
3117
3118 bool AccessibilityRenderObject::canHaveChildren() const
3119 {
3120     if (!m_renderer)
3121         return false;
3122
3123     return AccessibilityNodeObject::canHaveChildren();
3124 }
3125
3126 const String AccessibilityRenderObject::ariaLiveRegionStatus() const
3127 {
3128     const AtomicString& liveRegionStatus = getAttribute(aria_liveAttr);
3129     // These roles have implicit live region status.
3130     if (liveRegionStatus.isEmpty())
3131         return defaultLiveRegionStatusForRole(roleValue());
3132
3133     return liveRegionStatus;
3134 }
3135
3136 const AtomicString& AccessibilityRenderObject::ariaLiveRegionRelevant() const
3137 {
3138     static NeverDestroyed<const AtomicString> defaultLiveRegionRelevant("additions text", AtomicString::ConstructFromLiteral);
3139     const AtomicString& relevant = getAttribute(aria_relevantAttr);
3140
3141     // Default aria-relevant = "additions text".
3142     if (relevant.isEmpty())
3143         return defaultLiveRegionRelevant;
3144     
3145     return relevant;
3146 }
3147
3148 bool AccessibilityRenderObject::ariaLiveRegionAtomic() const
3149 {
3150     const AtomicString& atomic = getAttribute(aria_atomicAttr);
3151     if (equalIgnoringCase(atomic, "true"))
3152         return true;
3153     if (equalIgnoringCase(atomic, "false"))
3154         return false;
3155     // WAI-ARIA "alert" and "status" roles have an implicit aria-atomic value of true.
3156     switch (roleValue()) {
3157     case ApplicationAlertRole:
3158     case ApplicationStatusRole:
3159         return true;
3160     default:
3161         return false;
3162     }
3163 }
3164
3165 bool AccessibilityRenderObject::ariaLiveRegionBusy() const
3166 {
3167     return elementAttributeValue(aria_busyAttr);    
3168 }
3169     
3170 void AccessibilityRenderObject::ariaSelectedRows(AccessibilityChildrenVector& result)
3171 {
3172     // Determine which rows are selected.
3173     bool isMulti = isMultiSelectable();
3174
3175     // Prefer active descendant over aria-selected.
3176     AccessibilityObject* activeDesc = activeDescendant();
3177     if (activeDesc && (activeDesc->isTreeItem() || activeDesc->isTableRow())) {
3178         result.append(activeDesc);    
3179         if (!isMulti)
3180             return;
3181     }
3182
3183     // Get all the rows.
3184     auto rowsIteration = [&](const AccessibilityChildrenVector& rows) {
3185         for (auto& row : rows) {
3186             if (row->isSelected()) {
3187                 result.append(row);
3188                 if (!isMulti)
3189                     break;
3190             }
3191         }
3192     };
3193     if (isTree()) {
3194         AccessibilityChildrenVector allRows;
3195         ariaTreeRows(allRows);
3196         rowsIteration(allRows);
3197     } else if (is<AccessibilityTable>(*this)) {
3198         auto& thisTable = downcast<AccessibilityTable>(*this);
3199         if (thisTable.isExposableThroughAccessibility() && thisTable.supportsSelectedRows())
3200             rowsIteration(thisTable.rows());
3201     }
3202 }
3203     
3204 void AccessibilityRenderObject::ariaListboxSelectedChildren(AccessibilityChildrenVector& result)
3205 {
3206     bool isMulti = isMultiSelectable();
3207
3208     for (const auto& child : children()) {
3209         // Every child should have aria-role option, and if so, check for selected attribute/state.
3210         if (child->isSelected() && child->ariaRoleAttribute() == ListBoxOptionRole) {
3211             result.append(child);
3212             if (!isMulti)
3213                 return;
3214         }
3215     }
3216 }
3217
3218 void AccessibilityRenderObject::selectedChildren(AccessibilityChildrenVector& result)
3219 {
3220     ASSERT(result.isEmpty());
3221
3222     // only listboxes should be asked for their selected children. 
3223     AccessibilityRole role = roleValue();
3224     if (role == ListBoxRole) // native list boxes would be AccessibilityListBoxes, so only check for aria list boxes
3225         ariaListboxSelectedChildren(result);
3226     else if (role == TreeRole || role == TreeGridRole || role == TableRole)
3227         ariaSelectedRows(result);
3228 }
3229
3230 void AccessibilityRenderObject::ariaListboxVisibleChildren(AccessibilityChildrenVector& result)      
3231 {
3232     if (!hasChildren())
3233         addChildren();
3234     
3235     for (const auto& child : children()) {
3236         if (child->isOffScreen())
3237             result.append(child);
3238     }
3239 }
3240
3241 void AccessibilityRenderObject::visibleChildren(AccessibilityChildrenVector& result)
3242 {
3243     ASSERT(result.isEmpty());
3244         
3245     // only listboxes are asked for their visible children. 
3246     if (ariaRoleAttribute() != ListBoxRole) { // native list boxes would be AccessibilityListBoxes, so only check for aria list boxes
3247         ASSERT_NOT_REACHED();
3248         return;
3249     }
3250     return ariaListboxVisibleChildren(result);
3251 }
3252  
3253 void AccessibilityRenderObject::tabChildren(AccessibilityChildrenVector& result)
3254 {
3255     ASSERT(roleValue() == TabListRole);
3256     
3257     for (const auto& child : children()) {
3258         if (child->isTabItem())
3259             result.append(child);
3260     }
3261 }
3262     
3263 const String& AccessibilityRenderObject::actionVerb() const
3264 {
3265 #if !PLATFORM(IOS)
3266     // FIXME: Need to add verbs for select elements.
3267     static NeverDestroyed<const String> buttonAction(AXButtonActionVerb());
3268     static NeverDestroyed<const String> textFieldAction(AXTextFieldActionVerb());
3269     static NeverDestroyed<const String> radioButtonAction(AXRadioButtonActionVerb());
3270     static NeverDestroyed<const String> checkedCheckBoxAction(AXUncheckedCheckBoxActionVerb());
3271     static NeverDestroyed<const String> uncheckedCheckBoxAction(AXUncheckedCheckBoxActionVerb());
3272     static NeverDestroyed<const String> linkAction(AXLinkActionVerb());
3273
3274     switch (roleValue()) {