web/web_widget_numeric_step/readme/USAGE.md

44 lines
1.3 KiB
Markdown

In your xml view, add `widget="numeric_step"` This will add the 2
buttons "+" and "-" just next to the input field in edit mode. Iteration
step by default is 1.
![](../static/description/add_two_buttons.png)
**Optional**
Add an option to choose the step iteration and limits (min and max
values).
Example for an 0.25 step, min to -1 and max to 10 :
``` xml
<field name="sale_delay" widget="numeric_step" options="{'step': 0.25, 'min': -1, 'max': 10}" /> days
```
**Available Options**
- step \> Amount to increase/decrease (default: 1.0)
- min \> Min. value allowed (default: no limit)
- max \> Max. value allowed (default: no limit)
- auto_select \> Select the content when the element get focus (default:
False)
- placeholder \> Define the placeholder text (default: None)
**Examples**
Iteration with 0.25 step, min to -1 and max to 10.
Start to increment with button, continue incrementing with scrolling
mouse.
![](../static/description/step0,25andlimits.gif)
Iteration with 10 step, max limit 15, placeholder with onchange
![](../static/description/step10_limit15_placeholder117_with_onchange.gif)
**Demo**
You can test the feature by going to Settings > Technical > Scheduled Actions. The
field "Execute Every" is configured to use the widget with 2 step, min to 0 and max
to 40.