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

// Test various properties of the mobile UI
goto: file://|DOC_PATH|/staged_api/struct.Foo.html
size: (400, 600)

font-size: 18

// The out-of-band info (source, stable version, collapse) should be below the
// h1 when the screen gets narrow enough.
assert-css: (".main-heading", {
  "display": "flex",
  "flex-direction": "column"
})

assert-property: (".mobile-topbar h2.location", {"offsetHeight": 36})

// Note: We can't use assert-text here because the 'Since' is set by CSS and
// is therefore not part of the DOM.
assert-css: (".content .out-of-band .since::before", { "content": "\"Since \"" })

size: (1000, 1000)
assert-css-false: (".content .out-of-band .since::before", { "content": "\"Since \"" })

// On the settings page, the theme buttons should not line-wrap. Instead, they should
// all be placed as a group on a line below the setting name "Theme."
goto: file://|DOC_PATH|/settings.html
size: (400, 600)
compare-elements-position-near-false: ("#preferred-light-theme .setting-name", "#preferred-light-theme .choice", {"y": 16})
Rustdoc mobile: put out-of-band on its own line Before this, the item name and the stability, source link, and "collapse all docs" would compete for room on a single line, resulting in awkward wrapping behavior on mobile. This gives a separate line for that out-of-band information. It also removes the "copy path" icon on mobile to make a little more room. Also, switch to flex-wrap: wrap, so anytime there's not enough room for `source`, it gets bumped to the next line. 2022-01-13 17:54:44 +00:00			`// Test various properties of the mobile UI`
			`goto: file://\|DOC_PATH\|/staged_api/struct.Foo.html`
			`size: (400, 600)`

rustdoc: small fixes to mobile navigation - Make sure the mobile-topbar doesn't overflow its height if the user sets a bigger font. - Make sure the sidebar can be scrolled all the way to the bottom by shortening it to accommodate the mobile-topbar. - Make the item name in the mobile-topbar clickable to go to the top of the page. - Remove excess padding sidebar in mobile mode. 2022-01-22 01:44:54 +00:00			`font-size: 18`

Rustdoc mobile: put out-of-band on its own line Before this, the item name and the stability, source link, and "collapse all docs" would compete for room on a single line, resulting in awkward wrapping behavior on mobile. This gives a separate line for that out-of-band information. It also removes the "copy path" icon on mobile to make a little more room. Also, switch to flex-wrap: wrap, so anytime there's not enough room for `source`, it gets bumped to the next line. 2022-01-13 17:54:44 +00:00			`// The out-of-band info (source, stable version, collapse) should be below the`
			`// h1 when the screen gets narrow enough.`
			`assert-css: (".main-heading", {`
			`"display": "flex",`
			`"flex-direction": "column"`
			`})`

rustdoc: tweak line and ¶ spacing for a11y The W3C Web Content Accessibility Guidelines specify a minimum line spacing of 1.5 and a minimum paragraph spacing of 1.5 times the line spacing. Our current line spacing (implemented by line-height) is 1.4, so it's a small bump to go up to 1.5. Similarly, we have a paragraph spacing of 0.6em. Bump that to 0.75em (which is 1.5 times the 0.5em distance between lines). Also, fix all the font sizes so instead of being round-ish numbers in rem (like 1.1rem, 1.2rem), they are round numbers in pixels. Ensure each font size is at least 2 pixels different than the nearest other font size, so distinctions can be clearly seen. Overall the font-sizes are mostly staying the same, being rounded up or down as appropriate. Remove a few unused styles. Simplify the display of the mobile-topbar location, by setting its margins to auto rather than trying to size it exactly to the topbar. 2022-02-05 13:05:05 +00:00			`assert-property: (".mobile-topbar h2.location", {"offsetHeight": 36})`
rustdoc: small fixes to mobile navigation - Make sure the mobile-topbar doesn't overflow its height if the user sets a bigger font. - Make sure the sidebar can be scrolled all the way to the bottom by shortening it to accommodate the mobile-topbar. - Make the item name in the mobile-topbar clickable to go to the top of the page. - Remove excess padding sidebar in mobile mode. 2022-01-22 01:44:54 +00:00
Rustdoc mobile: put out-of-band on its own line Before this, the item name and the stability, source link, and "collapse all docs" would compete for room on a single line, resulting in awkward wrapping behavior on mobile. This gives a separate line for that out-of-band information. It also removes the "copy path" icon on mobile to make a little more room. Also, switch to flex-wrap: wrap, so anytime there's not enough room for `source`, it gets bumped to the next line. 2022-01-13 17:54:44 +00:00			`// Note: We can't use assert-text here because the 'Since' is set by CSS and`
			`// is therefore not part of the DOM.`
			`assert-css: (".content .out-of-band .since::before", { "content": "\"Since \"" })`

			`size: (1000, 1000)`
			`assert-css-false: (".content .out-of-band .since::before", { "content": "\"Since \"" })`
Improve wrapping on settings page Previously, the radio button choices for themes would wrap awkwardly on narrow screens. With this change, the group of choices will prefer bumping down to the next line together, leaving the setting name on its own line. Also fix some minor spacing issues: - Align the setting name vertically with the radio button choices. - Use margin instead of padding for most spacing choices. - Use no margin/padding on the right-hand side. 2022-01-28 13:21:34 +00:00
			`// On the settings page, the theme buttons should not line-wrap. Instead, they should`
			`// all be placed as a group on a line below the setting name "Theme."`
			`goto: file://\|DOC_PATH\|/settings.html`
			`size: (400, 600)`
			`compare-elements-position-near-false: ("#preferred-light-theme .setting-name", "#preferred-light-theme .choice", {"y": 16})`