---
title: PointerEvent.isPrimary
slug: Web/API/PointerEvent/isPrimary
tags:
  - API
  - DOM
  - Interface
  - PointerEvent
  - Property
  - Reference
translation_of: Web/API/PointerEvent/isPrimary
---
<div>{{ APIRef("Pointer Events") }}</div>

<p><span class="seoSummary">{{domxref("PointerEvent")}} インターフェイスの <strong><code>isPrimary</code></strong> 読み取り専用プロパティは、イベントを作成したポインタデバイスが<em>プライマリ</em>ポインタであるかどうかを示します。</span> イベントの発生原因となったポインタがプライマリデバイスの場合は <code>true</code> を返し、それ以外の場合は <code>false</code> を返します。</p>

<p>マルチポインタのシナリオ（複数のタッチ点をサポートするタッチ画面など）では、このプロパティを使用して、各ポインタタイプのアクティブポインタのセットから<em>マスタポインタ</em>を識別します。 プライマリポインタのみが<em>互換性マウスイベント</em>を生成します。 単一のポインタによる相互作用のみを希望する作成者は、非プライマリポインタを無視することによってそれを達成することができます。</p>

<p>マウスデバイスを表すポインタの場合、ポインタはプライマリと見なされます。 ペン入力を表す他のアクティブポインタが存在しないときに、その {{event("pointerdown")}} イベントが送出された場合、ペン入力を表すポインタはプライマリペン入力と見なされます。 タッチ入力を表す他のアクティブポインタが存在しないときに、その {{event("pointerdown")}} イベントが送出された場合、タッチ入力を表すポインタはプライマリタッチ入力と見なされます。</p>

<p>2つ以上のポインタデバイスタイプが同時に使用されている場合、複数のポインタ（各 {{domxref("PointerEvent.pointerType", "pointerType")}} に1つ）がプライマリと見なされます。 例えば、タッチ接触とマウスカーソルが同時に動かされると、両方ともプライマリと見なされるポインタが生成されます。 複数のプライマリポインタがある場合、これらのポインタはすべて<em>互換性マウスイベント</em>を生成します（ポインタ、マウス、およびタッチの相互作用の詳細については、{{domxref("Pointer events")}} を参照）。</p>

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

<pre class="syntaxbox">var <em>isPrimary</em> = <em>pointerEvent</em>.isPrimary;
</pre>

<h3 id="Return_value" name="Return_value">戻り値</h3>

<dl>
 <dt><code>isPrimary</code></dt>
 <dd>このイベントのポインタがプライマリポインタの場合は <code>true</code> を返し、そうでない場合は <code>false</code> を返します。</dd>
</dl>

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

<p>この例は、<code>isPrimary</code> の値を使用して適切な処理関数を呼び出す方法を示しています。</p>

<pre class="brush: js">target.addEventListener('pointerdown', function(event) {
   if (event.isPrimary)
     process_primary_pointer(event);
   else
     process_secondary_pointer(event);
 }, false);
</pre>

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

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">仕様</th>
   <th scope="col">状態</th>
   <th scope="col">コメント</th>
  </tr>
  <tr>
   <td>{{SpecName('Pointer Events 2','#widl-PointerEvent-isPrimary', 'isPrimary')}}</td>
   <td>{{Spec2('Pointer Events 2')}}</td>
   <td>不安定版</td>
  </tr>
  <tr>
   <td>{{SpecName('Pointer Events', '#widl-PointerEvent-isPrimary', 'isPrimary')}}</td>
   <td>{{Spec2('Pointer Events')}}</td>
   <td>初期定義</td>
  </tr>
 </tbody>
</table>

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

<p>{{Compat("api.PointerEvent.isPrimary")}}</p>