Botón

Crea un botón que puede utilizar para avanzar de un coach a otro o para salir de un coach en un flujo como, por ejemplo, un servicio de usuario.

Enlace de datos

Establezca o modifique el enlace de datos para Botón en la pestaña de propiedades General. El control está enlazado a una variable Booleana.

Propiedades de configuración

Establezca o modifique propiedades de configuración para Botón como, por ejemplo, propiedades de aspecto y comportamiento, en la pestaña de propiedades Configuración. Puede definir las propiedades de configuración de la fórmula en la pestaña Sucesos.

Tamaño de pantalla
Una propiedad de configuración que tenga el icono Tamaños de pantalla icono Tamaños de pantalla además del nombre de propiedad, puede tener distintos valores para cada tamaño de pantalla. Si no define un valor, el tamaño de la pantalla hereda el valor del siguiente tamaño de pantalla más grande como su valor predeterminado. Si está utilizando el editor de escritorio de Process Designer (en desuso), está estableciendo el valor para el tamaño de pantalla grande. Los otros tamaños de pantalla heredan este valor.
Definiciones de temas
Las definiciones de temas especifican los colores y estilos de un control y determinan el aspecto del control. Puede obtener una vista previa del aspecto de los controles en el editor de temas. Consulte Temas.
Las propiedades de configuración de aspecto para Botón se listan en la tabla siguiente:
Tabla 1. Propiedades de configuración de aspecto para Botón
Propiedad de configuración del aspecto Descripción Tipo de datos
Estilo de color El estilo de color para el botón. Los colores corresponden a variables en el tema especificado. String
Forma La forma del botón. String
Tamaño El tamaño del botón. String
Sólo esquema El botón muestra su estilo basado en el color solo cuando se pasa un cursor por encima. De forma predeterminada, esta propiedad no está seleccionada. Boolean
Icono icono Tamaños de pantalla El nombre del icono que precede al texto del botón. Por ejemplo: calendar, clock-o, camera, cloud-upload, bell, info, file-text.

Consulte Font Awesome para obtener una lista completa de iconos.

String
Anchura icono Tamaños de pantalla La anchura del control. Puede especificar la anchura en px (píxeles), % (porcentaje) o en unidades em. Por ejemplo, 50px, 20%, o 0.4em. Si no se especifica ningún tipo de unidad, se presupone px.. String
Las propiedades de configuración de comportamiento para Botón se listan en la tabla siguiente:
Tabla 2. Propiedades de configuración de comportamiento para Botón
Propiedad de configuración del comportamiento Descripción Tipo de datos
Índice de pestañas El índice de secuencia de pestañas. Los índices de pestañas empiezan en 1 y se pueden establecer de forma dispersa. Por ejemplo, puede utilizar 1, 5, 10. La propiedad Índice de pestañas controla la secuencia de las pestañas al desplazarse entre las distintas áreas de un coach pulsando la tecla Tabulador. Integer
Impedir varias pulsaciones Impide que los usuarios pulsen el botón más de una vez. Boolean

Ejemplo

A modo de ejemplo, imagine que desea añadir un botón de validación para avanzar de un coach a otro en un servicio de usuario del lado del cliente. Para añadir el botón al flujo de servicio de usuario, en la vista Coaches añada un control Botón en el diseño del primer coach y después establezca las siguientes propiedades de configuración para el botón:
  1. En Fórmula, especifique el nombre del botón en forma de texto estático entre comillas dobles, por ejemplo "Aceptar".
  2. En Comportamiento, seleccione Impedir varias pulsaciones.
  3. En Aspecto, establezca Estilo de color en Éxito y deje Estilo de forma y Estilo de tamaño en Predeterminado. En Icono, escriba marca de selección.
  4. Guarde los cambios.

El resultado es un botón rectangular donde pone Aceptar sobre un fondo verde. El texto del botón va precedido de una marca de selección.

Sucesos

Establezca o modifique las propiedades de configuración de la fórmula o los manejadores de sucesos del control en la pestaña Sucesos. Puede definir que los sucesos se desencadenen mediante programación o cuando el usuario interactúa con el control. Para obtener información sobre cómo definir y codificar sucesos, consulte Sucesos definidos por el usuario.

Las propiedades de configuración de fórmula para Botón se muestran en la tabla siguiente:
Tabla 3. Propiedades de configuración de fórmula para Botón
Propiedad de configuración de fórmula Descripción Tipo de datos
Fórmula de etiqueta La expresión o la fórmula que se utiliza para definir la etiqueta del control Botón. Puede definir la etiqueta utilizando una serie estática, o dinámicamente utilizando una fórmula. Por ejemplo:
  • Texto estático entre comillas dobles:
    "Texto de botón estático"
  • Una fórmula para calcular dinámicamente la etiqueta:
    ${"Text1"}.getText()

Si desea más información sobre fórmulas, consulte Fórmulas.

String

El botón tiene los tipos siguientes de manejadores de sucesos:

  • Al cargar: Se activa cuando se carga la página. Por ejemplo:
    console.log("Button loaded")
  • Al pulsar: Se activa cuando se pulsa en el enlace, antes de salir de la página. Si la expresión evaluada devuelve false, el clic no activa el suceso de límite. Por ejemplo:
    return ${Text1}.isValid();
  • En suceso de límite: Se activa cuando el flujo alcanza un suceso Permanecer en página después de que se haya activado el suceso de límite a través del control de enlace. Para obtener más información, consulte la propiedad context.trigger() en el tema El objeto de contexto de vista de coach. Por ejemplo:
    alert("Stay on Page status '" + status + "'")

Según el suceso específico, puede utilizar lógica de JavaScript para modificar los efectos del control. Puede obtener más información sobre la utilización de sucesos con controles en el tema Sucesos definidos por el usuario.

Métodos

Si desea información detallada sobre los métodos disponibles para Botón, consulte la API JavaScript Botón

Recursos adicionales

Para obtener información sobre cómo crear un coach, consulte Creación de coaches.
Para obtener información sobre las propiedades estándar (General, Configuración, Posicionamiento, Visibilidad y Atributos HTML), consulte Propiedades de vista de coach.