Unsurprisingly you will need to include jQuery (1.4.2 or above) to make all this work, I recommend using Google's Ajax Libraries API for the very latest version.
Apologies to anyone using an earlier version, I may update the code be compatible with jQuery 1.3 if there is enough demand. A version of jQuery News Ticker that is jQuery 1.3.2 compatible can be downloaded here: jquery.ticker.js. Please note that this version does not have all of the features of jQuery News Ticker and is no longer being actively developed.
Don't I need some HTML to make this news ticker work?
Yes you do, all you need is the following HTML:
<ul id="js-news"class="js-hidden">
<li class="news-item"><a href="#">This is the 1st latest news item.</a></li>
<li class="news-item"><a href="#">This is the 2nd latest news item.</a></li>
<li class="news-item"><a href="#">This is the 3rd latest news item.</a></li>
<li class="news-item"><a href="#">This is the 4th latest news item.</a></li>
</ul>
jQuery News Ticker will also work fine with an <ol> element to contain the news items.
And how do I make jQuery do its magic on this thing?
To get jQuery News Ticker working, you'll need to also add this code to your page:
That's everything to get the news ticker working! If you get stuck have a look at the source of the example on this page to see what's what.
You'll probably want to dive into the CSS to change the visual style to your liking, but you're on your own with that one!
Ok, that's great and everything but I want to fiddle with the settings...
Ok, so here are the settings that can be changed, shown with their default values:
$(function () {
$('#js-news').ticker(
speed: 0.10, // The speed of the revealajaxFeed: false, // Populate jQuery News Ticker via a feedfeedUrl: false, // The URL of the feed
// MUST BE ON THE SAME DOMAIN AS THE TICKERfeedType: 'xml', // Currently only XMLhtmlFeed: true, // Populate jQuery News Ticker via HTMLdebugMode: true, // Show some helpful errors in the console or as alerts
// SHOULD BE SET TO FALSE FOR PRODUCTION SITES!controls: true, // Whether or not to show the jQuery News Ticker controlstitleText: 'Latest', // To remove the title set this to an empty StringdisplayType: 'reveal', // Animation type - current options are 'reveal' or 'fade'direction: 'ltr'// Ticker direction - current options are 'ltr' or 'rtl'pauseOnItems: 2000, // The pause on a news item before being replacedfadeInSpeed: 600, // Speed of fade in animationfadeOutSpeed: 300// Speed of fade out animation
);
});
Woah, that made no sense, how do I use these settings?
Any changes you want to make to the default settings are passed in to the call of the news ticker, like so: