---
title: CanvasRenderingContext2D.measureText()
slug: Web/API/CanvasRenderingContext2D/measureText
tags:
  - API
  - Canvas
  - CanvasRenderingContext2D
  - Method
  - Reference
  - Référence(2)
translation_of: Web/API/CanvasRenderingContext2D/measureText
---
<div>{{APIRef}}</div>

<p><code><strong>CanvasRenderingContext2D.measureText()</strong></code> メソッドは、測定したテキストの情報 (例えば幅など) を持つ {{domxref("TextMetrics")}} オブジェクトを返します。</p>

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

<pre class="syntaxbox">TextMetrics <var><em>ctx</em></var>.measureText(text);</pre>

<h3 id="引数">引数</h3>

<dl>
 <dt>text</dt>
 <dd>測定する文字列。</dd>
</dl>

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

<p>{{domxref("TextMetrics")}} オブジェクト。</p>

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

<p>以下の {{HTMLElement("canvas")}} 要素があるとします:</p>

<pre class="brush: html">&lt;canvas id="canvas"&gt;&lt;/canvas&gt;
</pre>

<p>以下のコードを使用して {{domxref("TextMetrics")}} オブジェクトを得ることができます:</p>

<pre class="brush: js">var canvas = document.getElementById('canvas');
var ctx = canvas.getContext('2d');

var text = ctx.measureText("foo"); // TextMetrics オブジェクト
text.width; // 16;
</pre>

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

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">仕様書</th>
   <th scope="col">策定状況</th>
   <th scope="col">コメント</th>
  </tr>
  <tr>
   <td>{{SpecName('HTML WHATWG', "scripting.html#dom-context-2d-measuretext", "CanvasRenderingContext2D.measureText")}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td> </td>
  </tr>
 </tbody>
</table>

<h2 id="ブラウザ実装状況">ブラウザ実装状況</h2>



<p>{{Compat("api.CanvasRenderingContext2D.measureText")}}</p>

<h2 id="関連情報">関連情報</h2>

<ul>
 <li>このメソッドを定義するインターフェイスである {{domxref("CanvasRenderingContext2D")}}</li>
 <li>{{domxref("TextMetrics")}}</li>
</ul>