Commit a55056af authored by Marcia Ramos's avatar Marcia Ramos

Merge branch 'docs-html-style-guide' into 'master'

Docs: Bring HTML Style Guide in line with docs standards

See merge request gitlab-org/gitlab-ce!26252
parents a4b18040 b7b55b46
...@@ -2,11 +2,11 @@ ...@@ -2,11 +2,11 @@
## Buttons ## Buttons
<a name="button-type"></a><a name="1.1"></a> ### Button type
- [1.1](#button-type) **Use button type** Button tags requires a `type` attribute according to the [W3C HTML specification][button-type-spec]. Button tags requires a `type` attribute according to the [W3C HTML specification](https://www.w3.org/TR/2011/WD-html5-20110525/the-button-element.html#dom-button-type).
``` ```html
// bad // bad
<button></button> <button></button>
...@@ -14,11 +14,11 @@ ...@@ -14,11 +14,11 @@
<button type="button"></button> <button type="button"></button>
``` ```
<a name="button-role"></a><a name="1.2"></a> ### Button role
- [1.2](#button-role) **Use button role for non buttons** If an HTML element has an onClick handler but is not a button, it should have `role="button"`. This is more [accessible][button-role-accessible]. If an HTML element has an `onClick` handler but is not a button, it should have `role="button"`. This is [more accessible](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_button_role).
``` ```html
// bad // bad
<div onClick="doSomething"></div> <div onClick="doSomething"></div>
...@@ -28,11 +28,11 @@ ...@@ -28,11 +28,11 @@
## Links ## Links
<a name="blank-links"></a><a name="2.1"></a> ### Blank target
- [2.1](#blank-links) **Use rel for target blank** Use `rel="noopener noreferrer"` whenever your links open in a new window i.e. `target="_blank"`. This prevents [the following][jitbit-target-blank] security vulnerability documented by JitBit Use `rel="noopener noreferrer"` whenever your links open in a new window, i.e. `target="_blank"`. This prevents a security vulnerability [documented by JitBit](https://www.jitbit.com/alexblog/256-targetblank---the-most-underestimated-vulnerability-ever/).
``` ```html
// bad // bad
<a href="url" target="_blank"></a> <a href="url" target="_blank"></a>
...@@ -40,18 +40,14 @@ ...@@ -40,18 +40,14 @@
<a href="url" target="_blank" rel="noopener noreferrer"></a> <a href="url" target="_blank" rel="noopener noreferrer"></a>
``` ```
<a name="fake-links"></a><a name="2.2"></a> ### Fake links
- [2.2](#fake-links) **Do not use fake links** Use a button tag if a link only invokes JavaScript click event handlers. This is more semantic. **Do not use fake links.** Use a button tag if a link only invokes JavaScript click event handlers, which is more semantic.
``` ```html
// bad // bad
<a class="js-do-something" href="#"></a> <a class="js-do-something" href="#"></a>
// good // good
<button class="js-do-something" type="button"></button> <button class="js-do-something" type="button"></button>
``` ```
[button-type-spec]: https://www.w3.org/TR/2011/WD-html5-20110525/the-button-element.html#dom-button-type
[button-role-accessible]: https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_button_role
[jitbit-target-blank]: https://www.jitbit.com/alexblog/256-targetblank---the-most-underestimated-vulnerability-ever/
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment