Drupal 6 JavaScript and jQuery - Ebook-Cours.com

[ 217 ]
Chapter 7
The WebClips.showItem() function
The Drupal.behaviors.webclips() behavior we looked at earlier was complex,
performing several steps to set up the area where our web clips will be displayed. At
the very end, it calls WebClips.showItem() to display an item. The present function
is much simpler:
WebClips.showItem = function () {
var items = WebClips.items;
var theOne = Math.floor(Math.random() * items.length);
var item = items.eq(theOne);
var theLink = Drupal.theme(
"webclip",
item.find('title'),
item.find('link')
);
$('#webclips').html(theLink);
};
This function takes no parameters. The first thing it does is make a local copy of the
WebClips.items jQuery object. This is only done for the sake of readability.
Next, we get a random integer corresponding to a valid index in our items list. For
example, if our list has three items, we want an integer between 0 and 2. We get this
with Math.floor(Math.random() * items.length).
To limit the matched items from a jQuery object to just one specific index number,
we use the jQuery eq() method.
Now that we have an item, we are ready to theme it, and insert it into the web clips
area on the page. Here's the theming call:
var theLink = Drupal.theme(
"webclip",
item.find('title'),
item.find('link')
);
This uses the Drupal.theme.prototype.webclip() function, to which it passes: the
title of the RSS feed item, and the link from the RSS feed item. The link, you may
recall, points back to the original article that this feed item is describing:
Drupal.theme.prototype.webclip = function (title, href) {
return '→ ' + title.text().link(href.text());
};
This material is copyright and is licensed for the sole use by Richard Ostheimer on 18th June 2009
2205 hilda ave., , missoula, , 59801