On this page:
- Text
- Image element
- Anchor element
- Span element
- Inline decorative elements, and line break
- Inline phrase elements
Text
The main inline element is text, which can be marked up by decorative or phrase elements (see below). Text can also be used as a link to another location in the same document (an anchor) or to another web page (a link) by being enclosed in an anchor (a) element.
Image element
Inline or floating images are placed inside any block element that can take inline elements. Typically they are placed in paragraphs.
Inline image
Here's an example of an inline image (the envelope), which integrates into a line of text. Here's the same image with a border around it.
We add the "image-inline" value to the class attribute of the img element to make the inline image align correctly with the surrounding text. Note that the alt attribute is required, even if empy. A value assigned to alt appears as fly-over text when the mouse rests over the image. We use relative addressing (see Files) to refer to the location of the image assigned to the src attribute.
Floating image
Images can also be floated to the left or right of the text with which they are associated. They are anchored vertically by the location that you add them to the text.
Here they are again with borders.
Centred image
Images can also be centred, though text does not flow around them.
Here is a centered image with a border.
For titled and narrated images see Imageboxes on the Custom block level elements page.
Anchor element
The anchor element provides the hypertext capability of web pages. When a user clicks on text or an image enclosed by an anchor element, the browser navigates to the target specified in the anchor element (the value assigned to the href attribute). This target could be on the same page (called an "anchor"), on a new page in the same browser window, or on a new page in a new browser window (the latter two called "links"). Finally, anchor elements can be specified to open the user's email software (email link) and begin a new email with a specified target email address, subject line, and a short message. Anchors, links, and email links can be specified on either text or images.
Link
For links, we have adopted the convention that all links to Friends of Dufferin Grove website pages will open in the same window, whereas links to webpages from other websites will open in a new window. To have a link open in a new window add the target="_blank"
attribute to the anchor element (note carefully the leading underscore in "_blank"). For links to internal web pages, use relative addressing (See Files). For links to external websites, use full URL addressing, including the leading "http://".
Links can also be specified with non web pages as targets, such as PDF documents (see Files) and (large) pictures. No special attribution is required to accomplish this; the browser interprets the target from the file type of the target of the link. When the target is a non-html page (such as a PDF file or a large image) we open the PDF or image in a new window, both to indicate that the link is a digression, and to give the user an opportunity to cancel loading of the target document if it is taking too long to load, without losing the source reference page.
Anchor
When the target of a link is the same page, two forms of the anchor element are used in conjunction - one for the text clicked by the user (the source or link) and the other at the target location to identify for the browser the target location of the navigation (the target or anchor). The source anchor element is in the standard link form, with the exception that the value assigned to the href attribute is the name of the target anchor element, prefixed by a hash mark (#) to indicate to the browser that the target of the navigation is an on-page anchor (eg. <a href="#anchorname">Go to target</a>
). The target anchor is written in the form <a name="anchorname"></a>
. This target anchor is an empty element, with no text between the opening and closing tag. It's sole purpose is to identify a target location within the HTML to the browser.
The value assigned to the name attribute of the target anchor element must be unique for anchors on that page.
We commonly use the on-page links within the "On this page:" contents sections, to allow the user to navigate directly to a section of interest (see Layout patterns).
Email link
An email link is in the same general form as a standard link, with the exception that the value assigned to the href attribute is in a special form, notably by being prefixed with "mailto:". Three pieces of information can be added to the "mailto:" prefix - the email address of the recipient, text for the subject line, and text for the body of the email. See the pattern for details. Here as some samples that you can click on:
email to webmaster
email to webmaster with subject
email to webmaster with message
email to webmaster with subject and message
Note that in the last example the browser is alerted to the first extra argument with a question mark (?), and the second with an ampersand (&). For security reasons, browsers only allow relatively short strings to be assigned to the href attribute for mailing, therefore the message placed in the body of the email by the browser (if there is one) can only be a short one. The user can add any amount of text or other content as with a normal email once the new email message is presented to him or her.
Span element
Span is the generic inline container (analagous to the div on the block level element side). We use the span to define emphasis within text. We have defined several effects:
"heading-inline" is intended as an inline heading at the beginning of a paragraph; "emphasis-hot" and "highlight" provide special emphasis; and "emphasis-none" cancels emphasis within a stream of inline emphasis.
Inline decorative elements, and line break
Text decoration: bold, italic, underline, and strikethrough
This is bold. This is italic. This is underline. This is
strikethrough. This is the combination of all of them.
Size changes: big, small, subscript, and superscript
This is big. This is small. This is a subscript. This is a superscript.
The line break
You can place a line break (no end tag, just <br>
by itself)
anywhere in the content text to create a line break to make
the next character of text begin at the next page line.
Here is
a line break.
Inline phrase elements
References: acronym and citation
This is an acronym. This is a citation.
Emphasis: emphasis element, strong
This is emphasis. This is strong.
See the span element above for additional emphasis elements we have defined.