5a24289898fd
keymap.rs
//! Help โธ Keyboard Shortcuts (โ/): every command's shortcut, editable.
//!
//! Click a shortcut, then press the new keys (Esc cancels); ร removes it, โบ restores the declared
//! one. A key another command had moves to the new command. Changes go through
//! [`crate::shortcuts::assign`] into [`crate::state::AppSettings::keymap`] (saved in `ui.json`),
//! the same path as the `app.setShortcut` command.
use egui::RichText;
use crate::LightcraftApp;
use crate::shortcuts::{self, Bindable};
use crate::theme::Tokens;
use crate::widgets::register;
const SEARCH: &str = "shortcuts-search";
const SHOW_ALL: &str = "shortcuts-show-all";
/// Draw the Keyboard Shortcuts editor: search and "show all", Reset All, one row per bindable
/// command that has a shortcut (all bindable commands when "Show commands without a shortcut" is
/// on), and the fixed non-command keys. Pending shortcut capture is processed once per frame.
pub fn body(app: &mut LightcraftApp, ui: &mut egui::Ui, t: &Tokens) {
let mac = ui.ctx().os() == egui::os::OperatingSystem::Mac;
capture(app, ui.ctx());
ui.set_min_width(560.0);
let (search_id, all_id) = (egui::Id::unique(SEARCH), egui::Id::unique(SHOW_ALL));
let mut search: String = ui.data(|d| d.get_temp(search_id)).unwrap_or_default();
let mut show_all: bool = ui.data(|d| d.get_temp(all_id)).unwrap_or(false);
ui.horizontal(|ui| {
let r = ui.add(egui::TextEdit::singleline(&mut search).hint_text(crate::i18n::tr("Search commands or keys")).desired_width(220.0));
register(ui, "field:shortcutsSearch", r.rect);
let r = ui.checkbox(&mut show_all, crate::i18n::tr("Show commands without a shortcut"));
register(ui, "check:shortcuts.showAll", r.rect);
ui.with_layout(egui::Layout::right_to_left(egui::Align::Center), |ui| {
let r = ui.add_enabled(!app.ui.settings.keymap.is_empty(), egui::Button::new(crate::i18n::tr("Reset All")));
register(ui, "button:shortcutsResetAll", r.rect);
if r.clicked() {
let _ = app.run("app.resetShortcuts", serde_json::json!({}));
app.recording_shortcut = None;
}
});
});
ui.data_mut(|d| {
d.insert_temp(search_id, search.clone());
d.insert_temp(all_id, show_all);
});
ui.label(RichText::new(crate::i18n::tr("Click a shortcut, then press the new keys (Esc cancels).")).size(11.0).color(t.text_dim));
ui.add_space(4.0);
let needle = search.trim().to_lowercase();
let mut rows: Vec<(&'static Bindable, Option<String>)> = shortcuts::bindable()
.iter()
.map(|b| (b, shortcuts::binding(&app.ui.settings.keymap, b.id, b.default).map(str::to_string)))
.filter(|(b, sc)| show_all || sc.is_some() || app.recording_shortcut.as_deref() == Some(b.id))
.filter(|(b, sc)| {
needle.is_empty()
|| crate::i18n::tr(b.label).to_lowercase().contains(&needle)
|| b.id.to_lowercase().contains(&needle)
|| sc.as_deref().is_some_and(|sc| sc.to_lowercase().contains(&needle) || menu_text(sc, mac).to_lowercase().contains(&needle))
})
.collect();
rows.sort_by_cached_key(|(b, _)| crate::i18n::tr(b.label).to_lowercase());
// a fixed height, so the dialog doesn't jump around while the search narrows the list
// (shorter on a short window, so the dialog fits it)
let h = crate::panels::dialogs::list_height(ui, 400.0);
egui::ScrollArea::vertical().max_height(h).min_scrolled_height(h).auto_shrink([false, false]).id_salt("shortcuts-list").show(ui, |ui| {
egui::Grid::new("shortcuts").striped(true).num_columns(4).spacing([12.0, 4.0]).show(ui, |ui| {
for (b, sc) in &rows {
row(app, ui, t, b, sc.as_deref(), mac);
}
if rows.is_empty() {
ui.label(RichText::new(crate::i18n::tr("No matching commands")).color(t.text_dim));
ui.end_row();
}
});
fixed_keys(app, ui, t, mac, &needle);
});
}
/// `Cmd+Shift+Z` as menus show it (`โงโZ` on macOS).
fn menu_text(sc: &str, mac: bool) -> String {
crate::menubar::shortcut_text(sc, mac)
}
/// One editable command row: its label and id, a click-to-record shortcut button, and buttons
/// that clear or restore it. The restore button is enabled when a saved binding exists or the
/// declared default is currently yielded to another command.
fn row(app: &mut LightcraftApp, ui: &mut egui::Ui, t: &Tokens, b: &Bindable, sc: Option<&str>, mac: bool) {
// a declared key that yields to another command's saved key counts as changed: โบ takes it back
let changed = app.ui.settings.keymap.contains_key(b.id) || (sc.is_none() && b.default.is_some());
let mut name = RichText::new(crate::i18n::tr(b.label)).color(t.text);
if changed {
name = name.strong();
}
// keys whose command changes in the Library grids (see `shortcuts::handle`)
let hover = match b.id {
"panel.presets" => format!("{} โ {}", b.id, crate::i18n::tr("In Photo Grid and Square Grid: Flag as Pick and advance")),
"view.softProof" => format!("{} โ {}", b.id, crate::i18n::tr("In Photo Grid and Square Grid: expand or collapse the stack")),
_ => b.id.to_string(),
};
ui.label(name).on_hover_text(hover);
let recording = app.recording_shortcut.as_deref() == Some(b.id);
let text = if recording {
RichText::new(crate::i18n::tr("Press keysโฆ")).color(egui::Color32::WHITE)
} else {
match sc {
Some(sc) => RichText::new(menu_text(sc, mac)).color(t.text),
None => RichText::new("โ").color(t.text_dim),
}
};
let r = ui.add(egui::Button::new(text).min_size(egui::vec2(110.0, 0.0)).selected(recording));
register(ui, format!("button:shortcut-{}", b.id), r.rect);
if r.clicked() {
app.recording_shortcut = if recording { None } else { Some(b.id.to_string()) };
}
ui.horizontal(|ui| {
ui.spacing_mut().item_spacing.x = 2.0;
let r = ui.add_enabled(sc.is_some(), egui::Button::new("ร").small()).on_hover_text(crate::i18n::tr("Remove shortcut"));
register(ui, format!("button:shortcutClear-{}", b.id), r.rect);
if r.clicked() {
apply(app, ui.ctx(), serde_json::json!({"id": b.id, "shortcut": null}));
}
let r = ui.add_enabled(changed, egui::Button::new("โบ").small()).on_hover_text(match b.default {
Some(d) => crate::i18n::tr_format!("Restore {}", menu_text(d, mac)),
None => crate::i18n::tr("Restore (no shortcut)").to_string(),
});
register(ui, format!("button:shortcutReset-{}", b.id), r.rect);
if r.clicked() {
apply(app, ui.ctx(), serde_json::json!({"id": b.id, "reset": true}));
}
});
ui.label(RichText::new(b.id).size(10.5).color(t.text_dim));
ui.end_row();
}
/// Keys that aren't a command's own shortcut (ratings, labels, secondary keys): listed, not editable.
/// One the user gave to a command shows struck through.
fn fixed_keys(app: &LightcraftApp, ui: &mut egui::Ui, t: &Tokens, mac: bool, needle: &str) {
let mut fixed: Vec<(String, &str)> = Vec::new();
for (sc, id, _) in shortcuts::ALIASES {
let label = shortcuts::find_bindable(id).map_or(*id, |b| b.label);
fixed.push((sc.to_string(), label));
}
for n in 0..=5 {
fixed.push((n.to_string(), ["Clear rating", "Rate โ
", "Rate โ
โ
", "Rate โ
โ
โ
", "Rate โ
โ
โ
โ
", "Rate โ
โ
โ
โ
โ
"][n]));
fixed.push((
format!("Shift+{n}"),
[
"Clear rating and advance",
"Rate โ
and advance",
"Rate โ
โ
and advance",
"Rate โ
โ
โ
and advance",
"Rate โ
โ
โ
โ
and advance",
"Rate โ
โ
โ
โ
โ
and advance",
][n],
));
}
for (sc, label) in [("6", "Red label"), ("7", "Yellow label"), ("8", "Green label"), ("9", "Blue label")] {
fixed.push((sc.to_string(), label));
}
// grid navigation (Photo Grid and Square Grid): fixed keys that belong to no single command
for (sc, label) in [
("Home", "Grid: first photo of the view"),
("End", "Grid: last photo of the view"),
("Shift+Left", "Grid: add the previous photo to the selection"),
("Shift+Right", "Grid: add the next photo to the selection"),
] {
fixed.push((sc.to_string(), label));
}
let fixed: Vec<_> = fixed
.into_iter()
.filter(|(sc, label)| {
needle.is_empty() || crate::i18n::tr(label).to_lowercase().contains(needle) || menu_text(sc, mac).to_lowercase().contains(needle)
})
.collect();
if fixed.is_empty() {
return;
}
ui.add_space(8.0);
ui.label(RichText::new(crate::i18n::tr("Fixed keys")).font(t.semibold(12.5)).color(t.text));
// keys saved for commands this build knows: an entry for an unknown command takes no key
let taken: Vec<_> = shortcuts::saved_keys(&app.ui.settings.keymap).map(|(_, k)| k).collect();
egui::Grid::new("shortcuts-fixed").striped(true).num_columns(2).spacing([12.0, 4.0]).show(ui, |ui| {
for (sc, label) in fixed {
ui.label(RichText::new(crate::i18n::tr(label)).color(t.text_label));
let mut text = RichText::new(menu_text(&sc, mac)).color(t.text_dim);
if shortcuts::parse(&sc).is_some_and(|k| taken.contains(&k)) {
text = text.strikethrough();
}
ui.label(text);
ui.end_row();
}
});
}
/// Run `app.setShortcut` and say what changed (a key taken from another command, or why not).
fn apply(app: &mut LightcraftApp, ctx: &egui::Context, params: serde_json::Value) {
match app.run("app.setShortcut", params) {
Ok(r) => {
let lost: Vec<String> = r["removedFrom"]
.as_array()
.into_iter()
.flatten()
.filter_map(|v| v.as_str())
.map(|id| shortcuts::find_bindable(id).map_or(id, |b| crate::i18n::tr(b.label)).to_string())
.collect();
if !lost.is_empty() {
app.toast_for(ctx, crate::i18n::tr_format!("Removed from {}", lost.join(", ")), 3.0);
}
}
Err(e) => app.toast_for(ctx, e, 3.0),
}
}
/// While a row is recording: the first key press becomes its shortcut, Esc cancels.
fn capture(app: &mut LightcraftApp, ctx: &egui::Context) {
let Some(id) = app.recording_shortcut.clone() else { return };
let pressed = ctx.input(|i| {
i.events.iter().find_map(|e| match e {
// โ, โง, โฅ and โ on their own arrive as keys too: keep waiting for the key they modify
egui::Event::Key { key, pressed: true, repeat: false, modifiers, .. } if !shortcuts::is_modifier(*key) => Some((*key, *modifiers)),
// the windowing layer turns โC / โX / โV (with or without other modifiers) into these
egui::Event::Copy => Some((egui::Key::C, i.modifiers)),
egui::Event::Cut => Some((egui::Key::X, i.modifiers)),
egui::Event::Paste(_) => Some((egui::Key::V, i.modifiers)),
_ => None,
})
});
let Some((key, modifiers)) = pressed else { return };
// the key press is ours: nothing else (a focused button's Space, Tab navigation) acts on it
ctx.input_mut(|i| {
i.events
.retain(|e| !matches!(e, egui::Event::Key { .. } | egui::Event::Text(_) | egui::Event::Copy | egui::Event::Cut | egui::Event::Paste(_)));
});
app.recording_shortcut = None;
if key == egui::Key::Escape && modifiers.is_none() {
return;
}
match shortcuts::format(modifiers, key) {
Some(sc) => apply(app, ctx, serde_json::json!({"id": id, "shortcut": sc})),
None => app.toast_for(ctx, crate::i18n::tr("That key can't be used as a shortcut"), 3.0),
}
}
No file is open. Choose one in the tree, or press Ctrl+O (โO on a Mac) to find one by name.
Syntax highlighting could not load. The unmodified read-only text remains available above.