TheArtSite

A check box represents an independent or non-exclusive choice.

Checkboxes are represented with a sunken panel, populated with a "check" icon when selected, next to a label indicating the choice.

Note: You must include a corresponding label after your checkbox, using the <label> element with a for attribute pointed at the id of your input. This ensures the checkbox is easy to use with assistive technologies, on top of ensuring a good user experience for all (navigating with the tab key, being able to click the entire label to select the box).

<%- example(` This is a checkbox `) %>

Checkboxes can be selected and disabled with the standard checked and disabled attributes.

When grouping inputs, wrap each input in a container with the field-row class. This ensures a consistent spacing between inputs.

<%- example(` `) %>

An option button, also referred to as a radio button, represents a single choice within a limited set of mutually exclusive choices. That is, the user can choose only one set of options.

Option buttons can be used via the radio type on an input element.

Option buttons can be grouped by specifying a shared name attribute on each input. Just as before: when grouping inputs, wrap each input in a container with the field-row class to ensure a consistent spacing between inputs.

<%- example(` `) %>

Option buttons can also be checked and disabled with their corresponding HTML attributes.

<%- example(` `) %>

A group box is a special control you can use to organize a set of controls. A group box is a rectangular frame with an optional label that surrounds a set of controls.

A group box can be used by wrapping your elements with the fieldset tag. It contains a sunken outer border and a raised inner border, resembling an engraved box around your controls.

<%- example(`

Select one:

Diners

Drive-Ins

Dives

`) %>

You can provide your group with a label by placing a legend element within the fieldset.

<%- example(`

Today's mood

Claire Saffitz

Brad Leone

Chris Morocco

Carla Lalli Music

`) %>

A text box (also referred to as an edit control) is a rectangular control where the user enters or edits text. It can be defined to support a single line or multiple lines of text.

Text boxes can rendered by specifying a text type on an input element. As with checkboxes and radio buttons, you should provide a corresponding label with a properly set for attribute, and wrap both in a container with the field-row class.

<%- example(` `) %>

Additionally, you can make use of the field-row-stacked class to position your label above the input instead of beside it.

<%- example(` `) %>

To support multiple lines in the user's input, use the textarea element instead.

<%- example(` `) %>

Text boxes can also be disabled and have value with their corresponding HTML attributes.

<%- example(` `) %>

A slider, sometimes called a trackbar control, consists of a bar that defines the extent or range of the adjustment and an indicator that shows the current value for the control...

Sliders can rendered by specifying a range type on an input element.

<%- example(` `) %>

You can make use of the has-box-indicator class replace the default indicator with a box indicator, furthermore the slider can be wrapped with a div using is-vertical to display the input vertically.

Note: To change the length of a vertical slider, the input width and div height.

<%- example(` `) %>

A drop-down list box allows the selection of only a single item from a list. In its closed state, the control displays the current value for the control. The user opens the list to change the value.

Dropdowns can be rendered by using the select and option elements.

<%- example(` 5 - Incredible! 4 - Great! 3 - Pretty good 2 - Not so great 1 - Unfortunate `) %>

By default, the first option will be selected. You can change this by giving one of your option elements the selected attribute.

<%- example(` 5 - Incredible! 4 - Great! 3 - Pretty good 2 - Not so great 1 - Unfortunate `) %>

At the top edge of the window, inside its border, is the title bar (also reffered to as the caption or caption bar), which extends across the width of the window. The title bar identifies the contents of the window.

Include command buttons associated with the common commands of the primary window in the title bar. These buttons act as shortcuts to specific window commands.

You can build a complete title bar by making use of three classes, title-bar, title-bar-text, and title-bar-controls.

<%- example(` `) %>

We make use of aria-label to render the Close button, to let assistive technologies know the intent of this button. You may also use "Minimize", "Maximize", "Restore" and "Help" like so:

<%- example(`

`) %>

Each aria-label also has a corresponding styling class to render the title bar buttons, to let the aria-label text be in other languages without causing rendering, accessibility, or localization issues.

<%- example(`

`) %>

Maximize buttons can be disabled, useful when making a window appear as if it cannot be maximized.

<%- example(` `) %>

You can make a title bar "inactive" by adding inactive class, useful when making more than one window.

<%- example(` `) %>

Every window has a boundary that defines its shape.

To give our title bar a home, we make use of the window class. This provides a raised outer and inner border, as well as some padding. We can freely resize the window by specifying a width in the container style.

<%- example(` `) %>

To draw the contents of the window, we use the window-body class under the title bar.

<%- example(` `) %>

A status bar is a special area within a window, typically the bottom, that displays information about the current state of what is being viewed in the window or any other contextual information, such as keyboard state.

You can render a status bar with the status-bar class, and status-bar-field for every child text element.

<%- example(` `) %>

A tree view control is a special list box control that displays a set of objects as an indented outline based on their logical hierarchical relationship.

To render a tree view, use an ul element with the tree-view class. The children of this list (li elements), can contain whatever you'd like.

<%- example(`

• We can put
• ✨ Whatever ✨
• We want in here

`) %>

To make this a tree, we can nest further ul elements (no class needed on these). This will provide them with a nice dotted border and indentation to illustrate the structure of the tree.

To create expandable sections, wrap child lists inside of details elements.

<%- example(`

• Table of Contents
• What is web development?
• CSS
  • Selectors
  • Specificity
  • Properties
• JavaScript

  • Avoid at all costs
  • Unless

    • Avoid
    • At

      • Avoid
      • At
      • All
      • Cost
    • All
    • Cost
• HTML
• Special Thanks

`) %>

A tab control is analogous to a divider in a file cabinet or notebook. You can use this control to define multiple logical pages or sections of information within the same window.

To render a tab list, use a menu element with the [role=tablist] attribute. The children of this menu (li elements), should get a [role=tab] attribute.

Tabs should be managed by adding custom javascript code. All you need is to add the [aria-selected=true] attribute to the active tab.

<%- example(` `) %>

To create multirows tabs, add a multirows class to the menu tag.

<%- example(` `) %>

To render a table view, use a table element. Wrap it with a div element with sunken-panel class to provide proper border and overflow container.

With a bit of extra scripting you can make table view interactive. Give interactive class to table element to show pointer cursor when hovering over body rows. Table rows can be given highlighted class to appear selected.

<%- example(` `) %>

You can use a progress indicator, also known as a progress bar control, to show the percentage of completion of a lengthy operation.

There are two types of progress bars: solid and segmented. The solid version is the default. To declare a segmented bar, you should use the segmented class.

<%- example(` `) %> <%- example(` `) %>

Text boxes, check boxes, drop-down list boxes, spin boxes and list boxes use the field border style. You can also use the style for define the work area within a window. It uses the sunken outer and sunken inner basic border styles. For most controls, the interior of the field uses the button highlight color. For text fields, such as text boxes and combo boxes, the interior uses the button face color when the field is read-only or disabled.

Status fields use the status field border style. This style uses only the sunken outer basic border style. You use the status field style in status bars and other read-only fields where the content of the file can change dynamically.

As mentioned in these guidelines, these styles are used in other contexts than just form elements and status fields such as to indicate work areas and dynamic content. For that reason, we provide three classes for these generic usages, field-border, field-border-disabled, and status-field-border. These classes only define the border and background color and minimal padding, so you will typically need to at least provide some extra padding yourself. <%- example(` `) %> <%- example(` `) %> <%- example(` `) %>