| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427 |
- /*
- jQuery News Ticker is free software: you can redistribute it and/or modify
- it under the terms of the GNU General Public License as published by
- the Free Software Foundation, version 2 of the License.
-
- jQuery News Ticker is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- GNU General Public License for more details.
- You should have received a copy of the GNU General Public License
- along with jQuery News Ticker. If not, see <http://www.gnu.org/licenses/>.
- */
- (function($){
- $.fn.ticker = function(options) {
- // Extend our default options with those provided.
- // Note that the first arg to extend is an empty object -
- // this is to keep from overriding our "defaults" object.
- var opts = $.extend({}, $.fn.ticker.defaults, options);
- // check that the passed element is actually in the DOM
- if ($(this).length == 0) {
- if (window.console && window.console.log) {
- window.console.log('Element does not exist in DOM!');
- }
- else {
- alert('Element does not exist in DOM!');
- }
- return false;
- }
-
- /* Get the id of the UL to get our news content from */
- var newsID = '#' + $(this).attr('id');
- /* Get the tag type - we will check this later to makde sure it is a UL tag */
- var tagType = $(this).get(0).tagName;
- return this.each(function() {
- // get a unique id for this ticker
- var uniqID = getUniqID();
-
- /* Internal vars */
- var settings = {
- position: 0,
- time: 0,
- distance: 0,
- newsArr: {},
- play: true,
- paused: false,
- contentLoaded: false,
- dom: {
- contentID: '#ticker-content-' + uniqID,
- titleID: '#ticker-title-' + uniqID,
- titleElem: '#ticker-title-' + uniqID + ' SPAN',
- tickerID : '#ticker-' + uniqID,
- wrapperID: '#ticker-wrapper-' + uniqID,
- revealID: '#ticker-swipe-' + uniqID,
- revealElem: '#ticker-swipe-' + uniqID + ' SPAN',
- controlsID: '#ticker-controls-' + uniqID,
- prevID: '#prev-' + uniqID,
- nextID: '#next-' + uniqID,
- playPauseID: '#play-pause-' + uniqID
- }
- };
- // if we are not using a UL, display an error message and stop any further execution
- if (tagType != 'UL' && tagType != 'OL' && opts.htmlFeed === true) {
- debugError('Cannot use <' + tagType.toLowerCase() + '> type of element for this plugin - must of type <ul> or <ol>');
- return false;
- }
- // set the ticker direction
- opts.direction == 'rtl' ? opts.direction = 'right' : opts.direction = 'left';
-
- // lets go...
- initialisePage();
- /* Function to get the size of an Object*/
- function countSize(obj) {
- var size = 0, key;
- for (key in obj) {
- if (obj.hasOwnProperty(key)) size++;
- }
- return size;
- };
- function getUniqID() {
- var newDate = new Date;
- return newDate.getTime();
- }
-
- /* Function for handling debug and error messages */
- function debugError(obj) {
- if (opts.debugMode) {
- if (window.console && window.console.log) {
- window.console.log(obj);
- }
- else {
- alert(obj);
- }
- }
- }
- /* Function to setup the page */
- function initialisePage() {
- // process the content for this ticker
- processContent();
-
- // add our HTML structure for the ticker to the DOM
- $(newsID).wrap('<div id="' + settings.dom.wrapperID.replace('#', '') + '"></div>');
-
- // remove any current content inside this ticker
- $(settings.dom.wrapperID).children().remove();
-
- $(settings.dom.wrapperID).append('<div id="' + settings.dom.tickerID.replace('#', '') + '" class="ticker"><div id="' + settings.dom.titleID.replace('#', '') + '" class="ticker-title"><span><!-- --></span></div><p id="' + settings.dom.contentID.replace('#', '') + '" class="ticker-content"></p><div id="' + settings.dom.revealID.replace('#', '') + '" class="ticker-swipe"><span><!-- --></span></div></div>');
- $(settings.dom.wrapperID).removeClass('no-js').addClass('ticker-wrapper has-js ' + opts.direction);
- // hide the ticker
- $(settings.dom.tickerElem + ',' + settings.dom.contentID).hide();
- // add the controls to the DOM if required
- if (opts.controls) {
- // add related events - set functions to run on given event
- $(settings.dom.controlsID).live('click mouseover mousedown mouseout mouseup', function (e) {
- var button = e.target.id;
- if (e.type == 'click') {
- switch (button) {
- case settings.dom.prevID.replace('#', ''):
- // show previous item
- settings.paused = true;
- $(settings.dom.playPauseID).addClass('paused');
- manualChangeContent('prev');
- break;
- case settings.dom.nextID.replace('#', ''):
- // show next item
- settings.paused = true;
- $(settings.dom.playPauseID).addClass('paused');
- manualChangeContent('next');
- break;
- case settings.dom.playPauseID.replace('#', ''):
- // play or pause the ticker
- if (settings.play == true) {
- settings.paused = true;
- $(settings.dom.playPauseID).addClass('paused');
- pauseTicker();
- }
- else {
- settings.paused = false;
- $(settings.dom.playPauseID).removeClass('paused');
- restartTicker();
- }
- break;
- }
- }
- else if (e.type == 'mouseover' && $('#' + button).hasClass('controls')) {
- $('#' + button).addClass('over');
- }
- else if (e.type == 'mousedown' && $('#' + button).hasClass('controls')) {
- $('#' + button).addClass('down');
- }
- else if (e.type == 'mouseup' && $('#' + button).hasClass('controls')) {
- $('#' + button).removeClass('down');
- }
- else if (e.type == 'mouseout' && $('#' + button).hasClass('controls')) {
- $('#' + button).removeClass('over');
- }
- });
- // add controls HTML to DOM
- $(settings.dom.wrapperID).append('<ul id="' + settings.dom.controlsID.replace('#', '') + '" class="ticker-controls"><li id="' + settings.dom.playPauseID.replace('#', '') + '" class="jnt-play-pause controls"><a href=""><!-- --></a></li><li id="' + settings.dom.prevID.replace('#', '') + '" class="jnt-prev controls"><a href=""><!-- --></a></li><li id="' + settings.dom.nextID.replace('#', '') + '" class="jnt-next controls"><a href=""><!-- --></a></li></ul>');
- }
- if (opts.displayType != 'fade') {
- // add mouse over on the content
- $(settings.dom.contentID).mouseover(function () {
- if (settings.paused == false) {
- pauseTicker();
- }
- }).mouseout(function () {
- if (settings.paused == false) {
- restartTicker();
- }
- });
- }
- // we may have to wait for the ajax call to finish here
- if (!opts.ajaxFeed) {
- setupContentAndTriggerDisplay();
- }
- }
- /* Start to process the content for this ticker */
- function processContent() {
- // check to see if we need to load content
- if (settings.contentLoaded == false) {
- // construct content
- if (opts.ajaxFeed) {
- if (opts.feedType == 'xml') {
- $.ajax({
- url: opts.feedUrl,
- cache: false,
- dataType: opts.feedType,
- async: true,
- success: function(data){
- count = 0;
- // get the 'root' node
- for (var a = 0; a < data.childNodes.length; a++) {
- if (data.childNodes[a].nodeName == 'rss') {
- xmlContent = data.childNodes[a];
- }
- }
- // find the channel node
- for (var i = 0; i < xmlContent.childNodes.length; i++) {
- if (xmlContent.childNodes[i].nodeName == 'channel') {
- xmlChannel = xmlContent.childNodes[i];
- }
- }
- // for each item create a link and add the article title as the link text
- for (var x = 0; x < xmlChannel.childNodes.length; x++) {
- if (xmlChannel.childNodes[x].nodeName == 'item') {
- xmlItems = xmlChannel.childNodes[x];
- var title, link = false;
- for (var y = 0; y < xmlItems.childNodes.length; y++) {
- if (xmlItems.childNodes[y].nodeName == 'title') {
- title = xmlItems.childNodes[y].lastChild.nodeValue;
- }
- else if (xmlItems.childNodes[y].nodeName == 'link') {
- link = xmlItems.childNodes[y].lastChild.nodeValue;
- }
- if ((title !== false && title != '') && link !== false) {
- settings.newsArr['item-' + count] = { type: opts.titleText, content: '<a href="' + link + '">' + title + '</a>' }; count++; title = false; link = false;
- }
- }
- }
- }
- // quick check here to see if we actually have any content - log error if not
- if (countSize(settings.newsArr < 1)) {
- debugError('Couldn\'t find any content from the XML feed for the ticker to use!');
- return false;
- }
- settings.contentLoaded = true;
- setupContentAndTriggerDisplay();
- }
- });
- }
- else {
- debugError('Code Me!');
- }
- }
- else if (opts.htmlFeed) {
- if($(newsID + ' LI').length > 0) {
- $(newsID + ' LI').each(function (i) {
- // maybe this could be one whole object and not an array of objects?
- settings.newsArr['item-' + i] = { type: opts.titleText, content: $(this).html()};
- });
- }
- else {
- debugError('Couldn\'t find HTML any content for the ticker to use!');
- return false;
- }
- }
- else {
- debugError('The ticker is set to not use any types of content! Check the settings for the ticker.');
- return false;
- }
- }
- }
- function setupContentAndTriggerDisplay() {
- settings.contentLoaded = true;
- // update the ticker content with the correct item
- // insert news content into DOM
- $(settings.dom.titleElem).html(settings.newsArr['item-' + settings.position].type);
- $(settings.dom.contentID).html(settings.newsArr['item-' + settings.position].content);
- // set the next content item to be used - loop round if we are at the end of the content
- if (settings.position == (countSize(settings.newsArr) -1)) {
- settings.position = 0;
- }
- else {
- settings.position++;
- }
- // get the values of content and set the time of the reveal (so all reveals have the same speed regardless of content size)
- distance = $(settings.dom.contentID).width();
- time = distance / opts.speed;
- // start the ticker animation
- revealContent();
- }
- // slide back cover or fade in content
- function revealContent() {
- $(settings.dom.contentID).css('opacity', '1');
- if(settings.play) {
- // get the width of the title element to offset the content and reveal
- var offset = $(settings.dom.titleID).width() + 20;
-
- $(settings.dom.revealID).css(opts.direction, offset + 'px');
- // show the reveal element and start the animation
- if (opts.displayType == 'fade') {
- // fade in effect ticker
- $(settings.dom.revealID).hide(0, function () {
- $(settings.dom.contentID).css(opts.direction, offset + 'px').fadeIn(opts.fadeInSpeed, postReveal);
- });
- }
- else if (opts.displayType == 'scroll') {
- // to code
- }
- else {
- // default bbc scroll effect
- $(settings.dom.revealElem).show(0, function () {
- $(settings.dom.contentID).css(opts.direction, offset + 'px').show();
- // set our animation direction
- animationAction = opts.direction == 'right' ? { marginRight: distance + 'px'} : { marginLeft: distance + 'px' };
- $(settings.dom.revealID).css('margin-' + opts.direction, '0px').delay(20).animate(animationAction, time, 'linear', postReveal);
- });
- }
- }
- else {
- return false;
- }
- };
- // here we hide the current content and reset the ticker elements to a default state ready for the next ticker item
- function postReveal() {
- if(settings.play) {
- // we have to separately fade the content out here to get around an IE bug - needs further investigation
- $(settings.dom.contentID).delay(opts.pauseOnItems).fadeOut(opts.fadeOutSpeed);
- // deal with the rest of the content, prepare the DOM and trigger the next ticker
- if (opts.displayType == 'fade') {
- $(settings.dom.contentID).fadeOut(opts.fadeOutSpeed, function () {
- $(settings.dom.wrapperID)
- .find(settings.dom.revealElem + ',' + settings.dom.contentID)
- .hide()
- .end().find(settings.dom.tickerID + ',' + settings.dom.revealID)
- .show()
- .end().find(settings.dom.tickerID + ',' + settings.dom.revealID)
- .removeAttr('style');
- setupContentAndTriggerDisplay();
- });
- }
- else {
- $(settings.dom.revealID).hide(0, function () {
- $(settings.dom.contentID).fadeOut(opts.fadeOutSpeed, function () {
- $(settings.dom.wrapperID)
- .find(settings.dom.revealElem + ',' + settings.dom.contentID)
- .hide()
- .end().find(settings.dom.tickerID + ',' + settings.dom.revealID)
- .show()
- .end().find(settings.dom.tickerID + ',' + settings.dom.revealID)
- .removeAttr('style');
- setupContentAndTriggerDisplay();
- });
- });
- }
- }
- else {
- $(settings.dom.revealElem).hide();
- }
- }
- // pause ticker
- function pauseTicker() {
- settings.play = false;
- // stop animation and show content - must pass "true, true" to the stop function, or we can get some funky behaviour
- $(settings.dom.tickerID + ',' + settings.dom.revealID + ',' + settings.dom.titleID + ',' + settings.dom.titleElem + ',' + settings.dom.revealElem + ',' + settings.dom.contentID).stop(true, true);
- $(settings.dom.revealID + ',' + settings.dom.revealElem).hide();
- $(settings.dom.wrapperID)
- .find(settings.dom.titleID + ',' + settings.dom.titleElem).show()
- .end().find(settings.dom.contentID).show();
- }
- // play ticker
- function restartTicker() {
- settings.play = true;
- settings.paused = false;
- // start the ticker again
- postReveal();
- }
- // change the content on user input
- function manualChangeContent(direction) {
- pauseTicker();
- switch (direction) {
- case 'prev':
- if (settings.position == 0) {
- settings.position = countSize(settings.newsArr) -2;
- }
- else if (settings.position == 1) {
- settings.position = countSize(settings.newsArr) -1;
- }
- else {
- settings.position = settings.position - 2;
- }
- $(settings.dom.titleElem).html(settings.newsArr['item-' + settings.position].type);
- $(settings.dom.contentID).html(settings.newsArr['item-' + settings.position].content);
- break;
- case 'next':
- $(settings.dom.titleElem).html(settings.newsArr['item-' + settings.position].type);
- $(settings.dom.contentID).html(settings.newsArr['item-' + settings.position].content);
- break;
- }
- // set the next content item to be used - loop round if we are at the end of the content
- if (settings.position == (countSize(settings.newsArr) -1)) {
- settings.position = 0;
- }
- else {
- settings.position++;
- }
- }
- });
- };
- // plugin defaults - added as a property on our plugin function
- $.fn.ticker.defaults = {
- speed: 0.10,
- ajaxFeed: false,
- feedUrl: '',
- feedType: 'xml',
- displayType: 'reveal',
- htmlFeed: true,
- debugMode: true,
- controls: true,
- titleText: 'Latest',
- direction: 'ltr',
- pauseOnItems: 3000,
- fadeInSpeed: 600,
- fadeOutSpeed: 300
- };
- })(jQuery);
|