Timepicker
Timepicker
- HTML/CSS:Dev Ready
- Layout:Desktop Only
A timepicker is an autocomplete text input to capture a time.
BaseRequires ui:scrollerWrapper
Preview
About Timepicker
Implementation Notes and Requirements
A timepicker is used to select a single time. The component is using the combobox HTML structure and has the following markup requirements:
Desktop
- Add
.slds-is-opento the element with.slds-dropdown-triggerto invoke the dropdown that contains the list of time options. - The
.slds-has-focusmodifier class is required on the.slds-listbox__optionelement that has focus. - The
.slds-is-selectedmodifier class is required on the.slds-listbox__optionelement that has been selected.
Mobile
- When on mobile, we want to leverage the native timepicker by changing the
inputtype fromtexttotime - When switching
input type="text"toinput type="time"for mobile, we need to remove the ARIA attributes. The native rendering doesn't require these.- On the element with the class
slds-combobox, please removerole="combobox",aria-expanded, andaria-haspopup. - On the
inputthat we just addedtype="time"too, please removearia-controls,aria-autocomplete, androle="textbox".
- On the element with the class
Accessibility
Please follow the implementation guildelines found under Combobox
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-timepicker |
|---|---|
| Summary | Initializes a timepicker |
| Support | dev-ready |
| Restrict | div |
| Variant | True |