From 1c8a7bfefb1448abdb4616074b895458e0d98c8a Mon Sep 17 00:00:00 2001
From: Edouard Labre <edouard.labre@gmail.com>
Date: Tue, 28 Apr 2015 12:29:20 +0200
Subject: [PATCH] Add row().show().js plugin

---
 api/row().show().js | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 api/row().show().js

diff --git a/api/row().show().js b/api/row().show().js
new file mode 100644
index 0000000..3af551e
--- /dev/null
+++ b/api/row().show().js
@@ -0,0 +1,40 @@
+/**
+ *  This plugin permits to show the right page of DataTable to show the selected row
+ *
+ *  @version 1.0
+ *  @name row().show()
+ *  @summary See the row in datable by display the right pagination page
+ *  @author [Edouard Labre](http://www.edouardlabre.com)
+ *
+ *  @param {void} a row must be selected
+ *  @returns {DataTables.Api.Rows} DataTables Rows API instance
+ *
+ *  @example
+ *    // Add an element to a huge table and go to the right pagination page
+ *    var table = $('#example').DataTable();
+ *    var new_row = {
+ *      DT_RowId: 'row_example',
+ *      name: 'example',
+ *      value: 'an example row'
+ *    };
+ *    
+ *    table.row.add( new_row ).draw().show().draw(false);
+ */
+$.fn.dataTable.Api.register('row().show()', function() {
+    var page_info = this.table().page.info();
+    // Get row index
+    var new_row_index = this.index();
+    // Row position
+    var row_position = this.table().rows()[0].indexOf( new_row_index );
+    // Already on right page ?
+    if( row_position >= page_info.start && row_position < page_info.end ) {
+        // Return row object
+        return this;
+    }
+    // Find page number
+    var page_to_display = Math.floor( row_position / this.table().page.len() );
+    // Go to that page
+    this.table().page( page_to_display );
+    // Return row object
+    return this;
+});