Prototype revision on the the Friday Usability meeting

Created on 17 November 2023, 11 months ago
Updated 27 November 2023, 10 months ago

Problem/Motivation

Prior the round of test for 📌 Toolbar Prototype Usability Testing Phase 4 Active we've run a pilot test on the Friday Usability meeting.

Proposed resolution

Remaining tasks

User interface changes

API changes

Data model changes

📌 Task
Status

Fixed

Version

1.0

Component

Code

Created by

🇪🇸Spain ckrina Barcelona

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Comments & Activities

  • Issue created by @ckrina
  • 🇩🇪Germany rkoller Nürnberg, Germany

    The recording of the pilot user test that was run during 📌 Drupal Usability Meeting 2023-11-17 Needs work could be watched at https://www.youtube.com/watch?v=4IcfL2y_WLk . After the meeting there was also a discussion in a huddle (https://drupal.slack.com/archives/C1AFW2ZPD/p1700236515722839) that was unfortunately not recorded. After the that huddle I've tested the Tugboat instance a bit more in depth and was trying to express my experience and potential stepping stone for me from a cognitive perspective. In the following the comments:

    Intro:
    I went ahead and compared the Tugboat state with the implementation Gin currently is at. One thing I’ve realized you’ve solved one detail that bugged me about Gin from the start, you were able to untwine the two level toolbar Drupal Core currently has in a more elegant manner. In Gin you have the Shortcuts, Devel and the link to the User page in the horizontal nav bar at the top which was sort of suboptimal context wise. In the Tugboat instance the Shortcuts and User page got moved to the vertical nav bar. Double thumbs up. In the following I try to articulate a few more things I’ve noticed while I played around some more with the Tugboat instance over the course of the last weekend and also compared it how Gin tackled these problems (some details were impossible to notice in the short test last Friday). In addition I’ve tried to explain my experience for the parts that were challenging for me and I’ve struggled with cognitively.

    1. Vertical navbar

    1.1 General visual representation of the horizontal and vertical nav bar.

    One detail I haven’t really voiced nor was able to express on Friday is that in the Tugboat version the nav bar is sort of a visually dominant right angel. It surrounds the actual content of the page from two out of four sides (left and top). I’ve compared it to the current state of Gin. Sascha took a slightly different approach by making the horizontal top nav bar not with a solid white background but semi transparent instead. That way the two nav bars haven’t felt like a single UI element. It feels more that the horizontal nav bar belongs to the context of the current page while the vertical nav bar in solid white stands for the overall global context.
    And the horizontal nav bar took interesting alternative take on the node edit form in Gin. It is placed there in-between the vertical nav bar on the left and the sidebar on the right. That also helps to make it less dominant and more context sensitive. Visually it fits better into the current page.

    Question: One detail I wonder is how the vertical and horizontal nav bar behaves with the workspaces modules installed? Not sure if it would be ok and possible to install it on the Tugboat instance and if the installation gets rolled back when the instance gets paused? I don’t wanted to alter anything there. Or is the current state of the Tugboat instance a single experimental module or a collection of MRs? Cuz I wonder if it would be possible to get to the same state locally, then it would be easier to modify the install. That would make that kind of experimentation like installing modules and adding content easier.

    1.2 Drupal icon and the hide/show icon on the node edit page

    The Drupal icon in the upper left corner is in a solid lighter blue same as the hide/show toggle button in the horizontal nav bar in a strong dark black. Both buttons have a high affordance, stand out and draw the users attention, at least mine is always drawn back to those two each and every time - a source of distraction.

    1.3 The font size

    Another detail i haven’t voiced and went just over on Friday is the font size. With an expanded vertical nav bar the size was still legible but small enough that it took a certain amount of effort for me to process the text. I was just in a tunnel concentrated to solve the tasks (having that many pairs of eyes lay onto me and being in focus of everybody was an extra stress), therefore I had some extra energy for processing the nav bar labels and icons, but in the daily life, in particular when being stressed or being tired it might be a different story. The icons were on the brink of being too small to recognize their difference when the sidebar was collapsed. By just glossing over the icons I am only able to determine the type based on the position not by the actual icon shape. It is slightly too small. --admin-toolbar-font-size-s: is set to 0.875rem why not use 1rem like Gin? That way the sizing would be also more in line with the main content. At the moment it looks like the pages main content area has some sort of different “zoom level” compared to the horizontal and vertical sidebar icons their labels. Or will the general font size of the main content area get smaller with the upcoming design changes as well?

    1.4 Indicate which menu items are expandable

    Not sure if I mentioned it but after playing around with the current state a little longer I had to mention it again. In case I already did apologies. In the expanded state of the vertical nav bar it is sort of clear which menu items are expandable based on the chevrons. But as soon as the vertical nav bar gets collapsed it gets more complicated. I have a short working memory lately. With no visual cues by chevrons like in the expanded state you only have the icons to orient. Those are slightly too small (as mentioned in 1.3.) and in consequence hard to process and distinguish. That way it became a guessing game for me on which icon a widget with the child menu items will show up on hover and where not. An interesting detail when I focus on the icons moving my mouse cursor vertically down the different icons I only noticed when a toolbar popover with sub menu items gets shown on hover. That the other icons with no popover had a label with a dark background showing up I was unable to realize for 2 or 3 days testing - cognitively I haven’t recognized nor processed them. But i am not sure if there would be a way to illustrate menu items in the collapsed state that contain child menu items without the need of going through all the icons hovering?

    1.5 Create section

    @ckrina mentioned the problem of sites having not just 6 different entity types to choose from but 20 or 40+ which wouldn’t work in a single column for the vertical nav bar. One way to approach this might be twofold.
    If I remember correctly there were some discussions about the type_tray module ( https://www.drupal.org/project/type_tray ) in the context of the nav bar? I think it might help with the problem of those overview pages like “/node/add” where you currently only have a title and a description. To process that page right now the only way is to read them, there is no visual cue to orient. type_tray solved that at least for nodes so far. I don’t think it would be worth breaking the pattern for the vertical nav bar of parent menu items being just toggle buttons. But instead one option might be to add a menu item at the top or the bottom of the “Create” list forwarding to such an overview page with all available entity types you are able to create content for there. That page might be also used to choose the 6 to 10 types that are shown in the vertical nav bar (not sure about the exact number possible).
    For the vertical nav bar itself you have a plain homogenous short list of entity types to create. But the list is still sort of hard to process since the list of available entity types to create spans across content types, media types, and users. For someone less technical and or less familiar with Drupal that might be challenging and again it still puts a cognitive load on the user. What does recipe mean, what entity type is it in? Is it a content type, a block type, a media type? An option might be to add sub menu items for content, blocks, images, media , users and what ever other type is available and collect the different subtypes underneath as child’s. And for each sub menu item you could also add a menu item to corresponding the type tray of that subtype?

    1.6 Blocks missing

    A top level menu item for blocks is missing as well as a child menu item in the “Creation” top level menu item for blocks. That is sort of confusing when you visit either Content, Files or Media and notice a “Blocks” tab there but .

    1.7 Tab order and keyboard navigation

    In general the keyboard navigation looks good. The only potential problem I see is in the context of SC 2.4.7 because the focus is not always visible. and there is also the question of the order in general. In Tugboat the order is:
    1.7.A (Tugboat)

    1. Skip to main content
    2. (not visible on tab ref SC 2.4.7)
    3. Preview
    4. Save
    5. More options
    6. Hide/show toggle (in the expanded state it is ok but still challenging to recognize the color contrast with the green outline around darkish black)
    7. Drupal icon (the outline is close to invisible with green around the lighter blue ref SC 2.4.7)
    8. Shortcut

    1.7.B (Gin)

    1. Skip to main content
    2. Drupal icon (the outline is close to invisible with green around lighter blue)
    3. Tools

    The question is wouldn’t the following approach be desirable for Claro instead of keeping the order like outlined in 1.7.A . After you reach “Skip to main content” with your initial press of the tab key you get to the vertical nav bar like Gin does in 1.7.B instead of getting to the horizontal nav bar. While if you press return on “Skip to main content” you get to the main content. But if you skipped to the main content the question is where to place the horizontal sidebar in the DOM. At the moment the rough tabbing order on the node edit form page with a expanded sidebar is.

    1. Horizontal navbar
    2. Vertical navbar
    3. Expanded sidebar
    4. Main content

    With the save, preview and delete buttons potentially getting removed at the bottom of the node edit form and moved to the horizontal nav bar the decision on the order becomes even more relevant. If someone is using the keyboard but not a screen reader the taks of saving a node might become cumbersome and or complicated?
    One option to tackle that might be to add a “Skip to list of available actions” link after the last element of the node edit form that directs the user back up to the list of available actions. That way the actions would be one extra key press away as if the buttons would be still there at the bottom of the form. Directly available to keyboard only users.

    Question: Would it make sense to ping Camille Davis if she would have time and interest to chime in on the general keyboard accessibility topic for the nav bar. She provided great input on the admin_toolbar end (for example https://www.drupal.org/project/admin_toolbar/issues/3286466 Tabbing order does not satisfy 508 accessibility requirements Needs review ) and I imagine she might be also helpful here? Perhaps also as a participant in a user test?

    1.8 Windows high contrast mode

    The icons are invisible in the expanded as well as collapsed state. The blue dot signifying the active page in case you are on a sub menu item page is also invisible. But one detail I have to note even it is just communicated by color but in high contrast mode the navigation is way more clear because you know white means there is no link behind and it is just a toggle button while yellow communicates this is a link. From a a design perspective that would definitively not work in general but I just wanted to noted that such a cue helped immensely to remove a certain constant uncertainty while using the vertical nav bar.

    2. Contextual horizontal nav bar

    Aside 1.1 and 1.7 there are few observations about the horizontal nav bar:

    2.1 Go back to site button label

    The word “go” might be striked to make the micro copy shorter. It is slightly shorter and the core task of going back is front-loaded es well. Same for the “Go back to Administration” link.

    Question: Is it the expected behavior that “Go back to Site” points to the front page while “Go back to Administration” points to /admin/content. We had a discussion at a local meetup today and someone said currently the destination seems context sensitive in some cases but he was unable to spot a pattern. (I don’t use the go back to site at all personally therefore I ask)

    2.2 Open/close toggle button

    Is it intentionally that the padding of the horizontal nav bar is larger than the padding of the expanded sidebar underneath? That way the open/close toggle is not aligned with the “Revision log message” and “URL alias” field.

    2.3 The structure and function of the horizontal nav bar

    The question is if “How the horizontal nav bar on top functions and behaves” is predictable? Me as a user regularly had a challenging time using it over the weekend. First a few examples what is displayed inside the bar in different contexts (always a good way to spot patterns):
    /en/node/add/page

    1. 1. Go back to Site
    2. 2. Breadcrumb (“Add content” - clickable link)
    3. 3. Preview-button
    4. 4. Save-button
    5. 5. Hide/show toggle button

    => If you click “Article” in the sidebar in the create section first, then you change your mind and click “Basic page” and then change it another time to “Recipe”, each time the clicked active content type is on top of the list aka the order changes. If you have a fixed list of entities to choose from I am rather confused as a user and have to reorient if i assume the position is consistent across pages. Plus if you click “Image”, that is not going to the top of the list. Same as “Image”, “Document” or “User”. If you get the positioning into your muscle memory the moving of the current page to the for the content types can be potentially distracting. For media items (Image and Document) that behavior doesn’t happen.
    /en/media/add/image

    1. 1. Go back to Site
    2. 2. Breadcrumb (“Add media item” - clickable link)

    /en/admin/people/create

    1. 1. Go back to Site
    2. 2. Breadcrumb (“Administration > People” - clickable links)

    /admin/content

    1. 1. Go back to site
    2. 2. Breadcrumb (“Administration” - clickable link )
    3. 3. Add content

    /node/20/edit

    1. 1. Go back to site
    2. 2. Edit About us (plain text - none clickable link)
    3. 3. Preview (also a button at the end of the form)
    4. 4. Save (also a button at the end of the form - “(this translation)” isn’t appended for the nav bar label)
    5. 5. More options
    • Latest version
    • Layout (primary tab moved into the horizontal nav bar)
    • View (primary tab moved into the horizontal nav bar)
    • Edit (primary tab moved into the horizontal nav bar)
    • Delete (also button at the end of the form)
    • Revisions (primary tab moved into the horizontal nav bar)
    • Translate (primary tab moved into the horizontal nav bar)
  • 6. Hide/show toggle button
  • => All the tabs on the node edit form are moved under “More options”.
    /node/20/

    1. 1. Edit About us (Clickable link)
    2. 2. “Turn on in Place Editing” toggle button
    3. 3. More options
    • Latest version
    • Layout (duplicate of primary tab)
    • View (duplicate of primary tab)
    • Edit (duplicate of primary tab)
    • Delete (duplicate of primary tab)
    • Revisions (duplicate of primary tab)
    • Translate (duplicate of primary tab)

    => The edit button is redundant it occurs three times on the same page (in 1 , the sub item of 3 and within the primary tab) (edited)
    /es/media/21/edit?destination=/en/admin/content/media

    1. 1. Go back to site

    => Inconsistent with node pages. The buttons are not available in the horizontal nav bar neither are the primary tab links.
    /admin/structure/types/manage/article/fields

    1. 1. Go back to site
    2. 2. Breadcrumb (“Administration > Structure > Content types > Article” - all clickable links)

    => “Create a new field” and “Re-use an existing field” are not available in the horizontal nav bar
    /admin/appearance

    1. 1. Go back to site
    2. 2. Breadcrumb. (“Administration” - clickable link )

    => An interesting case that might be of interest for https://www.drupal.org/project/ideas/issues/2860419 [Meta] Appearance page is too long and confusing Active is the Appearance page. If being consistent the “Add new theme” button would have to move into the horizontal toolbar but then you also have the “Save configuration” button at the bottom of the page as well. Then you have that button were the field set with the settings still at the bottom of the page and depending on the number of added themes perhaps even beneath the fold. And technically each of the theme card has also one to three action buttons.
    There were ideas in the linked issue to untwine the page as well as discussion in the context of moving the “Block Layout” page into the “Appearance” page that ideated in the same direction. But in the current state it might be tricky to get the content of the horizontal nav bar clear and consistent for this page.

    In summary the problems I had cognitively using the horizontal nav bar that were challenging to me are the following:

    1. It was not that easy to figure out and predict when the breadcrumbs are shown, when nothing at all is shown and when just plain label text is shown in the horizontal nav bar right next to the “Go back to site” button.
    2. The way breadcrumbs are styled adds a cognitive load. I’ve struggled for several reasons. First the items in the breadcrumb are not styled as links (underlined) and the current page isn’t added as the last item. That way it happens pretty often that you have a single term like “Administration”. As a user I ask myself is that some sort of headline and shouldn’t this headline mirror the current h1 and why is it differing then? It is also confusing in cases like /node/20/edit where you have plain text instead of a breadcrumb (“Edit About us”). You are unable to distinguish visually between plain text and links, you have to hover over single items to see if the mouse cursor changes and uncovers that this is a link. Having a breadcrumb in the horizontal nav bar made me at least think each and every time I am trying to orient in which context I am currently in. I prefer to have a single source of truth for orientation, and having the breadcrumb in such a prominent position was sort of a distraction and a source of steady confusion. Right above the H1 in the current form I am able to blend it out mentally but up in the horizontal nav bar that doesn’t work plus it is more dominant there.
    3. The list for the “More options” button is sort of homogenous and feels like a waste basket where all available links were dropped in (mostly the primary tabs - but that took me quite a while to realize). And it is necessary to read and scan to process and know which option is which.

    In regards of options how to improve there are two areas.
    A: The section currently containing the breadcrumb
    I’ve informally asked around the last few days in local meetups if folks are actually using the breadcrumb navigation. Everyone was using it to a certain degree. The main example named was the need of editing the settings of several content types and that you don’t have to go back to Structure every time you change the content type (in case you don’t have admin_toolbar installed)

    Question: How should the “Go back to site” and “Go back to administration§ behave? Is it alway redirecting to the “front-page” and “admin/content”?

    Option 1) The breadcrumb could be kept as it is right now on Tugboat. It might be only a reasonable step to follow some of the best practices outlined in https://www.nngroup.com/articles/breadcrumbs/ (in particular to style links as links and add the current page in plain text not styled as a link). The only downside if someone doesn’t need or like breadcrumbs it wouldn’t be possible to disable them?
    Option 2) The breadcrumb might be moved back where it currently is in Drupal 10.1.x, right above the H1. That way the user would have the ability to disable the breadcrumbs via the Block Layout page while the styling could still be following the best practices outlined in the nngroup article in Option 1. What to use the empty space in the horizontal nav bar see C.

    B: The section currently containing the “More options” section
    On Friday I’ve suggested to untwine the “More options” list and move most of the options/links to the semantically appropriate sections that fit their context in the sidebar. For example revisions and last version to the Published section, delete maybe also to the published section with a dedicated button like Gin does, Translate to the Translations section, and Layout could get its own button in the horizontal nav bar (if layout is configured for that content type). But that suggestion would have one downside. Since the primary tabs are not available anymore when these actions would only be available while the sidebar is expanded, if collapsed those might be missed. Therefore also not the perfect approach.

    C: How to populate the horizontal nav bar across context and how to use the space freed in case option 2 for A was applied.
    At first I was under the impression the following pattern

    1. 1. Go back to site
    2. 2. Breadcrumb
    3. 3. one or two actions
    4. 4. More options
    5. 5. hide/show sidebar

    would be more or less applied to every page in the Admin UI and that all primary tabs would be moved and collected within the “More options” button. But that actually only applied to the node pages in full effect, in part for the overview and entity pages of other entity types. The other parts of the Admin UI don’t need to apply the “More options” button pattern. Some just still need to move some of their buttons up to the horizontal nav bar.
    In the following I outline a potential approach in case option 2 for A is followed (the breadcrumb moved right next to the H1 again). With the breadcrumb removed the free space might be used otherwise. Either way if options/links are more moved out of the “More options” list into the sidebar or if the current state is kept. Would it make sense mainly instead of using the space, currently reserved for the breadcrumb, for contextual links instead. That you have a list of up to three links a user usually goes to while being on page x. An idea @Aaron McHale wrote up in https://www.drupal.org/project/ideas/issues/3325034 🌱 Providing additional methods of navigating the admin interface Active Those contextual links might be positioned at the place the breadcrumb currently is in the Tugboat install. That way the horizontal nav bar would be roughly structured like that:

    1. 1. Go back to site
    2. 2. Contextual links
    3. 3. Available actions

    The different variations and contexts would be:
    Create an entity:

    1. 1. Go back to site
    2. 2. Preview
    3. 3. Save
    4. 4. Hide/show toggle button

    => no need to have anything for the contextual links section here. The only thing that might be considered is adding more available actions in the context of for example, save ,save and add translation and alike. We discussed that issue in one of the usability meetings: https://www.drupal.org/project/drupal/issues/3025384#comment-15096739 📌 Content translation overview should add destination query parameter Needs work
    Edit an entity:

    1. 1. Go back to site
    2. 2. Preview
    3. 3. Save
    4. 4. More options (in case it’s options are untwined it might be removed )
    5. 5. hide/show toggle

    View an Entity

    1. 1. Edit [node title]
    2. 2. Turn on in place editing
    3. 3. More options

    At first I thought it might be a good idea to move the options within the “More options” list out and place them as dedicated buttons as contextual links. But that would for one break the pattern and on the other hand there might be probably not much need if you are viewing the node in the front end to go either back or turn on the in place editing. Both options are directly available. and keeping the rest of the options hidden under “More options” “might” be ok. On the upside the primary tabs will get removed on the front end for the node.
    The rest of the page in admin ui:

    1. 1. Go back to site
    2. 2. context 1
    3. 3. context 2
    4. 4. context 3
    5. 5. Create a new field
    6. 6. Re use an existing field

    if you take a content type page as the example. The two buttons would be moved up to the nav bar and you could add one to three contextual link where a user would/could go next there. But I suppose to take full advantage of those contextual links some research would have to be done to figure out those pathways people regularly take through the admin ui. We took a first step in the UX meetings by repeatedly recommending more than a single button. Having a save button and then a second button for example for adding terms you have the save and a save and go to list button. And that might be pushed a level further with the contextual links.

  • 🇬🇧United Kingdom AaronMcHale Edinburgh, Scotland
  • 🇪🇸Spain ckrina Barcelona

    Adding the summary of the feedback from @AaronMcHale and @rkoller and crediting both for it:

    Vertical toolbar

    1. New navigation is faster and clearer to navigate than Gin Toolbar
    2. Shortcuts and user menus feel more logically placed in new Navigation than Gin
    3. But, compared to Gin the left and top navigation are too dominant, much more visually distinct from the main page area. Right angle where the navigation and toolbar meet is very pronounced, felt that was distracting compared to Gin (visually too much weight).
    4. Likes that the right sidebar is more vertically aligned with the content area.
    5. The Drupal icon in the top left really stands out against the white, drawing attention away. When right sidebar is open, the dark background of the toggle button also stands out too much, not consistent with the sidebar collapse button.
    6. Font size/zoom level of text on navigation/toolbar is different from main content area. Font-size is different, not too small but requires more effort to read.
    7. On expanded sidebar it is clear which menu items can be expanded (have sub-menu), but not clear when sidebar is collapsed. Needed to scan mouse across icons to know what item is the one looking for. With smaller font-size hard to distinguish between different icons.
    8. When scanning down, focus is on icon, and didn't notice black tool-tip with word "Content". However for "Create" which has a sub-menu, sub-menu is big enough that when it opened it was visually noticeable enough. The tooltip appearing is too small of a change, when used to seeing a large menu open on the right.
    9. With Create menu, it spans content, users, etc, but unable to know which entity type you are creating a (Recipe could be both a content type and a media image). Maybe group by entity type, with sub-menus for each one (so Media, then under that you have the media types).
    10. Mentioned the type_tray module is a good solution.
    11. Aaron's note: What if the create link opened a model, with a interface similar to the new Field UI, or Create menu had some common items in it with a link to open the model to see everything?
    12. Create menu is missing block type, and no option to go to Block collection from navigation (blocks top level menu item missing), but this is probably separate issue.
    13. Tab order is weird: first "skip to main content", then not visible, then "Add content", then "Drupal" icon. Tab order is horizontal, then vertical, then content, which isn't right. On node edit if the "Save", "Preview", "Delete" are on top toolbar, then you might not get to them when tabbing through content edit form.
    14. In high contrast mode, icons are not visible, blue dot of active item not visible; Yellow used to communicate link, white is text (so also used to communicate that there are sub-items), but missing chevron. But does find the change in colour useful to distinguish between those that have sub-items and don't.
    15. Under "Create" menu, for content types, the active one is moved to top, but not for other types

    Horizontal toolbar

    1. "Go back to site" could be shortened to "Back to site", "Go back to administration" could be "Back to administration"
    2. Right sidebar, show/hide button, Save, Preview, etc, only for nodes but should be for other entity types, e.g. Media;
    3. Similarly the "Edit [name]" breadcrumb is plain text not a link
    4. Relating to local tasks, best to take a look at Ralf's point 2.3 specifically
    5. Don't need "Edit" and "View" local task in "more actions"
    6. When Editing media item, only have "Back to site"
    7. Could move "Create field" and "Reuse existing field" to toolbar, move action buttons to toolbar. On Appearance page "Install theme" could also be in toolbar, but Appearance has so many other problems, and there are separate issues for that.
    8. Breadcrumbs appearing inconsistently, sometimes text, sometimes links, breadcrumb trail not styled as links, current page not in breadcrumb. Ralf's comment has more specific details.
    9. Ralf has some suggestions at the end of his thread for how to improve breadcrumb.
    10. In the "More actions" most of those could find better locations, e.g. Gin has Delete in right sidebar.
    11. More standardised and predictable toolbar: Back to site, then contextual breadcrumb (up to 3), then actions.
    12. Admin breadcrumb should be more contextual to where you have come from.
  • Status changed to Fixed 10 months ago
  • 🇪🇸Spain ckrina Barcelona

    Closing after giving feedback because I assume nobody else from the call will come to add anything else, but feel free to reopen this otherwise.

    Also noting that closing this means the feedback has been implemented or discarded, as discussed with @AaronMcHale and @rkoller we're iterating on this in other issues and implementing several of the proposals both on designs and other issues.

    Thanks both!!

  • Automatically closed - issue fixed for 2 weeks with no activity.

  • Production build 0.71.5 2024