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
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
|
// Copyright 2020 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_SHELF_DRAG_HANDLE_H_
#define ASH_SHELF_DRAG_HANDLE_H_
#include "ash/ash_export.h"
#include "ash/controls/contextual_nudge.h"
#include "ash/controls/contextual_tooltip.h"
#include "ash/shelf/shelf.h"
#include "ash/shell_observer.h"
#include "ash/wm/overview/overview_observer.h"
#include "ash/wm/splitview/split_view_controller.h"
#include "ash/wm/splitview/split_view_observer.h"
#include "base/functional/callback_helpers.h"
#include "base/memory/raw_ptr.h"
#include "base/memory/weak_ptr.h"
#include "base/scoped_observation.h"
#include "base/timer/timer.h"
#include "ui/compositor/layer_animator.h"
#include "ui/views/controls/button/button.h"
#include "ui/views/view_targeter_delegate.h"
namespace ash {
class OverviewController;
class Shell;
class ASH_EXPORT DragHandle : public views::Button,
public views::ViewTargeterDelegate,
public AccessibilityObserver,
public OverviewObserver,
public ShellObserver,
public ui::ImplicitAnimationObserver,
public SplitViewObserver,
public ShelfObserver {
public:
DragHandle(float drag_handle_corner_radius, Shelf* shelf);
DragHandle(const DragHandle&) = delete;
~DragHandle() override;
DragHandle& operator=(const DragHandle&) = delete;
// views::ViewTargeterDelegate:
bool DoesIntersectRect(const views::View* target,
const gfx::Rect& rect) const override;
// Checks whether the drag handle nudge should be shown. Handles the
// |show_drag_handle_nudge_timer_|, |nudge_visible_|, and
// |show_nudge_animation_in_progress_|.
// Returns whether the nudge will be shown.
bool MaybeShowDragHandleNudge();
// Animates drag handle and tooltip for drag handle teaching users that
// swiping up on will take the user back to the home screen.
void ShowDragHandleNudge();
// Schedule showing the drag handle.
void ScheduleShowDragHandleNudge();
// Immediately begins the animation to return the drag handle back to its
// original position and hide the tooltip.
void HideDragHandleNudge(contextual_tooltip::DismissNudgeReason reason,
bool animate);
// Called when the window drag from shelf starts or ends. The drag handle
// contextual nudge will remain visible while the gesture is in progress.
void SetWindowDragFromShelfInProgress(bool gesture_in_progress);
void UpdateColor();
// views::View:
void OnGestureEvent(ui::GestureEvent* event) override;
gfx::Rect GetAnchorBoundsInScreen() const override;
void GetAccessibleNodeData(ui::AXNodeData* node_data) override;
void OnThemeChanged() override;
// OverviewObserver:
void OnOverviewModeStarting() override;
// ShellObserver:
void OnShellDestroying() override;
// SplitViewObserver:
void OnSplitViewStateChanged(SplitViewController::State previous_state,
SplitViewController::State state) override;
// ShelfObserver:
void OnHotseatStateChanged(HotseatState old_state,
HotseatState new_state) override;
ContextualNudge* drag_handle_nudge() { return drag_handle_nudge_; }
bool gesture_nudge_target_visibility() const {
return gesture_nudge_target_visibility_;
}
bool show_nudge_animation_in_progress() const {
return show_nudge_animation_in_progress_;
}
bool has_show_drag_handle_timer_for_testing() {
return show_drag_handle_nudge_timer_.IsRunning();
}
void fire_show_drag_handle_timer_for_testing() {
show_drag_handle_nudge_timer_.FireNow();
}
bool has_hide_drag_handle_timer_for_testing() {
return hide_drag_handle_nudge_timer_.IsRunning();
}
void fire_hide_drag_handle_timer_for_testing() {
hide_drag_handle_nudge_timer_.FireNow();
}
private:
// AccessibilityObserver:
void OnAccessibilityStatusChanged() override;
// Show/hide hotseat in tablet mode. This is only available when spoken
// feedback is enabled.
void ButtonPressed();
// ui::ImplicitAnimationObserver:
void OnImplicitAnimationsCompleted() override;
// Animates tooltip for drag handle gesture.
void ShowDragHandleTooltip();
// Helper function to hide the drag handle nudge. Called by
// |hide_drag_handle_nudge_timer_|.
void HideDragHandleNudgeHelper(bool hidden_by_tap, bool animate);
// Helper function to animate the drag handle for the drag handle gesture
// contextual nudge.
void AnimateDragHandleShow();
// Animates translation of the drag handle by |vertical_offset| over
// |animation_time| using |strategy|.
void ScheduleDragHandleTranslationAnimation(
int vertical_offset,
base::TimeDelta animation_time,
gfx::Tween::Type tween_type,
ui::LayerAnimator::PreemptionStrategy strategy);
// Handler for tap gesture on the contextual nudge widget. It hides the nudge.
void HandleTapOnNudge();
// Stops the timer to show the drag handle nudge.
void StopDragHandleNudgeShowTimer();
// Pointer to the shelf that owns the drag handle.
const raw_ptr<Shelf, ExperimentalAsh> shelf_;
// Timer to hide drag handle nudge if it has a timed life.
base::OneShotTimer hide_drag_handle_nudge_timer_;
// Timer to animate the drag handle and show the nudge.
base::OneShotTimer show_drag_handle_nudge_timer_;
// Tracks the target visibility of the gesture nudge.
bool gesture_nudge_target_visibility_ = false;
// Tracks whether the in app shelf to home nudge is animating to the visible
// state. Set to true when animation starts, set to false when animation
// completes.
bool show_nudge_animation_in_progress_ = false;
// Whether window drag from shelf (i.e. gesture from in-app shelf to home or
// overview) is currently in progress. If the contextual nudge is shown when
// the gesture starts, it should remain shown until the gesture ends.
// Set by ShelfLayoutManager using SetWindowDragFromShelfInProgress().
bool window_drag_from_shelf_in_progress_ = false;
// A label used to educate users about swipe gestures on the drag handle.
raw_ptr<ContextualNudge, ExperimentalAsh> drag_handle_nudge_ = nullptr;
std::unique_ptr<Shelf::ScopedAutoHideLock> auto_hide_lock_;
base::ScopedClosureRunner force_show_hotseat_resetter_;
base::ScopedObservation<SplitViewController, SplitViewObserver>
split_view_observation_{this};
base::ScopedObservation<OverviewController, OverviewObserver>
overview_observation_{this};
base::ScopedObservation<Shell, ShellObserver> shell_observation_{this};
base::WeakPtrFactory<DragHandle> weak_factory_{this};
};
} // namespace ash
#endif // ASH_SHELF_DRAG_HANDLE_H_
|
