SVG In HTML Introduction

  • Revision slug: SVG_In_HTML_Introduction
  • Revision title: SVG In HTML Introduction
  • Revision id: 54260
  • Created:
  • Creator: Jonathan_Watt
  • Is current revision? No
  • Comment Add a link to the Inline SVG page on the SVG wiki

Revision Content

Overview

This article and its associated example shows how to use inline SVG to provide a background picture for a form. It shows how Javascript and CSS can be used to manipulate the picture in the same way you would script regular XHTML. Note that the example will only work in browsers that support XHTML (not HTML) and SVG integration.

Source

Here is the source to the example:

<html xmlns="http://www.w3.org/1999/xhtml">
<head>
  <title>XTech SVG Demo</title>
  <style>
    stop.begin { stop-color:yellow; }
    stop.end { stop-color:green; }
    body.invalid stop.end { stop-color:red; }
    #err { display:none; }
    body.invalid #err { display:inline; }
  </style>
  <script>
    function signalError() {
      document.getElementById('body').setAttribute("class", "invalid");
    }
  </script>
</head>
<body id="body"
   style="position:absolute; z-index:0; border:1px solid black; left:5%; top:5%; width:90%; height:90%;">
  <form>
     <fieldset>
       <legend>HTML Form</legend>
       <p><label>Enter something:</label>
          <input type="text"/>
          <span id="err">Incorrect value!</span></p>
       <p><button onclick="signalError();">Activate!</button></p>
     </fieldset>
  </form>
  <svg xmlns="http://www.w3.org/2000/svg" version="1.1"
    viewBox="0 0 100 100" preserveAspectRatio="xMidYMid slice"
    style="width:100%; height:100%; position:absolute; top:0; left:0; z-index:-1;">
    <linearGradient id="gradient">
      <stop class="begin" offset="0%"/>
      <stop class="end" offset="100%"/>
    </linearGradient>
    <rect x="0" y="0" width="100" height="100" style="fill:url(#gradient)" />
    <circle cx="50" cy="50" r="30" style="fill:url(#gradient)" />
  </svg>
</body>
</html>

Discussion

The page is mainly regular XHTML, CSS and Javascript. The only interesting part is the <svg> element it contains. This element and its children are declared to be in the SVG namespace. The element contains a gradient and two shapes filled with the gradient. The gradient color stops have their colors set by CSS. When the user enters something incorrect into the form, the script sets the "invalid" attribute on the <body>, and a style rule changes the gradient end-stop color to red. (Another style rule makes an error message appear.)

This approach has the following points in its favor:

  • We have taken a regular XHTML form that could have been part of an existing Web site, and added an attractive, interactive background
  • The approach is backward compatible to browsers that do not support SVG; simply, no background appears in them
  • It's very simple and performs very well
  • The picture dynamically sizes itself to the required size in an intelligent way
  • We can have declarative style rules applying to both HTML and SVG
  • The same script manipulates both HTML and SVG
  • The document is entirely standards-based

Details

The "viewBox" attribute establishes a logical coordinate system which the SVG picture's coordinates are relative to. In this case our picture is laid out in a 100 by 100 viewport.

The "preserveAspectRatio" attribute specifies that the aspect ratio must be preserved by centering the picture in the available size, sizing to the maximum of the height or width and then cutting off any overflow.

The "style" attribute pins the SVG element to the background of the form.

Related Links

http://svg-whiz.com/wiki/index.php?title=Inline_SVG

{{ wiki.languages( { "pl": "pl/SVG_w_XHTML_-_Wprowadzenie" } ) }}

Revision Source

<h3 name="Overview"> Overview </h3>
<p>This article and <a class="external" href="http://developer.mozilla.org/presentations/xtech2005/svg-canvas/SVGDemo.xml">its associated example</a> shows how to use inline SVG to provide a background picture for a form. It shows how Javascript and CSS can be used to manipulate the picture in the same way you would script regular XHTML.  Note that the example will only work in browsers that support XHTML (not HTML) and SVG integration.
</p>
<h3 name="Source"> Source </h3>
<p>Here is the source to <a class="external" href="http://developer.mozilla.org/presentations/xtech2005/svg-canvas/SVGDemo.xml">the example</a>:
</p>
<pre>&lt;html xmlns="http://www.w3.org/1999/xhtml"&gt;
&lt;head&gt;
  &lt;title&gt;XTech SVG Demo&lt;/title&gt;
  &lt;style&gt;
    stop.begin { stop-color:yellow; }
    stop.end { stop-color:green; }
    body.invalid stop.end { stop-color:red; }
    #err { display:none; }
    body.invalid #err { display:inline; }
  &lt;/style&gt;
  &lt;script&gt;
    function signalError() {
      document.getElementById('body').setAttribute("class", "invalid");
    }
  &lt;/script&gt;
&lt;/head&gt;
&lt;body id="body"
   style="position:absolute; z-index:0; border:1px solid black; left:5%; top:5%; width:90%; height:90%;"&gt;
  &lt;form&gt;
     &lt;fieldset&gt;
       &lt;legend&gt;HTML Form&lt;/legend&gt;
       &lt;p&gt;&lt;label&gt;Enter something:&lt;/label&gt;
          &lt;input type="text"/&gt;
          &lt;span id="err"&gt;Incorrect value!&lt;/span&gt;&lt;/p&gt;
       &lt;p&gt;&lt;button onclick="signalError();"&gt;Activate!&lt;/button&gt;&lt;/p&gt;
     &lt;/fieldset&gt;
  &lt;/form&gt;
  &lt;svg xmlns="http://www.w3.org/2000/svg" version="1.1"
    viewBox="0 0 100 100" preserveAspectRatio="xMidYMid slice"
    style="width:100%; height:100%; position:absolute; top:0; left:0; z-index:-1;"&gt;
    &lt;linearGradient id="gradient"&gt;
      &lt;stop class="begin" offset="0%"/&gt;
      &lt;stop class="end" offset="100%"/&gt;
    &lt;/linearGradient&gt;
    &lt;rect x="0" y="0" width="100" height="100" style="fill:url(#gradient)" /&gt;
    &lt;circle cx="50" cy="50" r="30" style="fill:url(#gradient)" /&gt;
  &lt;/svg&gt;
&lt;/body&gt;
&lt;/html&gt;</pre>
<h3 name="Discussion"> Discussion </h3>
<p>The page is mainly regular XHTML, CSS and Javascript. The only interesting part is the &lt;svg&gt; element it contains. This element and its children are declared to be in the SVG namespace. The element contains a gradient and two shapes filled with the gradient. The gradient color stops have their colors set by CSS. When the user enters something incorrect into the form, the script sets the "invalid" attribute on the &lt;body&gt;, and a style rule changes the gradient end-stop color to red. (Another style rule makes an error message appear.)
</p><p>This approach has the following points in its favor:
</p>
<ul><li> We have taken a regular XHTML form that could have been part of an existing Web site, and added an attractive, interactive background
</li><li> The approach is backward compatible to browsers that do not support SVG; simply, no background appears in them
</li><li> It's very simple and performs very well
</li><li> The picture dynamically sizes itself to the required size in an intelligent way
</li><li> We can have declarative style rules applying to both HTML and SVG
</li><li> The same script manipulates both HTML and SVG
</li><li> The document is entirely standards-based
</li></ul>
<h3 name="Details"> Details </h3>
<p>The "viewBox" attribute establishes a logical coordinate system which the SVG picture's coordinates are relative to. In this case our picture is laid out in a 100 by 100 viewport.
</p><p>The "preserveAspectRatio" attribute specifies that the aspect ratio must be preserved by centering the picture in the available size, sizing to the maximum of the height or width and then cutting off any overflow.
</p><p>The "style" attribute pins the SVG element to the background of the form.
</p>
<h3 name="Related_Links"> Related Links </h3>
<p>http://svg-whiz.com/wiki/index.php?title=Inline_SVG
</p>{{ wiki.languages( { "pl": "pl/SVG_w_XHTML_-_Wprowadzenie" } ) }}
Revert to this revision