Component Blueprints
Visual Picker
- HTML/CSS:Dev Ready
- Layout:Responsive
Sections
A visual picker can be either radio buttons, checkboxes, or links that are visually enhanced.
Coverable Content#
Base#
Coverable content comes in three sizes - small, medium (default) or large. The default uses radio buttons, allowing the user to pick only one. To allow multiple selections, follow the checkbox examples below.
Small#
<fieldset class="slds-form-element">
<legend class="slds-form-element__legend slds-form-element__label">Select an app</legend>
<div class="slds-form-element__control">
<div class="slds-visual-picker slds-visual-picker_small">Medium#
<fieldset class="slds-form-element">
<legend class="slds-form-element__legend slds-form-element__label">Select an app</legend>
<div class="slds-form-element__control">
<div class="slds-visual-picker slds-visual-picker_medium">Large#
<fieldset class="slds-form-element">
<legend class="slds-form-element__legend slds-form-element__label">Select an app</legend>
<div class="slds-form-element__control">
<div class="slds-visual-picker slds-visual-picker_large">States#
Disabled#
<fieldset class="slds-form-element">
<legend class="slds-form-element__legend slds-form-element__label">Select an app</legend>
<div class="slds-form-element__control">
<div class="slds-visual-picker slds-visual-picker_medium">Checkbox Examples#
To allow users to select more than one option, use checkboxes instead of radio buttons.
Small Checkboxes#
<fieldset class="slds-form-element">
<legend class="slds-form-element__legend slds-form-element__label">Add the following object(s)</legend>
<div class="slds-form-element__control">
<div class="slds-visual-picker slds-visual-picker_small">Medium Checkboxes#
<fieldset class="slds-form-element">
<legend class="slds-form-element__legend slds-form-element__label">Add the following object(s)</legend>
<div class="slds-form-element__control">
<div class="slds-visual-picker slds-visual-picker_medium">Large Checkboxes#
<fieldset class="slds-form-element">
<legend class="slds-form-element__legend slds-form-element__label">Add the following object(s)</legend>
<div class="slds-form-element__control">
<div class="slds-visual-picker slds-visual-picker_large">Non Coverable Content#
Base#
<fieldset class="slds-form-element">
<legend class="slds-form-element__legend slds-form-element__label">Select a plan</legend>
<div class="slds-form-element__control">
<div class="slds-visual-picker slds-visual-picker_medium">States#
Disabled#
<fieldset class="slds-form-element">
<legend class="slds-form-element__legend slds-form-element__label">Select a plan</legend>
<div class="slds-form-element__control">
<div class="slds-visual-picker slds-visual-picker_medium">Link#
<div class="demo-only" style="width:24rem">
<a href="#" class="slds-box slds-box_link slds-box_x-small slds-media">
<div class="slds-media__figure slds-media__figure_fixed-width slds-align_absolute-center slds-m-left_xx-small">
<span class="slds-icon_container slds-icon-utility-knowledge_base">Vertical#
Base#
<fieldset class="slds-form-element">
<legend class="slds-form-element__legend slds-form-element__label">Select an option</legend>
<div class="slds-form-element__control">
<div class="slds-visual-picker slds-visual-picker_vertical">States#
Disabled#
<fieldset class="slds-form-element">
<legend class="slds-form-element__legend slds-form-element__label">Select an option</legend>
<div class="slds-form-element__control">
<div class="slds-visual-picker slds-visual-picker_vertical">Overview of CSS Classes#
- Selector
- The CSS class being referred to.
- Summary
- A description of what the class does.
- Support
- Whether the class name is dev-ready (meaning it's fully vetted and tested and safe to use) or prototype (which means it's not fully vetted yet).
- Restrict
- The selector that the class name is allowed to be used on.
- Variant
- The base level pattern for a component. A variant can be extended to create another variant of that component, for example, a stateful button is a derivative of the base button.
- Modifier
- A single class that can be added to an HTML element of a component to modify its output. Typically these will be colors, sizing and positioning.
| Selector | .slds-visual-picker |
|---|---|
| Summary | Initializes a visual picker component |
| Support | dev-ready |
| Restrict | div |
| Variant | True |
| Selector | .slds-visual-picker__figure |
|---|---|
| Summary | Visual container for icon and text |
| Restrict | .slds-visual-picker div, .slds-visual-picker span |
| Selector | .slds-is-not-selected |
|---|---|
| Summary | Non-selected state |
| Restrict | .slds-visual-picker__figure > span |
| Selector | .slds-is-selected |
|---|---|
| Summary | Selected state |
| Restrict | .slds-visual-picker__figure > span |
| Selector | .slds-visual-picker__icon |
|---|---|
| Summary | Icon within visual picker |
| Restrict | .slds-visual-picker__figure |
| Selector | .slds-visual-picker__text |
|---|---|
| Summary | Text within visual picker |
| Restrict | .slds-visual-picker__figure |
| Selector | .slds-visual-picker_medium |
|---|---|
| Summary | Size modifier to adjust to the default size of medium |
| Restrict | .slds-visual-picker |
| Modifier | True |
| Selector | .slds-visual-picker_large |
|---|---|
| Summary | Size modifier to adjust to the size of large |
| Restrict | .slds-visual-picker |
| Modifier | True |
| Selector | .slds-visual-picker_small |
|---|---|
| Summary | Size modifier to adjust to the size of small |
| Restrict | .slds-visual-picker |
| Modifier | True |
| Selector | .slds-visual-picker__body |
|---|---|
| Summary | Text area that sits outside the visual picker |
| Restrict | .slds-visual-picker span |
| Selector | .slds-visual-picker__text-check |
|---|---|
| Summary | Checkmark that is visibily toggled when input is checked |
| Support | dev-ready |
| Restrict | .slds-visual-picker span |
| Variant | True |
| Selector | .slds-visual-picker_vertical |
|---|---|
| Summary | Initializes a vertical visual picker component |
| Support | dev-ready |
| Restrict | .slds-visual-picker |
| Variant | True |
| Selector | .slds-box_link |
|---|---|
| Summary | Checkmark that is visibily toggled when input is checked |
| Support | dev-ready |
| Restrict | .slds-box |
| Variant | True |
Visual Picker Release Notes
2.14.0
Fixed
- Changed checkmark vertical positioning
2.12.0
Added
- Added a Small variant to the visual picker
2.7.0
Changed
- Updated the disabled visual picker UI to be more apparent and a better match to the established conventions for disabled UI