Use is<>() / downcast<>() for Accessibility objects
[WebKit-https.git] / Source / WebCore / accessibility / AccessibilityTable.h
1 /*
2  * Copyright (C) 2008 Apple Inc. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  *
8  * 1.  Redistributions of source code must retain the above copyright
9  *     notice, this list of conditions and the following disclaimer.
10  * 2.  Redistributions in binary form must reproduce the above copyright
11  *     notice, this list of conditions and the following disclaimer in the
12  *     documentation and/or other materials provided with the distribution.
13  * 3.  Neither the name of Apple Inc. ("Apple") nor the names of
14  *     its contributors may be used to endorse or promote products derived
15  *     from this software without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY
18  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
19  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
20  * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY
21  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
22  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
23  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
24  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27  */
28
29 #ifndef AccessibilityTable_h
30 #define AccessibilityTable_h
31
32 #include "AccessibilityRenderObject.h"
33 #include <wtf/Forward.h>
34
35 namespace WebCore {
36
37 class AccessibilityTableCell;
38 class HTMLTableElement;
39 class RenderTableSection;
40     
41 class AccessibilityTable : public AccessibilityRenderObject {
42
43 protected:
44     explicit AccessibilityTable(RenderObject*);
45 public:
46     static PassRefPtr<AccessibilityTable> create(RenderObject*);
47     virtual ~AccessibilityTable();
48
49     virtual void init() override;
50
51     virtual AccessibilityRole roleValue() const override;
52     virtual bool isAriaTable() const { return false; }
53     
54     virtual void addChildren() override;
55     virtual void clearChildren() override;
56     
57     const AccessibilityChildrenVector& columns();
58     const AccessibilityChildrenVector& rows();
59     
60     virtual bool supportsSelectedRows() { return false; }
61     unsigned columnCount();
62     unsigned rowCount();
63     virtual int tableLevel() const override;
64     
65     virtual String title() const override;
66     
67     // all the cells in the table
68     void cells(AccessibilityChildrenVector&);
69     AccessibilityTableCell* cellForColumnAndRow(unsigned column, unsigned row);
70     
71     void columnHeaders(AccessibilityChildrenVector&);
72     void rowHeaders(AccessibilityChildrenVector&);
73     void visibleRows(AccessibilityChildrenVector&);
74     
75     // an object that contains, as children, all the objects that act as headers
76     AccessibilityObject* headerContainer();
77
78     // isAccessibilityTable is whether it is exposed as an AccessibilityTable to the platform.
79     virtual bool isAccessibilityTable() const override final;
80
81 protected:
82     AccessibilityChildrenVector m_rows;
83     AccessibilityChildrenVector m_columns;
84
85     RefPtr<AccessibilityObject> m_headerContainer;
86     bool m_isAccessibilityTable;
87
88     bool hasARIARole() const;
89
90     // isTable is whether it's an AccessibilityTable object.
91     virtual bool isTable() const override { return true; }
92     // isDataTable is whether it is exposed as an AccessibilityTable because the heuristic
93     // think this "looks" like a data-based table (instead of a table used for layout).
94     virtual bool isDataTable() const override;
95
96     virtual bool isTableExposableThroughAccessibility() const;
97     virtual bool computeAccessibilityIsIgnored() const override;
98
99 private:
100     virtual void titleElementText(Vector<AccessibilityText>&) const override;
101     HTMLTableElement* tableElement() const;
102     void addChildrenFromSection(RenderTableSection*, unsigned& maxColumnCount);
103 };
104
105 } // namespace WebCore 
106
107 SPECIALIZE_TYPE_TRAITS_ACCESSIBILITY(AccessibilityTable, isTable())
108
109 #endif // AccessibilityTable_h