diff --git a/images/ui/built_in_button/button_split_button.png b/images/ui/built_in_button/button_split_button.png new file mode 100644 index 00000000000..07f74e45a8e Binary files /dev/null and b/images/ui/built_in_button/button_split_button.png differ diff --git a/images/ui/built_in_button/split_button_tooltip_on_hover_tooltip_dark.png b/images/ui/built_in_button/split_button_tooltip_on_hover_tooltip_dark.png new file mode 100644 index 00000000000..b03e9b3ec81 Binary files /dev/null and b/images/ui/built_in_button/split_button_tooltip_on_hover_tooltip_dark.png differ diff --git a/topics/ui/controls/button.topic b/topics/ui/controls/button.topic index d3363ea5b50..0301466feaa 100644 --- a/topics/ui/controls/button.topic +++ b/topics/ui/controls/button.topic @@ -19,9 +19,9 @@ When to use a button - +
- + - + - + -
Using links instead of buttonsUsing links instead of buttons

Use a link instead if:

  • The action takes the user to another page of the same dialog or an external source like @@ -36,12 +36,12 @@

  • Using toolbar buttons instead of buttonsUsing toolbar buttons instead of buttons

    Use a toolbar button instead if there are several buttons related to a table or list.

    Using split buttons instead of buttonsUsing split buttons instead of buttons

    Use a split button instead if:

  • There are more than two related actions, but the space is limited and/or packed.
  • @@ -52,7 +52,7 @@
    + Using built-in buttons instead of buttons

    Use a built-in button instead if it's related to an input field, combo box, @@ -78,7 +78,7 @@

    The button should answer the question in the title, so the user can skip the description. Prefer specific labels over generic ones:

    - +

    @@ -105,7 +105,7 @@ use the word Now in labels because buttons always trigger an immediate action:

    - +

    @@ -130,7 +130,7 @@

    The label should be short, not more than five words. If it’s not obvious what element the button is related to, add more words to make it clear. Prefer clear labels to short ones:

    - +

    @@ -202,8 +202,6 @@ - - 'Cancel' button in a focused state

    All buttons can get focus, even on macOS if the @@ -313,7 +311,7 @@

    On hovering over a button, show a tooltip with the shortcut and the action name if it can be clarified. For more details, see Context help.

    - +
    Hovered buttons @@ -332,7 +330,7 @@ - +
    Hovered buttons @@ -350,7 +348,7 @@
    - +
    Hovered buttons @@ -386,7 +384,7 @@ - +
    Hovered buttons @@ -413,7 +411,7 @@
    - +
    - +
    Hovered buttons diff --git a/topics/ui/controls/split_button.md b/topics/ui/controls/split_button.md index e0147fc99ce..c895b18de54 100644 --- a/topics/ui/controls/split_button.md +++ b/topics/ui/controls/split_button.md @@ -54,7 +54,7 @@ If unrelated actions are hidden under the dropdown menu, they are hard to find: ### Only one related action -Putting the single action in the dropdown menu doesn't save a lot of space: +Putting a single action in the dropdown menu doesn't save a lot of space: Incorrect @@ -86,7 +86,8 @@ Show a tooltip: ### Dropdown menu -Place related actions into the dropdown menu. Do not duplicate the main action in the dropdown menu, otherwise it is confusing how to trigger the main action — with the button or from the menu. +Place related actions into the dropdown menu. Do not duplicate the main action in the dropdown menu. +Otherwise, it is not clear how to trigger the main action: with the button or from the menu. Incorrect @@ -119,7 +120,7 @@ Place related actions into the dropdown menu. Do not duplicate the main action i * Open the dropdown menu with the first menu item selected on Alt+Shift+Enter. -* Do **not** show the dropdown menuwhen the button gains focus. +* Do not show the dropdown menu when the button gains focus. ### Focus on the button @@ -144,7 +145,7 @@ Place related actions into the dropdown menu. Do not duplicate the main action i

    Tab

    Shift + Tab

    Move focus to the control next to the split button and hide the dropdown menu.Move focus to a component next to the split button and hide the dropdown menu.