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.
Clicking on an AWE button launches the list of attached actions (button actions) which are called sequentially.
When the screen size is too small (mobile devices) the buttons defined on the buttons
source of the screen are moved to the lower side:
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 | Required | 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 | Note: You can check all iconsets at icons screen |
button-type | Opcional | String | Comportamiento por defecto del botón | button (default), submit or reset . See button types |
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
Inside a button, you can define a list of button actions, which are actions that will be launched when the user pushes the button. El orden en que se definen las acciones de los botones es el mismo en el que serán lanzadas.
See the actions section for more details about actions.
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>
Button launched on click
event
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>