:host-context()
:host-context()
は CSS の擬似クラス関数で、内部で使用される CSS を含むシャドウ DOM のシャドウホストを選択します (そのため、シャドウ DOM の中のカスタム要素を選択することができます)。 — しかし、関数の引数として与えられたセレクターがシャドウホストの祖先に一致した場合のみです。
言い換えれば、これによってカスタム要素やそのカスタム要素のシャドウ DOM 内のものは、外部 DOM 内の位置や、祖先要素に適用されたクラスや属性に基づいて、異なるスタイルを適用することができます。
典型的な使い方としては、子孫のセレクター式 (例えば h1
) を使って、 <h1>
の中にあるカスタム要素のインスタンスのみを選択することができます。もう一つの典型的な使用法は、内部要素が任意の子孫要素のクラスや属性に反応するようにすることです。例えば、 .dark-theme
クラスが <body>
に適用されたときに、異なるテキスト色を適用することができます。
Note: これはシャドウ DOM の外で使用した場合、効果がありません。
/* 与えられたセレクター引数の子孫である場合のみ、
シャドウルートホストを選択します。 */
:host-context(h1) {
font-weight: bold;
}
:host-context(main article) {
font-weight: bold;
}
/* .dark-theme クラスが文書の body に適用されているとき、
段落のテキストの色を黒から白に変更します。 */
p {
color: #000;
}
:host-context(body.dark-theme) p {
color: #fff;
}
構文
例
シャドウホストの選択的なスタイル付け
以下のスニペットは host-selectors の例から取ったものです (ライブ版もあります。
この例には、単純なカスタム要素 — <context-span>
— があり、テキストを囲むことができます。
<h1>Host selectors <a href="#"><context-span>example</context-span></a></h1>
要素のコンストラクターの中で、 style
および span
要素を生成し、 span
の中をカスタム要素の内容で埋め、 style
要素をいくつかの CSS 規則で埋めます。
let style = document.createElement('style');
let span = document.createElement('span');
span.textContent = this.textContent;
const shadowRoot = this.attachShadow({mode: 'open'});
shadowRoot.appendChild(style);
shadowRoot.appendChild(span);
style.textContent = 'span:hover { text-decoration: underline; }' +
':host-context(h1) { font-style: italic; }' +
':host-context(h1):after { content: " - no links in headers!" }' +
':host-context(article, aside) { color: gray; }' +
':host(.footer) { color : red; }' +
':host { background: rgba(0,0,0,0.1); padding: 2px 5px; }';
:host-context(h1) { font-style: italic; }
および :host-context(h1):after { content: " - no links in headers!" }
の規則は <h1>
の中にある <context-span>
要素 (このインスタンスのシャドウホスト) のインスタンスをスタイル付けします。これは設計上、 <h1>
内部にカスタム要素が現れるべきではないことを明確にするために使用しています。
仕様書
Specification |
---|
CSS Scoping Module Level 1 # host-selector |
ブラウザーの互換性
BCD tables only load in the browser