Widget Percentage
En los archivos XMLView se puede utilizar el Widget Percentage (WidgetPercentage) para mostrar o editar porcentajes: descuentos, impuestos, comisiones, márgenes, etc. Funciona igual que el Widget Number, pero en los listados añade el símbolo % al valor y en los formularios muestra por defecto el icono de porcentaje.
<column name="dto" display="right" order="130">
<widget type="percentage" fieldname="dtopor"/>
</column>El valor se guarda tal cual en el campo: un 21 % se almacena como 21, no como 0,21.
Propiedades del Widget Percentage
- fieldname: Nombre del campo que contiene la información. Obligatorio.
- required: Evita que se guarden los datos del formulario si el usuario no ha ingresado nada en el campo.
- readonly: Impide la modificación del valor.
- onclick: URL o controlador al que será redirigido el usuario al hacer clic. A esta URL se le añade ?code= seguido del valor del campo.
- icon: Icono a mostrar en el campo de edición. Por defecto es
fa-solid fa-percentage. - decimal: Número de decimales a mostrar. Por defecto, será el indicado en el apartado Por defecto (menú administrador, panel de control) de FacturaScripts.
- min: Valor mínimo permitido. Opcional.
- max: Valor máximo permitido. Opcional.
- step: Valor que se sumará o restará cada vez que se pulse la flecha hacia arriba o hacia abajo.
Por ejemplo, para limitar un descuento entre 0 y 100 y mostrarlo sin decimales:
<column name="dto" display="right" order="130">
<widget type="percentage" fieldname="dtopor" decimal="0" min="0" max="100"/>
</column>Visualización
- En un formulario de edición se muestra un campo numérico con el icono de porcentaje a la izquierda.
- En un listado se muestra el número formateado seguido de %, por ejemplo 21,00%. Si el campo está vacío se muestra un guion (-).
🎨 Opciones de coloreado
Recuerda que todos los widgets tienen una serie de propiedades y opciones comunes.