Skip to content

Commit

Permalink
auto merge of #15037 : zzmp/rust/doc/hotkeys, r=alexcrichton
Browse files Browse the repository at this point in the history
Continuing from #15012, this makes four changes to the `rustdoc` static files.

- Change the placeholder text of the search bar to `Click or press 'S' to search, '?' for more options...` to make keyboard hotkeys more apparent (capitalizing the `S` to match the help text).
- Change the `main.js` file to use browser-normalized key codes (`e.which`, from `jQuery`), instead of `e.keyCode`.
- Change the key code for `?` to be the correct `191` instead of `188`, so that the hotkey works to bring up search information.
- Change the search information to display `tab` and `shift+tab` instead of `up` and `down`, as those do not yet work outside of Firefox (see #15011). Also, adjust the height so it does not cut off the help text.

<s>I've also opened up #15038 about the non-functional `up` and `down` functionality, although this does nothing to fix it.</s>
  • Loading branch information
bors committed Jun 19, 2014
2 parents 22d62fc + 677e6ed commit 40ca89e
Show file tree
Hide file tree
Showing 3 changed files with 10 additions and 10 deletions.
6 changes: 3 additions & 3 deletions src/librustdoc/html/layout.rs
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ r##"<!DOCTYPE html>
<div class="search-container">
<input class="search-input" name="search"
autocomplete="off"
placeholder="Click or press 's' to search, '?' for more options..."
placeholder="Click or press 'S' to search, '?' for more options..."
type="search">
</div>
</form>
Expand All @@ -82,9 +82,9 @@ r##"<!DOCTYPE html>
<dd>Show this help dialog</dd>
<dt>S</dt>
<dd>Focus the search field</dd>
<dt>&uarr;</dt>
<dt>&larrb;</dt>
<dd>Move up in search results</dd>
<dt>&darr;</dt>
<dt>&rarrb;</dt>
<dd>Move down in search results</dd>
<dt>&#9166;</dt>
<dd>Go to active search result</dd>
Expand Down
2 changes: 1 addition & 1 deletion src/librustdoc/html/static/main.css
Original file line number Diff line number Diff line change
Expand Up @@ -347,7 +347,7 @@ p a:hover { text-decoration: underline; }
margin-top: -125px;
margin-left: -275px;
width: 550px;
height: 250px;
height: 300px;
border: 1px solid #bfbfbf;
}

Expand Down
12 changes: 6 additions & 6 deletions src/librustdoc/html/static/main.js
Original file line number Diff line number Diff line change
Expand Up @@ -71,10 +71,10 @@
return;
}

if (e.keyCode === 188 && $('#help').hasClass('hidden')) { // question mark
if (e.which === 191 && $('#help').hasClass('hidden')) { // question mark
e.preventDefault();
$('#help').removeClass('hidden');
} else if (e.keyCode === 27) { // esc
} else if (e.which === 27) { // esc
if (!$('#help').hasClass('hidden')) {
e.preventDefault();
$('#help').addClass('hidden');
Expand All @@ -83,7 +83,7 @@
$('#search').addClass('hidden');
$('#main').removeClass('hidden');
}
} else if (e.keyCode === 83) { // S
} else if (e.which === 83) { // S
e.preventDefault();
$('.search-input').focus();
}
Expand Down Expand Up @@ -361,23 +361,23 @@
$(document).on('keypress.searchnav', function(e) {
var $active = $results.filter('.highlighted');

if (e.keyCode === 38) { // up
if (e.which === 38) { // up
e.preventDefault();
if (!$active.length || !$active.prev()) {
return;
}

$active.prev().addClass('highlighted');
$active.removeClass('highlighted');
} else if (e.keyCode === 40) { // down
} else if (e.which === 40) { // down
e.preventDefault();
if (!$active.length) {
$results.first().addClass('highlighted');
} else if ($active.next().length) {
$active.next().addClass('highlighted');
$active.removeClass('highlighted');
}
} else if (e.keyCode === 13) { // return
} else if (e.which === 13) { // return
e.preventDefault();
if ($active.length) {
document.location.href = $active.find('a').prop('href');
Expand Down

0 comments on commit 40ca89e

Please sign in to comment.