Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .changeset/editor-hide-unavailable-menu-items.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
'@office-kit/pptx-editor': minor
---

The menu bar no longer shows items the editor can never run. Before, it listed every item of the reference desktop app's menus and disabled the ones the editor has no counterpart for, or that a web page cannot do (Print, Share, Export, Macro, SmartArt, the online picture and translation services, the whole Window menu, and so on), so users scanned past dozens of greyed-out entries to find the ones that work. Those items, the submenus left empty and the Window menu are now gone, and separators no longer double up. Items that are unavailable only in the current state (Cut with nothing selected, Symbol outside text, Slide Show without a host that presents) stay, disabled with the reason as their tooltip. The shortcuts of hidden items still do nothing rather than reach the browser, so ⌘P does not print the editor page.
4 changes: 2 additions & 2 deletions packages/dev/NATIVE_PARITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -117,14 +117,14 @@ Measured like the Home ribbon above (AX dumps of the reference desktop app (Mac,

Compared with the AX dump of the menu bar of the reference desktop app (Mac, 16.113.3) (every menu and submenu, English and Japanese UI, with nothing selected, a shape selected and text selected). A web page cannot own the macOS menu bar, so the title bar carries the menus in place of the old Edit and View buttons. `core/menubar-native.ts` is generated from the capture: order, separators, submenus, labels and shortcut glyphs are the reference desktop app's in both languages.

- **Menus**: File, Edit, View, Insert, Format, Arrange, Tools, Slide Show, Window and Help. The application menu ("the reference desktop app": About, Settings…, Services, Hide, Quit) is left out: those belong to the browser and the operating system, and the editor's language picker stays in the title bar. Lists that name the capture machine's state are not reproduced: Open Recent keeps only More... ⇧⌘O, and Subtitle Settings ▸ Spoken Language / Subtitle Language / Microphone have no items. Window lists this deck with the reference desktop app's • mark. U+200B in Japanese labels is stripped.
- **Menus**: File, Edit, View, Insert, Format, Arrange, Tools, Slide Show and Help. The application menu ("the reference desktop app": About, Settings…, Services, Hide, Quit) is left out: those belong to the browser and the operating system, and the editor's language picker stays in the title bar. Lists that name the capture machine's state are not reproduced. Items the editor can never run (no counterpart in the editor, or something a web page cannot do: Print, Share, Macro, SmartArt, the online services …) are left out, and so is the Window menu, whose items all belong to the browser; a submenu left empty goes too, and separators do not double up. Their shortcuts still resolve, so ⌘P does not print the page. Items unavailable only in the current state stay, disabled with the reason as their tooltip. U+200B in Japanese labels is stripped.
- **Japanese differences**, from the capture: Pick Up Object Style is ⌥⌘C (⇧⌘C in English); the Window menu has a different order; Slide Show has no Rehearse with Coach. Japanese items carry their English item's id, so one command table serves both languages.
- **States**: Undo and Repeat name the edit ("Undo Move", "Can't Repeat"); Format ▸ Apply To Defaults becomes Apply Object Style when something is selected; View ▸ Enter Full Screen becomes Exit Full Screen. Every item in the capture's enabled-state table (Cut, Copy, Duplicate, Symbol..., Action Settings..., Hyperlink..., Font..., Paragraph..., Columns..., Alignment ▸, More Options..., Pick Up / Apply Object Style, Format Object..., the stacking order, Rotate or Flip ▸ and Align or Distribute ▸ items) is enabled and checked as the reference desktop app's with nothing, a shape or text selected (Center ✓ for centred text, Align to Slide ✓). While text is being edited, the menus open without taking focus, so the caret and selection stay. A walk of every menu in the three states against the capture found no item enabled where the reference desktop app disables it except View ▸ Enter Full Screen (disabled in the capture, which the reference desktop app had in the background); the editor disables the unsupported items listed below and, with nothing selected, Insert ▸ Date and Time... and Slide Number (they insert a field into a selected text box).
- **Commands**: items run the editor's existing commands (the same ones as the ribbon and context menus). Notable mappings: File ▸ Save saves to the project (or downloads outside the development preview) and Save As... downloads; Page Setup... opens Slide Size; Properties... edits the core properties; View ▸ Show Slides toggles the thumbnail pane; Format ▸ More Options... opens Text Options ▸ Text Box; Help ▸ Editor Help opens the command search. Disabled items name the reason as a tooltip. Not available: New from Template, Save as Template, Export, Print, Close, the cloud-storage items (Move, Rename, Version History, Share ▸), Restrict Permissions, Passwords, Always Open Read-Only, Paste Special, Clear, Replace Fonts, Find Next/Previous (use the Find dialog), Rename Section (Home ▸ Section), Handout and Notes Masters, Message Bar, Markup, Slides From ▸, SmartArt ▸, 3D Models ▸, Zoom ▸, Action Buttons ▸, Icons, Equation, Object, Cameo, the online media sources, Bullets and Numbering..., Animation Painter (Animations tab), Theme Colors... (Design ▸ Variants), Spelling, Thesaurus, Translate, Set Proofing Language (Review ▸ Language), AutoCorrect, Macros, Add-ins, Rehearse with Coach, subtitles, the Window menu's window management, and the system items (AutoFill, Start Dictation, Emoji & Symbols).
- **Keyboard**: every captured shortcut is bound through the same table the menus display (`core/menubar-shortcuts.ts`) and runs its item whenever the item is enabled. Keys match by physical key, so Option's alternate characters do not matter. Control stands in for Command unless the reference desktop app gives the Control chord its own item (⌃F Advanced Find, ⌃H Replace, ⌃⌘V Paste Special, ⌃⌥⌘G Guides, ⌃⇧⇥ Show Slides), which keeps the editor's Ctrl+Z, Ctrl+T … working. While text is edited on the slide, ⌘ and ⌃ menu shortcuts act on the selected text (⌘L/⌘E/⌘R alignment, ⌘T, ⌘K, ⌥⌘M, the object-style keys, ⌥⇧⌘V Paste and Match Formatting); undo, the clipboard, Select All and ⌘↩ (which ends editing) stay with the text. In other text fields only document-wide commands run (File, the views, Slide Show, Find, New Slide, Help). A disabled item still swallows its ⌘/⌃ key, so ⌘D on text does not bookmark the page.
- **Changed keys** (to the reference desktop app's): ⌘G is Find Next, so Group is only ⌥⌘G and Ungroup ⌥⇧⌘G; ⌘K is Insert ▸ Hyperlink, and the command search moved to ⌘? (Help ▸ Editor Help); ⌥⌘C / ⌥⌘V no longer paint formatting in English — Pick Up / Apply Object Style are ⇧⌘C (⌥⌘C in Japanese) / ⇧⌘V; pasting text without formatting is ⌥⇧⌘V (was ⇧⌘V); ⌘H no longer opens Replace (⌃H does). ⌘0 still fits the slide (the status bar names it).
- **Keys a page cannot have**: the fn/Globe chords (View ▸ Enter Full Screen 🌐F; Window ▸ Fill 🌐⌃F, Center 🌐⌃C, Return to Previous Size 🌐⌃R) and the dictation/emoji keys never reach a web page. The browser or macOS keeps ⌘N, ⇧⌘N (Chrome's incognito window), ⌘W, ⌘Q, ⌘M, ⌘H, ⌘T (Chrome's new tab) and ⌃⇧⇥ (previous tab) in most browsers, and Chrome may keep ⌘1–⌘5 for tab switching outside the embedded preview; File ▸ New Presentation and Insert ▸ New Slide still run from the menus, and their keys work wherever the browser delivers them.
- Tests: `menubar.test.mjs` asserts all 33 menus and submenus (labels, separators, submenu markers, shortcut glyphs) in English and Japanese against the capture, the enabled and checked states of the capture's state table in the three selection states, and that ⌘D, ⌥⌘G, ⌥⇧⌘G, ⌘T, ⌘K, ⇧⌘1, ⇧⌘C (en) / ⌥⌘C (ja), ⌘L, ⌘E, ⌘4, ⌘1, ⇧⌘N, ⌥⌘R and ⌘? run their commands (and ⌘G and the other language's pick-up key do not). `site/test/menubar-shortcuts.test.mjs` covers glyph parsing, key matching, the Control fallback and the en/ja pairing.
- Tests: `menubar.test.mjs` asserts all 21 menus and submenus the editor shows (labels, separators, submenu markers, shortcut glyphs) in English and Japanese against the capture, the enabled and checked states of the capture's state table in the three selection states, and that ⌘D, ⌥⌘G, ⌥⇧⌘G, ⌘T, ⌘K, ⇧⌘1, ⇧⌘C (en) / ⌥⌘C (ja), ⌘L, ⌘E, ⌘4, ⌘1, ⇧⌘N, ⌥⌘R and ⌘? run their commands (and ⌘G and the other language's pick-up key do not). `site/test/menubar-shortcuts.test.mjs` covers glyph parsing, key matching, the Control fallback and the en/ja pairing.

## Text, table-cell, picture and slide-background menus (2026-10-07)

Expand Down
Loading
Loading