The documentation fails to properly explain the difference between narrow and normal mode, in particular the fact that toggle ONLY WORKS in narrow mode!
That makes it incredibly hard to reverse engineer this complicated behavior (by studying a shitton of code).
Moreover, the documentation just plainly states:
"The drawer will slide in/out to hide/reveal the main panel."
It's absolutely not clear that this statement is about narrow layout, and narrow layout only, so confusing and misleading.
Some buttons would just disappear in narrow mode, nothing written about that, too.
Expected outcome
Fix the documentation, properly and fully explain the differences between narrow and normal mode.
At least describe how toggling behavior changes between narrow/normal modes and how standard buttons would appear and disappear from page (e.g. with attribute paper-drawer-toggle).
Description
https://elements.polymer-project.org/elements/paper-drawer-panel
The documentation fails to properly explain the difference between narrow and normal mode, in particular the fact that toggle ONLY WORKS in narrow mode! That makes it incredibly hard to reverse engineer this complicated behavior (by studying a shitton of code).
Moreover, the documentation just plainly states: "The drawer will slide in/out to hide/reveal the main panel." It's absolutely not clear that this statement is about narrow layout, and narrow layout only, so confusing and misleading. Some buttons would just disappear in narrow mode, nothing written about that, too.
Expected outcome
Fix the documentation, properly and fully explain the differences between narrow and normal mode. At least describe how toggling behavior changes between narrow/normal modes and how standard buttons would appear and disappear from page (e.g. with attribute paper-drawer-toggle).
Actual outcome
Live Demo
https://elements.polymer-project.org/elements/paper-drawer-panel
Steps to reproduce
open this and read https://elements.polymer-project.org/elements/paper-drawer-panel