smtlk-dotdotdot

jQuery.dotdotdot
================

A jQuery plugin for advanced cross-browser ellipsis on multiple line content.

Demo's and documentation: http://dotdotdot.frebsite.nl

Note:

Because its performance can not be improved, this plugin is no longer actively maintained.

Feel free to use it and submit pull requests though.

How to use the plugin

$3

Include all necessary .js-files inside the head-tag of the page.

``html




`

Then you can use either CSS or JS approach or use them both.

$3

You can add one or several CSS classes to HTML elements to automatically invoke "jQuery.dotdotdot functionality" and some extra features. It allows to use jQuery.dotdotdot only by adding appropriate CSS classes without JS programming.

Available classes and their description:
* dot-ellipsis - automatically invoke jQuery.dotdotdot to this element. This class must be included if you plan to use other classes below.
* dot-resize-update - automatically update if window resize event occurs. It's equivalent to option watch:'window'.
* dot-timer-update - automatically update at regular intervals using setInterval. It's equivalent to option watch:true.
* dot-load-update - automatically update after the window has beem completely rendered. Can be useful if your content is generated dynamically using JS and, hence, jQuery.dotdotdot can't correctly detect the height of the element before it's rendered completely.
* dot-height-XXX - available height of content area in pixels, where XXX is a number, e.g. can be dot-height-35 if you want to set maximum height for 35 pixels. It's equivalent to option height:'XXX'.

Examples

Adding jQuery.dotdotdot to element:

`html



`

Adding jQuery.dotdotdot to element with update on window resize:

`html

Lorem Ipsum is simply dummy text.

`

Adding jQuery.dotdotdot to element with predefined height of 50px:

`html

Lorem Ipsum is simply dummy text.

`

Javascript approach

Create a DOM element and put some text and other HTML markup in this "wrapper".

`html



`

Fire the plugin onDocumentReady using the wrapper-selector.

`javascript
$(document).ready(function() {
$("#wrapper").dotdotdot({
// configuration goes here
});
});
``

$3

* Fred Heusschen is the author of the jQuery.dotdotdot
* Ramil Valitov added the "CSS approach" functionality

$3

Please visit http://dotdotdot.frebsite.nl

$3

The jQuery.dotdotdot plugin is licensed under the MIT license:
http://en.wikipedia.org/wiki/MIT_License