OdooWiki OCA HUB

Web Widget Numeric Step

web_widget_numeric_step folder_open OCA/web open_in_new
web Licencia: AGPL-3

Este widget modifica el campo de entrada numérica y facilita el incremento del número gracias a 2 botones (+ y -). Utiliza la lógica nativa de JS para el campo de entrada numérica, por lo que puedes usar las opciones min, max, step, placeholder.

Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.

auto_awesome Qué hace este módulo

Generado por IA a partir del código · Odoo 20.0

Añade un widget de campo numérico con botones de menos y más para que los usuarios puedan aumentar o disminuir un número en un paso fijo, con límites mínimo y máximo opcionales. Se puede usar en cualquier campo decimal o de número entero en los formularios y listas de Odoo.

Este módulo proporciona a Odoo una nueva forma de mostrar los campos numéricos: en lugar de escribir un valor, los usuarios ven un botón de menos, el número y un botón de más. Cada clic cambia el valor en un paso definido (por ejemplo, 0.5 o 5), y nunca se permite que el resultado quede por debajo de un mínimo ni por encima de un máximo cuando esos límites están establecidos.

  • Funciona tanto en campos decimales como en campos de números enteros.
  • Los usuarios también pueden pulsar las teclas de flecha arriba y abajo, o desplazar la rueda del ratón sobre el campo, para cambiar el valor.
  • Se puede mostrar un texto de marcador de posición cuando el campo está vacío.
  • Cuando el campo es de solo lectura, simplemente muestra el número formateado sin botones.

El widget está disponible para los desarrolladores como numeric_step y se puede colocar en cualquier campo de una vista de formulario o de lista. El módulo en sí no añade menús ni pantallas nuevas; solo cambia el aspecto y el comportamiento de los campos numéricos allí donde se aplica.

A modo de demostración, el módulo incluye una vista de demostración que aplica el widget a la configuración del formato de papel (report.paperformat): los márgenes superior e inferior cambian de 0.5 en 0.5 entre 0 y 100, los márgenes izquierdo y derecho cambian de 1 en 1 entre 0 y 50, y el espaciado de la cabecera cambia de 5 en 5 entre 0 y 100. Esta demostración solo se carga en los datos de demostración y muestra cómo se puede configurar el widget.

Texto generado por IA (DeepSeek) al leer el código de la versión 20.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub

Disponibilidad por versión

Revisado: 2026-11-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 9 confirmadas, 0 sin información de 9 versiones.

terminal Instalación y uso

Documentación de OCA · Odoo 20.0

En tu vista xml, añade widget="numeric_step" a un campo float o integer. Esto añadirá los 2 botones "+" y "-" justo al lado del campo de entrada en modo edición. El paso de iteración por defecto es 1.

Opcional

Añade una opción para elegir el paso de iteración y los límites (valores min y max).

Ejemplo para un paso de 0.25, min a -1 y max a 10:

<field name="sale_delay" widget="numeric_step" options="{'step': 0.25, 'min': -1, 'max': 10}" /> days

Opciones disponibles

  • step \> Cantidad a incrementar/decrementar (por defecto: 1.0)
  • min \> Valor mínimo permitido (por defecto: sin límite)
  • max \> Valor máximo permitido (por defecto: sin límite)
  • auto_select \> Selecciona el contenido cuando el elemento obtiene el foco (por defecto: False)
  • placeholder \> Define el texto del placeholder (por defecto: None)
  • class \> Define clases adicionales para el input (por defecto: None)

Ejemplos

Iteración con paso de 0.25, min a -1 y max a 10.

Empieza a incrementar con el botón, continúa incrementando con el desplazamiento del ratón.

Iteración con paso de 10, límite máximo 15, placeholder con onchange

Demo

Puedes probar la funcionalidad yendo a Settings > Technical > Reporting > Paper Format. Los campos "Top Margin (mm)" y "Bottom Margin (mm)" están configurados para usar el widget con paso de 0.5, min a 0 y max a 100, y los campos "Left Margin (mm)" y "Right Margin (mm)" con paso de 1, min a 0 y max a 50. El campo integer "Header spacing" está configurado con paso de 5, min a 0 y max a 100.

Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación, Configuración.

info

Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.