Enum ChromeCommandGroup 

#[non_exhaustive]
pub enum ChromeCommandGroup {
    WindowAndTab,
    Document,
    BrowserChrome,
    BrowserSurface,
    History,
}

A family of Chrome commands the runtime swallows in an application window.

A Chrome style browser keeps its whole accelerator table live even when it is hosted as a child view with no browser UI, so Ctrl+N opens a real Chrome window next to the app’s and Ctrl+P prints the app’s own markup. The runtime blocks the families below by default; naming one in allow_chrome_commands lets that family run the way it would in a browser.

DevTools and zoom are not here: they follow WebviewAttributes::devtools and WebviewAttributes::zoom_hotkeys_enabled.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

WindowAndTab

Ctrl+N, Ctrl+Shift+N, Ctrl+T and the whole tab strip: new window, new incognito window, new tab, duplicate, restore, reorder, and select tab 1-8.

An app window has no tab strip for these to act on, and the windows they open are real Chrome windows the application does not own.

Document

Ctrl+P, Ctrl+S, Ctrl+U, Ctrl+O: print, print without preview, save page, view source, open file, and the PWA install and shortcut commands.

The commonest group to want back — Ctrl+P is a keystroke users expect. Note that WebviewDispatch::print prints on request without this, and that IDC_OPEN_FILE and IDC_SAVE_PAGE raise OS file dialogs.

BrowserChrome

Ctrl+L and its neighbours: focus the omnibox, the search box, the toolbar, the menu bar or the bookmarks bar, plus Home and open-current-URL.

An app window has none of that chrome, so these can only move keyboard focus somewhere the user cannot see; Home and open-current-URL additionally navigate the webview away from the app’s own UI.

BrowserSurface

Ctrl+H, Ctrl+J, Ctrl+D, Ctrl+Shift+Delete and the rest: history, downloads, bookmarks, settings, clear browsing data, the task manager, sign-in, about and feedback.

These load Chrome WebUI pages in place of the app’s UI, in the very webview the accelerator was pressed in, and expose the browsing data of every webview sharing the request context.

History

Alt+Left and Alt+Right: back and forward through the session history.

The browser is created at an internal placeholder URL and only then navigated to the app’s own, so the app’s first screen already sits on a second history entry and going back from it lands on a blank page. WebviewDispatch::go_back and go_forward work without this.

Trait Implementations

impl Clone for ChromeCommandGroup

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ChromeCommandGroup

impl Debug for ChromeCommandGroup

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for ChromeCommandGroup

impl Hash for ChromeCommandGroup

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ChromeCommandGroup

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ChromeCommandGroup