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