main page - page initiale - hauptseite - página principal projects - projets - projekte - proyectos authors - auteurs - autoren - autores papers - exposés - berichte - papeles help - aide - hilfe - ayuda

carto:papers:svg:examples:interactivity:mouseover

Example for use of mouseover effects


This example shows the use of mouseover and click events. Move the cursor above city-symbols to get their names, click on them to get a message.

On the symbols we attached the event handler attributes onmouseover, onmouseout and onclick. Events can trigger functions or objects that act according to the javascript code provided in the event handler. See also our tutorial on Event Handling in SVG Applications.

Files used

Right-click, save ...

Technical Details

The combination of SVG, DOM (Document Object Model), ECMAScript and events enables the creation of highly interactive web-maps.

Use of Javascript in combination with SVG

Javascript can be embedded in SVG or referenced in several ways: Short javascript constructs may be written directly within the event handler attribute of an SVG element (e.g. onload="some_js_code"), more complex constructs may be written in the header of the SVG or HTML file. However, in most cases it is recommended to use an external ECMAScript (javascript) (".js") file and set a reference in the header-section of the HTML or SVG file. The following code shows how to do this in an SVG-File (the last line is relevant for referencing external .js-files).

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN" "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd">
<svg xml:space="preserve" width="450" height="325" viewBox="480000 0 360000 260000"
  onload="init(evt)" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">

<script xlink:href="mouse_over_effects.js" type="text/ecmascript"/>

Our small project uses 3 files: a HTML-File for the initial layout, an external javascript-file and a separate SVG-File.

Event-Handler

In order to trigger the execution of javascripts one can use event handler attributes. These event handler attributes are compatible with HTML. Following are some of the more important SVG-event-handler: (For a complete list see: W3C-SPEC)

Note that there are more events available, but some are not yet supported in every browser/plugin (e.g. mutation events)! Also some events are restricted to specific elements.

<use id="Genf" x="499500" y="181000" xlink:href="#symbolRect" 
                 onmouseover="showCity('Geneva')" onmouseout="emptyCity()" #+
                 onclick="cityClick('Birthplace of the WWW ...')" />

The above SVG-code shows how to use mouseover and click-events. The event handler (javascript-functions) are stored in an external javascript-file.

Simple Javascript-functions to change SVG-elements

In order to change SVG-elements per javascript one needs to first reference them. This is done using the DOM-tree and DOM methods like document.getElementById(). If references are used more than once, one can store them in global variables, typically initialized by an onload event.

//global variables
//global variables
var svgCityText;

function init(evt) {
	//get reference to child (content) of the city text-Element
	svgCityText = document.getElementById("varCity").firstChild;
}

The global variable svgCityText is used as a reference to the first child of the text-object that we want to change. Because the same object is used in more functions we use it in a global context. The function init() is executed after the webpage is loaded and is initializizing this reference. The text-object we want to change has the ID "varCity" and is referenced by the method .getElementById(). In order to access the text-string itself we have to use the property .firstChild.

function showCity(city) {
	//change text-Value
	svgCityText.nodeValue = city;
}

This function changes the text-value itself using the property nodeValue. This function is triggered by the mouseover event.

function emptyCity() {
	//empty text-String
	svgCityText.nodeValue = " ";
}

The function emptyCity(), triggered by the mouseout event, resets the content of the text-element, when the user leaves the SVG graphics element.

function cityClick(text) {
	//show an alert message
	alert(text);
}

The above function is triggered by a mouse-click event and sends a javascript-alert message with the message-text given by the functions parameter.




Last modified: Monday, 17-Jul-2006 15:07:47 CEST
© carto:net (andré m. winter & andreas neumann)
original URL for reference: http://www.carto.net/papers/svg/samples/mouse_over_effects.shtml
del.icio.us Add this page to del.icio.us