Problem/Motivation

Currently the toolbar module relies heavily on javascript to display well. We should reduce this dependency so that the toolbar displays well in a non-javascript context.

The presentation of the toolbar in a non-javascript context is to be determined. I think the best answer is, as nicely as possible.

Remaining tasks

Code review

User interface changes

None

API changes

None.

This issue is a dependency for:

#1938044: Prefix all toolbar classes to prevent theme clashes
#1860434: Refactor the Toolbar JavaScript to use Backbone; fix several poorly functioning behaviors

Support from Acquia helps fund testing for Drupal Acquia logo

Comments

stevector’s picture

Here's a related issue that slightly reduces the amount of javascript. #1847574: Toolbar sets the active-trail to the last clicked menu item, not the current menu item.

Shyamala’s picture

Issue tags: -toolbar

editing tags

nod_’s picture

Category: task » bug

moving to bug since with js disabled it's pretty much unusable.

hello@melmcdougall.com’s picture

Assigned: Unassigned » hello@melmcdougall.com
Status: Active » Needs review
FileSize
1.69 KB

Here are some very small CSS changes to make a very basic version of the toolbar still work with javascript disabled. Have tested in Safari, FF and Chrome, but would appreciate some testing and feedback if i've approached this wrong.

Basically have just focused on hiding the tray elements entirely, and making sure the key menu items are clickable and in their correct position. Not happy with how i've had to re-hide the 'edit' button (which is no use without javascript), so some feedback there would be appreciated too.

nod_’s picture

Sorry haven't looked to closely at your changes. I've made the toolbar work without JS also, and try to get some more involved clean-up going. First go at the patch, haven't touched the JS yet. I guess it achieve sensibly the same thing :)

When js is not enabled, the toolbar is in the page flow so we don't have to guess the height of the toolbar to offset the body content with. It disappear on scroll, that's not a problem since toolbar without trays is pretty useless.

toolbar.base.css apears to be needing some simplification.

nod_’s picture

Status: Needs review » Needs work

not in a state to be reviewed.

jessebeach’s picture

The one thing I will ask you all to consider is that much of the redundant CSS is there to give sensible styling to IE8, since it doesn't understand media queries. It was written before be had modernizr in core, so perhaps we could eliminate much of it by adding a few feature tests and keying the CSS off those classes.

Maybe we could do something with CSS :target and anchor tags to do the show/hide of the trays?

jessebeach’s picture

Oh, and the "sensible styling" for IE8 has been torn to shreds by bit rot. The non-js version should probably just be the IE8 version as well for what it's worth.

oresh’s picture

Status: Needs review » Needs work
FileSize
2.57 KB

I've added css styles (not supported by ie8) for tray to be shown on .bar hover when the js is not loaded.
I was couldn't make it work like you hover on shortcuts and get the shortcuts dropdown - css can't handle it yet.
But still at least showing at least first tray for menu already gives more functionality for nojs users.

*patch includes #5 patch

oresh’s picture

Status: Needs work » Needs review
oresh’s picture

Status: Needs work » Needs review
FileSize
2.63 KB

Ooops. I failed with class name. Plese ignore #9, use this instead.

leochid’s picture

FileSize
76.24 KB
67.38 KB

Hover on Menu works perfectly as tested below.

Tested in browser: Chrome

1. Disabled javascript in the browser, the toolbar at the top becomes a list. see image below

beforepatch

2. Applied patch in #11, now the menu list becomes toolbar and showing the first submenu but not the submenus for shortcut and admin

afterpatch

Needs work:

The other menus must show their respective menu tray.

oresh’s picture

Ok. so I've changed the behavior:
If you hover the icon - you get the dropdown, if you hover the text (on bar) the dropdown will be hidden ( so you can click the link itself).
It's was a hard one - not sure if possible to make it better.

*sorted with csscomb. works only when 'toolbar-processed' class is not added.

oresh’s picture

Assigned: hello@melmcdougall.com » Unassigned
FileSize
3.29 KB

Ok, so after a lot of tests - found a sad thing - patch didn't work very well when js is working. And the dropdown was to sharp.
Fixed both, second by adding small css transition and a small white triangle at the bottom. Should look nicer now.

nod_’s picture

That works surprisingly well :)

Not sure about some of the CSS but I'm no CSS guy so that'd need to be reviewed by someone else.

LewisNyman’s picture

Status: Needs review » Needs work
+++ b/core/modules/toolbar/css/toolbar.base.cssundefined
@@ -225,3 +213,61 @@ html.js .toolbar {
+html:not(.js) .tray,

hmm, is there a reason why we're using :not(.js)? Don't we have a .no-js class?

The rest of the CSS seems fine

oresh’s picture

Status: Needs work » Needs review

@LewisNyman, I did not find a no-js class when i disabled js. There is no way you can see, if js is disabled or not.
As .js class is added direct to html - that's the first element which will be rendered and displayed showing that js is enabled.
So html:not(.js) will work only when js is disabled, independently from page load time. I treid width .toolbar-processed before and understood it's a bad idea, cause adding this class to toolbar can take a lot of time. adding .js to html is almost instant.

Hope this answers your question. Thanks.

nod_’s picture

#14: core-toolbar-nojs-1847314-14.patch queued for re-testing.

hass’s picture

Status: Needs review » Postponed
nod_’s picture

Status: Postponed » Needs review

leaving NR for now, we'll put it back to NW after the other one has landed, no reason to hold up work on this one.

hass’s picture

I do not like to re-role the other monster patch. So this is to prevent commit conflict.

nod_’s picture

this one is pretty far from rtbc anyway so there shouldn't be a problem.

jessebeach’s picture

Sorry for the long absence here. We've finally gotten through the bulk of issues with in-place edit and this has popped to the top of my queue again.

Thank you everyone for that patches this far. Here are a few comments.

+++ b/core/modules/toolbar/css/toolbar.base.cssundefined
@@ -225,3 +213,61 @@ html.js .toolbar {
+
+/** ¶
+ * If toolbar was not processed, show
+ * first tray on tab hover and hide elements
+ * that don't work, like buttons.
+ */
+html:not(.js) .tray,
+html:not(.js) .tray.vertical {
+  top: 0;
+  display: block;
+  width: 35px;
+  height: 39px;
+  opacity: 0;
+  border: none;
+  -webkit-transition: opacity 0.25s;
+  -moz-transition: opacity 0.25s;
+  -ms-transition: opacity 0.25s;
+  -o-transition: opacity 0.25s;
+  transition: opacity 0.25s;
+}
+html:not(.js) .tray:after {
+  content: '';
+  border-color: transparent transparent #fff transparent;
+  border-style: solid;
+  border-width: 5px;
+  display: block;
+  position: absolute;
+  bottom: 0;
+  left: 50%;
+  margin-left: -5px;
+}
+html:not(.js) .tray .lining {
+  position: fixed;
+  top: 0;
+  left: 0;
+  overflow: hidden;
+  margin-top: 39px;
+  width: 100%;
+  height: 0;
+}
+html:not(.js) .tray li {
+  float:left;
+}
+html:not(.js) .tray:hover {
+  opacity: 1;
+}
+html:not(.js) .tray:hover .lining {
+  height: auto;
+}
+html:not(.js) .tray li button,
+html:not(.js) .tray .toggle-orientation,
+html:not(.js) .tray:hover ~ .tray {
+  display:none;
+}
+html:not(.js) #toolbar-tray {     left: 97px; }
+html:not(.js) #toolbar-tray--2 {  left: 189px;}
+html:not(.js) #toolbar-tray--3 {  left: 310px;}

I wish we could use :not(), but it is not supported by IE8.

http://caniuse.com/#search=%3Anot

For this issue, the primary purpose of support a no-js presentation is to at least make the experience on IE8 and its ilk acceptable. We do this so that if the JavaScript evolves past IE8's abilities, we won't have broken the experience for the unfortunates who are still stuck with Internet Exploder.

Also, we can't target the trays by their machine-generated IDs, e.g. #toolbar-tray--2 because these values are not stable. They are used by the JavaScript and the association between tab and tray is made automatically.

updated patch

I'm taking the approach that we don't need to provide the full toolbar experience of trays to a non-js UI. We're approaching D8 from the perspective of progressive enhancement, not complete feature fidelity even in User Agents that don't provide basic feature support. Without the trays, when a user clicks on the Menu tab or the Shortcuts tab, they are taken to the page for this menu item. That is perfectly acceptable. This is why those elements are anchor tags instead of buttons. Sure, it's more clicking. But more clicking is what you get when JavaScript is turned off. JavaScript enhances the experience. It makes things faster and more efficient.

So I've hidden the trays by default. They stay hidden without JavaScript. The top bar is available and its position remains static. A user can click Admin and get to the /admin path. All of the admin links are available from there. The same is true for the Shortcut and User tabs.

I was able to remove all of the .js class scoping declarations.

Positioning of the toolbar must be static without JavaScript, because we use JS to determine how far to pad the top of the body from the top to accomodate the visual space that the toolbar consumes. A position of fixed or absolute pulls the toolbar out of the document flow, so we need JS to calculate its height and adjust the page contents placement.

I coded and tested with the following combos in mind:

no-JS/no-MediaQuery - IE8 without the ie8 module

In this case, the user simply sees the black administration bar, there are no trays. Menu items are found by following the admin menu tree.

In this case, the user simply sees the black administration bar, there are no trays. Menu items are found by following the admin menu tree.

no-JS/MediaQuery - Chrome with JS disabled

In this case, the user simply sees the black administration bar, there are no trays. Menu items are found by following the admin menu tree.

JS/no-MediaQuery - IE8 with the ie8 module

In this case, the user simply sees the black administration bar, there are no trays. Menu items are found by following the admin menu tree.

JS/MediaQuery - Chrome

Only when JS is enabled and media queries are supported does the user get access to the the full flexibility of the toolbar layout and positioning. In order to reduce the subtle complexities between JavaScript and CSS, the CSS is now driven from classes added to the page by the toolbar JavaScript. The JavaScript is driven from event handlers bound to window.matchMedia checks fed by breakpoint configurations. So now, the placement of the breakpoints can be adjusted t through configuration rather than overriding CSS.

I was able to greatly reduce the size and complexity of toolbar.module.css. Although I had to add some JavaScript, those changes will be incorporated into the patch posted by droplet in #1860434-39: Refactor the Toolbar JavaScript to use Backbone; fix several poorly functioning behaviors. I will rerolling that patch after this one, based on this one.

jessebeach’s picture

georgestephanis’s picture

First thought is that I'm a bit concerned with the efficiency of how the CSS rules will be applied to the DOM regarding how some of the selectors have changed from

.js[dir="rtl"] .something {}

to

[dir="rtl"] .something {}

This is bumping the speed at which the selector can fail from being class-based to being universal attribute-based.

Reference: https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Writing_efficient...

As these are all (by my understanding) based off the html element, I'd recommend swapping it to:

html[dir="rtl"] .something {}

so the CSS rendering engine doesn't have to scan every element in the DOM for having dir="rtl"

(Or, if tweaking the dom is an option, adding an ID to html, to make the queries against it super-speedy)

(Yes, unrelated to the actual thrust of the ticket, but it can be a fairly sizable performance hit if you look at profiling the CSS rendering -- sorry for the digression, though)

EDIT: Ignore me, https://drupal.org/node/2015789

jessebeach’s picture

@georgestephanis, that's a legit point in #25, but it's not germane to this issue. I'd leave a comment in #2015789: Remove language_css_alter() (RTL stylesheets) in favor of HTML 'dir' attribute.

jessebeach’s picture

What we want to test in this issue is that the toolbar works in the following scenarios:

  • no-js/no-media-query - IE8, JavaScript disabled
  • js/no-media-query - IE8, js
  • no-js/media-query - Chrome, JavaScript disabled
  • js/media-query - Chrome

And in each of those 4 states, that the toolbar displays well in the following viewport size ranges:

  • narrow - single column, no overlap with content, menu scrolls with page
  • standard - horizontal bar, vertical tray, both scroll with content
  • wide - horizontal bar, horizontal tray, both are fixed to the viewport; horizontal bar, vertical tray, both are fixed to the viewport, tray scrolls internally.
ry5n’s picture

I’m not able to do patch testing right now, but I’ve reviewed the CSS. Although in theory it could be improved as part of #1921610: [Meta] Architect our CSS, I don’t see anything that should prevent commit now. In fact, there’s less CSS on the whole and most selectors are simpler. The only thing that stands out is this:

+++ b/core/modules/toolbar/css/toolbar.theme.cssundefined
@@ -132,14 +126,14 @@
+[dir="rtl"] .toolbar .vertical .menu .menu .menu .menu {
   margin-left: 0;
   margin-right: 0.25em;

There has to be a better solution for styling nested menus, but – again – IMO this isn’t a blocker; it can be done as part of post-freeze cleanup.

Thumbs up from me.

nod_’s picture

Status: Needs review » Reviewed & tested by the community

tested on mobile. chrome and ff no js. works as expected.

Wim Leers’s picture

Title: Reduce the dependency on javascript for the toolbar to display properly » Reduce the dependency on JavaScript for the toolbar to display properly
Issue tags: +sprint, +Spark
jessebeach’s picture

@ekl1773 noted that the toolbar break in IE8- without JavaScript. Further investigation revealed that this is because the HTMLShiv isn't loaded with JS, so the <nav> around the toolbar is prematurely closed by IE. Not much we can do about this, since a lot of stuff in our themes break without the shiv. I don't consider this an issue. Ancient browser? No JavaScript? Ya, the internet is going to look broken. Note, this is just the experience for authenticated users with permission to use the toolbar on IE8- with JavaScript turned off. It's still usable, just not pretty.

Without JS on IE8-, using a div element instead of a nav element

Windows_XP_SP2_IE8_Native__Running_-2.png

Without JS on IE8-, using a nav element instead of a div element

Windows_XP_SP2_IE8_Native__Running_.png

We're not going to sacrifice semantic HTML for this extreme and fading corner case.

ekl1773’s picture

Confirmed pre-patch behavior with JS off in Chrome and IE, menu displays as raw list as above. Here are my results with the patch applied:

no-js/no-media-query - IE8, JavaScript disabled

Tested, double checked with jbeach as above in #31, IE8 behaves very badly without JS at any size.
IE8 no JS all sizes.png

js/no-media-query - IE8, js

narrow: Tabs pile up in bar, trays open as pages in tree.
IE8 JS narrow.png
standard: Tabs spread out in horizontal bar, trays open as pages
IE8 JS standard.png
wide: "
IE8 JS wide.png

no-js/media-query - Chrome, JavaScript disabled

narrow: Bar scrolls with page. No tray, new page appears instead.
Chrome no-JS narrow.png
standard: Bar scrolls with page
Chrome no-JS standard.png
wide: Bar scrolls with page.
Chrome no-JS wide.png

js/media-query - Chrome

narrow: Toolbar and tray scroll with the page. Tray is single column. Content slides under tray.
Chrome JS Narrow.png
standard: Bar and tray are fixed, scrolling inside vertical tray scrolls content as well but scrolling content doesn't budge tray.
Chrome JS standard.png
wide: Bar and tray are fixed to viewport in both cases. Tray does scroll internally in vertical.
Chrome JS wide.png

YesCT’s picture

Issue tags: +RTBC July 1

This issue was RTBC and passing tests on July 1, the beginning of API freeze.

jessebeach’s picture

Issue summary: View changes

a little grammar fix

hass’s picture

What's holding the commit back?

Gábor Hojtsy’s picture

jessebeach’s picture

Status: Reviewed & tested by the community » Needs review
FileSize
22.39 KB

Rerolled on current HEAD (e0f675f3b24735df93b03a6983aa7cfc23235322)

No code was changed in this patch. There were many conflict with the change from [dir=rtl] to [dir="rtl"]. This can be set back to RTBC once it comes back green. See #33.

dsnopek’s picture

Status: Needs review » Reviewed & tested by the community

RTBC'd! I'd love to see this go in. :-)

jessebeach’s picture

This was committed: 1cb65032844cb12907ed484e3c17ded1528ea44f

Updated the dependent patches in the chain above this one.

#1938044: Prefix all toolbar classes to prevent theme clashes
#1860434: Refactor the Toolbar JavaScript to use Backbone; fix several poorly functioning behaviors

hass’s picture

Status: Reviewed & tested by the community » Fixed

This means we have status fixed here?

Gábor Hojtsy’s picture

Status: Fixed » Closed (fixed)

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

tim.plunkett’s picture

tim.plunkett’s picture

Issue summary: View changes

put in the template

Wim Leers’s picture

droplet’s picture