Skip to content

Commit 52fc846

Browse files
borsnotriddle
bors
authored and
notriddle
committed
Rustdoc accessibility: use real headers for doc items
Part of rust-lang#87059 Partially reverts rust-lang#84703 Backport of rust-lang#87390 Preview at: https://notriddle.com/notriddle-rustdoc-test/real-headers/std/index.html
1 parent c8fb0b5 commit 52fc846

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

74 files changed

+218
-210
lines changed

‎src/librustdoc/html/render/mod.rs‎

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1214,7 +1214,7 @@ fn notable_traits_decl(decl: &clean::FnDecl, cx: &Context<'_>) -> String {
12141214
if out.is_empty() {
12151215
write!(
12161216
&mut out,
1217-
"<h3 class=\"notable\">Notable traits for {}</h3>\
1217+
"<div class=\"notable\">Notable traits for {}</div>\
12181218
<code class=\"content\">",
12191219
impl_.for_.print(cx)
12201220
);
@@ -1370,15 +1370,15 @@ fn render_impl(
13701370
"<div id=\"{}\" class=\"{}{} has-srclink\">",
13711371
id, item_type, in_trait_class,
13721372
);
1373-
w.write_str("<code>");
1373+
w.write_str("<h4 class=\"code-header\">");
13741374
render_assoc_item(
13751375
w,
13761376
item,
13771377
link.anchor(source_id.as_ref().unwrap_or(&id)),
13781378
ItemType::Impl,
13791379
cx,
13801380
);
1381-
w.write_str("</code>");
1381+
w.write_str("</h4>");
13821382
render_stability_since_raw(
13831383
w,
13841384
item.stable_since(tcx).as_deref(),
@@ -1396,7 +1396,7 @@ fn render_impl(
13961396
let id = cx.derive_id(source_id.clone());
13971397
write!(
13981398
w,
1399-
"<div id=\"{}\" class=\"{}{} has-srclink\"><code>",
1399+
"<div id=\"{}\" class=\"{}{} has-srclink\"><h4 class=\"code-header\">",
14001400
id, item_type, in_trait_class
14011401
);
14021402
assoc_type(
@@ -1408,7 +1408,7 @@ fn render_impl(
14081408
"",
14091409
cx,
14101410
);
1411-
w.write_str("</code>");
1411+
w.write_str("</h4>");
14121412
write!(w, "<a href=\"#{}\" class=\"anchor\"></a>", id);
14131413
w.write_str("</div>");
14141414
}
@@ -1417,7 +1417,7 @@ fn render_impl(
14171417
let id = cx.derive_id(source_id.clone());
14181418
write!(
14191419
w,
1420-
"<div id=\"{}\" class=\"{}{} has-srclink\"><code>",
1420+
"<div id=\"{}\" class=\"{}{} has-srclink\"><h4 class=\"code-header\">",
14211421
id, item_type, in_trait_class
14221422
);
14231423
assoc_const(
@@ -1429,7 +1429,7 @@ fn render_impl(
14291429
"",
14301430
cx,
14311431
);
1432-
w.write_str("</code>");
1432+
w.write_str("</h4>");
14331433
render_stability_since_raw(
14341434
w,
14351435
item.stable_since(tcx).as_deref(),
@@ -1444,7 +1444,7 @@ fn render_impl(
14441444
clean::AssocTypeItem(ref bounds, ref default) => {
14451445
let source_id = format!("{}.{}", item_type, name);
14461446
let id = cx.derive_id(source_id.clone());
1447-
write!(w, "<div id=\"{}\" class=\"{}{}\"><code>", id, item_type, in_trait_class,);
1447+
write!(w, "<div id=\"{}\" class=\"{}{}\"><h4 class=\"code-header\">", id, item_type, in_trait_class,);
14481448
assoc_type(
14491449
w,
14501450
item,
@@ -1454,7 +1454,7 @@ fn render_impl(
14541454
"",
14551455
cx,
14561456
);
1457-
w.write_str("</code>");
1457+
w.write_str("</h4>");
14581458
write!(w, "<a href=\"#{}\" class=\"anchor\"></a>", id);
14591459
w.write_str("</div>");
14601460
}
@@ -1641,7 +1641,7 @@ fn render_impl_summary(
16411641
write!(
16421642
w,
16431643
"<div id=\"{}\" class=\"impl has-srclink\"{}>\
1644-
<code class=\"in-band\">",
1644+
<h3 class=\"code-header in-band\">",
16451645
id, aliases
16461646
);
16471647
write!(w, "{}", i.inner_impl().print(use_absolute, cx));
@@ -1654,12 +1654,12 @@ fn render_impl_summary(
16541654
}
16551655
}
16561656
}
1657-
w.write_str("</code>");
1657+
w.write_str("</h3>");
16581658
} else {
16591659
write!(
16601660
w,
16611661
"<div id=\"{}\" class=\"impl has-srclink\"{}>\
1662-
<code class=\"in-band\">{}</code>",
1662+
<h3 class=\"code-header in-band\">{}</h3>",
16631663
id,
16641664
aliases,
16651665
i.inner_impl().print(false, cx)

‎src/librustdoc/html/render/print_item.rs‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -585,9 +585,9 @@ fn item_trait(w: &mut Buffer, cx: &Context<'_>, it: &clean::Item, t: &clean::Tra
585585
if toggled {
586586
write!(w, "<details class=\"rustdoc-toggle\" open><summary>");
587587
}
588-
write!(w, "<div id=\"{}\" class=\"method has-srclink\"><code>", id);
588+
write!(w, "<div id=\"{}\" class=\"method has-srclink\"><h4 class=\"code-header\">", id);
589589
render_assoc_item(w, m, AssocItemLink::Anchor(Some(&id)), ItemType::Impl, cx);
590-
w.write_str("</code>");
590+
w.write_str("</h4>");
591591
render_stability_since(w, m, t, cx.tcx());
592592
write_srclink(cx, m, w);
593593
w.write_str("</div>");

‎src/librustdoc/html/static/main.js‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -703,8 +703,10 @@ function hideThemeButtonState() {
703703
}
704704
}
705705

706-
var code = document.createElement("code");
706+
var code = document.createElement("h3");
707707
code.innerHTML = struct.text;
708+
addClass(code, "code-header");
709+
addClass(code, "in-band");
708710

709711
onEachLazy(code.getElementsByTagName("a"), function(elem) {
710712
var href = elem.getAttribute("href");

‎src/librustdoc/html/static/rustdoc.css‎

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -137,6 +137,13 @@ h1.fqn > .in-band > a:hover {
137137
h2, h3, h4 {
138138
border-bottom: 1px solid;
139139
}
140+
h3.code-header, h4.code-header {
141+
font-size: 1em;
142+
font-weight: 600;
143+
border: none;
144+
padding: 0;
145+
margin: 0;
146+
}
140147
.impl, .method,
141148
.type:not(.container-rustdoc), .associatedconstant,
142149
.associatedtype {
@@ -190,7 +197,7 @@ summary {
190197
outline: none;
191198
}
192199

193-
code, pre, a.test-arrow {
200+
.code-header, code, pre, a.test-arrow {
194201
font-family: "Source Code Pro", monospace;
195202
}
196203
.docblock code, .docblock-short code {
@@ -470,7 +477,7 @@ nav.sub {
470477
font-weight: normal;
471478
}
472479

473-
.method > code, .trait-impl > code, .invisible > code {
480+
.method > .code-header, .trait-impl > .code-header, .invisible > .code-header {
474481
max-width: calc(100% - 41px);
475482
display: block;
476483
}
@@ -486,7 +493,7 @@ nav.sub {
486493
padding: 0px;
487494
}
488495

489-
.in-band > code {
496+
.in-band > code, .in-band > .code-header {
490497
display: inline-block;
491498
}
492499

@@ -686,7 +693,7 @@ a {
686693
}
687694

688695
.invisible > .srclink,
689-
.method > code + .srclink {
696+
.method > .code-header + .srclink {
690697
position: absolute;
691698
top: 0;
692699
right: 0;
@@ -1041,8 +1048,7 @@ a.test-arrow:hover{
10411048
display: block;
10421049
}
10431050

1044-
1045-
:target > code {
1051+
:target > code, :target > .code-header {
10461052
opacity: 1;
10471053
}
10481054

‎src/librustdoc/html/static/themes/ayu.css‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -334,7 +334,7 @@ a.test-arrow:hover {
334334
color: #999;
335335
}
336336

337-
:target > code, :target > .in-band {
337+
:target, :target > * {
338338
background: rgba(255, 236, 164, 0.06);
339339
border-right: 3px solid rgba(255, 180, 76, 0.85);
340340
}

‎src/librustdoc/html/static/themes/dark.css‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -282,7 +282,7 @@ a.test-arrow:hover{
282282
color: #999;
283283
}
284284

285-
:target > code, :target > .in-band {
285+
:target, :target > * {
286286
background-color: #494a3d;
287287
border-right: 3px solid #bb7410;
288288
}

‎src/librustdoc/html/static/themes/light.css‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -275,7 +275,7 @@ a.test-arrow:hover{
275275
color: #999;
276276
}
277277

278-
:target > code, :target > .in-band {
278+
:target, :target > * {
279279
background: #FDFFD3;
280280
border-right: 3px solid #ffb44c;
281281
}

‎src/test/rustdoc/assoc-consts.rs‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ pub trait Foo {
1313
pub struct Bar;
1414

1515
impl Foo for Bar {
16-
// @has assoc_consts/struct.Bar.html '//code' 'impl Foo for Bar'
16+
// @has assoc_consts/struct.Bar.html '//h3[@class="code-header in-band"]' 'impl Foo for Bar'
1717
// @has - '//*[@id="associatedconstant.FOO"]' 'const FOO: usize'
1818
const FOO: usize = 12;
1919
// @has - '//*[@id="associatedconstant.FOO_NO_DEFAULT"]' 'const FOO_NO_DEFAULT: bool'
@@ -77,7 +77,7 @@ pub trait Qux {
7777
const QUX_DEFAULT2: u32 = 3;
7878
}
7979

80-
// @has assoc_consts/struct.Bar.html '//code' 'impl Qux for Bar'
80+
// @has assoc_consts/struct.Bar.html '//h3[@class="code-header in-band"]' 'impl Qux for Bar'
8181
impl Qux for Bar {
8282
// @has - '//*[@id="associatedconstant.QUX0"]' 'const QUX0: u8'
8383
// @has - '//*[@class="docblock"]' "Docs for QUX0 in trait."

‎src/test/rustdoc/assoc-types.rs‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@
22

33
// @has assoc_types/trait.Index.html
44
pub trait Index<I: ?Sized> {
5-
// @has - '//*[@id="associatedtype.Output"]//code' 'type Output: ?Sized'
5+
// @has - '//*[@id="associatedtype.Output"]//h4[@class="code-header"]' 'type Output: ?Sized'
66
type Output: ?Sized;
7-
// @has - '//*[@id="tymethod.index"]//code' \
7+
// @has - '//*[@id="tymethod.index"]//h4[@class="code-header"]' \
88
// "fn index<'a>(&'a self, index: I) -> &'a Self::Output"
9-
// @has - '//*[@id="tymethod.index"]//code//a[@href="trait.Index.html#associatedtype.Output"]' \
9+
// @has - '//*[@id="tymethod.index"]//h4[@class="code-header"]//a[@href="trait.Index.html#associatedtype.Output"]' \
1010
// "Output"
1111
fn index<'a>(&'a self, index: I) -> &'a Self::Output;
1212
}

‎src/test/rustdoc/async-fn.rs‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -35,9 +35,9 @@ pub async fn quux() -> impl Bar {
3535
}
3636

3737
// @has async_fn/struct.Foo.html
38-
// @matches - '//code' 'pub async fn f\(\)$'
39-
// @matches - '//code' 'pub async unsafe fn g\(\)$'
40-
// @matches - '//code' 'pub async fn mut_self\(self, first: usize\)$'
38+
// @matches - '//h4[@class="code-header"]' 'pub async fn f\(\)$'
39+
// @matches - '//h4[@class="code-header"]' 'pub async unsafe fn g\(\)$'
40+
// @matches - '//h4[@class="code-header"]' 'pub async fn mut_self\(self, first: usize\)$'
4141
pub struct Foo;
4242

4343
impl Foo {

0 commit comments

Comments
 (0)