PhpStorm 2017.3 Help

Keymap

Use this page to create, edit, and remove custom keymaps for specific environments, and change shortcuts associated with actions.

Note that default keymaps are not editable. To re-configure shortcut associations, create a child keymap based on the desired default one and edit it as required.

On the other hand, as soon as you try to change a keyboard shortcut associated with an action in one of the default keymaps, a copy of the corresponding keymap is automatically created.

Keymap Management Buttons

Item

Description

Keymaps

From this drop-down list, select the desired keymap.

Copy

Click this button to create a child keymap on the basis of the keymap selected in the Keymaps drop-down list.

Reset

Click this button to abandon all the changes made to a custom keymap and restore the configuration of the parent keymap.

Delete

Click this button to remove the selected custom keymap from the list.

Prefer key position over key char with national layout

This checkbox appears when a non-English keyboard layout has been detected (only available for MacOS). When this option is selected, key position is preferred over its meaning for keymap in national layouts.

Based on keymap

This read-only field shows the name of the parent keymap.

Keymap Toolbar

Item

Tooltip and shortcut

Description

Expand AllCtrl+NumPad Plus

Click this button to expand all nodes in the content pane of actions.

Collapse AllCtrl+NumPad -

Click this button to collapse all nodes in the content pane of actions.

Edit ShortcutEnter

Click this button to change shortcuts for the selected action. It is possible to remove existing shortcuts, and add new ones. Choose the desired change from the drop-down menu:

Select the option Add Keyboard Shortcut to open the Enter Keyboard Shortcut dialog box, where you can specify the combination of keystrokes to be assigned to the selected action in the current keymap.

Select the option Add Mouse Shortcut to open the Enter Mouse Shortcut dialog box, where you can specify the combination of mouse clicks and buttons to be assigned to the selected action in the current keymap.

Select the options Remove <shortcut> to delete the selected shortcut from the selected action.

These commands are duplicated on the context menus of the actions in the Actions content pane.

Use this text box to search through the content pane of actions. As you type a search string, the actions that match the search pattern are displayed. The previously used search patterns are stored in the search history list. To add the search string to the history list, press Enter.

Click to reveal the history list of the previous searches.

Click to clear the current search pattern from the text box.

Find Action by Shortcut

Click this button to open the Find Shortcut dialog to filter out the desired actions by keystrokes. Refer to the section Configuring Keyboard Shortcuts to learn how to specify keyboard shortcuts.

The actions with shortcuts that match the specified criteria are shown in the content pane of actions.

Clear Filtering

Click this button to restore the initial list of actions in the content pane.

Actions

Item

Description

All Actions

This content pane shows all actions currently available in PhpStorm. The actions are grouped below nodes according to the areas of their use.

Note that default keymaps are not editable. As soon as you try to change a keyboard shortcut associated with an action, a copy of the corresponding keymap is automatically created.

If some of the actions have no mapped keyboard shortcuts, they still can be invoked by Go to Action.

Shortcuts

This read-only field shows the list of shortcuts associated with the selected action in the current keymap.

The shortcuts are represented depending on the platform. However, some keys are missing on certain keyboard layouts. For example, PageUp /PageDown keys are not available on notebooks. That's why one should use Fn plus arrow keys.

Context menu of an action

Add Keyboard Shortcut

Choose this command on the context menu of an action to open the Enter Keyboard Shortcut dialog box, where you can specify the combination of keystrokes to be assigned to the selected action in the current keymap.

Add Mouse Shortcut

Choose this command on the context menu of an action to open the Enter Mouse Shortcut dialog box, where you can specify the combination of mouse clicks and buttons to be assigned to the selected action in the current keymap.