mirror of
https://github.com/OCA/web.git
synced 2025-02-22 13:21:25 +02:00
160a39c409
New option so we can add new classes to the input or remove existing ones so we can style the input at our will. TT49390
133 lines
4.6 KiB
ReStructuredText
133 lines
4.6 KiB
ReStructuredText
=======================
|
|
Web Widget Numeric Step
|
|
=======================
|
|
|
|
..
|
|
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
|
!! This file is generated by oca-gen-addon-readme !!
|
|
!! changes will be overwritten. !!
|
|
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
|
!! source digest: sha256:3f4e1a0c2c047ce2fc2dcc1f2b9bd928cf1c5c5a26f131d17b64d3f5b98459ad
|
|
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
|
|
|
.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
|
|
:target: https://odoo-community.org/page/development-status
|
|
:alt: Beta
|
|
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
|
|
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
|
|
:alt: License: AGPL-3
|
|
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fweb-lightgray.png?logo=github
|
|
:target: https://github.com/OCA/web/tree/15.0/web_widget_numeric_step
|
|
:alt: OCA/web
|
|
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
|
|
:target: https://translation.odoo-community.org/projects/web-15-0/web-15-0-web_widget_numeric_step
|
|
:alt: Translate me on Weblate
|
|
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
|
|
:target: https://runboat.odoo-community.org/builds?repo=OCA/web&target_branch=15.0
|
|
:alt: Try me on Runboat
|
|
|
|
|badge1| |badge2| |badge3| |badge4| |badge5|
|
|
|
|
This widget changes input number field and make it easier to increment the number thanks to 2 buttons (+ and -).
|
|
Use JS native logic for input number, so you can use the options ``min``, ``max``, ``step``, ``placeholder``.
|
|
|
|
Demo available at `Settings > Users & Companies > Users > *Select One* > See 'Credit Limit' field`
|
|
|
|
**Table of contents**
|
|
|
|
.. contents::
|
|
:local:
|
|
|
|
Usage
|
|
=====
|
|
|
|
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.
|
|
|
|
.. figure:: https://raw.githubusercontent.com/OCA/web/15.0/web_widget_numeric_step/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 :
|
|
|
|
.. code:: 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)
|
|
- add_class > Define additional classes for the input (default: None)
|
|
- remove_class > Remove default classes from the input (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.
|
|
|
|
.. figure:: https://raw.githubusercontent.com/OCA/web/15.0/web_widget_numeric_step/static/description/step0,25andlimits.gif
|
|
|
|
Iteration with 10 step, max limit 15, placeholder with onchange
|
|
|
|
.. figure:: https://raw.githubusercontent.com/OCA/web/15.0/web_widget_numeric_step/static/description/step10_limit15_placeholder117_with_onchange.gif
|
|
|
|
Bug Tracker
|
|
===========
|
|
|
|
Bugs are tracked on `GitHub Issues <https://github.com/OCA/web/issues>`_.
|
|
In case of trouble, please check there if your issue has already been reported.
|
|
If you spotted it first, help us to smash it by providing a detailed and welcomed
|
|
`feedback <https://github.com/OCA/web/issues/new?body=module:%20web_widget_numeric_step%0Aversion:%2015.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
|
|
|
|
Do not contact contributors directly about support or help with technical issues.
|
|
|
|
Credits
|
|
=======
|
|
|
|
Authors
|
|
~~~~~~~
|
|
|
|
* GRAP
|
|
* Tecnativa
|
|
|
|
Contributors
|
|
~~~~~~~~~~~~
|
|
|
|
* `GRAP <http://www.grap.coop>`_:
|
|
|
|
* Quentin DUPONT <quentin.dupont@grap.coop>
|
|
|
|
* `Tecnativa <https://www.tecnativa.com/>`_:
|
|
|
|
* Alexandre Díaz
|
|
* Carlos Roca
|
|
|
|
* Helly kapatel <helly.kapatel@initos.com>
|
|
* Thanakrit Pintana <thanakrit.p39@gmail.com>
|
|
|
|
Maintainers
|
|
~~~~~~~~~~~
|
|
|
|
This module is maintained by the OCA.
|
|
|
|
.. image:: https://odoo-community.org/logo.png
|
|
:alt: Odoo Community Association
|
|
:target: https://odoo-community.org
|
|
|
|
OCA, or the Odoo Community Association, is a nonprofit organization whose
|
|
mission is to support the collaborative development of Odoo features and
|
|
promote its widespread use.
|
|
|
|
This module is part of the `OCA/web <https://github.com/OCA/web/tree/15.0/web_widget_numeric_step>`_ project on GitHub.
|
|
|
|
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
|