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
ash / accessibility / ui / accessibility_focus_ring.h [blame]
// Copyright 2014 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef ASH_ACCESSIBILITY_UI_ACCESSIBILITY_FOCUS_RING_H_
#define ASH_ACCESSIBILITY_UI_ACCESSIBILITY_FOCUS_RING_H_
#include "ash/ash_export.h"
#include "ui/gfx/geometry/point.h"
#include "ui/gfx/geometry/rect.h"
namespace ash {
// An AccessibilityFocusRing is a special type of shape designed to
// outline the focused object on the screen for users with visual
// impairments. It's specifically designed to outline text ranges that
// span multiple lines (we'll call this a "paragraph" shape from here on,
// but it works for any text range), so it can outline a shape defined by a
// few words from the first line, the complete contents of more lines,
// followed by a few words from the last line. See the figure below.
// When highlighting any other object, it outlines a rectangular shape.
//
// The outline is outset from the object it's highlighting by a few pixels;
// this margin distance also determines its border radius for rounded
// corners.
//
// An AccessibilityFocusRing can be initialized with either a rectangle
// defining the bounds of an object, or a paragraph-shape with three
// rectangles defining a top line, a body, and a bottom line, which are
// assumed to be adjacent to one another.
//
// Initializing an AccessibilityFocusRing computes the following 36 points
// that completely define the shape's outline. This shape can be traced
// using Skia or any other drawing utility just by drawing alternating
// straight lines and quadratic curves (e.g. a line from 0 to 1, a curve
// from 1 to 3 with 2 as a control point, then a line from 3 to 4, and so on.
//
// The same path should be used even if the focus ring was initialized with
// a rectangle and not a paragraph shape - this makes it possible to
// smoothly animate between one object and the next simply by interpolating
// points.
//
// Noncontiguous shapes should be handled by drawing multiple focus rings.
//
// The 36 points are defined as follows:
//
// 2 3------------------------------4 5
// / |
// 1 6
// | First line of paragraph |
// 0 7
// / |
// 32 33-34 35 8 9---------------10 11
// / |
// 31 Middle line of paragraph.......................... 12
// | |
// | |
// | Middle line of paragraph.......................... |
// | |
// | |
// 30 Middle line of paragraph.......................... 13
// | |
// 29 28---------27 26 17 16---------15 14
// | |
// 25 18
// | Last line of paragraph |
// 24 19
// | |
// 23 22-----------------------21 20
//
// Exported for tests.
struct ASH_EXPORT AccessibilityFocusRing {
// Construct an AccessibilityFocusRing that outlines a rectangular object.
static AccessibilityFocusRing CreateWithRect(const gfx::Rect& bounds,
int margin);
// Returns a ring where 0.0 returns r1, 1.0 returns r2, and any number
// in-between interpolates linearly between them.
static AccessibilityFocusRing Interpolate(const AccessibilityFocusRing& r1,
const AccessibilityFocusRing& r2,
double fraction);
// Construct an AccessibilityFocusRing that outlines a paragraph-shaped
// object.
static AccessibilityFocusRing CreateWithParagraphShape(
const gfx::Rect& top_line,
const gfx::Rect& body,
const gfx::Rect& bottom_line,
int margin);
// Gets the bounds in screen coordinates.
gfx::Rect GetBounds() const;
static void ClipToBounds(gfx::Rect* rect, const gfx::Rect& bounds);
// Gets the bounds of the screen which contains |rect|. Returns
// |screen_bounds_for_testing_| when that has been set.
static gfx::Rect GetScreenBoundsForRect(const gfx::Rect& rect);
static void set_screen_bounds_for_testing(const gfx::Rect& bounds) {
screen_bounds_for_testing_ = bounds;
}
static int GetScreenPaddingForTesting();
// Display coordinates for the focus ring. These are in the coordinate system
// of the display on which the ring will be shown.
gfx::Point points[36];
// Bounds in screen coordinates for the focus ring.
gfx::Rect bounds_in_screen;
// Returned by GetScreenBoundsForRect.
static gfx::Rect screen_bounds_for_testing_;
};
} // namespace ash
#endif // ASH_ACCESSIBILITY_UI_ACCESSIBILITY_FOCUS_RING_H_