SVGStyleElement
The SVGStyleElement
interface corresponds to the SVG <style>
element.
Instance properties
This interface also inherits properties from its parent interface, SVGElement
.
SVGStyleElement.type
Deprecated-
A string corresponding to the
type
attribute of the given element. SVGStyleElement.media
-
A string corresponding to the
media
attribute of the given element. SVGStyleElement.title
-
A string corresponding to the
title
attribute of the given element. SVGStyleElement.sheet
Read only-
Returns the
CSSStyleSheet
object associated with the given element, ornull
if there is none. SVGStyleElement.disabled
-
A boolean value indicating whether or not the associated stylesheet is disabled.
Instance methods
This interface doesn't implement any specific methods, but inherits methods from its parent interface, SVGElement
.
Examples
Dynamically adding an SVG style element
To dynamically create an SVG style element (SVGStyleElement
), you need to use Document.createElementNS()
, specifying a style
element in the SVG namespace.
Note: Document.createElement()
can't be used to create SVG style elements (it returns an HTMLStyleElement
).
Given the following SVG element:
html
<svg
xmlns="http://www.w3.org/2000/svg"
xmlns:xlink="http://www.w3.org/1999/xlink">
<circle cx="50" cy="50" r="25" />
</svg>
You can create an SVG style element as shown:
js
// Get the SVG element object by tag name
const svg = document.querySelector("svg");
// Create the `style` element in the SVG namespace
const style = document.createElementNS("http://www.w3.org/2000/svg", "style");
const node = document.createTextNode("circle { fill: red; }");
style.appendChild(node);
// Append the style element to the SVG element
svg.appendChild(style);
Accessing an existing SVG style
You can access an SVG style element that was defined in HTML (or an SVG file) using the normal HTML methods for getting tags, ids, and so on.
These include: Document.getElementsByTagName()
, Document.getElementById()
, Document.querySelector()
, Document.querySelectorAll()
, and so on.
For example, consider the HTML below that defines an SVG file with a style element.
html
<svg
xmlns="http://www.w3.org/2000/svg"
xmlns:xlink="http://www.w3.org/1999/xlink">
<style id="circle_style_id">
circle {
fill: gold;
stroke: green;
stroke-width: 3px;
}
</style>
<circle cx="50" cy="50" r="25" />
</svg>
To fetch the first style
element in the first svg
element, you might use Document.querySelector()
as shown below.
js
const svg = document.querySelector("svg");
const style = svg.querySelector("style");
Alternatively, you can could use Document.getElementById()
, specifying the tag id:
js
const svg = document.querySelector("svg");
const style = svg.getElementById("circle_style_id");
Or just get the element from document by id (in this case using document.querySelector()
):
js
const style = document.querySelector("#circle_style_id");
Getting and setting properties
This example demonstrates how to get and set the properties of a style element, which in this case was specified in an SVG definition.
HTML
The HTML contains an SVG definition for a <circle>
with a <style>
element, along with an HTML <button>
element that will be used to enable and disable the style, and an HTML <textarea>
element for logging the property values.
html
<button>Disable</button>
<textarea id="log" rows="6" cols="90"></textarea>
<svg
xmlns="http://www.w3.org/2000/svg"
xmlns:xlink="http://www.w3.org/1999/xlink">
<style id="circle_style_id" media="all and (min-width: 600px)">
circle {
fill: gold;
stroke: green;
stroke-width: 3px;
}
</style>
<circle cx="60" cy="60" r="50" />
</svg>
Note that above we have set the media
attribute on the style
tag.
We have not set type
as it is deprecated, or disabled
because there is no such attribute (only the property on the element).
JavaScript
The code below gets the style
element (an SVGStyleElement
) using its id.
js
const svg = document.querySelector("svg");
const style = svg.getElementById("circle_style_id");
We then add a function to log the style properties. This is called after initialization, whenever the frame resizes, and if the button is pressed.
js
// Get logging text area
const log = document.getElementById("log");
function setLogText() {
//Log current values of properties
log.value = `style.media: ${style.media} (frame width: ${window.innerWidth})\n`; // 'all' by default
log.value += `style.title: ${style.title}\n`; // no default value
log.value += `style.disabled: ${style.disabled}\n`; // 'false' by default
log.value += `style.type: ${style.type}\n`; // deprecated (do not use)
log.value += `style.sheet.rules[0].cssText: ${style.sheet.rules[0].cssText}\n`;
}
// Log initial property values
setLogText();
// Log when the frame resizes
addEventListener("resize", () => {
setLogText();
});
Last of all we set an event handler for the button.
When the button is clicked the disabled
property is toggled.
This also updates the log and the button text.
js
const button = document.querySelector("button");
button.addEventListener("click", () => {
style.disabled = !style.disabled;
button.textContent = style.disabled ? "Enable" : "Disable";
// Log after button presses
setLogText();
});
Result
The result is shown below.
Toggle the button to enable and disable the SVG style element.
If the SVG style is not disabled, you can also resize the window width to see the effect of the media
property on the style when the frame holding the live example is 600px wide.
Specifications
Specification |
---|
Scalable Vector Graphics (SVG) 2 # InterfaceSVGStyleElement |
Browser compatibility
BCD tables only load in the browser