.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "tmp::p3z_yeNs_Y::Hoola 3"
.TH tmp::p3z_yeNs_Y::Hoola 3 "2018-12-25" "EN Tools" "EN Tools"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
wml::des::rollover \- RollOver\-Style Image\-Button
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\& #use wml::des::rollover
\&
\& <rollover [attributes]>
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
One of the most interesting trick to make a webpage more interactive is the
so-called \fIrollover effect\fR commonly known from window system GUIs. The idea
is simply to change the underlaying image when the mouse \fIrolls over\fR it.
Additionally when a mouse click occurs over the image it acts like a button
and jumps to a new \s-1URL.\s0
.PP
Although there are more then one way to achieve this optical effect, to use
the client-side scripting-language \fIJavaScript\fR currently is the best
solution. But here only those variants can be used which provide the \f(CW\*(C`image\*(C'\fR
object.  Netscape version 3 and 4 and Internet Explorer 4 support this. But
the generated code of this \f(CW\*(C`<rollover>\*(C'\fR tag is backward-compatible
with all types of browsers.
.SH "ATTRIBUTES"
.IX Header "ATTRIBUTES"
.IP "name" 4
.IX Item "name"
The name of the image. Just for internal usage to bind the correct image
objects to the image tag.
.IP "src" 4
.IX Item "src"
The normal image which is displayed when the mouse \fIis not\fR over the image.
.IP "oversrc" 4
.IX Item "oversrc"
The image which is displayed when the mouse \fIis\fR over the image.
.IP "href" 4
.IX Item "href"
The \s-1URL\s0 for the hyperlink which gets activated when the mouse clicks into the
image.
.IP "alt" 4
.IX Item "alt"
This string is displayed in text-only browsers or browsers which have images
disabled at the place where the image stays. Additionally it is displayed in
the browsers status line when the mouse is over the image.
.IP "target" 4
.IX Item "target"
This sets the \f(CW\*(C`target\*(C'\fR attribute for the surrounding anchor (\f(CW\*(C`<a>\*(C'\fR)
tag. Use this for redirecting the hyperlink to different target area, i.e.
usually when using frames or multiple windows.
.IP ":a:\fI\s-1ATTR\s0\fR=\fI\s-1STR\s0\fR :img:\fI\s-1ATTR\s0\fR=\fI\s-1STR\s0\fR" 4
.IX Item ":a:ATTR=STR :img:ATTR=STR"
The ``\fI\s-1ATTR\s0\fR=\fI\s-1STR\s0\fR'' pairs are passed along to the \f(CW\*(C`<a>\*(C'\fR
and \f(CW\*(C`<img>\*(C'\fR \s-1HTML\s0 tags.
.SH "AUTHOR"
.IX Header "AUTHOR"
.Vb 3
\& Ralf S. Engelschall
\& rse@engelschall.com
\& www.engelschall.com
.Ve
.SH "REQUIRES"
.IX Header "REQUIRES"
.Vb 2
\& Internal: P1, P2
\& External: JavaScript (BROWSER)
.Ve
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\s-1HTML 3.2\s0 \f(CW\*(C`<img>\*(C'\fR and \f(CW\*(C`<a>\*(C'\fR tags,
JavaScript: http://home.netscape.com/eng/mozilla/3.0/handbook/javascript/