396577604a476e6dbc0f9917d0f6cdb41ef65710
[WebKit-https.git] / Source / WebCore / accessibility / mac / AccessibilityObjectMac.mm
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  * 1. Redistributions of source code must retain the above copyright
8  *    notice, this list of conditions and the following disclaimer.
9  * 2. Redistributions in binary form must reproduce the above copyright
10  *    notice, this list of conditions and the following disclaimer in the
11  *    documentation and/or other materials provided with the distribution.
12  *
13  * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
14  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE INC. OR
17  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
18  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
19  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
20  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
21  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
23  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
24  */
25
26 #import "config.h"
27 #import "AccessibilityObject.h"
28 #import "ElementAncestorIterator.h"
29 #import "HTMLFieldSetElement.h"
30 #import "RenderObject.h"
31
32 #if HAVE(ACCESSIBILITY)
33
34 #import "WebAccessibilityObjectWrapperMac.h"
35 #import "Widget.h"
36
37 namespace WebCore {
38
39 void AccessibilityObject::detachFromParent()
40 {
41     if (isAttachment())
42         overrideAttachmentParent(0);
43 }
44
45 void AccessibilityObject::overrideAttachmentParent(AccessibilityObject* parent)
46 {
47     if (!isAttachment())
48         return;
49     
50     id parentWrapper = nil;
51     if (parent) {
52         if (parent->accessibilityIsIgnored())
53             parent = parent->parentObjectUnignored();
54         parentWrapper = parent->wrapper();
55     }
56     
57     [[wrapper() attachmentView] accessibilitySetOverrideValue:parentWrapper forAttribute:NSAccessibilityParentAttribute];
58 }
59     
60 bool AccessibilityObject::accessibilityIgnoreAttachment() const
61 {
62     // FrameView attachments are now handled by AccessibilityScrollView, 
63     // so if this is the attachment, it should be ignored.
64     Widget* widget = 0;
65     if (isAttachment() && (widget = widgetForAttachmentView()) && widget->isFrameView())
66         return true;
67
68     if ([wrapper() attachmentView])
69         return [[wrapper() attachmentView] accessibilityIsIgnored];
70     
71     // Attachments are ignored by default (unless we determine that we should expose them).
72     return true;
73 }
74
75 AccessibilityObjectInclusion AccessibilityObject::accessibilityPlatformIncludesObject() const
76 {
77     if (isMenuListPopup() || isMenuListOption())
78         return IgnoreObject;
79
80     // Never expose an unknown object on the Mac. Clients of the AX API will not know what to do with it.
81     // Special case is when the unknown object is actually an attachment.
82     if (roleValue() == UnknownRole && !isAttachment())
83         return IgnoreObject;
84     
85     if (RenderObject* renderer = this->renderer()) {
86         // The legend element is ignored if it lives inside of a fieldset element that uses it to generate alternative text.
87         if (renderer->isLegend()) {
88             Element* element = this->element();
89             if (element && ancestorsOfType<HTMLFieldSetElement>(*element).first())
90                 return IgnoreObject;
91         }
92     }
93     
94     return DefaultBehavior;
95 }
96     
97 } // WebCore
98
99 #endif // HAVE(ACCESSIBILITY)