ladybird/Userland/Libraries/LibGUI/CommandPalette.cpp
faxe1008 9e323241f8 LibGUI: Use fuzzy matching in CommandPalette
This patch changes the previously used contains method for matching the
user search term with all available commands to use the fuzzy match
algorithm, which makes it more typo tolerant.
2022-04-20 18:34:09 +02:00

294 lines
8.8 KiB
C++

/*
* Copyright (c) 2022, Andreas Kling <kling@serenityos.org>
* Copyright (c) 2022, Jakob-Niklas See <git@nwex.de>
* 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);
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("");
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);
on_active_window_change = [this](bool is_active_window) {
if (!is_active_window)
close();
};
}
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<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 const* action = menu_item.action();
if (action && action->is_enabled())
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 (it.value->is_enabled())
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(ExecOK);
}
}