colResizable is a jQuery plugin designed to enhance HTML tables adding column resizing features by dragging column anchors manually. It is tiny in size (colResizable v1.0 is only 2.8kb) and it doesn´t require any other library dependencies such as jQuery-UI or others. It is fully compatible with all major browsers (IE7+, Firefox, Chrome and Opera), and works perfectly with both percentage and pixel-based table layouts. colResizable can also be used as multiple range slider.
colResizable was developed since no other similar plugin with the below listed features was found:
- Small footprint
- No other library dependencies
- Column resizing not altering total table width
- Compatibility with both percentage and pixel-based table layouts
- No external resources needed (such as images or stylesheets)
- Customization of column anchors
- Layout restoration after postback
- Cross-browser compatibility
- Events
To use this plugin a script reference must be added to the colResizable.min.js file in the head section of the document once jQuery is loaded. To enhance a table (or collection of tables) point it with a jQuery wrapper and apply the colResizable() method.
$(function(){
$("table").colResizable();
});
- liveDrag: [type: boolean] [default: false] [version: 1.0]
When set to true the table layout is updated while dragging column anchors. liveDrag enabled is more CPU consuming so it is not recommended for slow computers, specially when dealing with huge or extremely complicated tables.
- innerGripHtml: [type: string] [default: empty string] [version: 1.0]
Its purpose is to allow column anchor customization by defining the HTML to be used in the column grips to provide some visual feedback. It can be used in a wide range of ways to obtain very different outputs, and its flexibility can be increased by combining it with the draggingClass attribute.
- draggingClass: [type: string] [default: internal css class] [version: 1.0]
This attribute is used as the css class assigned to column anchors while being dragged. It can be used for visual feedback purposes.
- disable: [type: boolean] [default: false] [version: 1.0]
When set to true it aims to remove all previously added enhancements such as events and additional DOM elements assigned by this plugin to a single or collection of tables. It is required to disable a previously colResized table prior its removal from the document object tree.
- minWidth: [type: number] [default: 15] [version: 1.1]
This value specifies the minimum width (measured in pixels) that is allowed for the columns.
- headerOnly: [type: boolean] [default: false] [version: 1.2]
This attribute can be used to prevent vertical expansion of the column anchors to fit the table height. If it is set to true, column handler's size will be bounded to the first row's vertical size.
- hoverCursor: [type: string] [default: "e-resize"] [version: 1.3]
This attribute can be used to customize the cursor that will be displayed when the user is positioned on the column anchors.
- dragCursor: [type: string] [default: "e-resize"] [version: 1.3]
Defines the cursor that will be used while the user is resizing a column.
- postbackSafe: [type: boolean] [default: false] [version: 1.3]
This attribute can be used to specify that the manually selected column widths must remain unaltered after a postback or browser refresh. This feature is mainly oriented to those pages created with server-side logic (codebehind), such as PHP or .NET, and it is only compatible with browsers with sessionStorage support (all modern browsers). However, if you are targeting older browsers (such as IE7 and IE8) you can still emulate sessionStorage using sessionStorage.js. It is important to note that some browsers (IE and FF) doesn’t enable the sessionStorage object while running the website directly from the local file system, so if you want to test this feature it is recommended to view the website through a web server or use browsers such as Chrome or Opera which doesn’t have this limitation. Don't worry about compatibility issues, once your site is up on the internet, all browsers will act in exactly the same way.
- flush: [type: boolean] [default: false] [version: 1.3]
Flush is only effective when postbackSafe is enabled. Its purpose is to remove all previously stored data related to the current table layout to get it back to its original layout preventing width restoration after postback.
- marginLeft: [type: string / null] [default: null] [version: 1.3]
If the target table contains an explicit margin-left CSS rule, the same value must be used in this attribute (for example: "auto", "20%", "10px"). The reason why it is needed it is because most browsers (all except of IE) don’t allow direct access to the current CSS rule applied to an element in its original units (such as "%", "em" or "auto" values). If you know any workaround which doesn’t involve iteration through all the styles defined in the site and any other external dependencies, please let me know!
- marginRight: [type: string / null] [default: null] [version: 1.3]
It behaves in exactly the same way than the previous attribute but applied to the right margin.
- onResize: [type: callback function] [default: null] [version: 1.0]
If a callback function is supplied it will be fired when the user has ended dragging a column anchor altering the previous table layout. The callback function can obtain a reference to the updated table through the currentTarget attribute of the event retrieved by parameters
- onDrag: [type: callback function] [default: null] [version: 1.1]
This event is fired while dragging a column anchor if liveDrag is enabled. It can be useful if the table is being used as a multiple range slider. The callback function can obtain a reference to the updated table through the currentTarget attribute of the event retrieved by parameters