Tabla
Enlace de datos
Defina o modifique el enlace de datos para la vista en la pestaña de propiedades Generales. La vista Tabla está enlazada a una lista de objetos que rellena las filas.
Propiedades de configuración
En Configuración, establezca o modifique las propiedades de configuración de la vista.
- Tamaño de pantalla
- Una propiedad de configuración que tenga el icono Tamaños de pantalla
junto al 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 valor predeterminado.
- Definiciones de temas
- Las definiciones de temas especifican los colores y los estilos de una vista y determinan su aspecto. Puede obtener una vista previa del aspecto de las vistas en el editor de temas. Consulte Temas.
| Propiedad de configuración del aspecto | Descripción | Tipo de datos |
|---|---|---|
| Estilo de tabla | El estilo de la tabla. Puede elegir las opciones siguientes:
|
TableStyle |
| Estilo de color | El estilo de color de la tabla. Los colores corresponden a variables en el tema especificado. Puede elegir las opciones siguientes:
|
TableColorStyle |
| Resaltar selección | Sombrea las filas seleccionadas. Esta opción no funciona si el estilo de color es 'ninguno'. | Boolean |
Ancho![]() |
Especifica la anchura de la tabla. Puede especificar la anchura en px (píxeles), en % (porcentaje) o en unidades em. Por ejemplo, 50px, 20%o 0.4em. Si no se especifica ningún tipo de unidad, se presupone que es px | String |
Altura ![]() |
Especifica la altura de la vista en px (píxeles) o en unidades em. Si no se especifica ningún tipo de unidad, se presupone que es px La altura no incluye la cabecera ni el pie. Si especifica una altura y las filas exceden el espacio vertical disponible en el cuerpo de la tabla, el cuerpo pasa a ser desplazable verticalmente. | String |
| Ajustar cabeceras de columna | Ajusta las columnas de cabecera en función del espacio disponible en la tabla. | Boolean |
| Mostrar elementos emergentes | Las vistas y menús emergentes aparecen sobre la tabla cuando no se especifica la altura. Por ejemplo, si esta opción está seleccionada, aparece una vista Selector de fecha y hora sobre la tabla. De lo contrario, el Selector de fecha y hora se incorpora en la celda de tabla. | Boolean |
| Estilo de cabecera y pie de página | Habilita para aplicar un estilo de cabecera y de pie de página distinto. El estilo Moderno , por ejemplo, agiliza la paginación en la cabecera y el pie de página. | TableHFStyle |
| Propiedad de configuración del comportamiento | Descripción | Tipo de datos |
|---|---|---|
| Modalidad de selección | Especifica cuántas filas puede seleccionar un usuario:
|
TableSelectionMode |
| Mostrar botón Suprimir | Mostrar u ocultar el botón para suprimir una fila. | Boolean |
Mostrar pie de página![]() |
Mostrar u ocultar el pie de página. El pie de página también se muestra si está habilitada cualquiera de las vistas de pie de página, por ejemplo, Mostrar botón Añadir. | Boolean |
| Mostrar botón Añadir | Mostrar u ocultar el botón para añadir una fila. Si se está ordenando o filtrando la tabla, es posible que la fila recién añadida no se muestre como la última de la tabla, o que no se muestre en absoluto hasta que se quite la ordenación o el filtrado. Tenga en cuenta que si elige un estilo de cabecera y pie de página Moderno y desea mostrar el botón Añadir , también debe seleccionar la opción Mostrar pie de página . |
Boolean |
Mostrar estadísticas de tabla![]() |
Habilita la visualización de estadísticas de tabla en el pie de página. Por ejemplo, Showing
1 to 5 of 59 entries.Tenga en cuenta que también debe seleccionar la opción Mostrar pie de página. |
Boolean |
Mostrar buscapersonas![]() |
Mostrar u ocultar el número de páginas. El buscapersonas solo muestra 5 páginas, por lo tanto, dependiendo del tamaño de página inicial, y el número de registros, las páginas pueden no ser consecutivas (1, 2, 3 ...). Por ejemplo: La tabla tiene un total de 50 entradas y el tamaño de página inicial está establecido en 5. Los números de páginas que se muestran son 1, 3, 5, 7, 10. El usuario pulsa el botón Siguiente para pasar por las páginas en orden o utiliza los botones de número de página para desplazarse rápidamente por las páginas. Tenga en cuenta que también debe seleccionar la opción Mostrar pie de página. |
Boolean |
Mostrar medidor de página![]() |
Mostrar u ocultar el medidor de página, que muestra el número de filas en una página. | Boolean |
Tamaño de página inicial![]() |
El número de filas que se visualizan en una página. | Integer |
| Cambiar el tamaño de las columnas | Permite al usuario cambiar el tamaño de las columnas arrastrando los separadores de columna. | Boolean |
| Tipo ANY | Especificación del tipo de definición de objeto de negocio cuando la vista está enlazada a una lista de tipos ANY. | TableANYType |
| Propiedad de configuración de columnas | Descripción | Tipo de datos |
|---|---|---|
| Representar como | Cómo se debe representar el contenido de célula:
Las vistas que están anidadas en celdas de tabla como, por ejemplo, Entero y Selector de fechas (en desuso), normalmente tienen los bordes visibles. La tabla también tiene su propio borde. Para eliminar los bordes de las vistas anidadas, utilice una vista sin fisuras. Si está utilizando la Vista de coach o la Vista de coach sin fisuras, seleccione showLabel para mostrar la etiqueta de la vista anidada. Para obtener más información, consulte Tipos de representación. |
String |
| Visibilidad | La visibilidad de las columnas. | String |
| Ordenable | Permitir que se puedan ordenar los datos de esta columna. De forma predeterminada, sólo se pueden ordenar las columnas que están enlazadas a tipos simples. Para ordenar un tipo complejo, debe establecer Representar como en Personalizado y utilizar un suceso En celda personalizada. Por ejemplo: |
Boolean |
| Opciones | Opciones para dar formato a los datos en la columna, según el tipo de datos.
|
String |
| CSS | El estilo CSS a aplicar a la columna. Puede utilizar un estilo CSS (por ejemplo, Por ejemplo, color:#00ff00 ) o clases CSS. Si hay dos puntos en este campo, la vista de tabla presupone que ha especificado un estilo CSS. De lo contrario, presupone que ha especificado uno o más nombres de clase CSS. |
String |
| Ancho | Ancho de columna en px, em, o %. Si no se especifica ninguna unidad, se presupone que es px. Nota: Considere la posibilidad de dejar un ancho de columna sin definir de forma que el navegador pueda calcular el espacio restante y asignarlo a la columna cuya anchura no se ha especificado. | String |
| label | La etiqueta de la columna. | String |
| showLabel | Cuando la celda se representa como una vista de coach o una vista de coach sin fisuras, muestra u oculta la etiqueta de la vista. | Boolean |
| Propiedad de configuración del rendimiento | Descripción | Tipo de datos |
|---|---|---|
| Carga asíncrona | Proporciona una mejor experiencia de interfaz de usuario para conjuntos de datos grandes (en detrimento de un tiempo de carga de filas general más lento una vez que la sección empieza a cargarse). | Boolean |
| Tamaño de lote asíncrono | Define cuántas filas se cargan de forma síncrona en un lote asíncrono. Esto puede ayudar a ajustar/optimizar el rendimiento de carga síncrono vs. asíncrono. | Integer |
Ejemplo
- Un parámetro name de tipo String.
- Un parámetro favoriteSport de tipo String.
- Un parámetro favoritePlayer de tipo String.
var autoObject = [];
autoObject[0] = {};
autoObject[0].name = "Dylan";
autoObject[0].favoriteSport = "Tennis";
autoObject[0].favoritePlayer = "Federer";
autoObject[1] = {};
autoObject[1].name = "Max";
autoObject[1].favoriteSport = "Soccer";
autoObject[1].favoritePlayer = "Messi";
autoObjectEl servicio de usuario del lado del cliente tiene una variable privada profiles de tipo Profiles[].
- General > Etiqueta es Perfiles - Coach Uno.
- General > Enlace es perfiles[].
- Una columna Nombre con el enlace profiles.currentItem.name
- Una columna Deporte favorito con el enlace profiles.currentItem.favoriteSport
- Una columna Jugador favorito con el enlace profiles.currentItem.favoritePlayer
- Configuración > Comportamiento
- El modo de selección es Único
- Mostrar botón Suprimir está seleccionado
- Mostrar pie de página está seleccionado
- Mostrar botón Añadir está seleccionado
- Mostrar estadísticas de tabla está seleccionado
- Configuración > Columnas tiene tres entradas con los valores siguientes:
- RenderAs está establecido en Vista de coach
- La visibilidad está establecida en visible
- Ordenable está seleccionado
En el servicio del lado del cliente, cree una copia de la página y conéctela a la primera página. En la segunda página, cambie la etiqueta de la Table por Perfiles - Coach dos.
Tipos de representación
- Vista de coach
- Utilice este tipo de representación, que es el valor predeterminado, para representar los contenidos de una columna de tabla como una vista que ejecuta la lógica de JavaScript. Este tipo de representación es más intensivo en datos y podría tener un impacto en el rendimiento de representación de la columna. Por ejemplo, para que una sección modal incluida en una tabla sea visible al pulsar un botón, puede utilizar el tipo de representación de vista de coach y una lógica similares a la siguiente JavaScript en el caso del botón:
- Vista de coach sin fisuras
- Utilice este tipo de representación para eliminar el marco de las vistas incluidas en una tabla durante la representación. Puede utilizar este tipo de representación para cambiar la apariencia de representación de vistas de entrada de forma típica como, por ejemplo, Entero o Decimal. Este tipo de representación se trata como una vista a excepción de la diferencia de apariencia.
- HTML simple
- Utilice este tipo de representación para representar los contenidos de la tabla utilizando HTML puro y únicamente cuando los campos de la tabla no ejecutan ninguna lógica de JavaScript. Si se utiliza con campos que ejecutan JavaScript (por ejemplo, en un suceso de vista), la vista no se representa en la página. Este tipo de representación es el menos intensivo en cuanto a datos de los tipos que se han descrito.
- Personalizada
- Utilice este tipo de representación para especificar opciones de representación en una columna de tabla o columna de tabla personalizada o para especificar qué aspecto debe tener un campo. Al editar los datos de configuración de una columna de tabla, puede utilizar el cuadro de edición Opciones para especificar el formateo opcional que se debe aplicar a objetos ya creados. Por ejemplo, .
Sucesos
Establezca o modifique los manejadores de sucesos para la vista en las propiedades de Sucesos. Puede establecer que los sucesos se activen mediante programación o cuando un usuario interactúe con la vista. Para obtener información sobre cómo definir y codificar sucesos, consulte Sucesos definidos por el usuario.
La tabla tiene los siguientes tipos de manejadores de sucesos:
- : Activado cuando se carga la tabla. Por ejemplo:
me.setPageIndex(0); - : Se activa cuando se carga una celda que tiene opciones de representación personalizadas (establecidas en la configuración de Columnas). Para utilizar este suceso, debe establecer Render como valor de configuración en la configuración Columnas. También puede utilizar este suceso para establecer tipos complejos. Por ejemplo:
var div = document.createElement("div"); div.innerHTML = cell.row.data[cell.varName]; return div; - : Activado cuando se muestran las filas. Este suceso se aplica únicamente para tablas con páginas. Por ejemplo:
alert("All rows have " + (all ? "" : "NOT") + " been loaded"); - : Este evento se activa cuando se carga una fila expandible. Para utilizar este suceso, debe habilitar la opción permitir la configuración de filas expandibles. Por ejemplo, cuando la fila se representa como:
Ejemplo cuando la fila se representa como:row.views.forEach(function(view) { switch(view.context.viewid) { case "Text1": view.setData(row.data[varName]); break; case "Text2": view.setData(row.data[varName]); break; } });var div = document.createElement("div"); div.innerHTML = row.data[varName] + " " + row.data[varName]; return div; - : Se desencadena cuando la fila se expande. Por ejemplo:
${Service_Call1}.execute(); - : Se desencadena cuando la fila se contrae. Por ejemplo:
alert("Collapsed row has index " + row.recordIndex); - : Activado cuando el usuario selecciona una fila. Por ejemplo:
alert("Selected row has index " + row.recordIndex); - : Se activa cuando el usuario utiliza Seleccionar todo para seleccionar todas las filas de una tabla que está en modalidad de selección Múltiple o para borrar la selección en todas las filas de la tabla. Proporciona una variable de contexto denominada todos para indicar que todas o ninguna de las filas están seleccionadas. Por ejemplo:
alert("All rows selected: " + all); - : Se llama a este suceso cuando el usuario añade una fila mediante el botón. Si devuelve un objeto JavaScript, se añade el objeto, de lo contrario se añade un objeto vacío. Por ejemplo:
alert("New row will be added"); - : Activado cuando el usuario solicita suprimir un registro. Si el suceso se devuelve, el registro no se suprime. Este suceso puede utilizarse para requerir la confirmación del usuario antes de que suprimir oficialmente el registro. Por ejemplo:
return confirm("Are you sure you want to delete item " + item.str1); - : Se activa cuando el usuario pulsa el icono de ordenación en una cabecera de columna de tabla. Vuelve a utilizar la ordenación personalizada y omite la ordenación de tabla predeterminada. Puede utilizar este suceso para establecer una lista ordenada de forma personalizada. Por ejemplo:
alert("Sorting " + col + " column in " + order + " order"); me.context.binding.set("value", myCustomSortedList); return false; - : Activado cuando el usuario cambia el valor del campo de entrada por página. Por ejemplo:
me.showPager(true); - : Activado cuando el usuario cambia el tamaño de una columna. Por ejemplo:
alert("Column resized"); - : Activado cuando el usuario arrastra y suelta una columna.
alert("Column dropped");
Métodos
Para obtener información detallada sobre los métodos disponibles para Table, consulte la API de Table JavaScript .
Recursos adicionales
Para obtener información sobre cómo crear un coach o una página, consulte Creación de coaches.
Para obtener información sobre las propiedades estándar (General, Configuración, Posicionamiento, Visibilidady Atributos HTML), consulte Ver propiedades.