OLD | NEW |
| (Empty) |
1 // Copyright 2014 The Chromium Authors. All rights reserved. | |
2 // Use of this source code is governed by a BSD-style license that can be | |
3 // found in the LICENSE file. | |
4 | |
5 #ifndef CONTENT_BROWSER_ANDROID_OVERSCROLL_REFRESH_H_ | |
6 #define CONTENT_BROWSER_ANDROID_OVERSCROLL_REFRESH_H_ | |
7 | |
8 #include "base/macros.h" | |
9 #include "content/common/content_export.h" | |
10 #include "ui/gfx/geometry/size_f.h" | |
11 #include "ui/gfx/geometry/vector2d_f.h" | |
12 | |
13 namespace content { | |
14 | |
15 class CONTENT_EXPORT OverscrollRefreshHandler { | |
16 public: | |
17 // Signals the start of an overscrolling pull. Returns whether the handler | |
18 // will consume the overscroll gesture, in which case it will receive the | |
19 // remaining pull updates. | |
20 virtual bool PullStart() = 0; | |
21 | |
22 // Signals a pull update, where |delta| is in device pixels. | |
23 virtual void PullUpdate(float delta) = 0; | |
24 | |
25 // Signals the release of the pull, and whether the release is allowed to | |
26 // trigger the refresh action. | |
27 virtual void PullRelease(bool allow_refresh) = 0; | |
28 | |
29 // Reset the active pull state. | |
30 virtual void PullReset() = 0; | |
31 | |
32 protected: | |
33 virtual ~OverscrollRefreshHandler() {} | |
34 }; | |
35 | |
36 // Simple pull-to-refresh styled effect. Listens to scroll events, conditionally | |
37 // activating when: | |
38 // 1) The scroll begins when the page's root layer 1) has no vertical scroll | |
39 // offset and 2) lacks the overflow-y:hidden property. | |
40 // 2) The page doesn't consume the initial scroll events. | |
41 // 3) The initial scroll direction is upward. | |
42 // The actuall pull response, animation and action are delegated to the | |
43 // provided refresh handler. | |
44 class CONTENT_EXPORT OverscrollRefresh { | |
45 public: | |
46 // Minmum number of overscrolling pull events required to activate the effect. | |
47 // Useful for avoiding accidental triggering when a scroll janks (is delayed), | |
48 // capping the impulse per event. | |
49 enum { kMinPullsToActivate = 3 }; | |
50 | |
51 explicit OverscrollRefresh(OverscrollRefreshHandler* handler); | |
52 ~OverscrollRefresh(); | |
53 | |
54 // Scroll event stream listening methods. | |
55 void OnScrollBegin(); | |
56 // Returns whether the refresh was activated. | |
57 void OnScrollEnd(const gfx::Vector2dF& velocity); | |
58 | |
59 // Scroll ack listener. The effect will only be activated if the initial | |
60 // updates go unconsumed. | |
61 void OnScrollUpdateAck(bool was_consumed); | |
62 | |
63 // Returns true if the effect has consumed the |scroll_delta|. | |
64 bool WillHandleScrollUpdate(const gfx::Vector2dF& scroll_delta); | |
65 | |
66 // Release the effect (if active), preventing any associated refresh action. | |
67 void ReleaseWithoutActivation(); | |
68 | |
69 // Notify the effect of the latest scroll offset and overflow properties. | |
70 // The effect will be disabled when the offset is non-zero or overflow is | |
71 // hidden. Note: All dimensions are in device pixels. | |
72 void OnFrameUpdated(const gfx::Vector2dF& content_scroll_offset, | |
73 bool root_overflow_y_hidden); | |
74 | |
75 // Reset the effect to its inactive state, immediately detaching and | |
76 // disabling any active effects. | |
77 void Reset(); | |
78 | |
79 // Returns true if the refresh effect is either being manipulated or animated. | |
80 bool IsActive() const; | |
81 | |
82 // Returns true if the effect is waiting for an unconsumed scroll to start. | |
83 bool IsAwaitingScrollUpdateAck() const; | |
84 | |
85 private: | |
86 void Release(bool allow_refresh); | |
87 | |
88 bool scrolled_to_top_; | |
89 bool overflow_y_hidden_; | |
90 | |
91 enum ScrollConsumptionState { | |
92 DISABLED, | |
93 AWAITING_SCROLL_UPDATE_ACK, | |
94 ENABLED, | |
95 } scroll_consumption_state_; | |
96 | |
97 OverscrollRefreshHandler* const handler_; | |
98 | |
99 DISALLOW_COPY_AND_ASSIGN(OverscrollRefresh); | |
100 }; | |
101 | |
102 } // namespace content | |
103 | |
104 #endif // CONTENT_BROWSER_ANDROID_OVERSCROLL_REFRESH_H_ | |
OLD | NEW |