javascriptgraphicssvgscalable

Scripting <path> data in SVG (reading and modifying)


I've been searching for ways to run scripts for my SVG. But all the things I got don't match up! And it doesn't contain enough information why each set of codes were used. For example, one used event.target, another had event.getTarget(), and another had event.target.firstchild.data.

<svg xmlns="http://www.w3.org/2000/svg" version="1.1">
  <path d="M150 0 L75 200 L225 200 Z" />
</svg>

This is an example of a path svg, right? What I need is to get those coordinates, probably put it in a variable, and use it as coordinates for another svg. So how can I do that? Another thing is how can I change those coordinates by entering numbers in an interface?


Solution

  • It sounds like you may have four questions:

    1. How do I embed script inside an SVG file?
    2. How do I run script inside an SVG file?
    3. How do I access data for a <path> element from script?
    4. How can I manipulate data for a <path> element from script?

    Let's tackle them one at a time:


    How do I embed script inside an SVG file?

    As described in the SVG specification you can place a <script> element in your document to contain JavaScript code. According to the latest SVG specifications, you do not need to specify a type attribute for your script. It will default to type="application/ecmascript".

    As with HTML, you may either put the script code directly in the document, or you may reference an external file. When doing the latter, you must use an href attribute (not src) for the URI, with the attribute in the xlink namespace.

    <svg version="1.1" baseProfile="full" xmlns="http://www.w3.org/2000/svg"
         xmlns:xlink="http://www.w3.org/1999/xlink">
      <script xlink:href="/js/mycode.js" />
      <script><![CDATA[
        // Wrap the script in CDATA since SVG is XML and you want to be able to write
        // for (var i=0; i<10; ++i )
        // instead of having to write
        // for (var i=0; i&lt;10; ++i )
      ]]></script>
    </svg>
    

    How do I run script inside an SVG file?

    As with HTML, code included in your SVG document will be run as soon as it is encountered. If you place your <script> element above the rest of your document (as you might when putting <script> in the <head> of an HTML document) then none of your document elements will be available when your code is running.

    The simplest way to avoid this is to place your <script> elements at the bottom of your document:

    <svg version="1.1" baseProfile="full" xmlns="http://www.w3.org/2000/svg"
         xmlns:xlink="http://www.w3.org/1999/xlink">
      <!-- all SVG content here, above the script -->
      <script><![CDATA[
        // Now I can access the full DOM of my document
      ]]></script>
    </svg>
    

    Alternatively, you can create a callback function at the top of your document that is only invoked when the rest of the document is ready:

    <svg version="1.1" baseProfile="full" xmlns="http://www.w3.org/2000/svg">
      <title>SVG Coordinates for Embedded XHTML Elements</title>
      <script>document.documentElement.addEventListener('load',function(){
        // This code runs once the 'onload' event fires on the root SVG element
        console.log( document.getElementById('foo') );
      },false)</script>
      <path id="foo" d="M0 0" />
    </svg>
    

    How do I access data for a <path> element from script?

    There are two ways to access most information about elements in SVG: you can either access the attribute as a string through the standard DOM Level 1 Core method getAttribute(), or you can use the SVG DOM objects and methods. Let's look at both:

    Accessing path data through getAttribute()

    Using getAttribute() returns the same string as you would see when you view source:

    <path id="foo" d="M150 0 L75 200 L225 200 Z" />
    <script><![CDATA[
      var path = document.getElementById('foo');
      var data = path.getAttribute('d');
      console.log(data);
      //-> "M150 0 L75 200 L225 200 Z"
    ]]></script>
    

    Accessing path data through SVG DOM methods

    <path id="foo" d="M150 0 L75 200 L225 200 Z" />
    <script><![CDATA[
      var path = document.getElementById('foo');
    
      // http://www.w3.org/TR/SVG/paths.html#__svg__SVGAnimatedPathData__normalizedPathSegList
      // See also path.pathSegList and path.animatedPathSegList and path.animatedNormalizedPathSegList
      var segments = path.normalizedPathSegList ;
    
      for (var i=0,len=segments.numberOfItems;i<len;++i){
        var pathSeg = segments.getItem(i);
        // http://www.w3.org/TR/SVG/paths.html#InterfaceSVGPathSeg
        switch(pathSeg.pathSegType){
          case SVGPathSeg.PATHSEG_MOVETO_ABS:
            // http://www.w3.org/TR/SVG/paths.html#InterfaceSVGPathSegMovetoAbs
            console.log("Move to",pathSeg.x,pathSeg.y);
          break;
          case SVGPathSeg.PATHSEG_LINETO_ABS:
            // http://www.w3.org/TR/SVG/paths.html#InterfaceSVGPathSegLinetoAbs
            console.log("Line to",pathSeg.x,pathSeg.y);
          break;
          case SVGPathSeg.PATHSEG_CLOSEPATH:
            // http://www.w3.org/TR/SVG/paths.html#InterfaceSVGPathSegClosePath
            console.log("Close Path");
          break;
        }
      }
    ]]></script>
    

    The above script produces the following output:

    Move to 150 0
    Line to 75 200
    Line to 225 200
    Close Path
    

    Because it can be hard to read the W3C specs for SVG DOM, many years ago I created an online tool for browsing what properties and objects exist. You may use it here: http://objjob.phrogz.net/svg/hierarchy


    How can I manipulate data for a <path> element from script

    Similar to the above, you can either create a new string and use setAttribute() to shove it onto the object, or you can manipulate the SVG DOM.

    Manipulating path data using setAttribute()

    <path id="foo" d="M150 0 L75 200 L225 200 Z" />
    <script><![CDATA[
      var path = document.getElementById('foo');
      path.setAttribute('d','M150,0 L150,100 200,300 Z');
    ]]></script>
    

    Manipulating path data using SVG DOM

    <path id="foo" d="M150,0 L75,200 l150,0 Z" />
    <script><![CDATA[
      var path = document.getElementById('foo');
      var segments = path.pathSegList;
      segments.getItem(2).y = -10;
    ]]></script>
    

    In general, you just have to modify the properties of the various SVGPathSeg subclass instances; the changes are made immediately in the DOM. (With the above example, the original triangle is skewed as the last point is moved up slightly.)

    When you need to create new path segments, you need to use methods like var newSegment = myPath.createSVGPathSegArcAbs(100,200,10,10,Math.PI/2,true,false) and then use one of the methods to stick this segment into the list, e.g. segments.appendItem(newSegment).