An Intro to HTML

HTML Stands for HyperText Markup Language

HTML is the standard markup language/format for creating web pages, containing the content and structure of a page as a series of elements.

HTML – MDN
When in doubt, refer to the MDN documentation!
Basics of HTML
A very calming introduction by Laurel Schwulst.
Organizing Files for the Web
Sasha Portis on (web) file-naming, for when you get to saving.

In our ongoing analogy, HTML is the skeleton of the web. At its most basic it is a text file, in a folder on a computer, with a .html extension⁠—text, with instructions.

As we heard in our first class, this format was codified by our pal Tim Berners-Lee in 1991, evolving from his earlier SGML, a similar/proto language. There have been five major revisions to the spec since then, which added (and sometimes deprecated, or removed) tags and syntax:

HTML 1, 1991
HTML 2, 1995
HTML 3, 1997
HTML 4, 1997 (busy year)
HTML 5, 2014

The Basic Document

HTML consists of a range of elements, nested inside one another, like a matryoshka doll of text.

The <html> element contains all elements of the page. In diagram here, the <head> element contains the <title>, and the <body> contains the <h1> and <p> elements.

We call these semantic elements⁠—which is saying that they give their contents a meaning or a role. (Remember Tim’s diagram.) These roles are then interpreted by your browser (Chrome, Safari, Firefox, etc.) when it loads the file, to ultimately display the page. We call this parsing the document.

The Semantic Web is not a separate Web but an extension of the current one, in which information is given well-defined meaning, better enabling computers and people to work in cooperation.

Tim Berners-Lee, 2001

What Does That Even Mean

						<!doctype html>
<html>
	<head>
		<title>Page title</title>
	</head>
	<body>
		<h1>This is a heading</h1>
		<p>This is a paragraph.</p>
		<p>This is another paragraph.</p>
	</body>
</html>

In our example, here is what we’ve told the computer:

<!doctype html>

What type/version of HTML this file contains, so it knows how to parse it.
- <html></html>
  
  The root element of an HTML page, containing all the content.
- <head></head>
  
  The meta information about the HTML page⁠—like its title, default language, and any scripts and stylesheets it needs to display the page.
  
  Nothing in this element is visible on the page itself!
  - <title></title>
    
    Specifies a title for the page⁠—which is shown in the browser’s tab, and when it is shared.
- <body></body>
  
  Defines the document’s body⁠—the container for all the visible contents, such as headings, paragraphs, images, hyperlinks, tables, lists, etc.
  - <h1></h1>
    
    Defines a primary/first-level heading.
  - <p></p>
    
    Defines a paragraph.

We use semantic elements to help structure and describe our content⁠—but also for accessibility (screen readers)⁠—where the tag type helps indicate what things are.

What Are Elements?

Elements are composed of tags and their content:

HTML Elements Reference – MDN
MDN will always go deep; this is all the elements.

Some elements do not have any content or children, like <br> or <img>. These are called empty elements, and do not have a closing tag.

Headings: <h#>

						<h1>There should only be one first-level heading!</h1>

There are also <h2> <h3> <h4> <h5> and <h6>. These provide semantic organization and hierarchy for your document!

Paragraphs: <p>

						<p>You should always wrap your text in a paragraph!</p>

Our basic, default text element.

Links: <a>

						<a href="https://www.example.com">Links need attributes!</a>

The <a> is for anchor⁠—one end of the link.

The href (Hypertext REFerence) specifies a URL that the link points to, and the tag wraps the visible link text. This attribute can point to another, local HTML file (living in the same directory structure) or an external page. They can also point to specific parts of a page.

Images: <img>

						<img src="example.jpg" alt="Images should have descriptions!">

The src likewise can point to a local image file or an external URL! alt provides a description for accessibility/screen readers. More on these attributes in a bit.

Containers

						<body>
	<header>
		<!-- A header. -->
	</header>
	<main>
		<!-- Your main content. -->
	</main>
	<footer>
		<!-- The footer. -->
	</footer>
</body>

Some others are <nav>, <article>, <section>, and <div> (when nothing else is more appropriate).

These are the structural containers of a website. The names don’t imbue function directly, but help us organize and think about our content structure⁠—and also are helpful for accessibility.

Inline Text Elements

						<p>You may have noticed I like using<em>emphasis</em>.</p>

These wrap around bits of text (within headings or <p>) for semantic meaning and to apply specific styles using <span>, <strong>, <em>, <abbr>, <cite>, <time>, <code>, <mark>, <del>, <ins>, <sub>, and <sup>.

Lists: ol / <ul>

						<ul>
	<li><!-- A list item. --></li>
	<li><!-- Another. --></li>
	<li><!-- A third. --></li>
</ul>

If you have three of something, it is probably a list! There are also ol.

There are many, many HTML elements, all with particular uses. (We’ll unpack some more, later.)

Attributes

All HTML elements can have attributes, which provide more information about the element:

HTML Attribute Reference – MDN
There are a lot of them.

Common Attributes

Language: lang

						<html lang="en"></html>

The lang attribute of the <html> tag declares the language of the Web page.

HyperText Reference: href

						<a href="https://www.example.com">Goes to example.com</a>

The href attribute of <a> specifies the URL of the page the link goes to.

Target: target

						<a href="https://www.example.com" target="_blank">New tab!</a>

The target attribute _blank can tell an <a> to open in a new window/tab.

This can be annoying, so use it judiciously!

Style: style

						<p style="color: blue;">This is blue text.</p>

The style attribute is used to add styles to an element, such as color, font, size, etc.

We’ll use CSS for this kind of thing, but know this is how it used to be done and it was brittle and terrible.

Source: src

						<img src="example.jpg">

The src attribute of <img> specifies the path to the image to be displayed.

						<iframe src="https://typography-interaction-2526.github.io"></iframe>

Same thing for an <iframe>, which is a little window into another website.

Dimensions: width / height

						<img src="example.jpg" width="200" height="200">

The width and height attributes of <img> provide size information for images.

Not required, but helps prevent layout “sloshing” as images load.

Alternate Text: alt

						<img src="example.jpg" alt="A description of the image.">

The alt attribute of <img> provides an alternate text for an image, used by screen readers.

Identifier: id

						<h2 id="a-heading-element">A heading element</h2>

						<a href="#a-heading-element">Goes to “a heading element”</a>

The id specifies a singular, unique element on a page⁠—for CSS targeting and anchor (scroll, jump) links, prepended with #.

Class: class

						<p class="warning">We’ll get into this soon.</p>

The class attribute provides an additional way to select the element in CSS or JS.

Case, White Space, Tabs, Line Breaks

Generally speaking, HTML doesn’t care about capitalization, extra white space, or line breaks (one exception, below). The browser will just read everything from left to right, as if it is one long, running sentence. So the shouty <html> and quieter <html> are interpreted the same.

How Whitespace Is Handled – MDN
It depends! It always depends.

The browser parses both of these in the exact same way:

						<body>
	<h1>Dog Breeds</h1>
	<p>There are many kind of dog breeds</p>
	<ul>
		<li>German Shepherd</li>
		<li>Bulldog</li>
		<li>Poodle</li>
	</ul>
</body>

						<body><h1>Dog Breeds</h1><p>There are many k
ind of dog breeds</p><ul><li>German Shepherd
</li><li>Bulldog</li><li>Poodle</li></ul></body>

But obviously, the left one here is much more readable to us humans. We can use white space, tabs/indenting, and line breaks to make it easier for us to read the code.

There are a lot of common patterns used⁠—like indenting to indicate hierarchy/nesting. But there are also no wrong ways to do it! In HTML, spaces are code ergonomics for you⁠—just like a good chair or desk⁠—that allow you to work more comfortably.

Code is read more often than it is written. Code should always be written in a way that promotes readability.

Guido van Rossum, 2001

Block Elements

Block-level elements always start on a new line, and take up the full width available⁠—stretching out to the left and right of their parent/container. They stack on top of each other. Importantly, block elements can have a top and bottom margin, unlike inline elements.

<address>
<article>
<aside>
<blockquote>
<canvas>

<dd>
<div>
<dl>
<dt>
<fieldset>

<figcaption>
<figure>
<footer>
<form>
<h1> – <h6>

<header>
<hr>
<li>
<main>
<nav>

<noscript>
<ol>
<p>
<pre>
<section>

<table>
<tfoot>
<ul>

These are live, editable examples!

Inline Elements

Inline elements do not start on a new line, and only take up as much width as necessary. You can think of these as the little metal slugs from printing. Other text and inline elements will continue to flow around them, and they can wrap to new lines:

<abbr> <a> <cite> <code> <del> <em> <img> <ins> <mark> <span> <strong> <sub> <sup> <time>

Inline Whitespace

Inline elements are the exception to the “white space is generally ignored” rule: extra space between inline elements will always be reduced⁠—collapsed⁠—to one space.

						<p>
	<span>Hello</span>
	<span>World</span>
</p>

…displays as Hello World, not HelloWorld.

So Many Elements

Comments

You can comment part of the code and the browser won’t show it. Comments are often used to explain your thinking, organize your code, “turn off” a bit of code, or temporarily hide whatever you’d like.

Keep in mind these are still readable in the source.

Lists

Any time you have more than two of something, you probably have a list. These are commonly used for semantic navigation elements, as well⁠—think “here’s a list of links in this site”:

Description Lists

There are specific lists for defining things:

These aren’t much to look at without CSS, though. Soon!

Details / Summary

There is even some basic interactivity (way, way ahead of JavaScript) with details disclosure elements that open and close:

You can do a lot with these, without any JavaScript!

Tables

Tables can we used to display tabular data:

This syntax is pretty verbose, for what you get.

They used to be the only way to achieve multi-column or grid layouts, but that has luckily since been replaced by modern CSS techniques like flexbox, and grid. (Or even float.) We’ll talk about those later!

Again, there are many, many, many, many HTML elements. Try and find the one that best fits your usage, wherever possible using a semantic element that fits your content.

User-Agent Styles

We haven’t applied any styles/CSS here yet, so everything we see in these examples is based on the user-agent stylesheets⁠—that is, each browser’s own default display (and behavior) for an element type.

This is what the web was, before CSS! But as a designer, rarely what you want. We’ll get into writing our own styles in the coming weeks.

In case of conflict, consider users over authors over implementors over specifiers over theoretical purity.

•••

Of course, it is preferred to make things better for multiple constituencies at once.

W3C, HTML Design Principles, 2007