DataTables, un plugin de jQuery para manejar tablas

1 de septiembre de 20104 min de lectura
DataTables es un plugin para jQuery que nos permite darle dinamismo a nuestras tablas de una forma sencilla y aumentando la vistosidad de nuestras tablas. Con solo un par de líneas, cambiaremos completamente la apariencia de nuestra tabla.

Con este plugin conseguiremos las siguientes acciones con nuestras tablas:

  • Ordenar por campos.
  • Paginar resultados
  • Filtrar
  • Sistema de búsqueda
  • Obtención de datos de forma dinámica.

Veamos un ejemplo sencillo de como utilizar este plugin.


Lo primero que hacemos es descargarnos la librería jQuery y el plugin DataTables que añadiremos a nuestro proyecto.
 
<script type="text/javascript" language="javascript" src="jquery.js"></script> 
<script type="text/javascript" language="javascript" src="jquery.dataTables.js"></script> 

A continuación, lo que hacemos es crear nuestra tabla en html donde queremos aplicar el plugin. Los datos de la tabla pueden ser fijos, o bien creados de forma dinámica.

	<table cellpadding="0" cellspacing="0" border="0" class="display" id="example">
		<thead> 
			<tr> 
				<th>Rendering engine</th> 
				<th>Browser</th> 
				<th>Platform(s)</th> 
				<th>Engine version</th> 
				<th>CSS grade</th> 
			</tr> 
		</thead> 
		
		<tbody> 
			<tr class="gradeX"> 
				<td>Trident</td> 
				<td>Internet
					 Explorer 4.0</td> 
				<td>Win 95+</td> 
				<td class="center">4</td> 
				<td class="center">X</td> 
			</tr> 
			<tr class="gradeC"> 
				<td>Trident</td> 
				<td>Internet
					 Explorer 5.0</td> 
				<td>Win 95+</td> 
				<td class="center">5</td> 
				<td class="center">C</td> 
			</tr> 
			<tr class="gradeA"> 
				<td>Trident</td> 
				<td>Internet
					 Explorer 5.5</td> 
				<td>Win 95+</td> 
				<td class="center">5.5</td> 
				<td class="center">A</td> 
			</tr> 
			<tr class="gradeA"> 
				<td>Trident</td> 
				<td>Internet
					 Explorer 6</td> 
				<td>Win 98+</td> 
				<td class="center">6</td> 
				<td class="center">A</td> 
			</tr> 
			
			............................
			
			<tr class="gradeA"> 
				<td>Gecko</td> 
				<td>Mozilla 1.5</td> 
				<td>Win 95+ / OSX.1+</td> 
				<td class="center">1.5</td> 
				<td class="center">A</td> 
			</tr>
		</tbody>
	</table>
Por último lo que falta hacer es la llamada al plugin para que aparezca las funciones indicadas anteriormente.

<script type="text/javascript" charset="utf-8"> 
	$(document).ready(function() {
		$('#example').dataTable();
	} );
</script> 

La apariencia de la tabla no es fija, sino que el plugin nos permite indicar que elementos queremos que aparezcan. Por ejemplo, si solo queremos que aparezca la caja de búsqueda, el código que debermos de poner sería el siguiente.

<script type="text/javascript" charset="utf-8"> 
	$(document).ready(function() {
		$('#example').dataTable( {
			"bPaginate": false,
			"bLengthChange": false,
			"bFilter": true,
			"bSort": false,
			"bInfo": false,
			"bAutoWidth": false } );
	} );
</script> 

El plugin también nos permite indicar al cargar la página, por que columna queremos que salga ordenado y si lo queremos ascendente (ASC) o descendente (DESC). Para conseguir esto, debemos de indicar el número de columna al que hacer referencia. Si por ejemplo queremos que aparezca ordenado por la última columna, el código que debemos de poner es el siguiente.

<script type="text/javascript" charset="utf-8"> 
	$(document).ready(function() {
		$('#example').dataTable( {
			"aaSorting": [[ 4, "desc" ]],
			"aoColumns": [
				null,
				null,
				null,
				null,
				null
			]
		} );
	} );
</script> 

Otra de las opciones que nos permite el plugin es indicar que columnas queremos que aparezcan ocultas. Para conseguir esto, deberíamos de utilizar el siguiente código.

<script type="text/javascript" charset="utf-8"> 
	$(document).ready(function() {
		$('#example').dataTable( {
			"aoColumns": [ 
				/* Engine */   null,
				/* Browser */  null,
				/* Platform */ { "bSearchable": false,
						 "bVisible":    false },
				/* Version */  { "bVisible":    false },
				/* Grade */    null
			] } );
		} );
</script> 

Estas son solo algunas de las funcionalidades que nos permite el plugin, pero hay más que podéis ver visitando el sitio oficial del plugin.

Sigue leyendo