Saltar al contenido principal
Version: 4.5.0

Button

Un botón es un elemento de control gráfico que proporciona al usuario una forma simple de lanzar un evento, como realizar una consulta, o interactuar con cuadros de diálogo, como confirmar una acción.

Al hacer clic en un botón de AWE se lanza la lista de acciones definidas (acciones de botón) que son llamadas secuencialmente.

Button
Botones

Cuando el tamaño de la pantalla es demasiado pequeño (dispositivos móviles) los botones definidos en el source buttons de la pantalla son movidos al borde inferior:

Botones en formato móvil

Esqueleto de XML

<button id="[button-identifier]" button-type="[button-type]" label="[button-label]" icon="[button-icon]" 
style="[button-style]" size="[button-size]">
<button-action... />
<dependency... />
</button>

Estructura del botón

ElementoUsoVarias instanciasDescripción
buttonObligatorioNoElemento principal del botón. Define los atributos del botón
button-actionOpcionalSiLista de acciones que se lanzan al pulsar el botón
dependencyOpcionalSiLista de dependencias definidas en el botón

Atributos del botón

AtributoUsoTipoDescripciónValores
idOpcionalStringIdentificador del botón. Con fines de referencia
labelOpcionalStringTexto del botónNota: Puedes usar i18n archivos (locales)
styleOpcionalStringClases CSS del botón
iconoOpcionalStringIdentificador de iconoNota: Puede comprobar todos los iconos en FontAwesome
button-typeOpcionalStringComportamiento por defecto del botónbutton (por defecto), submit o reset. Ver tipos de botones
sizeOpcionalStringTamaño del criteriosm (default), md or lg.
valorOpcionalStringEstablece un valor para el botón (puede ser utilizado como variable en el servidor)
help-textOpcionalStringTexto para mostrar en el botón como ayudaNota: Puedes usar i18n archivos (locales)
imagen de ayudaOpcionalStringURL de imagen para mostrar en el botón como ayudaNota: Puedes usar i18n archivos (locales)

Tipos de botón

TipoDescripciónImagen
buttonBotón estándar. No hace nada si no hay acciones de botón adjuntasButton
submitBotón de enviar. Se llama cuando un usuario presiona INTRO dentro de un criterioEnviar
resetBotón de reiniciar. Si se hace clic lanza una acción de restablecimientoRestaurar datos

Eventos del botón

EventDescripción
clickSe lanza cuando un usuario hace clic en el botón

Acciones de botón

Dentro de un botón, puede definir una lista de acciones que se ejecutarán cuando el usuario haga clic en el botón. El orden en que se definen las acciones de los botones es el mismo en el que serán lanzadas.

Consulte la sección de acciones para obtener más detalles.

Ejemplos

Botón estándar con acciones y dependencias (borrar fila en tabla)

El botón está desactivado hasta que se seleccione al menos un elemento en la tabla.

<button label="BUTTON_DELETE" icon="trash" id="ButDel">
<button-action type="check-some-selected" target="Grd..."/>
<button-action type="confirm" target="DelMsg" />
<button-action type="server" server-action="maintain" target-action="...Del"/>
<button-action type="filter" target="Grd..."/>
<dependency target-type="disable" initial="true">
<dependency-element id="Grd..." condition="&lt;" value="1"/>
</dependency>
</button>

Botón que lanza un evento click

El mismo caso que antes, pero activado con una dependencia (y tal vez con otras condiciones de elementos)

<button label="BUTTON_DELETE" icon="trash" id="ButDel">
<dependency target-type="disable" initial="true">
<dependency-element id="Grd..." condition="&lt;" value="1"/>
</dependency>
<dependency initial="true">
<dependency-element id="ButDel" event="click"/>
<dependency-element .../>
<dependency-action type="check-some-selected" target="Grd..."/>
<dependency-action type="confirm" target="DelMsg" />
<dependency-action type="server" server-action="maintain" target-action="...Del"/>
<dependency-action type="filter" target="Grd..."/>
</dependency>
</button>