Botón

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.

---

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:

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

Elemento	Uso	Varias instancias	Descripción
button	Obligatorio	No	Elemento principal del botón. Define los atributos del botón
button-action	Opcional	Si	Lista de acciones que se lanzan al pulsar el botón
dependency	Opcional	Si	Lista de dependencias definidas en el botón

Atributos del botón

Atributo	Uso	Tipo	Descripción	Valores
id	Opcional	String	Identificador del botón. Con fines de referencia
label	Opcional	String	Texto del botón	Nota: Puedes usar literales i18n
style	Opcional	String	Clases CSS del botón
icon	Opcional	String	Identificador de icono	Note: You can check all iconsets at icons screen
button-type	Opcional	String	Comportamiento por defecto del botón	button (por defecto), submit o reset. Ver tipos de botones
size	Opcional	String	Tamaño del criterio	sm (por defecto), md o lg.
value	Opcional	String	Establece un valor para el botón (puede ser utilizado como variable en el servidor)
help-text	Opcional	String	Texto para mostrar en el botón como ayuda	Nota: Puedes usar literales i18n
imagen de ayuda	Opcional	String	URL de imagen para mostrar en el botón como ayuda	Nota: Puedes usar literales i18n

Tipos de botón

Tipo	Descripción	Imagen
button	Botón estándar. No hace nada si no hay acciones de botón adjuntas
submit	Botón de enviar. Se llama cuando un usuario presiona INTRO dentro de un criterio
reset	Botón de reiniciar. Si se hace clic lanza una acción de restablecimiento

Eventos del botón

Evento	Descripción
click	Se 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>