2018-01-31 01:36:50 +08:00
<!DOCTYPE html>
< html lang = "en" >
< head >
< meta charset = "utf-8" >
< title > Google HTML/CSS Style Guide< / title >
< link rel = "stylesheet" href = "javaguide.css" >
< script src = "include/styleguide.js" > < / script >
< link rel = "shortcut icon" href = "https://www.google.com/favicon.ico" >
< script src = "include/jsguide.js" > < / script >
< / head >
< body onload = "initStyleGuide();" >
< div id = "content" >
< h1 > Google HTML/CSS Style Guide< / h1 >
2022-01-13 00:56:30 +08:00
< h2 id = "Background" class = "numbered" > Background< / h2 >
2018-01-31 01:36:50 +08:00
< p > This document defines formatting and style rules for HTML and CSS. It aims at
improving collaboration, code quality, and enabling supporting infrastructure.
It applies to raw, working files that use HTML and CSS, including GSS files.
Tools are free to obfuscate, minify, and compile as long as the general code
quality is maintained.< / p >
2022-01-13 00:56:30 +08:00
< h2 id = "General" class = "numbered" > General< / h2 >
2018-01-31 01:36:50 +08:00
2022-01-13 00:56:30 +08:00
< h3 id = "General_Style_Rules" class = "numbered" > General Style Rules< / h3 >
2018-01-31 01:36:50 +08:00
2022-01-13 00:56:30 +08:00
< h4 id = "Protocol" class = "numbered" > Protocol< / h4 >
2018-01-31 01:36:50 +08:00
2019-02-22 09:32:43 +08:00
< p > Use HTTPS for embedded resources where possible.< / p >
2018-01-31 01:36:50 +08:00
2022-01-13 00:56:30 +08:00
< p > Always use HTTPS (< code > https:< / code > ) for images and other media files, style sheets, and
scripts, unless the respective files are not available over HTTPS.< / p >
2018-01-31 01:36:50 +08:00
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html bad" > < !-- Not recommended: omits the protocol -->
2019-04-17 15:59:48 +08:00
< script src="//ajax.googleapis.com/ajax/libs/jquery/3.4.0/jquery.min.js"> < /script>
2018-01-31 01:36:50 +08:00
2019-02-22 09:32:43 +08:00
< !-- Not recommended: uses HTTP -->
2019-04-17 15:59:48 +08:00
< script src="http://ajax.googleapis.com/ajax/libs/jquery/3.4.0/jquery.min.js"> < /script>
2018-01-31 01:36:50 +08:00
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html good" > < !-- Recommended -->
2019-04-17 15:59:48 +08:00
< script src="https://ajax.googleapis.com/ajax/libs/jquery/3.4.0/jquery.min.js"> < /script>
2018-01-31 01:36:50 +08:00
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css bad" > /* Not recommended: omits the protocol */
2018-01-31 01:36:50 +08:00
@import '//fonts.googleapis.com/css?family=Open+Sans';
2019-02-22 09:32:43 +08:00
/* Not recommended: uses HTTP */
2018-01-31 01:36:50 +08:00
@import 'http://fonts.googleapis.com/css?family=Open+Sans';
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css good" > /* Recommended */
2018-01-31 01:36:50 +08:00
@import 'https://fonts.googleapis.com/css?family=Open+Sans';
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h3 id = "General_Formatting_Rules" class = "numbered" > General Formatting Rules< / h3 >
2018-01-31 01:36:50 +08:00
2022-01-13 00:56:30 +08:00
< h4 id = "Indentation" class = "numbered" > Indentation< / h4 >
2018-01-31 01:36:50 +08:00
< p > Indent by 2 spaces at a time.< / p >
2022-01-12 22:33:52 +08:00
< p > Don’ < / p >
2018-01-31 01:36:50 +08:00
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html good" > < ul>
2018-01-31 01:36:50 +08:00
< li> Fantastic
< li> Great
< /ul>
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css good" > .example {
2018-01-31 01:36:50 +08:00
color: blue;
}
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "Capitalization" class = "numbered" > Capitalization< / h4 >
2018-01-31 01:36:50 +08:00
< p > Use only lowercase.< / p >
< p > All code has to be lowercase: This applies to HTML element names, attributes,
attribute values (unless < code > text/CDATA< / code > ), CSS selectors, properties, and property
values (with the exception of strings).< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html bad" > < !-- Not recommended -->
2018-01-31 01:36:50 +08:00
< A HREF="/"> Home< /A>
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html good" > < !-- Recommended -->
2018-01-31 01:36:50 +08:00
< img src="google.png" alt="Google">
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css bad" > /* Not recommended */
2018-01-31 01:36:50 +08:00
color: #E5E5E5;
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css good" > /* Recommended */
2018-01-31 01:36:50 +08:00
color: #e5e5e5;
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "Trailing_Whitespace" class = "numbered" > Trailing Whitespace< / h4 >
2018-01-31 01:36:50 +08:00
< p > Remove trailing white spaces.< / p >
< p > Trailing white spaces are unnecessary and can complicate diffs.< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html bad" > < !-- Not recommended -->
2018-01-31 01:36:50 +08:00
< p> What?_
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html good" > < !-- Recommended -->
2018-01-31 01:36:50 +08:00
< p> Yes please.
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h3 id = "General_Meta_Rules" class = "numbered" > General Meta Rules< / h3 >
2018-01-31 01:36:50 +08:00
2022-01-13 00:56:30 +08:00
< h4 id = "Encoding" class = "numbered" > Encoding< / h4 >
2018-01-31 01:36:50 +08:00
< p > Use UTF-8 (no BOM).< / p >
< p > Make sure your editor uses UTF-8 as character encoding, without a byte order
mark.< / p >
< p > Specify the encoding in HTML templates and documents via < code > < meta
charset="utf-8"> < / code > . Do not specify the encoding of style sheets as these assume
UTF-8.< / p >
2022-01-13 00:56:30 +08:00
< p > (More on encodings and when and how to specify them can be found in
< a href = "https://www.w3.org/International/tutorials/tutorial-char-enc/" > Handling character encodings in HTML and CSS< / a > .)< / p >
2018-01-31 01:36:50 +08:00
2022-01-13 00:56:30 +08:00
< h4 id = "Comments" class = "numbered" > Comments< / h4 >
2018-01-31 01:36:50 +08:00
< p > Explain code as needed, where possible.< / p >
< p > Use comments to explain code: What does it cover, what purpose does it serve,
why is respective solution used or preferred?< / p >
< p > (This item is optional as it is not deemed a realistic expectation to always
demand fully documented code. Mileage may vary heavily for HTML and CSS code and
2022-01-12 22:33:52 +08:00
depends on the project’ < / p >
2018-01-31 01:36:50 +08:00
2022-01-13 00:56:30 +08:00
< h4 id = "Action_Items" class = "numbered" > Action Items< / h4 >
2018-01-31 01:36:50 +08:00
< p > Mark todos and action items with < code > TODO< / code > .< / p >
< p > Highlight todos by using the keyword < code > TODO< / code > only, not other common formats like
< code > @@< / code > .< / p >
< p > Append a contact (username or mailing list) in parentheses as with the format
< code > TODO(contact)< / code > .< / p >
< p > Append action items after a colon as in < code > TODO: action item< / code > .< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-django external good" > {# TODO(john.doe): revisit centering #}
2018-01-31 01:36:50 +08:00
< center> Test< /center>
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html good" > < !-- TODO: remove optional tags -->
2018-01-31 01:36:50 +08:00
< ul>
< li> Apples< /li>
< li> Oranges< /li>
< /ul>
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h2 id = "HTML" class = "numbered" > HTML< / h2 >
2018-01-31 01:36:50 +08:00
2022-01-13 00:56:30 +08:00
< h3 id = "HTML_Style_Rules" class = "numbered" > HTML Style Rules< / h3 >
2018-01-31 01:36:50 +08:00
2022-01-13 00:56:30 +08:00
< h4 id = "Document_Type" class = "numbered" > Document Type< / h4 >
2018-01-31 01:36:50 +08:00
< p > Use HTML5.< / p >
< p > HTML5 (HTML syntax) is preferred for all HTML documents: < code > < !DOCTYPE html> < / code > .< / p >
2022-01-12 22:33:52 +08:00
< p > (It’ < code > text/html< / code > . Do not use XHTML. XHTML, as
2018-01-31 01:36:50 +08:00
< a href = "https://hixie.ch/advocacy/xhtml" > < code > application/xhtml+xml< / code > < / a > , lacks both browser
and infrastructure support and offers less room for optimization than HTML.)< / p >
2022-01-13 00:56:30 +08:00
< p > Although fine with HTML, do not close void elements, i.e. write < code > < br> < / code > , not < code > < br
/> < / code > .< / p >
2018-01-31 01:36:50 +08:00
2022-01-13 00:56:30 +08:00
< h4 id = "HTML_Validity" class = "numbered" > HTML Validity< / h4 >
2018-01-31 01:36:50 +08:00
< p > Use valid HTML where possible.< / p >
< p > Use valid HTML code unless that is not possible due to otherwise unattainable
performance goals regarding file size.< / p >
2022-01-13 00:56:30 +08:00
< p > Use tools such as the
< a href = "https://validator.w3.org/nu/" > W3C HTML validator< / a >
to test.< / p >
2018-01-31 01:36:50 +08:00
< p > Using valid HTML is a measurable baseline quality attribute that contributes to
learning about technical requirements and constraints, and that ensures proper
HTML usage.< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html bad" > < !-- Not recommended -->
2018-01-31 01:36:50 +08:00
< title> Test< /title>
< article> This is only a test.
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html good" > < !-- Recommended -->
2018-01-31 01:36:50 +08:00
< !DOCTYPE html>
< meta charset="utf-8">
< title> Test< /title>
< article> This is only a test.< /article>
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "Semantics" class = "numbered" > Semantics< / h4 >
2018-01-31 01:36:50 +08:00
< p > Use HTML according to its purpose.< / p >
2022-01-12 22:33:52 +08:00
< p > Use elements (sometimes incorrectly called “tags”) for what they have been
2018-01-31 01:36:50 +08:00
created for. For example, use heading elements for headings, < code > p< / code > elements for
paragraphs, < code > a< / code > elements for anchors, etc.< / p >
< p > Using HTML according to its purpose is important for accessibility, reuse, and
code efficiency reasons.< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html bad" > < !-- Not recommended -->
2018-01-31 01:36:50 +08:00
< div onclick="goToRecommendations();"> All recommendations< /div>
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html good" > < !-- Recommended -->
2018-01-31 01:36:50 +08:00
< a href="recommendations/"> All recommendations< /a>
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "Multimedia_Fallback" class = "numbered" > Multimedia Fallback< / h4 >
2018-01-31 01:36:50 +08:00
< p > Provide alternative contents for multimedia.< / p >
< p > For multimedia, such as images, videos, animated objects via < code > canvas< / code > , make sure
to offer alternative access. For images that means use of meaningful alternative
text (< code > alt< / code > ) and for video and audio transcripts and captions, if available.< / p >
< p > Providing alternative contents is important for accessibility reasons: A blind
user has few cues to tell what an image is about without < code > @alt< / code > , and other users
may have no way of understanding what video or audio contents are about either.< / p >
< p > (For images whose < code > alt< / code > attributes would introduce redundancy, and for images
whose purpose is purely decorative which you cannot immediately use CSS for, use
no alternative text, as in < code > alt=""< / code > .)< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html bad" > < !-- Not recommended -->
2018-01-31 01:36:50 +08:00
< img src="spreadsheet.png">
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html good" > < !-- Recommended -->
2018-01-31 01:36:50 +08:00
< img src="spreadsheet.png" alt="Spreadsheet screenshot.">
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "Separation_of_Concerns" class = "numbered" > Separation of Concerns< / h4 >
2018-01-31 01:36:50 +08:00
< p > Separate structure from presentation from behavior.< / p >
< p > Strictly keep structure (markup), presentation (styling), and behavior
(scripting) apart, and try to keep the interaction between the three to an
absolute minimum.< / p >
< p > That is, make sure documents and templates contain only HTML and HTML that is
solely serving structural purposes. Move everything presentational into style
sheets, and everything behavioral into scripts.< / p >
< p > In addition, keep the contact area as small as possible by linking as few style
sheets and scripts as possible from documents and templates.< / p >
< p > Separating structure from presentation from behavior is important for
maintenance reasons. It is always more expensive to change HTML documents and
templates than it is to update style sheets and scripts.< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html bad" > < !-- Not recommended -->
2018-01-31 01:36:50 +08:00
< !DOCTYPE html>
< title> HTML sucks< /title>
< link rel="stylesheet" href="base.css" media="screen">
< link rel="stylesheet" href="grid.css" media="screen">
< link rel="stylesheet" href="print.css" media="print">
< h1 style="font-size: 1em;"> HTML sucks< /h1>
2022-01-12 22:33:52 +08:00
< p> I’ ’
2018-01-31 01:36:50 +08:00
< u> HTML is stupid!!1< /u>
2022-01-12 22:33:52 +08:00
< center> I can’ ’
2018-01-31 01:36:50 +08:00
my website without doing everything all over again!< /center>
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html good" > < !-- Recommended -->
2018-01-31 01:36:50 +08:00
< !DOCTYPE html>
< title> My first CSS-only redesign< /title>
< link rel="stylesheet" href="default.css">
< h1> My first CSS-only redesign< /h1>
2022-01-12 22:33:52 +08:00
< p> I’ ’
2018-01-31 01:36:50 +08:00
doing it: separating concerns and avoiding anything in the HTML of
my website that is presentational.
2022-01-12 22:33:52 +08:00
< p> It’
2018-01-31 01:36:50 +08:00
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "Entity_References" class = "numbered" > Entity References< / h4 >
2018-01-31 01:36:50 +08:00
< p > Do not use entity references.< / p >
< p > There is no need to use entity references like < code > & mdash;< / code > , < code > & rdquo;< / code > , or
2022-01-13 00:56:30 +08:00
< code > & #x263a;< / code > , assuming the same encoding (UTF-8) is used for files and editors as
well as among teams.< / p >
2018-01-31 01:36:50 +08:00
< p > The only exceptions apply to characters with special meaning in HTML (like < code > < < / code >
2022-01-12 22:33:52 +08:00
and < code > & < / code > ) as well as control or “invisible” characters (like no-break spaces).< / p >
2018-01-31 01:36:50 +08:00
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html bad" > < !-- Not recommended -->
2018-01-31 01:36:50 +08:00
The currency symbol for the Euro is & ldquo;& eur;& rdquo;.
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html good" > < !-- Recommended -->
2022-01-12 22:33:52 +08:00
The currency symbol for the Euro is “€”.
2018-01-31 01:36:50 +08:00
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "Optional_Tags" class = "numbered" > Optional Tags< / h4 >
2018-01-31 01:36:50 +08:00
< p > Omit optional tags (optional).< / p >
< p > For file size optimization and scannability purposes, consider omitting optional
2022-01-13 00:56:30 +08:00
tags. The
< a href = "https://html.spec.whatwg.org/multipage/syntax.html#syntax-tag-omission" > HTML5 specification< / a >
2018-01-31 01:36:50 +08:00
defines what tags can be omitted.< / p >
< p > (This approach may require a grace period to be established as a wider guideline
2022-01-12 22:33:52 +08:00
as it’
For consistency and simplicity reasons it’
2018-01-31 01:36:50 +08:00
tags, not just a selection.)< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html bad" > < !-- Not recommended -->
2018-01-31 01:36:50 +08:00
< !DOCTYPE html>
< html>
< head>
< title> Spending money, spending bytes< /title>
< /head>
< body>
< p> Sic.< /p>
< /body>
< /html>
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html good" > < !-- Recommended -->
2018-01-31 01:36:50 +08:00
< !DOCTYPE html>
< title> Saving money, saving bytes< /title>
< p> Qed.
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "type_Attributes" class = "numbered" > < code > type< / code > Attributes< / h4 >
2018-01-31 01:36:50 +08:00
< p > Omit < code > type< / code > attributes for style sheets and scripts.< / p >
< p > Do not use < code > type< / code > attributes for style sheets (unless not using CSS) and scripts
(unless not using JavaScript).< / p >
< p > Specifying < code > type< / code > attributes in these contexts is not necessary as HTML5 implies
< a href = "https://html.spec.whatwg.org/multipage/obsolete.html#attr-style-type" > < code > text/css< / code > < / a >
2022-01-13 00:56:30 +08:00
and
< a href = "https://html.spec.whatwg.org/multipage/scripting.html#attr-script-type" > < code > text/javascript< / code > < / a >
2018-01-31 01:36:50 +08:00
as defaults. This can be safely done even for older browsers.< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html bad" > < !-- Not recommended -->
2018-01-31 01:36:50 +08:00
< link rel="stylesheet" href="https://www.google.com/css/maia.css"
2019-04-23 15:48:28 +08:00
type="text/css">
2018-01-31 01:36:50 +08:00
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html good" > < !-- Recommended -->
2018-01-31 01:36:50 +08:00
< link rel="stylesheet" href="https://www.google.com/css/maia.css">
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html bad" > < !-- Not recommended -->
2018-01-31 01:36:50 +08:00
< script src="https://www.google.com/js/gweb/analytics/autotrack.js"
2019-04-23 15:48:28 +08:00
type="text/javascript"> < /script>
2018-01-31 01:36:50 +08:00
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html good" > < !-- Recommended -->
2018-01-31 01:36:50 +08:00
< script src="https://www.google.com/js/gweb/analytics/autotrack.js"> < /script>
< / code > < / pre >
2022-01-13 22:13:57 +08:00
< h4 id = "id_Attributes" class = "numbered" > < code > id< / code > Attributes< / h4 >
< p > Avoid unnecessary < code > id< / code > attributes.< / p >
< p > Prefer < code > class< / code > attributes for styling and < code > data< / code > attributes for scripting.< / p >
< p > Where < code > id< / code > attributes are strictly required, always include a hyphen in the
value to ensure it does not match the JavaScript identifier syntax, e.g. use
< code > user-profile< / code > rather than just < code > profile< / code > or < code > userProfile< / code > .< / p >
< p > When an element has an < code > id< / code > attribute, browsers will make that available as a
< a href = "https://html.spec.whatwg.org/multipage/window-object.html#named-access-on-the-window-object" > named property on the global < code > window< / code > prototype< / a > ,
which may cause unexpected behavior. While < code > id< / code > attribute values containing a
hyphen are still available as property names, these cannot be referenced as
global JavaScript variables.< / p >
< pre > < code class = "language-html bad" > < !-- Not recommended: `window.userProfile` will resolve to reference the < div> node -->
< div id="userProfile"> < /div>
< / code > < / pre >
< pre > < code class = "language-html good" > < !-- Recommended: `id` attribute is required and its value includes a hyphen -->
< div aria-describedby="user-profile">
…
< div id="user-profile"> < /div>
…
< /div>
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h3 id = "HTML_Formatting_Rules" class = "numbered" > HTML Formatting Rules< / h3 >
2018-01-31 01:36:50 +08:00
2022-01-13 00:56:30 +08:00
< h4 id = "General_Formatting" class = "numbered" > General Formatting< / h4 >
2018-01-31 01:36:50 +08:00
< p > Use a new line for every block, list, or table element, and indent every such
child element.< / p >
< p > Independent of the styling of an element (as CSS allows elements to assume a
different role per < code > display< / code > property), put every block, list, or table element
on a new line.< / p >
< p > Also, indent them if they are child elements of a block, list, or table element.< / p >
2022-01-12 22:33:52 +08:00
< p > (If you run into issues around whitespace between list items it’
2018-01-31 01:36:50 +08:00
put all < code > li< / code > elements in one line. A linter is encouraged to throw a warning
instead of an error.)< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html good" > < blockquote>
2018-01-31 01:36:50 +08:00
< p> < em> Space< /em> , the final frontier.< /p>
< /blockquote>
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html good" > < ul>
2018-01-31 01:36:50 +08:00
< li> Moe
< li> Larry
< li> Curly
< /ul>
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html good" > < table>
2018-01-31 01:36:50 +08:00
< thead>
< tr>
< th scope="col"> Income
< th scope="col"> Taxes
< tbody>
< tr>
< td> $ 5.00
< td> $ 4.50
< /table>
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "HTML_Line-Wrapping" class = "numbered" > HTML Line-Wrapping< / h4 >
2018-01-31 01:36:50 +08:00
< p > Break long lines (optional).< / p >
< p > While there is no column limit recommendation for HTML, you may consider
wrapping long lines if it significantly improves readability.< / p >
< p > When line-wrapping, each continuation line should be indented at least 4
2022-01-13 21:46:52 +08:00
additional spaces from the original line to distinguish wrapped attributes from
child elements.< / p >
2018-01-31 01:36:50 +08:00
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html good" > < md-progress-circular md-mode="indeterminate" class="md-accent"
2018-01-31 01:36:50 +08:00
ng-show="ctrl.loading" md-diameter="35">
< /md-progress-circular>
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html good" > < md-progress-circular
2018-01-31 01:36:50 +08:00
md-mode="indeterminate"
class="md-accent"
ng-show="ctrl.loading"
md-diameter="35">
< /md-progress-circular>
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html good" > < md-progress-circular md-mode="indeterminate"
2018-01-31 01:36:50 +08:00
class="md-accent"
ng-show="ctrl.loading"
md-diameter="35">
< /md-progress-circular>
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "HTML_Quotation_Marks" class = "numbered" > HTML Quotation Marks< / h4 >
2018-01-31 01:36:50 +08:00
< p > When quoting attributes values, use double quotation marks.< / p >
< p > Use double (< code > ""< / code > ) rather than single quotation marks (< code > ''< / code > ) around attribute
values.< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html bad" > < !-- Not recommended -->
2018-01-31 01:36:50 +08:00
< a class='maia-button maia-button-secondary'> Sign in< /a>
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-html good" > < !-- Recommended -->
2018-01-31 01:36:50 +08:00
< a class="maia-button maia-button-secondary"> Sign in< /a>
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h2 id = "CSS" class = "numbered" > CSS< / h2 >
2018-01-31 01:36:50 +08:00
2022-01-13 00:56:30 +08:00
< h3 id = "CSS_Style_Rules" class = "numbered" > CSS Style Rules< / h3 >
2018-01-31 01:36:50 +08:00
2022-01-13 00:56:30 +08:00
< h4 id = "CSS_Validity" class = "numbered" > CSS Validity< / h4 >
2018-01-31 01:36:50 +08:00
< p > Use valid CSS where possible.< / p >
< p > Unless dealing with CSS validator bugs or requiring proprietary syntax, use
valid CSS code.< / p >
2022-01-13 00:56:30 +08:00
< p > Use tools such as the
< a href = "https://jigsaw.w3.org/css-validator/" > W3C CSS validator< / a >
to test.< / p >
2018-01-31 01:36:50 +08:00
< p > Using valid CSS is a measurable baseline quality attribute that allows to spot
CSS code that may not have any effect and can be removed, and that ensures
proper CSS usage.< / p >
2022-01-13 22:13:57 +08:00
< h4 id = "ID_and_Class_Naming" class = "numbered" > Class Naming< / h4 >
2018-01-31 01:36:50 +08:00
2022-01-13 22:13:57 +08:00
< p > Use meaningful or generic class names.< / p >
2018-01-31 01:36:50 +08:00
2022-01-13 22:13:57 +08:00
< p > Instead of presentational or cryptic names, always use class names that reflect
the purpose of the element in question, or that are otherwise generic.< / p >
2018-01-31 01:36:50 +08:00
< p > Names that are specific and reflect the purpose of the element should be
preferred as these are most understandable and the least likely to change.< / p >
< p > Generic names are simply a fallback for elements that have no particular or no
2022-01-12 22:33:52 +08:00
meaning different from their siblings. They are typically needed as “helpers.”< / p >
2018-01-31 01:36:50 +08:00
< p > Using functional or generic names reduces the probability of unnecessary
document or template changes.< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css bad" > /* Not recommended: meaningless */
2022-01-13 22:13:57 +08:00
.yee-1901 {}
2018-01-31 01:36:50 +08:00
/* Not recommended: presentational */
.button-green {}
.clear {}
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css good" > /* Recommended: specific */
2022-01-13 22:13:57 +08:00
.gallery {}
.login {}
2018-01-31 01:36:50 +08:00
.video {}
/* Recommended: generic */
.aux {}
.alt {}
< / code > < / pre >
2022-01-13 22:13:57 +08:00
< h4 id = "ID_and_Class_Name_Style" class = "numbered" > Class Name Style< / h4 >
2018-01-31 01:36:50 +08:00
2022-01-13 22:13:57 +08:00
< p > Use class names that are as short as possible but as long as necessary.< / p >
2018-01-31 01:36:50 +08:00
2022-01-13 22:13:57 +08:00
< p > Try to convey what a class is about while being as brief as possible.< / p >
2018-01-31 01:36:50 +08:00
2022-01-13 22:13:57 +08:00
< p > Using class names this way contributes to acceptable levels of understandability
and code efficiency.< / p >
2018-01-31 01:36:50 +08:00
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css bad" > /* Not recommended */
2022-01-13 22:13:57 +08:00
.navigation {}
2018-01-31 01:36:50 +08:00
.atr {}
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css good" > /* Recommended */
2022-01-13 22:13:57 +08:00
.nav {}
2018-01-31 01:36:50 +08:00
.author {}
< / code > < / pre >
2022-01-13 22:13:57 +08:00
< h4 id = "ID_and_Class_Name_Delimiters" class = "numbered" > Class Name Delimiters< / h4 >
2022-01-13 22:03:19 +08:00
2022-01-13 22:13:57 +08:00
< p > Separate words in class names by a hyphen.< / p >
2022-01-13 22:03:19 +08:00
< p > Do not concatenate words and abbreviations in selectors by any characters
(including none at all) other than hyphens, in order to improve understanding
and scannability.< / p >
< pre > < code class = "language-css bad" > /* Not recommended: does not separate the words “demo” and “image” */
.demoimage {}
/* Not recommended: uses underscore instead of hyphen */
.error_status {}
< / code > < / pre >
< pre > < code class = "language-css good" > /* Recommended */
2022-01-13 22:13:57 +08:00
.video-id {}
2022-01-13 22:03:19 +08:00
.ads-sample {}
< / code > < / pre >
< h4 id = "Prefixes" class = "numbered" > Prefixes< / h4 >
< p > Prefix selectors with an application-specific prefix (optional).< / p >
< p > In large projects as well as for code that gets embedded in other projects or on
2022-01-13 22:13:57 +08:00
external sites use prefixes (as namespaces) for class names. Use short, unique
identifiers followed by a dash.< / p >
2022-01-13 22:03:19 +08:00
< p > Using namespaces helps preventing naming conflicts and can make maintenance
easier, for example in search and replace operations.< / p >
< pre > < code class = "language-css good" > .adw-help {} /* AdWords */
2022-01-13 22:13:57 +08:00
.maia-note {} /* Maia */
2022-01-13 22:03:19 +08:00
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "Type_Selectors" class = "numbered" > Type Selectors< / h4 >
2018-01-31 01:36:50 +08:00
2022-01-13 22:13:57 +08:00
< p > Avoid qualifying class names with type selectors.< / p >
2018-01-31 01:36:50 +08:00
< p > Unless necessary (for example with helper classes), do not use element names in
2022-01-13 22:13:57 +08:00
conjunction with classes.< / p >
2018-01-31 01:36:50 +08:00
2022-01-13 00:56:30 +08:00
< p > Avoiding unnecessary ancestor selectors is useful for
< a href = "http://www.stevesouders.com/blog/2009/06/18/simplifying-css-selectors/" > performance reasons< / a > .< / p >
2018-01-31 01:36:50 +08:00
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css bad" > /* Not recommended */
2022-01-13 22:13:57 +08:00
ul.example {}
2018-01-31 01:36:50 +08:00
div.error {}
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css good" > /* Recommended */
2022-01-13 22:13:57 +08:00
.example {}
2018-01-31 01:36:50 +08:00
.error {}
< / code > < / pre >
2022-01-13 22:13:57 +08:00
< h4 id = "ID_Selectors" class = "numbered" > ID Selectors< / h4 >
< p > Avoid ID selectors.< / p >
< p > ID attributes are expected to be unique across an entire page, which is
difficult to guarantee when a page contains many components worked on by many
different engineers. Class selectors should be preferred in all situations.< / p >
< pre > < code class = "language-css bad" > /* Not recommended */
#example {}
< / code > < / pre >
< pre > < code class = "language-css good" > /* Recommended */
.example {}
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "Shorthand_Properties" class = "numbered" > Shorthand Properties< / h4 >
2018-01-31 01:36:50 +08:00
< p > Use shorthand properties where possible.< / p >
2022-01-13 00:56:30 +08:00
< p > CSS offers a variety of
< a href = "https://www.w3.org/TR/CSS21/about.html#shorthand" > shorthand< / a >
2018-01-31 01:36:50 +08:00
properties (like < code > font< / code > ) that should be used whenever possible, even in cases
where only one value is explicitly set.< / p >
< p > Using shorthand properties is useful for code efficiency and understandability.< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css bad" > /* Not recommended */
2018-01-31 01:36:50 +08:00
border-top-style: none;
font-family: palatino, georgia, serif;
font-size: 100%;
line-height: 1.6;
padding-bottom: 2em;
padding-left: 1em;
padding-right: 1em;
padding-top: 0;
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css good" > /* Recommended */
2018-01-31 01:36:50 +08:00
border-top: 0;
font: 100%/1.6 palatino, georgia, serif;
padding: 0 1em 2em;
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "0_and_Units" class = "numbered" > 0 and Units< / h4 >
2018-01-31 01:36:50 +08:00
2022-01-12 22:33:52 +08:00
< p > Omit unit specification after “0” values, unless required.< / p >
2018-01-31 01:36:50 +08:00
< p > Do not use units after < code > 0< / code > values unless they are required.< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css good" > flex: 0px; /* This flex-basis component requires a unit. */
2018-01-31 01:36:50 +08:00
flex: 1 1 0px; /* Not ambiguous without the unit, but needed in IE11. */
margin: 0;
padding: 0;
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "Leading_0s" class = "numbered" > Leading 0s< / h4 >
2018-01-31 01:36:50 +08:00
2022-01-13 21:53:15 +08:00
< p > Always include leading “0”s in values.< / p >
2018-01-31 01:36:50 +08:00
2022-01-13 21:53:15 +08:00
< p > Put < code > 0< / code > s in front of values or lengths between -1 and 1.< / p >
2018-01-31 01:36:50 +08:00
2022-01-13 21:53:15 +08:00
< pre > < code class = "language-css good" > font-size: 0.8em;
2018-01-31 01:36:50 +08:00
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "Hexadecimal_Notation" class = "numbered" > Hexadecimal Notation< / h4 >
2018-01-31 01:36:50 +08:00
< p > Use 3 character hexadecimal notation where possible.< / p >
< p > For color values that permit it, 3 character hexadecimal notation is shorter and
more succinct.< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css bad" > /* Not recommended */
2018-01-31 01:36:50 +08:00
color: #eebbcc;
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css good" > /* Recommended */
2018-01-31 01:36:50 +08:00
color: #ebc;
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "Hacks" class = "numbered" > Hacks< / h4 >
2018-01-31 01:36:50 +08:00
2022-01-12 22:33:52 +08:00
< p > Avoid user agent detection as well as CSS “hacks”—try a different approach
2018-01-31 01:36:50 +08:00
first.< / p >
2022-01-12 22:33:52 +08:00
< p > It’
2018-01-31 01:36:50 +08:00
special CSS filters, workarounds, and hacks. Both approaches should be
considered last resort in order to achieve and maintain an efficient and
manageable code base. Put another way, giving detection and hacks a free pass
will hurt projects in the long run as projects tend to take the way of least
resistance. That is, allowing and making it easy to use detection and hacks
2022-01-12 22:33:52 +08:00
means using detection and hacks more frequently—and more frequently is too
2018-01-31 01:36:50 +08:00
frequently.< / p >
2022-01-13 00:56:30 +08:00
< h3 id = "CSS_Formatting_Rules" class = "numbered" > CSS Formatting Rules< / h3 >
2018-01-31 01:36:50 +08:00
2022-01-13 00:56:30 +08:00
< h4 id = "Declaration_Order" class = "numbered" > Declaration Order< / h4 >
2018-01-31 01:36:50 +08:00
< p > Alphabetize declarations.< / p >
< p > Put declarations in alphabetical order in order to achieve consistent code in a
way that is easy to remember and maintain.< / p >
< p > Ignore vendor-specific prefixes for sorting purposes. However, multiple
vendor-specific prefixes for a certain CSS property should be kept sorted (e.g.
-moz prefix comes before -webkit).< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css good" > background: fuchsia;
2018-01-31 01:36:50 +08:00
border: 1px solid;
-moz-border-radius: 4px;
-webkit-border-radius: 4px;
border-radius: 4px;
color: black;
text-align: center;
text-indent: 2em;
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "Block_Content_Indentation" class = "numbered" > Block Content Indentation< / h4 >
2018-01-31 01:36:50 +08:00
< p > Indent all block content.< / p >
2022-01-13 00:56:30 +08:00
< p > Indent all
< a href = "https://www.w3.org/TR/CSS21/syndata.html#block" > block content< / a > ,
2018-01-31 01:36:50 +08:00
that is rules within rules as well as declarations, so to reflect hierarchy and
improve understanding.< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css good" > @media screen, projection {
2018-01-31 01:36:50 +08:00
html {
background: #fff;
color: #444;
}
}
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "Declaration_Stops" class = "numbered" > Declaration Stops< / h4 >
2018-01-31 01:36:50 +08:00
< p > Use a semicolon after every declaration.< / p >
< p > End every declaration with a semicolon for consistency and extensibility
reasons.< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css bad" > /* Not recommended */
2018-01-31 01:36:50 +08:00
.test {
display: block;
height: 100px
}
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css good" > /* Recommended */
2018-01-31 01:36:50 +08:00
.test {
display: block;
height: 100px;
}
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "Property_Name_Stops" class = "numbered" > Property Name Stops< / h4 >
2018-01-31 01:36:50 +08:00
2022-01-12 22:33:52 +08:00
< p > Use a space after a property name’ < / p >
2018-01-31 01:36:50 +08:00
< p > Always use a single space between property and value (but no space between
property and colon) for consistency reasons.< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css bad" > /* Not recommended */
2018-01-31 01:36:50 +08:00
h3 {
font-weight:bold;
}
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css good" > /* Recommended */
2018-01-31 01:36:50 +08:00
h3 {
font-weight: bold;
}
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "Declaration_Block_Separation" class = "numbered" > Declaration Block Separation< / h4 >
2018-01-31 01:36:50 +08:00
< p > Use a space between the last selector and the declaration block.< / p >
< p > Always use a single space between the last selector and the opening brace that
2022-01-13 00:56:30 +08:00
begins the
< a href = "https://www.w3.org/TR/CSS21/syndata.html#rule-sets" > declaration block< / a > .< / p >
2018-01-31 01:36:50 +08:00
< p > The opening brace should be on the same line as the last selector in a given
rule.< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css bad" > /* Not recommended: missing space */
2022-01-13 22:13:57 +08:00
.video{
2018-01-31 01:36:50 +08:00
margin-top: 1em;
}
/* Not recommended: unnecessary line break */
2022-01-13 22:13:57 +08:00
.video
2018-01-31 01:36:50 +08:00
{
margin-top: 1em;
}
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css good" > /* Recommended */
2022-01-13 22:13:57 +08:00
.video {
2018-01-31 01:36:50 +08:00
margin-top: 1em;
}
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "Selector_and_Declaration_Separation" class = "numbered" > Selector and Declaration Separation< / h4 >
2018-01-31 01:36:50 +08:00
< p > Separate selectors and declarations by new lines.< / p >
< p > Always start a new line for each selector and declaration.< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css bad" > /* Not recommended */
2018-01-31 01:36:50 +08:00
a:focus, a:active {
position: relative; top: 1px;
}
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css good" > /* Recommended */
2018-01-31 01:36:50 +08:00
h1,
h2,
h3 {
font-weight: normal;
line-height: 1.2;
}
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "Rule_Separation" class = "numbered" > Rule Separation< / h4 >
2018-01-31 01:36:50 +08:00
< p > Separate rules by new lines.< / p >
< p > Always put a blank line (two line breaks) between rules.< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css good" > html {
2018-01-31 01:36:50 +08:00
background: #fff;
}
body {
margin: auto;
width: 50%;
}
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h4 id = "CSS_Quotation_Marks" class = "numbered" > CSS Quotation Marks< / h4 >
2018-01-31 01:36:50 +08:00
< p > Use single (< code > ''< / code > ) rather than double (< code > ""< / code > ) quotation marks for attribute
selectors and property values.< / p >
< p > Do not use quotation marks in URI values (< code > url()< / code > ).< / p >
< p > Exception: If you do need to use the < code > @charset< / code > rule, use double quotation
2022-01-12 22:33:52 +08:00
marks—< a href = "https://www.w3.org/TR/CSS21/syndata.html#charset" > single quotation marks are not permitted< / a > .< / p >
2018-01-31 01:36:50 +08:00
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css bad" > /* Not recommended */
2018-01-31 01:36:50 +08:00
@import url("https://www.google.com/css/maia.css");
html {
font-family: "open sans", arial, sans-serif;
}
< / code > < / pre >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css good" > /* Recommended */
2018-01-31 01:36:50 +08:00
@import url(https://www.google.com/css/maia.css);
html {
font-family: 'open sans', arial, sans-serif;
}
< / code > < / pre >
2022-01-13 00:56:30 +08:00
< h3 id = "CSS_Meta_Rules" class = "numbered" > CSS Meta Rules< / h3 >
2018-01-31 01:36:50 +08:00
2022-01-13 00:56:30 +08:00
< h4 id = "Section_Comments" class = "numbered" > Section Comments< / h4 >
2018-01-31 01:36:50 +08:00
< p > Group sections by a section comment (optional).< / p >
< p > If possible, group style sheet sections together by using comments. Separate
sections with new lines.< / p >
2022-01-12 21:47:29 +08:00
< pre > < code class = "language-css good" > /* Header */
2018-01-31 01:36:50 +08:00
2022-01-13 22:13:57 +08:00
.adw-header {}
2018-01-31 01:36:50 +08:00
/* Footer */
2022-01-13 22:13:57 +08:00
.adw-footer {}
2018-01-31 01:36:50 +08:00
/* Gallery */
.adw-gallery {}
< / code > < / pre >
< h2 id = "Parting_Words" > Parting Words< / h2 >
< p > < em > Be consistent.< / em > < / p >
2022-01-12 22:33:52 +08:00
< p > If you’
2018-01-31 01:36:50 +08:00
determine its style. If they use spaces around all their arithmetic operators,
you should too. If their comments have little boxes of hash marks around them,
make your comments have little boxes of hash marks around them too.< / p >
< p > The point of having style guidelines is to have a common vocabulary of coding so
2022-01-12 22:33:52 +08:00
people can concentrate on what you’ ’
2018-01-31 01:36:50 +08:00
it. We present global style rules here so people know the vocabulary, but local
style is also important. If code you add to a file looks drastically different
from the existing code around it, it throws readers out of their rhythm when
they go to read it. Avoid this.< / p >
< / div >
< / body >
< / html >
