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
|
// Copyright 2024 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#include "chrome/browser/ui/toasts/api/toast_specification.h"
#include <memory>
#include "base/check.h"
#include "base/functional/callback.h"
#include "base/functional/callback_forward.h"
#include "base/types/pass_key.h"
#include "ui/menus/simple_menu_model.h"
ToastSpecification::Builder::Builder(const gfx::VectorIcon& icon,
int body_string_id)
: toast_specification_(
std::make_unique<ToastSpecification>(base::PassKey<Builder>(),
icon,
body_string_id)) {}
ToastSpecification::Builder::Builder(const gfx::VectorIcon& icon)
: toast_specification_(
std::make_unique<ToastSpecification>(base::PassKey<Builder>(),
icon)) {}
ToastSpecification::Builder::~Builder() {
// Verify that ToastSpecification::Builder::Build() has been called
// so the toast specification is completely built.
CHECK(!toast_specification_);
}
ToastSpecification::Builder& ToastSpecification::Builder::AddCloseButton() {
toast_specification_->AddCloseButton();
return *this;
}
ToastSpecification::Builder& ToastSpecification::Builder::AddActionButton(
int action_button_string_id,
base::RepeatingClosure closure) {
toast_specification_->AddActionButton(action_button_string_id,
std::move(closure));
return *this;
}
ToastSpecification::Builder& ToastSpecification::Builder::AddMenu() {
toast_specification_->AddMenu();
return *this;
}
ToastSpecification::Builder& ToastSpecification::Builder::AddGlobalScoped() {
toast_specification_->AddGlobalScope();
return *this;
}
ToastSpecification::Builder&
ToastSpecification::Builder::SetToastAsActionable() {
toast_specification_->SetToastAsActionable();
return *this;
}
std::unique_ptr<ToastSpecification> ToastSpecification::Builder::Build() {
ValidateSpecification();
return std::move(toast_specification_);
}
void ToastSpecification::Builder::ValidateSpecification() {
// Toasts with an action button must have a close button and not a menu.
if (toast_specification_->action_button_string_id().has_value()) {
CHECK(toast_specification_->has_close_button());
CHECK(!toast_specification_->has_menu());
}
// Toasts with a menu can't have a close button. If this behavior is needed,
// discuss with UX how to design this in a way that supports both.
if (toast_specification_->has_menu()) {
CHECK(!toast_specification_->has_close_button());
}
// Toasts can be manually set as actionable, or have close / menu buttons. Not
// both.
if (toast_specification_->has_actionable_override()) {
CHECK(!toast_specification_->has_close_button() &&
!toast_specification_->has_menu())
<< "Avoid use of SetToastAsActionable() on an already actionable toast";
}
}
ToastSpecification::ToastSpecification(
base::PassKey<ToastSpecification::Builder>,
const gfx::VectorIcon& icon,
int string_id)
: icon_(icon), body_string_id_(string_id) {}
ToastSpecification::ToastSpecification(
base::PassKey<ToastSpecification::Builder>,
const gfx::VectorIcon& icon)
: icon_(icon) {}
ToastSpecification::~ToastSpecification() = default;
void ToastSpecification::AddCloseButton() {
has_close_button_ = true;
}
void ToastSpecification::AddActionButton(int string_id,
base::RepeatingClosure closure) {
CHECK(!closure.is_null());
action_button_string_id_ = string_id;
action_button_closure_ = std::move(closure);
}
void ToastSpecification::AddMenu() {
has_menu_ = true;
}
void ToastSpecification::AddGlobalScope() {
is_global_scope_ = true;
}
void ToastSpecification::SetToastAsActionable() {
actionable_toast_override_ = true;
}
|
