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
|
// Copyright 2023 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROME_BROWSER_UI_EXTENSIONS_EXTENSION_SIDE_PANEL_UTILS_H_
#define CHROME_BROWSER_UI_EXTENSIONS_EXTENSION_SIDE_PANEL_UTILS_H_
#include <optional>
#include "extensions/common/extension_id.h"
class Browser;
namespace content {
class WebContents;
} // namespace content
namespace extensions::side_panel_util {
// Toggles the side panel for the given `extension_id` in `browser`, opening
// the panel if it is closed and closing it if it is open.
// Implemented by extension_side_panel_utils.cc in views/.
void ToggleExtensionSidePanel(Browser* browser,
const ExtensionId& extension_id);
// Opens the global side panel for the given `extension_id` in `browser`.
// If `web_contents` is specified, this will close any active side panel in
// `web_contents`; otherwise, this will not override any contextual side panels.
// This may not immediately show the side panel if `web_contents` is not the
// active tab and the active tab has an open contextual panel. No-op (and safe
// to call) if the panel is already open.
// Implemented by extension_side_panel_utils.cc in views/.
void OpenGlobalExtensionSidePanel(Browser& browser,
content::WebContents* web_contents,
const ExtensionId& extension_id);
// Opens a contextual side panel for the given `extension_id` in `browser` for
// `web_contents`. If `web_contents` is not the active tab, this will set the
// panel for that tab, but will not open the side panel until that tab is
// activated.
// Implemented by extension_side_panel_utils.cc in views/.
void OpenContextualExtensionSidePanel(Browser& browser,
content::WebContents& web_contents,
const ExtensionId& extension_id);
// Closes the global side panel for the given `extension_id` in `browser`.
// This will close the global side panel across all tabs where no contextual
// panel is active. No-op (and safe to call) if the panel is already closed.
// This function provides a programmatic way to close global side panels
// without user interaction.
// Implemented by extension_side_panel_utils.cc in views/.
void CloseGlobalExtensionSidePanel(Browser* browser,
const ExtensionId& extension_id);
// Closes the contextual side panel for the specified `extension_id` in
// `browser` associated with `web_contents`. If no contextual panel exists on
// this tab and `window_id` is not `nullopt`, checks for a global side panel
// for the same extension in `browser` and closes it across all tabs if found.
// No-op (and safe to call) if the panel is already closed.
// Implemented in extension_side_panel_utils.cc in views/.
void CloseContextualExtensionSidePanel(Browser* browser,
content::WebContents* web_contents,
const ExtensionId& extension_id,
std::optional<int> window_id);
} // namespace extensions::side_panel_util
#endif // CHROME_BROWSER_UI_EXTENSIONS_EXTENSION_SIDE_PANEL_UTILS_H_
|
