The HTTP Content-Security-Policy (CSP) style-src-attr directive specifies valid sources for inline styles applied to individual DOM elements.
The directive does not set valid sources for style elements and link elements with rel="stylesheet".
These are set using style-src-elem (and valid sources for all styles may be set with style-src).
<table class="properties"> <tbody> <tr> <th scope="row">CSP version</th> <td>3</td> </tr> <tr> <th scope="row">Directive type</th> <td>Fetch directive</td> </tr> <tr> <th scope="row">default-src fallback</th> <td> <p> Yes. If this directive is absent, the user agent will look for the style-src directive, and if both of them are absent, fallback to <code>default-src</code> directive. </p> </td> </tr> </tbody> </table>
Syntax
Content-Security-Policy: style-src-attr 'none';
Content-Security-Policy: style-src-attr <source-expression-list>;
This directive may have one of the following values:
'none'- : No resources of this type may be loaded. The single quotes are mandatory.
<source-expression-list>- : A space-separated list of source expression values. Resources of this type may be loaded if they match any of the given source expressions. For this directive, the following source expression values are applicable:
style-src-attr can be used in conjunction with style-src:
Content-Security-Policy: style-src <source>;
Content-Security-Policy: style-src-attr <source>;
Examples
Violation cases
Given this CSP header:
Content-Security-Policy: style-src-attr 'none'
…the inline style applied to the element below will not be applied:
<div style="display: inline">Foo</div>
The policy would also block any styles applied in JavaScript by setting the style attribute directly, or by setting CSSStyleDeclaration.cssText:
document.querySelector("div").setAttribute("style", "display: inline");
document.querySelector("div").style.cssText = "display: inline";
Style properties that are set directly on the element's HTMLElement/style property will not be blocked, allowing users to safely manipulate styles via JavaScript:
document.querySelector("div").style.display = "inline";
Note that using JavaScript might independently be blocked using the script-src CSP directive.
Specifications
Browser compatibility
See also
- Content-Security-Policy
- style-src
- style-src-elem
- Link header
- style, link
- @import
- CSSStyleSheet.insertRule()
- CSSGroupingRule.insertRule()
- CSSStyleDeclaration.cssText
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
