Skip to main content

Internet Archive elements

Specs

What each component in the design system should look like and do, drawn in plain HTML and CSS. The look comes from demo/docs/assets/ia.css, which uses nothing but the tokens; the behavior is a few lines of script. Each section is the reference for its spec in docs/components/.

These are not elements, and ia.css does not ship in the package. The Components tab is the real elements. Where an element already covers a spec, its section here says so and links to it; until the element matches the spec, this page is what it is measured against.

This page shrinks as elements land. Once an element matches its spec, its section and its ia.css rules are deleted, and the spec's markdown points at the element instead. Anything still here is a component no element covers yet.

Actions

Button

Three sizes, eight intents. Every size guarantees a 44×44 hit area on coarse pointers even when its visual box is smaller.

Intents

Sizes

States

Icon-only

A square whose side is the size's control height, or a circle. Always carries an aria-label. --floating adds the lift for a control that sits over media.

Press

Press and hold. Each squeezes by the scale for its width, so the edge travels about the same distance: icon buttons 0.92, text buttons 0.97, full-width buttons 0.985.

Prefer aria-disabled over disabled on form submits — a disabled button leaves the tab order, so a keyboard user reaches the end of a form and finds nothing there. (D-32)

Inputs

Input

The signup form's fields are native browser defaults today — border: 2px inset #767676, no focus state, no error state.

Up to 127 characters

Use at least 3 characters

Segmented control

One choice from two to four options that fit on screen. A radio group: one tab stop, arrows and Home/End move the choice. The chosen option takes the soft selected look. The sort bar's view switch is one.

Checkbox and radio

20px controls in 44px rows. Live renders these at 13×13 on mobile, inside a list of about seventy.

Media Type
Search In

Switch

A binary setting that takes effect the moment it changes. A form value that is submitted later is a checkbox.

Content

Tile

The most-repeated component on the site — fifty per page of results. Four kinds, chosen per result by content type — item, collection, account and saved search — on one skeleton. Titles clamp at three lines (four for a search).

Item

Collection

Account and search

An account: its avatar in a circle, the screen name, "Archivist since", and uploads in place of views. A saved search: the search glyph on a light well in a dark card, the query as its title, no footer.

What a tile can carry

Sorted by a date, that date replaces the byline ("published 1926"). Sorted by weekly views, the views stat counts the week. A serial adds its volume and issue; a full-text search adds the matching passages with the terms marked. A restricted result blurs its thumbnail under a banner saying why.

Parts

The two parts the site builds as components of their own: the thumbnail well (image-block) — a fixed 170px, image contained, square top corners rounded to match the card — and the item stat row (tile-stats).

Hover pane

With a pointer that can hover, resting on a grid or compact result for 300ms opens its list-view row beside the pointer; keyboard focus opens it too, and Down Arrow moves into it. Where a pointer cannot hover, the ⓘ button on the thumbnail opens it instead — this page shows that button only on a touch screen.

List view

    Compact view

    Read more

    Collapses long prose to six lines. The toggle appears only when at least four lines are hidden — a short description shows whole, with no control.

    Buster Keaton's College (1927) follows Ronald, a bookish valedictorian whose graduation speech denounces athletics. He loses his girlfriend to a star athlete and enrolls at Clayton College determined to win her back by excelling at every sport he once dismissed.

    The film was produced by Joseph M. Schenck and released by United Artists. This copy was digitized from a 16mm print held by a private collector and restored for the silent film collection. Intertitles are in English. The musical score is a later addition and is not part of the original release.

    Running time is 66 minutes at 20 frames per second. The print shows wear in the second reel, most visibly during the rowing sequence, and two short passages are supplied from a second source.

    A 1927 silent comedy starring Buster Keaton.

    Chips, badges, avatars, pagination

    3 New New 99+

    Item page

    The parts of offshoot's details page that no other page uses. The whole page is on the Screens page.

    Actions

    The glyph over the label in a 2px ink frame. Add to List shows when signed in, Borrow only on TV and radio items. Pressed, open, or holding a choice, an action takes the soft selected tier. Below lg each shows its short label.

    Lending bar

    Across the top of the theater over a lendable book: the loan's state, then its actions — the first a split button whose caret lists the rest.

    This book can be borrowed for 14 days.

    Print Disability Access

    Sidebar states

    A stream-only item says so under its stats. An item that needs a login replaces its downloads with the way in.

    • 9,804 Views
    • 41 Favorites

    Stream Only

    Log in to view this item

    Flag panel and list picker

    Flag opens a panel in the danger modal's dress; each flag is a checkbox item. Add to List opens a menu of the patron's lists, each checked when the item is in it.

    Not found

    The item you have requested had an error:

    Item cannot be found.

    which prevents us from displaying this page.

    Items may be taken down for various reasons, including by decision of the uploader or due to a violation of our Terms of Use.

    Feedback

    Messages

    Every intent carries an icon. Color alone fails WCAG 1.4.1 — and fails outright for the success/danger distinction, which is exactly red vs green.

    This collection is mirrored from a partner institution.
    Your changes were saved.
    Showing 200 of an estimated 1,200 results; the rest are still being counted.

    Banner

    The same message about the whole site, above the topnav and edge to edge like it: the tint spans the window and the text lines up with the page. Up to three stack, under the donation banner when a fundraiser is on. A dismissible banner fires an event and leaves remembering the dismissal to the page.

    The Wayback Machine is back to full speed after this week's outage.
    Uploads pause Saturday from 02:00 to 04:00 UTC for maintenance.

    Tooltip

    Names an icon-only control for pointer users, on hover and on focus. Escape hides it without moving focus. Never essential information, never anything interactive — the control's aria-label is still its name.

    Loading

    Skeletons match the shape of what is coming. A grid never gets a spinner.

    Empty state

    No results, or a failed search, replaces the whole browser — rail and sort bar included — with the message over a large illustration. A failure adds the search engine's own message under "Error details:".

    Page chrome

    Topnav

    The dark bar across every page. Wide, it carries the brand, the media types, search, account links and upload, with the subnav (About … Volunteer) in a row beneath. Narrower than the lg breakpoint, the subnav goes, the media types move into a drawer of full-width rows and search and account become icons. It responds to its own width, so the preview switch above shows the narrow form. The logo is the live mark and wordmark, lifted as a brand asset.

    Signed in, Texts open

    The account area is the avatar and, from 990px, the screen name; it opens the account menu, staff groups included. The open media type takes its color on the #333 fill. From 1200px each glyph carries its label.

    Environment badge

    On a development or staging host only, beside the logo, so a tab is never mistaken for production.

    Development Staging

    Narrow, menu open

    Loading

    While a page or its results load, a 3px bar sweeps under the header in the link color, over the page's first 3px. Under reduced motion it holds still.

    The page.

    Footer

    One line on the chrome surface: fixed to the viewport's foot on the homepage, at the end of the page on an item page, absent elsewhere.

    Dark chrome

    Everything inside .ia-inverse re-points its text, border and focus tokens. The focus ring switches to #9aa8ff automatically.

    A link on chrome

    Secondary text