1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
/*
* Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies)
* Copyright (C) 2009 Antonio Gomes <tonikitoo@webkit.org>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public License
* along with this library; see the file COPYING.LIB. If not, write to
* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef SpatialNavigation_h
#define SpatialNavigation_h
#include "FocusDirection.h"
#include "Node.h"
#include <limits>
namespace WebCore {
class Element;
class Frame;
class IntRect;
class RenderObject;
using namespace std;
inline long long maxDistance()
{
return numeric_limits<long long>::max();
}
// Spatially speaking, two given elements in a web page can be:
// 1) Fully aligned: There is a full intersection between the rects, either
// vertically or horizontally.
//
// * Horizontally * Vertically
// _
// |_| _ _ _ _ _ _
// |_|...... _ |_|_|_|_|_|_|
// |_| |_| . .
// |_|......|_| OR . .
// |_| |_| . .
// |_|......|_| _ _ _ _
// |_| |_|_|_|_|
//
//
// 2) Partially aligned: There is a partial intersection between the rects, either
// vertically or horizontally.
//
// * Horizontally * Vertically
// _ _ _ _ _ _
// |_| |_|_|_|_|_|
// |_|.... _ OR . .
// |_| |_| . .
// |_|....|_| ._._ _
// |_| |_|_|_|
// |_|
//
// 3) Or, otherwise, not aligned at all.
//
// * Horizontally * Vertically
// _ _ _ _ _
// |_| |_|_|_|_|
// |_| .
// |_| .
// . OR .
// _ . ._ _ _ _ _
// |_| |_|_|_|_|_|
// |_|
// |_|
//
// "Totally Aligned" elements are preferable candidates to move
// focus to over "Partially Aligned" ones, that on its turns are
// more preferable than "Not Aligned".
enum RectsAlignment {
None = 0,
Partial,
Full
};
struct FocusCandidate {
FocusCandidate()
: node(0)
, distance(maxDistance())
, parentDistance(maxDistance())
, alignment(None)
, parentAlignment(None)
{
}
FocusCandidate(Node* n)
: node(n)
, distance(maxDistance())
, parentDistance(maxDistance())
, alignment(None)
, parentAlignment(None)
{
}
bool isNull() const { return !node; }
Document* document() const { return node ? node->document() : 0; }
Node* node;
long long distance;
long long parentDistance;
RectsAlignment alignment;
RectsAlignment parentAlignment;
};
void distanceDataForNode(FocusDirection direction, Node* start, FocusCandidate& candidate);
bool scrollInDirection(Frame*, FocusDirection);
void scrollIntoView(Element*);
bool hasOffscreenRect(Node*);
bool isInRootDocument(Node*);
} // namspace WebCore
#endif // SpatialNavigation_h
|