OLD | NEW |
(Empty) | |
| 1 // Copyright 2017 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 IOS_SHARED_CHROME_BROWSER_TABS_WEB_STATE_LIST_H_ |
| 6 #define IOS_SHARED_CHROME_BROWSER_TABS_WEB_STATE_LIST_H_ |
| 7 |
| 8 #include <memory> |
| 9 #include <vector> |
| 10 |
| 11 #include "base/compiler_specific.h" |
| 12 #include "base/macros.h" |
| 13 #include "base/observer_list.h" |
| 14 #include "ui/base/page_transition_types.h" |
| 15 |
| 16 class WebStateListDelegate; |
| 17 class WebStateListObserver; |
| 18 class WebStateListOrderController; |
| 19 struct WebStateOpener; |
| 20 |
| 21 namespace web { |
| 22 class WebState; |
| 23 } |
| 24 |
| 25 // Manages a list of WebStates. |
| 26 class WebStateList { |
| 27 public: |
| 28 explicit WebStateList(WebStateListDelegate* delegate); |
| 29 ~WebStateList(); |
| 30 |
| 31 // Returns whether the model is empty or not. |
| 32 bool empty() const { return web_state_wrappers_.empty(); } |
| 33 |
| 34 // Returns the number of WebStates in the model. |
| 35 int count() const { return static_cast<int>(web_state_wrappers_.size()); } |
| 36 |
| 37 // Returns the index of the currently active WebState, or kInvalidIndex if |
| 38 // there are no active WebState. |
| 39 int active_index() const { return active_index_; } |
| 40 |
| 41 // Returns true if the specified index is contained by the model. |
| 42 bool ContainsIndex(int index) const; |
| 43 |
| 44 // Returns the currently active WebState or null if there is none. |
| 45 web::WebState* GetActiveWebState() const; |
| 46 |
| 47 // Returns the WebState at the specified index. It is invalid to call this |
| 48 // with an index such that |ContainsIndex(index)| returns false. |
| 49 web::WebState* GetWebStateAt(int index) const; |
| 50 |
| 51 // Returns the index of the specified WebState or kInvalidIndex if the |
| 52 // WebState is not in the model. |
| 53 int GetIndexOfWebState(const web::WebState* web_state) const; |
| 54 |
| 55 // Returns information about the opener of the WebState at the specified |
| 56 // index. The structure |opener| will be null if there is no opener. |
| 57 WebStateOpener GetOpenerOfWebStateAt(int index) const; |
| 58 |
| 59 // Stores information about the opener of the WebState at the specified |
| 60 // index. The WebStateOpener |opener| must be non-null and the WebState |
| 61 // must be in WebStateList. |
| 62 void SetOpenerOfWebStateAt(int index, WebStateOpener opener); |
| 63 |
| 64 // Returns the index of the next WebState in the sequence of WebStates opened |
| 65 // from the specified WebState after |start_index|, or kInvalidIndex if there |
| 66 // are no such WebState. If |use_group| is true, the opener's navigation index |
| 67 // is used to detect navigation changes within the same session. |
| 68 int GetIndexOfNextWebStateOpenedBy(const web::WebState* opener, |
| 69 int start_index, |
| 70 bool use_group) const; |
| 71 |
| 72 // Returns the index of the last WebState in the sequence of WebStates opened |
| 73 // from the specified WebState after |start_index|, or kInvalidIndex if there |
| 74 // are no such WebState. If |use_group| is true, the opener's navigation index |
| 75 // is used to detect navigation changes within the same session. |
| 76 int GetIndexOfLastWebStateOpenedBy(const web::WebState* opener, |
| 77 int start_index, |
| 78 bool use_group) const; |
| 79 |
| 80 // Inserts the specified WebState at the specified index. |
| 81 void InsertWebState(int index, std::unique_ptr<web::WebState> web_state); |
| 82 |
| 83 // Inserts the specified WebState at the best position in the WebStateList |
| 84 // given the specified transition, opener, etc. It defaults to inserting the |
| 85 // WebState at the end of the list. |
| 86 void AppendWebState(ui::PageTransition transition, |
| 87 std::unique_ptr<web::WebState> web_state, |
| 88 WebStateOpener opener); |
| 89 |
| 90 // Moves the WebState at the specified index to another index. |
| 91 void MoveWebStateAt(int from_index, int to_index); |
| 92 |
| 93 // Replaces the WebState at the specified index with new WebState. Returns |
| 94 // the old WebState at that index to the caller (abandon ownership of the |
| 95 // returned WebState). |
| 96 std::unique_ptr<web::WebState> ReplaceWebStateAt( |
| 97 int index, |
| 98 std::unique_ptr<web::WebState> web_state); |
| 99 |
| 100 // Detaches the WebState at the specified index. Returns the detached WebState |
| 101 // to the caller (abandon ownership of the returned WebState). |
| 102 std::unique_ptr<web::WebState> DetachWebStateAt(int index); |
| 103 |
| 104 // Closes and destroys the WebState at the specified index. |
| 105 void CloseWebStateAt(int index); |
| 106 |
| 107 // Closes and destroys all WebStates. |
| 108 void CloseAllWebStates(); |
| 109 |
| 110 // Makes the WebState at the specified index the active WebState. |
| 111 void ActivateWebStateAt(int index); |
| 112 |
| 113 // Adds an observer to the model. |
| 114 void AddObserver(WebStateListObserver* observer); |
| 115 |
| 116 // Removes an observer from the model. |
| 117 void RemoveObserver(WebStateListObserver* observer); |
| 118 |
| 119 // Invalid index. |
| 120 static const int kInvalidIndex = -1; |
| 121 |
| 122 private: |
| 123 class WebStateWrapper; |
| 124 |
| 125 // Sets the opener of any WebState that reference the WebState at the |
| 126 // specified index to null. |
| 127 void ClearOpenersReferencing(int index); |
| 128 |
| 129 // Notify the observers if the active WebState change. |
| 130 void NotifyIfActiveWebStateChanged(web::WebState* old_web_state, |
| 131 bool user_action); |
| 132 |
| 133 // Returns the index of the |n|-th WebState (with n > 0) in the sequence of |
| 134 // WebStates opened from the specified WebState after |start_index|, or |
| 135 // kInvalidIndex if there are no such WebState. If |use_group| is true, the |
| 136 // opener's navigation index is used to detect navigation changes within the |
| 137 // same session. |
| 138 int GetIndexOfNthWebStateOpenedBy(const web::WebState* opener, |
| 139 int start_index, |
| 140 bool use_group, |
| 141 int n) const; |
| 142 |
| 143 // The WebStateList delegate. |
| 144 WebStateListDelegate* delegate_; |
| 145 |
| 146 // Wrappers to the WebStates hosted by the WebStateList. |
| 147 std::vector<std::unique_ptr<WebStateWrapper>> web_state_wrappers_; |
| 148 |
| 149 // An object that determines where new WebState should be inserted and where |
| 150 // selection should move when a WebState is detached. |
| 151 std::unique_ptr<WebStateListOrderController> order_controller_; |
| 152 |
| 153 // List of observers notified of changes to the model. |
| 154 base::ObserverList<WebStateListObserver, true> observers_; |
| 155 |
| 156 // Index of the currently active WebState, kInvalidIndex if no such WebState. |
| 157 int active_index_ = kInvalidIndex; |
| 158 |
| 159 DISALLOW_COPY_AND_ASSIGN(WebStateList); |
| 160 }; |
| 161 |
| 162 #endif // IOS_SHARED_CHROME_BROWSER_TABS_WEB_STATE_LIST_H_ |
OLD | NEW |