SVG
Skrypty
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:
- Dodanie
mousedown
obsługimousedown
do rozpoczęcia przeciągania: dodanie tłumaczenia elementu do użycia podczas przeciągania (w razie potrzeby), śledzeniemousemove
związanych zmousemove
i dodaniemouseup
obsługimousemove
, aby zakończyć przeciąganie. - 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. - Podczas
mouseup
, usuwającmousemove
imouseup
ł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());
}
}