- Use tabs rather than spaces to format the code as this enables the developer to set the indenting to their own preference.
- Nested elements should be indented once (one tab).
- Always use double quotes, never single quotes, on attributes.
- Always include a trailing slash in self-closing elements.
- Do not omit optional closing tags (eg.
- Do not use an ID unless absolutely necessary to guarantee reuse on pages. IDs must be unique on a page.
<!DOCTYPE html> <html> <head> <title>Page title</title> </head> <body> <img src="images/company-logo.png" alt="Company" /> <h1 class="hello-world">Hello, world!</h1> </body> </html>
Enforce standards mode and more consistent rendering in every browser possible by including the doctype at the beginning of every HTML page.
<!DOCTYPE html> <html> <head> </head> <body> </body> </html>
Always include the language attribute. From the HTML5 spec:
Authors are encouraged to specify a lang attribute on the root html element, giving the document's language. This aids speech synthesis tools to determine what pronunciations to use, translation tools to determine what rules to use, and so forth.
<html lang="en-us"> <!-- ... --> </html>
Always declare an explicit character encoding. When doing so, you may avoid using character entities in your HTML, provided their encoding matches that of the document (generally UTF-8).
Always include a viewport meta tag, to ensure correct rendering across all sizes of devices set the viewport scale to be 1.
<meta name="viewport" content="width=device-width,initial-scale=1.0" />
IE compatibility mode
Internet Explorer supports the use of a document compatibility
<meta> tag to specify what version of IE the page should be rendered as. Unless circumstances require otherwise, it's most useful to instruct IE to use the latest supported mode with edge mode.
<meta http-equiv="X-UA-Compatible" content="IE=Edge">
Set the canonical tag on every page to ensure that they are only listed once in search engines no matter what protocol they are accessed through.
<link rel="canonical" href="https://standards.aviva.com/framework/" />
There is no need to specify a
HTML attributes should come in this particular order for easier reading of code.
Classes make for great reusable components, so they come first. Ids are more specific and should be used sparingly (eg. for in-page bookmarks), so they come second.
<a class="..." id="..." data-toggle="o-modal" href="">...</a> <input class="form-control" type="text" /> <img src="..." alt="..." />
Do not declare values for boolean attributes. XHTML required you to declare a value, but HTML5 has no such requirement.
<input type="text" disabled /> <input type="checkbox" value="1" checked /> <select> <option value="1" selected >1</option> </select>
Whenever possible, avoid superfluous parent elements when writing HTML. Many times this requires iteration and refactoring, but produces less HTML. Take the following example:
<!-- Ok --> <span class="profile-image"> <img src="..." /> </span> <!-- Better --> <img class="profile-image" src="..." />
Practicality over purity
Strive to maintain HTML standards and semantics, but not at the expense of practicality. Use the least amount of markup with the fewest intricacies whenever possible.
Giving presentational elements semantic meaning
em are semantic tags, meaning that they provide emphasis, which is rendered as bold/italic on a visual browser or in different speaking styles on a screen reader.
Screen readers could pronounce STRONG and EM in a different voice or style.
Do not use the
<b></b> presentational elements.
The em element represents stress emphasis of its contents:
<p>A paragraph with <em>emphasized text</em>.</p>
The strong element represents strong importance for its contents.
<p>A paragraph with some <strong>important text</strong>.</p>
Button type attribute
Always declare the type of a button explicitly, so that it gives clear context for the button by looking at the markup.
Possible values for the type attribute:
- Submit - Submits form data to the server.
- Reset - Reset values and controls to the default values.
- Button - The button that triggers when an event occurs.
- Menu - The button opens a popup menu.
<button type="submit">Submit</button> <button type="reset">Reset</button> <button type="button">Button</button> <button type="menu" menu="popup-menu">Dropdown Menu</button>
Semantic mark–up is HTML that describes the content, rather than the manner in which the content is presented. It allows the meaning to be delivered to users regardless of the browser they use, so that content can be provided to the widest possible audience.
All elements must be used appropriately for the content they contain. For example headings must be in a heading element and a list must be within the appropriate type of list element. Do not use elements for the presentational look that they will provide.
For attributes such as IDs and classes their values should be created so as to describe the content of the element and not how it will make them look. For example ‘error’ would be correct and ‘largeRed’ would be wrong.
The Microdata specification was produced as part of the HTML5 specification and can also be used to add semantics to content. It is suggested to use the patterns available on for any Microdata included on a page.
img element should be used to insert images that are integral to the content. Image elements must be self–closing and include a src attribute and an alt attribute. If the same visual presentation can be made using text alone, an image should not be used to present that text.
Text must only be used within an image for decoration (images must not convey content) OR when the information cannot be presented with text alone, in this case the alt attribute must be used. The alt attribute must be included in all
img elements and provides alternative text to the image. This text should be an appropriate replacement of the image and not purely a description of what the image is.
Where images are for decoration only they should be background images instead of inline elements. These should be formed of image sprites wherever possible. For more information on this see the CSS guidelines.
Image maps must not be used unless the data and/or functionality they provide is replicated elsewhere on the page. However wherever possible we would recommend alternative methods of providing this type of behaviour.
The format of the image should be appropriate to the image being displayed and one of – GIF, JPEG or PNG. When choosing an appropriate format special care must be taken with the file size of the image. This should be minimised as far as possible without degrading the quality of the image significantly.
It is recommend the following coding practices to improve the accessibility and usability of forms.
Labels and inputs
The label and input elements should be used appropriately and associated with each other by using the for and id attributes. A basic example of this would be:
<label for="answer1">Answer 1</label><input type="text" id="answer1" />
When using multiple inputs for something such as a date ensure that each input has a corresponding label. These can then be hidden using CSS by positioning off the screen, do not set display:none on them.
Fieldset and legend
The fieldset element should be used to group together thematically related controls and labels. Grouping controls makes it easier for users to understand their purpose while simultaneously facilitating tabbing navigation for visual user agents and speech navigation for speech–oriented user agents.
If a fieldset is declared, the legend element must appear immediately after the opening fieldset tag and be used as the caption for the fieldset.
When a user inputs information or interacts with a control, it must not result in a substantial change to the page, the spawning of a pop–up window, an additional change of keyboard focus, or any other change that could confuse or disorient the user unless the user is informed of the change ahead of time.
Required form elements or form elements that require a specific format, value, or length provide this information within the element’s label (or if a label is not provided, within the element’s title attribute).
If utilized, form validation cues and errors (client–side or server–side) should alert users to errors in an efficient, intuitive, and accessible manner. The error should be clearly identified, quick access to the problematic element should be provided, and the user should be allowed to easily fix the error and resubmit the form.
The level of security required for a form will depend on the data being accepted by it.
Tables must only be used to display tabular data and not for page layout. The incorrect use of tables presents accessibility problems, a table element tells the user–agent that the content is tabular data and it will interpret it as such to the user. Developers must use style sheets and meaningful mark up to control the layout of anything other than tabular data.
Caption and summary
The caption element should be used on each table to describe the nature of the table. When the caption element is included it must appear immediately after the opening table tag. The summary attribute should not be used unless the complexity of the table requires it, however in the case we would recommend simplifying the table rather than using a summary.
Headers and general cell data must be distinguished using the appropriate
th (table header) and
td (table data) elements. Table header data can form columns or rows.
The scope attribute
The scope attribute should be used to explicitly associate a table header (
th) element with a column or row.
iframes should not be used except where there is no other option (ie Third–party analytics code), although their use (and any possible alternatives to them) does depend on the exact situation they are being considered for. Here is a brief overview of why they should be avoided:
- There is no fallback if the user’s browser cannot display iframes (this includes many mobile/tablet devices).
- Many accessibility aids such as screen readers do not support iframes or cannot use them correctly leaving the user unable to use the website.
- Where accessibility aids do support them they can still leave the page very difficult to use and confusing to the user.
- iframes can break the browsers forward/back functionality.
- Due to being a fixed size they cannot scale to the content being inserted into them potentially producing multiple scrollbars that can confuse the user and produces a maintenance risk and overhead where later changes can have unintended consequences.
iframes have a significant effect on page load speed slowing the rendering of the page considerably.
There are also potential security issues to their use, such as cross domain exploits and cross–site–scripting. This risk must always be considered in their use.
Set your editor to the following settings to avoid common code inconsistencies and dirty diffs:
- Use tabs rather than soft tabs.
- Trim trailing white space on save.
- Set encoding to UTF-8.
- Add new line at end of files.