Sugerencias para implementar el control de cuadrícula JS
Última modificación: viernes, 24 de junio de 2011
Hace referencia a: SharePoint Foundation 2010
En este artículo
Controlador
Filtrado
Persistencia
Cuadrícula de impresión
Asociación a eventos
Versiones de depuración de JsGrid.js y JsGrid.Gantt.js
Controlador
El controlador del Control de JS Grid indica a la cuadrícula cómo representar contenido (es decir, qué columnas o paneles debe mostrar). El controlador habilita el origen de datos. El controlador sabe cómo controlar filas no relacionadas, lo que permite que las ediciones se produzcan sin tener todos los datos de forma local.
También puede definir estilos en el controlador. En el siguiente código, RegisterCellStyle define un estilo, 'TextRightAlign', que se puede usar para alinear las columnas a la derecha.
<SharePoint:JSGrid ID="_grid" runat="server" />
<script type="text/javascript">
Type.registerNamespace("GridManager");
this.control;
GridManager = function () {
this.Init = function (jsGridControl, initialData, props) {
control = jsGridControl;
var dataSource = new SP.JsGrid.StaticDataSource(initialData);
var jsGridParams = dataSource.InitJsGridParams();
jsGridParams.styleManager.RegisterCellStyle('TextRightAlign', SP.JsGrid.Style.CreateStyle(SP.JsGrid.Style.Type.Cell, { textAlign: 'right' }));
jsGridControl.Init(jsGridParams);
}
};
</script>
Para obtener un ejemplo completo, vea Procedimiento para crear un control de JS Grid básico.
Filtrado
A continuación se muestra una lista de opciones de configuración que pueden ser útiles para filtrar contenido:
Estado oculto o visible de columna
Orden de columnas
Anchos de columna
Filtro complejo
Agrupación
Ordenación
Posición de la barra divisora
Persistencia
El término persistencia hace referencia a la retención de preferencias de selección de filtro, grupo, ordenación y vista en todas las sesiones de usuario. La persistencia es una característica de cada controlador.
Algunas de las opciones de configuración que no deben ser persistentes entre sesiones son:
Filtro automático: persistir la configuración de filtro automático puede confundir a los usuarios, ya que es posible que no comprendan por qué sus vistas no contienen datos. Si se configuran manualmente, los filtros del lado cliente son persistentes.
Jerarquía: se crea el conjunto de datos "sobre la marcha", por lo que es difícil que sea persistente; sin embargo, la configuración de "mostrar nivel de esquema" es persistente. Esta configuración hace que la vista cree el conjunto de datos mencionado anteriormente.
La fila o columna seleccionada
Nota
En Microsoft Office Project Server 2007, la mayoría de las opciones fueron persistentes entre sesiones. Project Server 2010 aún permite una opción de persistencia por página. El valor predeterminado debe ser conservar la configuración dentro de la configuración de usuario a menos que tenga un caso de negocios fuerte para que las preferencias solo sean persistentes en la sesión.
Cuadrícula de impresión
Al imprimir, el controlador carga los datos de la cuadrícula como de solo lectura. Esto puede ser una operación de larga ejecución en un conjunto de datos paginado, por lo que es mejor abrir una nueva ventana de explorador. De este modo, la impresión se deja en el explorador. Si la página no cumple las expectativas del usuario, este puede cerrar la ventana de impresión, agregar o quitar columnas, aplicar el zoom y hacer clic en Imprimir de nuevo.
Asociación a eventos
En este ejemplo se muestra cómo adjuntar código personalizado al evento OnCellEditComplete.
<script type="text/javascript">
Type.registerNamespace("GridManager");
GridManager = function () {
this.Init = function (jsGridControl, initialData, props) {
control = jsGridControl;
var dataSource = new SP.JsGrid.StaticDataSource(initialData);
var jsGridParams = dataSource.InitJsGridParams();
// This event is triggered after the standard grid error checking.
jsGridControl.AttachEvent(SP.JsGrid.EventType.OnCellEditCompleted, GotHere);
jsGridControl.Init(jsGridParams);
}
};
function GotHere(obj) {
alert('Got Here, ' + obj.fieldKey);
}
</script>
Versiones de depuración de JsGrid.js y JsGrid.Gantt.js
Las versiones de depuración de JsGrid.js y JsGrid.Gantt.js se instalan con el producto, normalmente en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS. Estos archivos proporcionan información valiosa acerca de JS Grid.
Vea también
Tareas
Procedimiento para crear un control de JS Grid básico