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-open
to the element with.slds-dropdown-trigger
to invoke the dropdown that contains the list of time options. - The
.slds-has-focus
modifier class is required on the.slds-listbox__option
element that has focus. - The
.slds-is-selected
modifier class is required on the.slds-listbox__option
element that has been selected.
Mobile
- When on mobile, we want to leverage the native timepicker by changing the
input
type fromtext
totime
- 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
input
that 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 |