Szukaj…


Uwagi

Skrypty SVG przy użyciu rodzimych interfejsów DOM są obecnie (2016) w stanie niewielkiej zmiany. Obecny standard SVG (1.1) jest dobrze zaimplementowany przez większość głównych przeglądarek internetowych. Ponieważ jednak trwa opracowywanie standardu SVG 2.0, niektóre przeglądarki zaczęły usuwać funkcje SVG 1.1, które w 2.0 będą przestarzałe. Pełna lista proponowanych zmian z SVG 1.1 na SVG 2.0 znajduje się w załączniku L do SVG 2.0 .

Zastępowanie pathSegList i inne użycie SVGPathSeg

W SVG 1.1 <path> elementy są zdefiniowane tak, aby miały właściwość pathSegList która daje dostęp do natywnej reprezentacji wszystkich poleceń ścieżki . Google Chrome v48 usunął tę właściwość pod koniec 2015 r., Przygotowując się do proponowanej zamiany w SVG 2.0 . Do czasu dodania obsługi SVG 2.0 należy użyć wypełnienia wielokrotnego, aby odzyskać funkcjonalność 1.1 lub wdrożyć proponowany interfejs API 2.0 .

Zastępowanie getTransformToElement()

Chrome v48 usunął również metodę SVGGraphicsElement.getTransformToElement() . Istnieje prosty polifill do implementacji starej metody .

Tworzenie elementu

Najprostszym sposobem na zrozumienie tworzenia i modyfikowania elementów SVG jest działanie na elementach przy użyciu interfejsów DOM Level 2 Core , tak jak w przypadku HTML lub XML.

Konieczne jest, aby elementy utworzone z JavaScript były tworzone w tej samej przestrzeni nazw zadeklarowanej w elemencie SVG - w tym przykładzie: „ http://www.w3.org/2000/svg ”. Jednak prawie wszystkie atrybuty elementów SVG nie znajdują się w żadnej przestrzeni nazw. Nie należy umieszczać ich w przestrzeni nazw SVG.

Tutaj demonstrujemy SVG hostowane wewnątrz HTML, ponieważ jest to częsty przypadek:

<!doctype HTML>
<html><title>Creating an Element</title>
<body>
  <svg xmlns="http://www.w3.org/2000/svg"
       width="100%" height="100%"
       viewBox="0 0 400 300"></svg>

  <script>
     var svgNS = "http://www.w3.org/2000/svg";

     // Create a circle element (not part of the DOM yet)
     var circle = document.createElementNS(svgNS,'circle'); // Creates a <circle/>
     circle.setAttribute('fill','red'); // Note: NOT setAttributeNS()
     circle.setAttribute('cx',150);     // setAttribute turns 150 into a string
     circle.setAttribute('cy','80');    // using a string works, too
     circle.setAttribute('r',35);       // give the circle a radius so we can see it

     // Now, add the circle to the SVG document so we can see it
     var svg = document.querySelector('svg'); // the root <svg> element
     svg.appendChild(circle);
  </script>
</body></html>

Istnieje kilka atrybutów, które należy utworzyć w określonej przestrzeni nazw. Są to te z dwukropkami w swoich nazwach w indeksie atrybutów SVG . W szczególności są to: xlink:actuate : xlink:actuate , xlink:arcrole , xlink:href , xlink:role , xlink:show , xlink:title , xlink:type , xml:base , xml:lang i xml:space . Ustaw te atrybuty za pomocą setAttributeNS() :

var svgNS   = "http://www.w3.org/2000/svg";
var xlinkNS = "http://www.w3.org/1999/xlink";
var img = document.createElementNS( svgNS, 'image' );
img.setAttributeNS( xlinkNS, 'href', 'my.png' );

Jeśli często tworzysz elementy, w szczególności z wieloma atrybutami, funkcja pomocnika taka jak poniżej pozwala zaoszczędzić na pisaniu, uniknąć błędów i ułatwić czytanie kodu:

<!doctype HTML>
<html><title>Creating an Element</title>
<body>
  <svg xmlns="http://www.w3.org/2000/svg"></svg>
  <script>
     var svg = document.querySelector('svg');
     var circle = createOn( svg, 'circle', {fill:'red', cx:150, cy:80, r:35} );

    // Create an SVG element on another node with a set of attributes.
    // Attributes with colons in the name (e.g. 'xlink:href') will automatically
    // find the appropriate namespace URI from the SVG element.
    // Optionally specify text to create as a child node, for example
    //   createOn(someGroup,'text',{x:100,'text-anchor':'middle'},"Hello World!");
    function createOn(parentEl,name,attrs,text){
      var doc=parentEl.ownerDocument, svg=parentEl;
      while (svg && svg.tagName!='svg') svg=svg.parentNode;
      var el = doc.createElementNS(svg.namespaceURI,name);
      for (var a in attrs){
        if (!attrs.hasOwnProperty(a)) continue;
        var p = a.split(':');
        if (p[1]) el.setAttributeNS(svg.getAttribute('xmlns:'+p[0]),p[1],attrs[a]);
        else      el.setAttribute(a,attrs[a]);
      }
      if (text) el.appendChild(doc.createTextNode(text));
      return parentEl.appendChild(el);
    }
  </script>
</body></html>

Odczytywanie / zapisywanie atrybutów

Możesz użyć albo podstawowych metod DOM Level 2 getAttribute() , getAttributeNS() , setAttribute() i setAttributeNS() do odczytu i zapisu wartości z elementów SVG lub możesz użyć niestandardowych właściwości i metod określonych w SVG 1.1 IDL (interfejs Język definicji).

Proste atrybuty numeryczne

Na przykład, jeśli masz element koła SVG:

<circle id="circ" cx="10" cy="20" r="15" />

możesz użyć metod DOM do odczytu i zapisu atrybutów:

var circ = document.querySelector('#circ');
var x = circ.getAttribute('cx') * 1; // Use *1 to convert from string to number value
circ.setAttribute('cy', 25);

... lub możesz użyć niestandardowych właściwości cx , cy i r zdefiniowanych dla SVGCircleElement . Zauważ, że nie są to liczby bezpośrednie, ale zamiast tego - jak w przypadku wielu akcesoriów w SVG 1.1 - umożliwiają dostęp do animowanych wartości. Te właściwości są typu SVGAnimatedLength . Pomijając jednostki animacji i długości, możesz użyć takich atrybutów, jak:

var x = circ.cx.baseVal.value; // this is a number, not a string
circ.cy.baseVal.value = 25;

Transformacje

Grupy SVG mogą być używane do przesuwania, obracania, skalowania i w inny sposób przekształcania wielu elementów graficznych jako całości. (Aby uzyskać szczegółowe informacje na temat tłumaczeń SVG, patrz rozdział 7 ). Oto grupa, która robi uśmiechniętą twarz, którą można dostosować rozmiar, obrót i położenie, dostosowując transform :

<g id="smiley" transform="translate(120,120) scale(5) rotate(30)">
  <circle r="20" fill="yellow" stroke-width="2"/>
  <path fill="none" d="M-10,5 a 5 3 0 0 0 20,0" stroke-width="2"/>
  <circle cx="-6" cy="-5" r="2" fill="#000"/>
  <circle cx="6"  cy="-5" r="2" fill="#000"/>
</g>

Użycie skryptu do dostosowania skali tego za pomocą metod DOM wymaga manipulowania całym atrybutem transform jako ciągiem:

var face = document.querySelector('#smiley');

// Find the full string value of the attribute
var xform = face.getAttribute('transform');

// Use a Regular Expression to replace the existing scale with 'scale(3)'
xform = xform.replace( /scale\s*\([^)]+\)/, 'scale(3)' );

// Set the attribute to the new string.
face.setAttribute('transform',xform);

Za pomocą SVG DOM można przechodzić przez określone transformacje na liście, znajdować żądaną i modyfikować wartości:

var face = document.querySelector('#smiley');

// Get the SVGTransformList, ignoring animation
var xforms = face.transform.baseVal;          

// Find the scale transform (pretending we don't know its index)
for (var i=0; i<xforms.numberOfItems; ++i){
  // Get this part as an SVGTransform
  var xform = xforms.getItem(i);
  if (xform.type == SVGTransform.SVG_TRANSFORM_SCALE){
    // Set the scale; both X and Y scales are required
    xform.setScale(3,3);
    break;
  }
}
  • Aby przejść i zmienić liczbę transformacji, zobacz SVGTransformList .
  • Aby manipulować pojedynczymi transformacjami, zobacz SVGTransform .

Przeciąganie elementów SVG

Przeciągnięcie elementu SVG (lub grupy elementów) za pomocą myszy można osiągnąć poprzez:

  1. Dodanie mousedown obsługi mousedown do rozpoczęcia przeciągania: dodanie tłumaczenia elementu do użycia podczas przeciągania (w razie potrzeby), śledzenie mousemove związanych z mousemove i dodanie mouseup obsługi mousemove , aby zakończyć przeciąganie.
  2. Podczas mousemove przekształcaj pozycję myszy ze współrzędnych ekranu na lokalne współrzędne dla przeciąganego obiektu i odpowiednio zaktualizuj tłumaczenie.
  3. Podczas mouseup , usuwając mousemove i mouseup ładowarki.
// Makes an element in an SVG document draggable.
// Fires custom `dragstart`, `drag`, and `dragend` events on the
// element with the `detail` property of the event carrying XY
// coordinates for the location of the element.
function makeDraggable(el){
  if (!el) return console.error('makeDraggable() needs an element');
  var svg = el;
  while (svg && svg.tagName!='svg') svg=svg.parentNode;
  if (!svg) return console.error(el,'must be inside an SVG wrapper');
  var pt=svg.createSVGPoint(), doc=svg.ownerDocument;

  var root = doc.rootElement || doc.body || svg;
  var xlate, txStartX, txStartY, mouseStart;
  var xforms = el.transform.baseVal;

  el.addEventListener('mousedown',startMove,false);

  function startMove(evt){
    // We listen for mousemove/up on the root-most
    // element in case the mouse is not over el.
    root.addEventListener('mousemove',handleMove,false);
    root.addEventListener('mouseup',  finishMove,false);

    // Ensure that the first transform is a translate()
    xlate = xforms.numberOfItems>0 && xforms.getItem(0);
    if (!xlate || xlate.type != SVGTransform.SVG_TRANSFORM_TRANSLATE){
      xlate = xforms.createSVGTransformFromMatrix( svg.createSVGMatrix() );
      xforms.insertItemBefore( xlate, 0 );
    }
    txStartX=xlate.matrix.e;
    txStartY=xlate.matrix.f;
    mouseStart = inElementSpace(evt);
    fireEvent('dragstart');
  }

  function handleMove(evt){
    var point = inElementSpace(evt);
    xlate.setTranslate(
      txStartX + point.x - mouseStart.x,
      txStartY + point.y - mouseStart.y
    );
    fireEvent('drag');
  }

  function finishMove(evt){
    root.removeEventListener('mousemove',handleMove,false);
    root.removeEventListener('mouseup',  finishMove,false);
    fireEvent('dragend');
  }

  function fireEvent(eventName){
    var event = new Event(eventName);
    event.detail = { x:xlate.matrix.e, y:xlate.matrix.f };
    return el.dispatchEvent(event);
  }

  // Convert mouse position from screen space to coordinates of el
  function inElementSpace(evt){
    pt.x=evt.clientX; pt.y=evt.clientY;
    return pt.matrixTransform(el.parentNode.getScreenCTM().inverse());
  }
}


Modified text is an extract of the original Stack Overflow Documentation
Licencjonowany na podstawie CC BY-SA 3.0
Nie związany z Stack Overflow