src/test/rustdoc-gui/sidebar-mobile.goml

   1 // This test ensure that the sidebar isn't "hidden" on mobile but instead moved out of the viewport.
   2 // This is especially important for devices for "text-first" content (like for users with
   3 // sight issues).
   4 goto: "file://" + |DOC_PATH| + "/test_docs/struct.Foo.html"
   5 // Switching to "mobile view" by reducing the width to 600px.
   6 size: (600, 600)
   7 assert-css: (".sidebar", {"display": "block", "left": "-1000px"})
   8 // Opening the sidebar menu.
   9 click: ".sidebar-menu-toggle"
  10 assert-css: (".sidebar", {"display": "block", "left": "0px"})
  11 // Closing the sidebar menu.
  12 click: ".sidebar-menu-toggle"
  13 assert-css: (".sidebar", {"display": "block", "left": "-1000px"})
  14 // Force the sidebar open by focusing a link inside it.
  15 // This makes it easier for keyboard users to get to it.
  16 focus: ".sidebar-elems h3 a"
  17 assert-css: (".sidebar", {"display": "block", "left": "0px"})
  18 // When we tab out of the sidebar, close it.
  19 focus: ".search-input"
  20 assert-css: (".sidebar", {"display": "block", "left": "-1000px"})
  21
  22 // Open the sidebar menu.
  23 click: ".sidebar-menu-toggle"
  24 assert-css: (".sidebar", {"left": "0px"})
  25
  26 // Make sure the "struct Foo" header is hidden, since the mobile topbar already does it.
  27 assert-css: ("//nav[contains(@class, 'sidebar')]//h2/a[text()='Foo']/parent::h2", {"display": "none"})
  28 // Make sure the global navigation is still here.
  29 assert-css: ("//nav[contains(@class, 'sidebar')]//h2/a[text()='In test_docs']/parent::h2", {"display": "block"})
  30
  31 // Click elsewhere.
  32 click: "body"
  33 assert-css: (".sidebar", {"display": "block", "left": "-1000px"})
  34
  35 // Check that the topbar is visible
  36 assert-property: (".mobile-topbar", {"clientHeight": "45"})
  37
  38 // Check that clicking an element from the sidebar scrolls to the right place
  39 // so the target is not obscured by the topbar.
  40 click: ".sidebar-menu-toggle"
  41 click: ".sidebar-elems section .block li > a"
  42 assert-position: ("#method\.must_use", {"y": 45})
  43
  44 // Check that the bottom-most item on the sidebar menu can be scrolled fully into view.
  45 click: ".sidebar-menu-toggle"
  46 scroll-to: ".block.keyword li:nth-child(1)"
  47 compare-elements-position-near: (".block.keyword li:nth-child(1)", ".mobile-topbar", {"y": 543.19})
  48
  49 // Now checking the background color of the sidebar.
  50 show-text: true
  51 local-storage: {"rustdoc-use-system-theme": "false", "rustdoc-theme": "dark"}
  52 reload:
  53
  54 // Open the sidebar menu.
  55 click: ".sidebar-menu-toggle"
  56 assert-css: (".sidebar", {"background-color": "rgb(80, 80, 80)", "color": "rgb(221, 221, 221)"})
  57
  58 local-storage: {"rustdoc-use-system-theme": "false", "rustdoc-theme": "ayu"}
  59 reload:
  60
  61 // Open the sidebar menu.
  62 click: ".sidebar-menu-toggle"
  63 assert-css: (".sidebar", {"background-color": "rgb(20, 25, 31)", "color": "rgb(197, 197, 197)"})
  64
  65 local-storage: {"rustdoc-use-system-theme": "false", "rustdoc-theme": "light"}
  66 reload:
  67
  68 // Open the sidebar menu.
  69 click: ".sidebar-menu-toggle"
  70 assert-css: (".sidebar", {"background-color": "rgb(245, 245, 245)", "color": "rgb(0, 0, 0)"})