]> git.lizzy.rs Git - rust.git/commit
rustdoc: clean up docblock table CSS
authorMichael Howell <michael@notriddle.com>
Thu, 8 Dec 2022 04:59:54 +0000 (21:59 -0700)
committerMichael Howell <michael@notriddle.com>
Thu, 8 Dec 2022 05:49:10 +0000 (22:49 -0700)
commita09e8c55c663d2b070f99ab0fdadbcc2c45656b2
treebb0c155d021df1dbdc08b716bb8a281bc3c6e40b
parentb28d30e1e3c2b90fd08b7dd79d8e63884d1e0339
rustdoc: clean up docblock table CSS

* The rule `display: block` had no noticeable effect. Technically, because
  markdown tables have a tbody and thead, they get wrapped in an [anonymous
  table box] in the CSS tree, nested within the `<table>` element's block
  layout box.

  This rule was added in #87230 to make the table side-scrolling, but
  this same issue was doubly fixed in #88742 by wrapping it in an explicit
  `<div>` tag. Since accessibility advocates recommend the wrapper div over
  marking the table as `display: block`, we'll stick with that.

  https://adrianroselli.com/2020/11/under-engineered-responsive-tables.html

* The rule `width: calc(100% - 2px)` had no visible effect, because the
  anonymous table box was not affected.

* The style is tweaked to basically be the same style GitHub uses.
  In particular, it adds zebra stripes, and removes dotted borders.

[anonymous table box]: https://www.w3.org/TR/CSS2/tables.html#anonymous-boxes
src/librustdoc/html/static/css/rustdoc.css
src/librustdoc/html/static/css/themes/ayu.css
src/librustdoc/html/static/css/themes/dark.css
src/librustdoc/html/static/css/themes/light.css