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.
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 | Note: You can use i18n files (locales) |
style | Opcional | String | Clases CSS del botón | |
icon | Opcional | String | Identificador de icono | Nota: Se pueden utilizar todos los iconos de FontAwesome |
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 (default), md or 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 | Note: You can use i18n files (locales) |
imagen de ayuda | Opcional | String | URL de imagen para mostrar en el botón como ayuda | Note: You can use i18n files (locales) |
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
Event | 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="<" 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="<" 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>