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, the BackgroundImage and BackgroundAlpha of a filter primitive are processed as if background image processing were not enabled.

Specifications

Specification Status Comment
Scalable Vector Graphics (SVG) 1.1 (Second Edition)
The definition of 'enable-background' in that specification.
Recommendation Initial definition

Browser compatibility

BCD tables only load in the browser