/*
Provide sounds and onmouseover utility functions in MSIE.
Doesn't work, but gracefully degrades, elsewhere.
We are not concerned about Firefox support at this point because stock
Firefox installations will display an "Additional plugins are required
to display all the media on this page" warning, which is not desirable.
Notes:
- Do not execute addSound() methods from the . It relies on using
DOM methods to add elements to document.body, which isn't there yet
when executing JavaScript from the .
- It should be obvious that running addSound() before setting up sound
events is an excellent idea. :-)
example usage:
...
onmouseover:
are we having fun
how now brown cow
...
*/
var MSIE = (navigator.appVersion.indexOf("MSIE") != -1 && document.all);
var debugMessageElement;
var bgSoundElement;
function startSound (el) {
if (!MSIE) {
return;
}
if (el == null) {
return;
}
if (bgSoundElement) {
bgSoundElement.src = "";
bgSoundElement.src = el.src;
} else {
if (el.ReadyState && el.ReadyState >= 4) {
el.stop();
el.play();
}
}
}
function stopSound (el) {
if (!MSIE) {
return;
}
if (el == null) {
return;
}
if (bgSoundElement) {
bgSoundElement.src = "";
} else {
if (el.ReadyState && el.ReadyState >= 4) {
el.stop();
}
}
}
function addSound (soundFile) {
if (!MSIE) {
return;
}
if (!document.createElement) {
return;
}
if (!document.body) {
return;
}
// if (!bgSoundElement) {
// document.write("");
// bgSoundElement = document.getElementById("bgSoundElement");
// }
// This also has the effect of preloading the sound.
var embed = document.createElement("embed");
embed.style.display = "none";
embed.hidden = "true";
embed.autostart = "false";
embed.src = soundFile;
embed.startFunction = function () {
startSound(embed);
};
/* if prependChild() existed, this is what it would do. */
if (document.body.hasChildNodes()) {
document.body.insertBefore(embed, document.body.childNodes[0]);
} else {
document.body.appendChild(embed);
}
return embed;
}
/*
setupSoundRolloversOnElements() accepts the following paramenters:
- container - a container element within which certain elements
will have sound rollover triggers added
- sound - a sound object created using addSound().
- tagName - an HTML tag name
- className (OPTIONAL) - a CSS class name
This function will find any elements whose tag name is tagName within
the container element, and will add onmouseover events to those elements
to play the specified sound. If the optional className argument is
specified, then only those elements matching the tagName that also have
the specified className as one of the classes in the element's class
attribute will receive the sound rollovers.
Example:
*/
function setupSoundRolloversOnElements (container, sound, tagName, className) {
if (!MSIE) return;
if (!RegExp) return;
var classNameRegex;
if (className != null) {
/* We need to match the className in a string containing
multiple space-separated class names. */
classNameRegex = new RegExp("(^|\\s)" + className + "(\\s|$)");
}
if (container && container.getElementsByTagName) {
var els = container.getElementsByTagName(tagName);
for (i = 0; i < els.length; ++i) {
var el = els[i];
if (className != null) {
if (el.className == null) continue; // next element
if (!classNameRegex.test(el.className)) continue; // next elem.
}
el.onmouseover = sound.startFunction;
}
}
}
/*
setupSoundRolloversOnLinks() accepts a container element within an HTML
document, finds any links within that container element, and triggers
the specified sound to be played upon mouseover.
Example:
*/
function setupSoundRolloversOnLinks (container, sound) {
if (!MSIE) return;
setupSoundRolloversOnElements(container, sound, "a");
}