/*--------------------------------------------------------------------------------------------- * Copyright (c) Microsoft Corporation. All rights reserved. * Licensed under the MIT License. See License.txt in the project root for license information. *--------------------------------------------------------------------------------------------*/ import { RunOnceScheduler } from '../../../../vs/base/common/async'; import { Emitter, Event } from '../../../../vs/base/common/event'; import { DisposableStore } from '../../../../vs/base/common/lifecycle'; import { IMenu, IMenuActionOptions, IMenuItem, IMenuService, isIMenuItem, ISubmenuItem, MenuId, MenuItemAction, MenuRegistry, SubmenuItemAction, ILocalizedString, } from '../../../../vs/platform/actions/common/actions'; import { ICommandService } from '../../../../vs/platform/commands/common/commands'; import { IContextKeyService, ContextKeyExpression, } from '../../../../vs/platform/contextkey/common/contextkey'; export class MenuService implements IMenuService { declare readonly _serviceBrand: undefined; constructor( @ICommandService private readonly _commandService: ICommandService ) { // } /** * Create a new menu for the given menu identifier. A menu sends events when it's entries * have changed (placement, enablement, checked-state). By default it does send events for * sub menu entries. That is more expensive and must be explicitly enabled with the * `emitEventsForSubmenuChanges` flag. */ createMenu( id: MenuId, contextKeyService: IContextKeyService, emitEventsForSubmenuChanges: boolean = false ): IMenu { return new Menu( id, emitEventsForSubmenuChanges, this._commandService, contextKeyService, this ); } } type MenuItemGroup = [string, Array]; class Menu implements IMenu { private readonly _dispoables = new DisposableStore(); private readonly _onDidChange = new Emitter(); readonly onDidChange: Event = this._onDidChange.event; private _menuGroups: MenuItemGroup[] = []; private _contextKeys: Set = new Set(); constructor( private readonly _id: MenuId, private readonly _fireEventsForSubmenuChanges: boolean, @ICommandService private readonly _commandService: ICommandService, @IContextKeyService private readonly _contextKeyService: IContextKeyService, @IMenuService private readonly _menuService: IMenuService ) { this._build(); // rebuild this menu whenever the menu registry reports an // event for this MenuId const rebuildMenuSoon = new RunOnceScheduler(() => this._build(), 50); this._dispoables.add(rebuildMenuSoon); this._dispoables.add( MenuRegistry.onDidChangeMenu((e) => { if (e.has(_id)) { rebuildMenuSoon.schedule(); } }) ); // when context keys change we need to check if the menu also // has changed const fireChangeSoon = new RunOnceScheduler( () => this._onDidChange.fire(this), 50 ); this._dispoables.add(fireChangeSoon); this._dispoables.add( _contextKeyService.onDidChangeContext((e) => { if (e.affectsSome(this._contextKeys)) { fireChangeSoon.schedule(); } }) ); } dispose(): void { this._dispoables.dispose(); this._onDidChange.dispose(); } private _build(): void { // reset this._menuGroups.length = 0; this._contextKeys.clear(); const menuItems = MenuRegistry.getMenuItems(this._id); let group: MenuItemGroup | undefined; menuItems.sort(Menu._compareMenuItems); for (let item of menuItems) { // group by groupId const groupName = item.group || ''; if (!group || group[0] !== groupName) { group = [groupName, []]; this._menuGroups.push(group); } group![1].push(item); // keep keys for eventing this._collectContextKeys(item); } this._onDidChange.fire(this); } private _collectContextKeys(item: IMenuItem | ISubmenuItem): void { Menu._fillInKbExprKeys(item.when, this._contextKeys); if (isIMenuItem(item)) { // keep precondition keys for event if applicable if (item.command.precondition) { Menu._fillInKbExprKeys(item.command.precondition, this._contextKeys); } // keep toggled keys for event if applicable if (item.command.toggled) { const toggledExpression: any = (item.command.toggled as { condition: ContextKeyExpression }) .condition || item.command.toggled; Menu._fillInKbExprKeys(toggledExpression, this._contextKeys); } } else if (this._fireEventsForSubmenuChanges) { // recursively collect context keys from submenus so that this // menu fires events when context key changes affect submenus MenuRegistry.getMenuItems(item.submenu).forEach( this._collectContextKeys, this ); } } getActions( options?: IMenuActionOptions ): [string, Array][] { const result: [string, Array][] = []; for (let group of this._menuGroups) { const [id, items] = group; const activeActions: Array = []; for (const item of items) { if (this._contextKeyService.contextMatchesRules(item.when)) { const action = isIMenuItem(item) ? new MenuItemAction( item.command, item.alt, options, this._contextKeyService, this._commandService ) : new SubmenuItemAction( item, this._menuService, this._contextKeyService, options ); activeActions.push(action); } } if (activeActions.length > 0) { result.push([id, activeActions]); } } return result; } private static _fillInKbExprKeys( exp: ContextKeyExpression | undefined, set: Set ): void { if (exp) { for (let key of exp.keys()) { set.add(key); } } } private static _compareMenuItems( a: IMenuItem | ISubmenuItem, b: IMenuItem | ISubmenuItem ): number { let aGroup = a.group; let bGroup = b.group; if (aGroup !== bGroup) { // Falsy groups come last if (!aGroup) { return 1; } else if (!bGroup) { return -1; } // 'navigation' group comes first if (aGroup === 'navigation') { return -1; } else if (bGroup === 'navigation') { return 1; } // lexical sort for groups let value = aGroup.localeCompare(bGroup); if (value !== 0) { return value; } } // sort on priority - default is 0 let aPrio = a.order || 0; let bPrio = b.order || 0; if (aPrio < bPrio) { return -1; } else if (aPrio > bPrio) { return 1; } // sort on titles return Menu._compareTitles( isIMenuItem(a) ? a.command.title : a.title, isIMenuItem(b) ? b.command.title : b.title ); } private static _compareTitles( a: string | ILocalizedString, b: string | ILocalizedString ) { const aStr = typeof a === 'string' ? a : a.original; const bStr = typeof b === 'string' ? b : b.original; return aStr.localeCompare(bStr); } }