Components/Step Input

fd-step-input · 6 examples from SAP's documentation · Back to the gallery

About

The step input control allows the user to change the input values in predefined increments (steps).

**Use the step input if:** - The user needs to adjust amounts, quantities, or other values quickly. - The user needs to adjust values for a specific step (for example, in a shopping cart). **Do not use the step input if:** - The user needs to enter a static number (for example, postal code, phone number, or ID). In this case, use **Input Field** instead. - You want to display a value that rarely needs to be adjusted and does not pertain to a particular step. In this case, use **Input Field** instead. - You want the user to enter dates and times. In this case, use the **Date Picker** or **Time Picker** pattern instead. **Use the step input if:** - The user needs to adjust amounts, quantities, or other values quickly. - The user needs to adjust values for a specific step (for example, in a shopping cart). - The user needs to enter a static number (for example, postal code, phone number, or ID). In this case, use **Input Field** instead. - You want to display a value that rarely needs to be adjusted and does not pertain to a particular step. In this case, use **Input Field** instead. - You want the user to enter dates and times. In this case, use the **Date Picker** or **Time Picker** pattern instead.

Default

The default step input displays an input field with a plus and minus icon on opposing sides to either increase or decrease the value. It is displayed in cozy mode, which is ideal for mobile and tablet screens.

States

Step input can be displayed in various states such as Success, Information, Error and Warning. **To display step input in a semantic state, add the following classes to the main elements:** | State | Class | | :------ | :----------- | | Success | \

Focused

To enable the focused state add the \

Disabled

Step input can be disabled by adding the \

Read-only

Step input can be displayed as read-only by adding the \

Degree Celsius

FullWidth

For Step Input that takes the whole width of the container element add the \