ladybird/Userland/Libraries/LibGUI/CommandPalette.cpp
thankyouverycool 24d299c9c8 LibGUI+WindowServer+Applets+Taskbar: Remove active input concepts
and the CaptureInput mode. They are a source of unneeded complexity
in WindowServer and have proven prone to regressions, so this patch
replaces them with a simple input preemption scheme using Popups.

Popup windows now have ergonomics similar to menus: When open,
a popup preempts all mouse and key events for the entire window
stack; however, they are fragile and will close after WindowServer
swallows the first event outside them. This is similar to how combo
box windows and popups work in the classic Windows DE and has the
added benefit of letting the user click anywhere to dismiss a popup
without having to worry about unwanted interactions with other
widgets.
2022-11-19 16:04:42 +01:00

294 lines
9 KiB
C++

/*
* Copyright (c) 2022, Andreas Kling <kling@serenityos.org>
* Copyright (c) 2022, networkException <networkexception@serenityos.org>
* Copyright (c) 2022, the SerenityOS developers.
*
* SPDX-License-Identifier: BSD-2-Clause
*/
#include <AK/FuzzyMatch.h>
#include <AK/QuickSort.h>
#include <LibGUI/Action.h>
#include <LibGUI/ActionGroup.h>
#include <LibGUI/Application.h>
#include <LibGUI/BoxLayout.h>
#include <LibGUI/CommandPalette.h>
#include <LibGUI/FilteringProxyModel.h>
#include <LibGUI/Menu.h>
#include <LibGUI/MenuItem.h>
#include <LibGUI/Menubar.h>
#include <LibGUI/Model.h>
#include <LibGUI/Painter.h>
#include <LibGUI/TableView.h>
#include <LibGUI/TextBox.h>
#include <LibGUI/Widget.h>
#include <LibGfx/Painter.h>
namespace GUI {
enum class IconFlags : unsigned {
Checkable = 0,
Exclusive = 1,
Checked = 2,
};
AK_ENUM_BITWISE_OPERATORS(IconFlags);
class ActionIconDelegate final : public GUI::TableCellPaintingDelegate {
public:
virtual ~ActionIconDelegate() override = default;
bool should_paint(ModelIndex const& index) override
{
return index.data().is_u32();
}
virtual void paint(GUI::Painter& painter, Gfx::IntRect const& cell_rect, Gfx::Palette const& palette, ModelIndex const& index) override
{
auto flags = static_cast<IconFlags>(index.data().as_u32());
VERIFY(has_flag(flags, IconFlags::Checkable));
auto exclusive = has_flag(flags, IconFlags::Exclusive);
auto checked = has_flag(flags, IconFlags::Checked);
if (exclusive) {
Gfx::IntRect radio_rect { 0, 0, 12, 12 };
radio_rect.center_within(cell_rect);
Gfx::StylePainter::paint_radio_button(painter, radio_rect, palette, checked, false);
} else {
Gfx::IntRect radio_rect { 0, 0, 13, 13 };
radio_rect.center_within(cell_rect);
Gfx::StylePainter::paint_check_box(painter, radio_rect, palette, true, checked, false);
}
}
};
class ActionModel final : public GUI::Model {
public:
enum Column {
Icon,
Text,
Menu,
Shortcut,
__Count,
};
ActionModel(Vector<NonnullRefPtr<GUI::Action>>& actions)
: m_actions(actions)
{
}
virtual ~ActionModel() override = default;
virtual int row_count(ModelIndex const& parent_index) const override
{
if (!parent_index.is_valid())
return m_actions.size();
return 0;
}
virtual int column_count(ModelIndex const& = ModelIndex()) const override
{
return Column::__Count;
}
virtual String column_name(int) const override { return {}; }
virtual ModelIndex index(int row, int column = 0, ModelIndex const& = ModelIndex()) const override
{
return create_index(row, column, m_actions.at(row).ptr());
}
virtual Variant data(ModelIndex const& index, ModelRole role = ModelRole::Display) const override
{
if (role != ModelRole::Display)
return {};
auto& action = *static_cast<GUI::Action*>(index.internal_data());
switch (index.column()) {
case Column::Icon:
if (action.icon())
return *action.icon();
if (action.is_checkable()) {
auto flags = IconFlags::Checkable;
if (action.is_checked())
flags |= IconFlags::Checked;
if (action.group() && action.group()->is_exclusive())
flags |= IconFlags::Exclusive;
return (u32)flags;
}
return "";
case Column::Text:
return action_text(index);
case Column::Menu:
return menu_name(index);
case Column::Shortcut:
if (!action.shortcut().is_valid())
return "";
return action.shortcut().to_string();
}
VERIFY_NOT_REACHED();
}
virtual TriState data_matches(GUI::ModelIndex const& index, GUI::Variant const& term) const override
{
auto needle = term.as_string();
if (needle.is_empty())
return TriState::True;
auto haystack = String::formatted("{} {}", menu_name(index), action_text(index));
if (fuzzy_match(needle, haystack).score > 0)
return TriState::True;
return TriState::False;
}
static String action_text(ModelIndex const& index)
{
auto& action = *static_cast<GUI::Action*>(index.internal_data());
return Gfx::parse_ampersand_string(action.text());
}
static String menu_name(ModelIndex const& index)
{
auto& action = *static_cast<GUI::Action*>(index.internal_data());
if (action.menu_items().is_empty())
return {};
auto* menu_item = *action.menu_items().begin();
auto* menu = Menu::from_menu_id(menu_item->menu_id());
if (!menu)
return {};
return Gfx::parse_ampersand_string(menu->name());
}
private:
Vector<NonnullRefPtr<GUI::Action>> const& m_actions;
};
CommandPalette::CommandPalette(GUI::Window& parent_window, ScreenPosition screen_position)
: GUI::Dialog(&parent_window, screen_position)
{
set_frameless(true);
set_blocks_emoji_input(true);
resize(450, 300);
collect_actions(parent_window);
auto& main_widget = set_main_widget<GUI::Frame>();
main_widget.set_frame_shape(Gfx::FrameShape::Window);
main_widget.set_fill_with_background_color(true);
auto& layout = main_widget.set_layout<GUI::VerticalBoxLayout>();
layout.set_margins(4);
m_text_box = main_widget.add<GUI::TextBox>();
m_table_view = main_widget.add<GUI::TableView>();
m_model = adopt_ref(*new ActionModel(m_actions));
m_table_view->set_column_headers_visible(false);
m_filter_model = MUST(GUI::FilteringProxyModel::create(*m_model));
m_filter_model->set_filter_term(""sv);
m_table_view->set_column_painting_delegate(0, make<ActionIconDelegate>());
m_table_view->set_model(*m_filter_model);
m_text_box->on_change = [this] {
m_filter_model->set_filter_term(m_text_box->text());
if (m_filter_model->row_count() != 0)
m_table_view->set_cursor(m_filter_model->index(0, 0), GUI::AbstractView::SelectionUpdate::Set);
};
m_text_box->on_down_pressed = [this] {
m_table_view->move_cursor(GUI::AbstractView::CursorMovement::Down, GUI::AbstractView::SelectionUpdate::Set);
};
m_text_box->on_up_pressed = [this] {
m_table_view->move_cursor(GUI::AbstractView::CursorMovement::Up, GUI::AbstractView::SelectionUpdate::Set);
};
m_text_box->on_return_pressed = [this] {
if (!m_table_view->selection().is_empty())
finish_with_index(m_table_view->selection().first());
};
m_table_view->on_activation = [this](GUI::ModelIndex const& filter_index) {
finish_with_index(filter_index);
};
m_text_box->set_focus(true);
}
void CommandPalette::collect_actions(GUI::Window& parent_window)
{
OrderedHashTable<NonnullRefPtr<GUI::Action>> actions;
auto collect_action_children = [&](Core::Object& action_parent) {
action_parent.for_each_child_of_type<GUI::Action>([&](GUI::Action& action) {
if (action.is_enabled())
actions.set(action);
return IterationDecision::Continue;
});
};
Function<bool(GUI::Action*)> should_show_action = [&](GUI::Action* action) {
return action && action->is_enabled() && action->shortcut() != Shortcut(Mod_Ctrl | Mod_Shift, Key_A);
};
Function<void(Menu&)> collect_actions_from_menu = [&](Menu& menu) {
for (auto menu_item : menu.items()) {
if (menu_item.submenu())
collect_actions_from_menu(*menu_item.submenu());
auto* action = menu_item.action();
if (should_show_action(action))
actions.set(*action);
}
};
for (auto* widget = parent_window.focused_widget(); widget; widget = widget->parent_widget())
collect_action_children(*widget);
collect_action_children(parent_window);
parent_window.menubar().for_each_menu([&](Menu& menu) {
collect_actions_from_menu(menu);
return IterationDecision::Continue;
});
if (!parent_window.is_modal()) {
for (auto const& it : GUI::Application::the()->global_shortcut_actions({})) {
if (should_show_action(it.value))
actions.set(*it.value);
}
}
m_actions.clear();
for (auto& action : actions)
m_actions.append(action);
quick_sort(m_actions, [&](auto& a, auto& b) {
// FIXME: This is so awkward. Don't be so awkward.
return Gfx::parse_ampersand_string(a->text()) < Gfx::parse_ampersand_string(b->text());
});
}
void CommandPalette::finish_with_index(GUI::ModelIndex const& filter_index)
{
if (!filter_index.is_valid())
return;
auto action_index = m_filter_model->map(filter_index);
auto* action = static_cast<GUI::Action*>(action_index.internal_data());
VERIFY(action);
m_selected_action = action;
done(ExecResult::OK);
}
}