Bug 153065 - Tool names are different between the toolbar and Visible Buttons list
Summary: Tool names are different between the toolbar and Visible Buttons list
Status: NEW
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: UI (show other bugs)
Version:
(earliest affected)
7.5.0.1 rc
Hardware: All All
: medium enhancement
Assignee: Not Assigned
URL:
Whiteboard:
Keywords:
Depends on:
Blocks: Toolbars-Tooltips
  Show dependency treegraph
 
Reported: 2023-01-17 11:53 UTC by PeeWee
Modified: 2023-02-03 09:06 UTC (History)
5 users (show)

See Also:
Crash report or crash signature:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description PeeWee 2023-01-17 11:53:47 UTC
Description:
Some tool names on a toolbar are different when viewed in the Visible Buttons list for a toolbar. Also, some tool names are far too long making LibreOffice very amateurish.
For example, on the Drawing toolbar, a too is called "Select at least three objects to distribute". Also, this tool name is too long. In Visible Buttons, the same tool is called "Distribution", which looks more professional.
For example, on the Outline toolbar, a tool is called "Demote outline level of selected list paragraphs". This tool name is also too long. In Visible Buttons, the same tool is called "Move Down".

Steps to Reproduce:
1. Open a document in LibreOffice Draw or Impress.
2. Move the cursor over a tool and hold until the tool name appears in a pop-up on the Drawing, or Outline toolbars.
3. Check the name that appears in the pop-up.
4. Click on the down triangle in the toolbar title bar and select Visible Buttons.
5. Check the same tool name that appears in the Visible Buttons list.

Actual Results:
The tool names are different between the selected toolbar and the Visible Buttons list.

Expected Results:
The tool names should be the same on the toolbar and the Visible Buttons list.


Reproducible: Always


User Profile Reset: No

Additional Info:
Making the tool names short and easy to read would make LibreOffice look more professional and new users would not have any problems. The function of each tool on a toolbar can easily be explained in the user guide for each LibreOffice module.
Comment 1 Stéphane Guillou (stragu) 2023-01-17 12:21:44 UTC
Thanks PeeWee

What you see is the difference between the Label (usually shorter name) and the Tooltip (more descriptive, might contain a shortcut too, and even interactive information like the colour in Line Color and Fill Color in the Drawing toolbar). It is expected that Tooltips are more explicit, verbose, than shorter Labels that need to be displayed in a compact way in the UI.

You can see both the Labels and Tooltips when selecting a command in the Tools > Customize dialog.

If you think a Label or Tooltip is not suitable, please open a more specific bug report about it, which will make it more likely to be resolved.
Comment 2 PeeWee 2023-01-17 12:35:50 UTC
There are several examples of long tool names used on a toolbar and in the Visible Buttons list.

Also, there are several examples of tool names being different between the toolbar and the Visible Buttons list.

It would take time to make a list of all the examples that I know of. The two examples already given are just the tip of the iceberg.
Comment 3 Stéphane Guillou (stragu) 2023-01-17 13:59:59 UTC
Again, the Tooltip being different to the Tooltip is not a bug, it's usually by design. I'll add that they can also be shorter than the label, probably because there is enough context in the menu they are used in to understand what their main function is and avoid repetition (e.g. in Shape > Distribute Selection).

However, if the label and the tooltip are *too* different, e.g. providing an instruction without mentioning the name, I can understand it can create confusion when trying to identify the right button when customising the toolbar.

Toolbar context menu > Visible Buttons uses the command's label, which is the same as in the Customize dialog. In that sense, it is consistent.

From experience, giving a couple of examples and then saying something like "there are many more" is pretty much guaranteed to never be entirely resolved because it is too vague. But I'll try expliciting the two examples you have given:

1)
Label: Distribution
Command: .uno:DistributeSelection
Tooltip: Select at least three objects to distribute

2) Unsure if you refer to .uno:OutlineRight or .uno:OutlineDown (I think you mixed the label of one with the tooltip of the other), but they are similar in how their tooltip is worded, so let's go with the first one:
Label: Demote
Command: .uno:OutlineRight
Tooltip: Demote outline level of selected list paragraphs

... I can see how the first one could be reworded into something that sounds less like instructions. It is a visible tooltip in e.g. the Tabbed UI (Home tab). PeeWee, do you have suggestions for better tooltips?

The only guidelines I've seen about tooltips and labels are on this page: https://wiki.documentfoundation.org/Design/Guidelines/ToolBar#Text

UX, what do you think about this? Should the 2 tooltips above be changed? And should guidelines be clarified about what tooltips and labels should contain, where they are used in the UI, and their potential size limits?
Comment 4 V Stuart Foote 2023-01-17 14:03:41 UTC
There is no reason that the button name/description (only shown when selecting the  button controls that will be visible on the toolbar) should match the tooltip.

The name/description should not "wrap" or expand the "Visible button" dialog overly wide--but up to a quarter of the screen is fine.

The "Visible button" selection is not in continual use, and is only for configuring the Toolbar.

IMHO => NAB and no reason to force awkward relabeling for what is a configuration tool and not a UI for usage.
Comment 5 Heiko Tietze 2023-01-19 10:01:01 UTC
(In reply to Stéphane Guillou (stragu) from comment #3)
> Should the 2 tooltips above be changed?

The question is rather whether the unlabeled toolbar buttons should show some other label than the tooltip. Could be the context label, in this case "Distribute Selection".
Comment 6 Stéphane Guillou (stragu) 2023-01-19 13:04:24 UTC
(In reply to Heiko Tietze from comment #5)
> The question is rather whether the unlabeled toolbar buttons should show
> some other label than the tooltip. Could be the context label, in this case
> "Distribute Selection".

There you go, I wasn't even aware of the label type ContextLabel.
Code pointer: https://opengrok.libreoffice.org/xref/core/officecfg/registry/data/org/openoffice/Office/UI/GenericCommands.xcu?r=d4e4a2b9#7358

Logic of what is used where in the UI: https://opengrok.libreoffice.org/xref/core/officecfg/registry/schema/org/openoffice/Office/UI/Commands.xcs?r=b399bb87
Comment 7 Heiko Tietze 2023-01-27 08:04:23 UTC
So let's give it a shot. We show the contextual label by default and maybe add the tooltip if the extended tips are enabled.
Comment 8 Heiko Tietze 2023-02-03 09:06:57 UTC
We discussed a solution to assign the popup labels by default (which is the fallback anyway if no tooltip is defined). https://gerrit.libreoffice.org/c/core/+/146464
However, it was concluded that this path is not a good solution as popup labels might be misleading.

So please name every command individually in order to change the tooltip. If it requires a more verbose description we should move that into the extended tooltip.