enable-background
Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
The enable-background attribute specifies how the accumulation of the background image is managed.
Note: As a presentation attribute, enable-background can be used as a CSS property.
You can use this attribute with the following SVG elements:
Context notes
| Value |
accumulate | new [ <x>
<y> <width>
<height> ]?
|
|---|---|
| Default value | accumulate |
| Animatable | No |
accumulate-
If an ancestor container element has a property value of
enable-background: new, then all graphics elements within the current container element are rendered both onto the parent container element's background image canvas and onto the target device.Otherwise, there is no current background image canvas, so graphics elements are only rendered onto the target device.
new [ <x> <y> <width> <height> ]?-
This value enables the ability of children of the current container element to access the background image.
It also indicates that a new (i.e., initially transparent black) background image canvas is established and that in effect all children of the current container element shall be rendered into the new background image canvas in addition to being rendered onto the target device.
The optional
<x>,<y>,<width>, and<height>parameters are<number>values that indicate the subregion of the container element's user space where access to the background image is allowed to happen. Those values act as a clipping rectangle on the background image canvas. Negative values for<width>or<height>are forbidden. If one, two, or three values are specified or if neither<width>nor<height>are specified, theBackgroundImageandBackgroundAlphaof a filter primitive are processed as if background image processing were not enabled.
Specifications
| Specification |
|---|
| Scalable Vector Graphics (SVG) 1.1 (Second Edition) # EnableBackgroundProperty |
Browser compatibility
BCD tables only load in the browser