Visualizar propiedades

Cada vista tiene un conjunto de propiedades estándar, que incluye general, posicionamiento, configuración, sucesos, visibilidad y atributos HTML.

Al seleccionar una vista en un diseño, se muestran las propiedades que describen la instancia de vista. Las propiedades general, posicionamiento, visibilidad y atributo HTML son comunes a todas las instancias de vista. Las propiedades de configuración se definen en la definición de vista y son específicas de las instancias de dicha vista.

  • Tema general
  • Posicionamiento
  • Configuración
  • Sucesos
  • Visibilidad
  • Atributos HTML

Tema general

Las propiedades generales constan de los campos siguientes:
Propiedad general Descripción
Etiqueta Define el nombre de visualización de la vista. La ubicación de la etiqueta depende del tipo de vista y de si dicha ubicación se ha modificado temporalmente mediante codificación CSS. El valor predeterminado es el nombre de la vista.
Restricción: Cuando coloca la vista en una tabla, la etiqueta de la vista no puede utilizar referencias a entidades dentro de una lista, como currentItem o selectedItem.
Ayuda Proporciona un área en la cual puede proporcionar ayuda contextual para la instancia de la vista.
ID de control Proporciona un identificador que puede utilizar en JavaScript para acceder a esta instancia de vista concreta. El ID de control también se conoce como ID de vista en la documentación de la API.
Enlazando Define el objeto de negocio que está asociado a esta instancia de vista.
Vista Establece la definición de vista para la instancia de vista. Si cambia esta propiedad, cambiará el tipo de la vista y las propiedades de configuración establecidas previamente dejarán de aplicarse.
Visibilidad de etiqueta Establece si los usuarios pueden ver la etiqueta en tiempo de ejecución. Por ejemplo, es posible que quiera que una vista Área de texto muestre una gran descripción sin ninguna etiqueta adjunta. Los valores son Show (valor predeterminado) y Hide.

Por ejemplo, puede utilizar una variable para cambiar de manera dinámica la visibilidad en función de distintas condiciones. Si utiliza una variable para establecer la visibilidad, la variable debe ser una serie con uno de los valores siguientes: SHOW HIDE.
Dirección del texto de base Define la dirección del texto que muestra la vista, como el texto de etiqueta, los valores de texto y otro texto que ve el usuario.

La propiedad Dirección de texto base sólo está disponible si habilita la preferencia Dirección de texto base.

El valor predeterminado es Valor predeterminado, lo que significa que la vista utiliza la dirección del texto definida en el perfil del usuario. Cuando establece la dirección del texto en Left to Right o Right to Left, el texto se bloquea en la dirección especificada. Cuando establece la dirección del texto en Contextual, el primer carácter direccional fuerte de una serie determina la dirección del texto. Esta regla se aplica a todos los elementos de texto que muestra una vista. Por ejemplo, una vista Texto tiene una etiqueta en árabe, pero el contenido de su campo está en inglés. En este caso, el texto de la etiqueta es de derecha a izquierda, mientras que el texto del campo es de izquierda a derecha.
Nota: En el editor de vistas, puede asignar una variable para las propiedades generales Etiqueta, Ayuda, Visibilidad y Visibilidad de etiqueta de cualquier instancia de vista anidada. Las opciones de configuración incluyen una categoría especial de variables denominada opciones generales. Estas variables corresponden a las propiedades generales Etiqueta, Ayuda, Visibilidad y Visibilidad de etiqueta de la vista. Es decir, la instancia de la vista anidada puede hacer referencia a las propiedades generales de su vista padre. Al contrario que otras opciones de configuración, no puede editar sus valores en la vista Variables.

Posicionamiento

Puede controlar el espaciado de las vistas en las páginas o en la vista personalizada estableciendo las propiedades de posicionamiento para cada instancia de vista. Los valores que define pueden ser absolutos, por ejemplo, en milímetros, o relativos, por ejemplo como un porcentaje del espacio de visualización disponible.

Los valores que defina determinan la cantidad de espacio que rodea el contenido de la vista. El relleno hace referencia al espacio dentro del margen de la vista. El margen hace referencia al espacio que se encuentra fuera del borde de la vista. Si la vista no tiene un borde visible definido, para verlo seleccione la vista de forma que se resalte el borde.

Sugerencia: Si está creando una vista personalizada y desea incluir un borde, se recomienda que utilice un div dentro del derivador divy que aplique valores de posicionamiento al divinterno. Esto se debe a que la vista contiene un derivador div que ha creado la infraestructura, y que es de su propiedad, en el tiempo de diseño y el tiempo de ejecución. Debe evitar actualizar este derivador div porque podría entrar en conflicto con el indicador visual en tiempo de diseño y tiempo de ejecución. Esto significa, por ejemplo, que el editor resalta el derivador div cuando se selecciona la vista, lo que dificulta ver el estilo establecido en el derivador div.

También puede especificar la altura de una vista, medida desde el borde inferior hasta el borde superior, así como el ancho desde el borde izquierdo al derecho. Los valores de altura y ancho mínimos le permiten limitar la reducción en altura y ancho, por ejemplo, si se reduce el espacio de la pantalla en el dispositivo de ejecución.

Las propiedades de margen y relleno pueden adoptar cuatro valores, que se corresponden a los valores de arriba, derecha, abajo e izquierda de la vista. Si se especifica un solo valor para los márgenes o el relleno, se aplica a los cuatro lados. Por ejemplo, si especifica el margen de la vista con un solo valor de 15pt, el margen de los cuatro lados de la vista se definirá en 15 pt. Para establecer los valores individualmente para los distintos lados de la vista, puede escribirlos individualmente utilizando el formato top right bottom left o puede pulsar el botón situado junto al campo para utilizar el diálogo para especificar valores para cada lado.

Los valores que especifique pueden ser relativos o absolutos, en función de la unidad de medida que especifique. Las unidades de medida soportadas se describen en las tablas siguientes.

Tabla 1. Unidades de medida relativas
Abreviatura Descripción
% Porcentaje de zona de observación
px Píxeles CSS
em Anchura de letra 'm' en font actual
supr Anchura de letra 'm' en font del elemento de página de nivel superior
Tabla 2. Unidades de medida absolutas
Abreviatura Descripción
en Pulgada
mm. Milímetro
cm Centímetro
pt Punto (1/72 pulgadas)
pc Pica (12 puntos)

Configuración

Puede definir las opciones de configuración en la vista para que los usuarios puedan personalizar una instancia específica de la vista. Los usuarios verán estas opciones de configuración como propiedades de configuración en dicha instancia.

Sucesos

Utilizando las nuevas herramientas e infraestructura de sucesos, puede desarrollar sucesos definidos por el usuario que aprovechen las ampliaciones de programación de la infraestructura para las vistas personalizadas. También puede ejecutar la lógica de negocio desde cualquiera de los manejadores de sucesos. Esta metodología permite a los manejadores de sucesos reaccionar a diversos tipos de sucesos, independientemente de si los sucesos vienen desencadenados mediante programación, por dispositivos o por acciones de usuario.

Visibilidad

Las propiedades Visibilidad especifican cómo se visualiza una vista.

El valor predeterminado es Same as parent, lo que significa que la vista utiliza la propiedad de visibilidad de la página o vista que contiene esta vista.
  • Si establece la propiedad Visibilidad en Editable, los usuarios pueden ver la vista y añadir o editar valores en ella, o bien interactuar con la misma.
  • Cuando establece la visibilidad en Required, la vista es editable y también tiene un decorador que indica a los usuarios que deben especificar o establecer un valor.
    Importante: Establecer la visibilidad en Required no valida si un usuario especifica o establece un valor. Debe proporcionar código que haga esta comprobación, por ejemplo, implementando un servicio de validación o script para la página que contiene la vista.
  • Cuando establece la visibilidad en Read only, los usuarios pueden ver la vista pero no pueden interactuar con los datos que contiene. Las vistas de solo lectura se distinguen visualmente de las vistas editables y las funciones para editar sus datos están inhabilitadas o eliminadas.
    Importante: El valor Sólo lectura sólo controla cómo se representa la vista. No está pensada como una forma de control de acceso. Puesto que los datos se pueden manipular mediante programación mediante una API o un script, la aplicación debe incluir la lógica del lado del servidor para proteger los datos en el servidor. Por ejemplo, si una aplicación tiene un customerID de campo que nunca se debe modificar en el cliente, la lógica del lado del servidor podría comparar que el valor customerID enviado desde el cliente es el mismo que el valor customerId almacenado en una base de datos de sistema de registro.
  • Cuando establece la visibilidad en Hidden, los usuarios ven un espacio en blanco donde se coloca la vista. El HTML generado todavía contiene el nodo DOM de la vista. El valor Hidden es la visibilidad de la vista en pantalla y no si los usuarios pueden verla en el origen HTML. Si elige Hidden, la vista padre reserva espacio en el diseño como si la vista estuviera visible. Por ejemplo, tiene una sección vertical con tres campos de texto. Si establece la visibilidad del campo central en Hidden , la sección muestra un espacio vacío donde estaría el campo central si estuviera visible.
  • Cuando establece la visibilidad en None, los usuarios no pueden ver la vista, pero la vista se lista en la ventana emergente Elementos invisibles . Para que la vista vuelva a ser visible, selecciónela en la lista emergente y pulse Mostrar elementos invisibles. De forma similar a Hidden, el HTML generado todavía contiene el nodo DOM para la vista. Si establece la visibilidad del campo central en None , la sección contrae el espacio entre los campos superior e inferior. Si el campo central pasa a ser visible, el campo inferior se desplaza hacia abajo para habilitar espacio para el campo central.
Por ejemplo, puede utilizar una variable para cambiar dinámicamente la visibilidad en función de distintas condiciones. Si utiliza una variable para definir la visibilidad, la variable debe ser una serie de caracteres con uno de los valores siguientes: DEFAULT (código equivalente a Igual que padre) EDITABLE REQUIRED READONLY NONE HIDDEN.

Atributos HTML

Los Atributos HTML es el lugar en el que se alteran temporalmente los estilos para una instancia de vista específica.

La alteración temporal de un estilo consta de lo siguiente:
  • Un atributo de clase HTML en cada instancia de vista a la que quiera dar un estilo específico
  • Una regla de CSS correspondiente a ese atributo de clase
Importante: No utilice los nombres siguientes como nombres de clase CSS en el código fuente HTML porque son nombres reservados:
  • CoachView
  • ContentBox
Además, asegúrese de que los nombres de las clases CSS no entren en conflicto con los nombres de las vistas. Un conflicto puede producir un estilo imprevisible durante la ejecución, pues el nombre de la vista se añade automáticamente, para delimitar el ámbito, al atributo de clase del encapsulador de la vista div.
En el ejemplo siguiente se muestra cómo mover una etiqueta:
  1. Añada una clase a los atributos HTML de la instancia del cuadro de texto. Por ejemplo, pulse Añadir clase y, a continuación, en Nombre de clase, escriba myText.
  2. En el código CSS, defina el estilo de la clase. Por ejemplo, defina la clase myText para alterar temporalmente los estilos de la posición de la etiqueta:
    .myText.Output_Text .outputTextLabel,
.Text .textLabel {
display: inline-block;
width: 100px;
}
.myText.Text .content {
display: inline-block;
}
  3. En una vista padre, añada la regla CSS a un archivo .css y añada dicho archivo como script incluido. Si la vista es una vista de nivel superior en un coach, añada un elemento HTML personalizado que contenga la regla de estilo.