Muestra las diferencias entre dos versiones de la página.
Ambos lados, revisión anterior Revisión previa Próxima revisión | Revisión previa | ||
contrib:wdatatable [25/08/2023 13:48] pedro |
contrib:wdatatable [08/11/2023 15:38] (actual) pedro [wDataTable] |
||
---|---|---|---|
Línea 1: | Línea 1: | ||
====== wDataTable ====== | ====== wDataTable ====== | ||
- | Esta clase Nefeliza el control [[https://datatables.net/|DataTables.net]], permitiendo incluir en nuestras web Browses para la representación y/o edición de datos de una manera sencilla y muy vistosa. | + | Esta clase Néfeliza el control [[https://datatables.net/|DataTables.net]], permitiendo incluir en nuestras web Browses para la representación y/o edición de datos de una manera sencilla y muy vistosa. |
- | En la Nefelización del control hemos incluido dos funciones JavaScript que pueden sernos útiles desde nuestras APP; | + | Tenemos Néfelizada la versión 1.10.22 |
+ | Ha sido realizada como una [[contrib:wdatatable#Agradecimientos|contribución]] a Néfele. | ||
- | dt_ | ||
- | |||
- | Ha sido realizada como una [[contrib:wdatatable#Agradecimientos|contribución]] a Néfele. | ||
===== Ejemplo de uso ===== | ===== Ejemplo de uso ===== | ||
Línea 51: | Línea 49: | ||
|[[propiedades:cId]] | Nil | Identificador único para cada Control | 0.3| | |[[propiedades:cId]] | Nil | Identificador único para cada Control | 0.3| | ||
|cTitle | | Texto que aparecerá en la cabecera del control | 0.3| | |cTitle | | Texto que aparecerá en la cabecera del control | 0.3| | ||
- | |[[https://datatables.net/examples/styling/|CssClass]] | "compact" | [[https://datatables.net/examples/styling/|Estilo de la Tabla]] | 0.3| | + | |CssClass | "compact" | [[https://datatables.net/examples/styling/|Estilo de la Tabla]] | 0.3| |
|lResetLocalStorage | .T. | Limpia el Local Storage del datatable antes de crearlo | 0.3| | |lResetLocalStorage | .T. | Limpia el Local Storage del datatable antes de crearlo | 0.3| | ||
|lButtonCopy | .F. | Habilita el botón de de copiar al portapapeles | 0.3| | |lButtonCopy | .F. | Habilita el botón de de copiar al portapapeles | 0.3| | ||
|lButtonCSV | .F. | Habilita el botón de exportar a CSV | 0.3| | |lButtonCSV | .F. | Habilita el botón de exportar a CSV | 0.3| | ||
|lButtonExcel | .F. | Habilita el botón de exportar a EXCEL | 0.3| | |lButtonExcel | .F. | Habilita el botón de exportar a EXCEL | 0.3| | ||
- | |lButtonPDF | .F. | Habilita el botón de exportar a PDF | 0.3| | + | |lButtonPDF | .F. | Habilita el botón de exportar a PDF | 0.3| |
|lButtonPrint | .F. | Habilita el botón de Imprimir | 0.3| | |lButtonPrint | .F. | Habilita el botón de Imprimir | 0.3| | ||
|lSelectable | .F. | Habilita la selección de filas | 0.3| | |lSelectable | .F. | Habilita la selección de filas | 0.3| | ||
- | |cSelectStyle | "os" | Define el tipo de selección (os, single, multi y multi+shift ) | 0.3| | + | |cSelectStyle | "os" | Define el tipo de [[https://datatables.net/reference/event/selectStyle|selección]] (os, single, multi y multi+shift ) | 0.3| |
|lRowReOrder | .F. | Habilita la reordenación de las filas | 0.3| | |lRowReOrder | .F. | Habilita la reordenación de las filas | 0.3| | ||
|lScrollToTop | .T. | Cuando se crea la tabla se posiciona en la primera fila | 0.3| | |lScrollToTop | .T. | Cuando se crea la tabla se posiciona en la primera fila | 0.3| | ||
Línea 69: | Línea 67: | ||
^Nombre ^Descripción ^Versión ^ | ^Nombre ^Descripción ^Versión ^ | ||
- | |[[metodos:datatable:Configure]] | Este método nos devuelve el objeto JavaScript DataTables que corresponde con la tabla a crear, las propiedades de este objeto están documentadas en la ayuda de [[https://datatables.net/manual/server-side|DataTables.net]] | 0.3| | + | |[[metodos:datatable:Configure]] | Este método nos devuelve el objeto options del DataTables, las propiedades de este objeto están documentadas en la ayuda de [[https://datatables.net/manual/options|DataTables.net]] | 0.3| |
- | |[[metodos:datatable:AddButton]] | Añadir botones estándar configurador por efecto | 0.3| | + | |[[metodos:datatable:AddButton]] | Añadir botones estándar configurador por defecto | 0.3| |
|[[metodos:datatable:AddButtonEx]] | Añadir botones personalizados | 0.3| | |[[metodos:datatable:AddButtonEx]] | Añadir botones personalizados | 0.3| | ||
|[[metodos:Install]] | Añade a la página todo el código JS y CSS necesario para que funcione el DataTable | 0.4| | |[[metodos:Install]] | Añade a la página todo el código JS y CSS necesario para que funcione el DataTable | 0.4| | ||
+ | |||
+ | ===== Funciones JavaScript ===== | ||
+ | |||
+ | **En la Nefelización del control hemos incluido dos funciones JavaScript que pueden sernos útiles en nuestras APP;** | ||
+ | |||
+ | dt_getSelected( dt, e ) -> Nos retorna las filas que están seleccionadas. | ||
+ | |||
+ | ^Parametro ^Descripción ^ | ||
+ | | dt | cId del wDataTable | | ||
+ | | e | Elemento del data que queremos recuperar; si se alimento data es un JSon se indicaremos la clave y si es una array en indice (tenga en cuenta que los array empiezan en 0), si no indicamos nada nos retorna la fila completa. | | ||
+ | |||
+ | dt_getValues( dt, r ) -> Nos retorna el valor de las columnas Input y Select. | ||
+ | |||
+ | ^Parametro ^Descripción ^ | ||
+ | | dt | cId del wDataTable | | ||
+ | | r | Índice de la fila a recuperar, si no indicamos nos recupera todas. | | ||
+ | |||
+ | | ||
+ | Podemos utilizar cualquiera de ellas en los aParam de los controles que hacen llamadas a nuestro CGI. | ||
+ | |||
+ | <Code:xailer linenums:1> | ||
+ | :AddParam({"seleccion","js:dt_getSelected('mibrowse')"}) | ||
+ | :AddParam({"editables","js:dt_getValues('mibrowse')"}) | ||
+ | </Code> | ||
===== Agradecimientos ===== | ===== Agradecimientos ===== | ||
A Joaquim Ferrer Godoy <quim_ferrer@yahoo.es> por contribuir con este fantástico control a Néfele. | A Joaquim Ferrer Godoy <quim_ferrer@yahoo.es> por contribuir con este fantástico control a Néfele. |