---
title: mask-composite
slug: Web/CSS/mask-composite
tags:
  - CSS
  - CSS Masking
  - CSS Property
  - Experimental
  - Reference
  - 'recipe:css-property'
translation_of: Web/CSS/mask-composite
---
<div>{{CSSRef}}</div>

<p><strong><code>mask-composite</code></strong> は <a href="/ja/docs/Web/CSS">CSS</a> のプロパティで、現在のマスクレイヤーとその下のマスクレイヤーとの間で使われる合成操作を表します。</p>

<pre class="brush:css no-line-numbers notranslate">/* キーワード値 */
mask-composite: add;
mask-composite: subtract;
mask-composite: intersect;
mask-composite: exclude;

/* グローバル値 */
mask-composite: inherit;
mask-composite: initial;
mask-composite: unset;
</pre>

<h2 id="Syntax" name="Syntax">構文</h2>

<p>以下に示す1つまたは複数のキーワード値を、カンマで区切って指定します。</p>

<h3 id="Values" name="Values">値</h3>

<p>混合において、現在のマスクレイヤーは <em>source</em>、その下にあるすべてのマスクレイヤーは <em>destination</em> とします。</p>

<dl>
 <dt><code>add</code></dt>
 <dd>source が destination の上に配置されます。</dd>
 <dt><code>subtract</code></dt>
 <dd>destination の外側に source が配置されます。</dd>
 <dt><code>intersect</code></dt>
 <dd>destination と重なっている source の部分が destination を置き換えます。</dd>
 <dt><code>exclude</code></dt>
 <dd>source と destination で重なっていない領域が結合されます。</dd>
</dl>

<h2 id="Formal_definition" name="Formal_definition">公式定義</h2>

<p>{{cssinfo}}</p>

<h2 id="Formal_syntax" name="Formal_syntax">形式文法</h2>

{{csssyntax}}

<h2 id="Examples" name="Examples">例</h2>

<h3 id="Compositing_mask_layers_with_addition" name="Compositing_mask_layers_with_addition">追加でマスクレイヤーの合成</h3>

<h4 id="CSS">CSS</h4>

<pre class="brush: css; highlight[7] notranslate">#masked {
  width: 100px;
  height: 100px;
  background-color: #8cffa0;
  mask-image: url(https://mdn.mozillademos.org/files/12668/MDN.svg),
              url(https://mdn.mozillademos.org/files/12676/star.svg);
  mask-size: 100% 100%;
  mask-composite: add; /* Can be changed in the live sample */
}
</pre>

<div class="hidden">
<h4 id="HTML">HTML</h4>

<pre class="brush: html notranslate">&lt;div id="masked"&gt;
&lt;/div&gt;
&lt;select id="compositeMode"&gt;
  &lt;option value="add"&gt;add&lt;/option&gt;
  &lt;option value="subtract"&gt;subtract&lt;/option&gt;
  &lt;option value="intersect"&gt;intersect&lt;/option&gt;
  &lt;option value="exclude"&gt;exclude&lt;/option&gt;
&lt;/select&gt;
</pre>

<h4 id="JavaScript">JavaScript</h4>

<pre class="brush: js notranslate">var clipBox = document.getElementById("compositeMode");
clipBox.addEventListener("change", function (evt) {
  document.getElementById("masked").style.maskComposite = evt.target.value;
});
</pre>
</div>

<h4 id="Result" name="Result">結果</h4>

<p>{{EmbedLiveSample("Compositing_mask_layers_with_addition", "100px", "130px")}}</p>

<h2 id="Specifications" name="Specifications">仕様書</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">仕様書</th>
   <th scope="col">状態</th>
   <th scope="col">備考</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName("CSS Masks", "#the-mask-composite", "mask-composite")}}</td>
   <td>{{Spec2("CSS Masks")}}</td>
   <td>初回定義</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>

<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div>

<p>{{Compat("css.properties.mask-composite")}}</p>