TableCellsSelection - jQuery plugin for intuitive table's cells selection (like Excel or Google Docs)

This jQuery plugin for emulate rectangular highlighting cells on selection .

Make highlighting cells as it happens in GoogleDocs or Excel e.q. Can be useful in WYSIWYG editors.

Usage

Add stylesheet on your html page

	<link rel="stylesheet" href="tablecellsselection.css">

Include tablecellsselection.js before closing tag body

	<script src="tablecellsselection.js"></script>

Apply this plugin to any tables

	jQuery(document).ready(function($) {
		$('.tables-with-selection').tableCellsSelection();
	});

TableCellsSelection API

init - apply plugin to jQuery object. Add plugin's classes and attach event handlers to selected tables.
destroy - delete cells selection functionality from selected tables. Delete plugin's classes and detach events listenters.
selectedCells - return selected cells as jQuery-object.
removeDocumentHtmlChanges - revert all HTML DOM changes, made by plugin. May be helpfull for call by wisiwig-editor's on save() method for clear markup.

TODO:

addDocumentHtmlChanges - apply HTML DOM changes, required by plugin to work.

Example of usage API

//Apply plugin to selected tables.
$('.tables-with.selection').tableCellsSelection();//equal to  `$('.tables-with.selection').tableCellsSelection('init');`
var testTable = $('#test');

//select some cells in table#test

//Get selected cells in #test table.
var $selectedCells = $('#test').tableCellsSelection('selectedCells');

//Before get table html-content clear markup from plugin changes.
testTable.tableCellsSelection('removeDocumentHtmlChanges');

//Get table html-content
$testTableContent = testTable.html();

//Restore HTML changes required by plugin to work.

//Make table cells not intuitive selectable
testTable.tableCellsSelection('destroy');

Appreciation

This is a almost completely rewritten version of cells-selector plugin

#TODO

Integrate with browseer's selection API (if possible).
Implement valid table cells/columns/rows selection/deselection.
Implement valid addDocumentHtmlChanges - apply HTML DOM changes, required by plugin to work.

Licence

The MIT License (MIT).

roojay520 / tablecellsselection