• Stars
    star
    148
  • Rank 244,746 (Top 5 %)
  • Language
    JavaScript
  • Created almost 11 years ago
  • Updated over 6 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Make sentences and snippets easily tweetable for your users.

jquery.tweetable.js

A simple li'l plugin that lets you make site content easily tweetable.

Inspired (and by inspired I mean I stole this) from a recent New York Times article doing the exact same thing.

You can see a demo of the plugin in action here.

Usage

Dependencies

I mean, jquery is in the name and everything ...

The Basics

Using the plugin is super duper easy:

$('[data-tweetable]').tweetable();

That will grab all elements with the data-tweetable attribute and create clickable links out of them. If the attribute in question has a value (e.g. data-tweetable='I love lamp'), the tweet's text will be set to that value; otherwise, it is set to whatever text is within the given element.

(If you're using a selector which is not an attribute, then be sure to set dataAttr so it knows where to pick up the text.)

The links are unstyled by default, but those links also are created with a given class (by default tweetable) so you can style them to your heart's content.

Options

Options are pretty simple, and you can pass them as so:

$('.awesome-text').tweetable({
	via: 'justinmduke'
});

The defaults:

// Defaults
{
	dataAttr: 'data-tweetable',
	linkClass: 'tweetable',
	via: null,
	related: null,
	url: window.location.pathname
}

The first two should be fairly obvious: via, related, and url all correspond to what you're passing to Twitter in terms of data.