2 files changed, 172 insertions, 0 deletions
diff --git a/files/zh-cn/web/api/textmetrics/index.html b/files/zh-cn/web/api/textmetrics/index.html
new file mode 100644
index 0000000000..97f5a5fa5a
--- /dev/null
+++ b/files/zh-cn/web/api/textmetrics/index.html
@@ -0,0 +1,71 @@
+---
+title: TextMetrics
+slug: Web/API/TextMetrics
+translation_of: Web/API/TextMetrics
+---
+<div>{{APIRef("Canvas API")}}</div>
+
+<p><code><font face="Open Sans, Arial, sans-serif"><span style="font-weight: normal;">在 canvas 中，</span></font>TextMetrics</code> 接口表示文本的尺寸，通过 {{domxref("CanvasRenderingContext2D.measureText()")}} 方法创建。</p>
+
+<h2 id="属性">属性</h2>
+
+<dl>
+ <dt>{{domxref("TextMetrics.width")}} {{readonlyInline}}</dt>
+ <dd><strong>double </strong>类型，使用 CSS 像素计算的内联字符串的宽度。基于当前上下文字体考虑。</dd>
+ <dt>{{domxref("TextMetrics.actualBoundingBoxLeft")}} {{readonlyInline}}</dt>
+ <dd><strong>double</strong> 类型，平行于基线，从{{domxref("CanvasRenderingContext2D.textAlign")}} 属性确定的对齐点到文本矩形边界左侧的距离，使用 CSS 像素计算。</dd>
+ <dt>{{domxref("TextMetrics.actualBoundingBoxRight")}} {{readonlyInline}}</dt>
+ <dd><strong>double</strong> 类型，平行于基线，从{{domxref("CanvasRenderingContext2D.textAlign")}} 属性确定的对齐点到文本矩形边界右侧的距离，使用 CSS 像素计算。</dd>
+ <dt>{{domxref("TextMetrics.fontBoundingBoxAscent")}} {{readonlyInline}}</dt>
+ <dd><strong>double</strong> 类型，从{{domxref("CanvasRenderingContext2D.textBaseline")}} 属性标明的水平线到渲染文本的所有字体的矩形最高边界顶部的距离，使用 CSS 像素计算。</dd>
+ <dt>{{domxref("TextMetrics.fontBoundingBoxDescent")}} {{readonlyInline}}</dt>
+ <dd><strong>double</strong> 类型，从{{domxref("CanvasRenderingContext2D.textBaseline")}} 属性标明的水平线到渲染文本的所有字体的矩形边界最底部的距离，使用 CSS 像素计算。</dd>
+ <dt>{{domxref("TextMetrics.actualBoundingBoxAscent")}} {{readonlyInline}}</dt>
+ <dd><strong>double</strong> 类型，从{{domxref("CanvasRenderingContext2D.textBaseline")}} 属性标明的水平线到渲染文本的矩形边界顶部的距离，使用 CSS 像素计算。</dd>
+ <dt>{{domxref("TextMetrics.actualBoundingBoxDescent")}} {{readonlyInline}}</dt>
+ <dd><strong>double</strong> 类型，从{{domxref("CanvasRenderingContext2D.textBaseline")}} 属性标明的水平线到渲染文本的矩形边界底部的距离，使用 CSS 像素计算。</dd>
+ <dt>{{domxref("TextMetrics.emHeightAscent")}} {{readonlyInline}}</dt>
+ <dd><strong>double</strong> 类型，从{{domxref("CanvasRenderingContext2D.textBaseline")}} 属性标明的水平线到线框中 <em>em</em> 方块顶部的距离，使用 CSS 像素计算。</dd>
+ <dt>{{domxref("TextMetrics.emHeightDescent")}} {{readonlyInline}}</dt>
+ <dd><strong>double</strong> 类型，从{{domxref("CanvasRenderingContext2D.textBaseline")}} 属性标明的水平线到线框中 <em>em</em> 方块底部的距离，使用 CSS 像素计算。</dd>
+ <dt>{{domxref("TextMetrics.hangingBaseline")}} {{readonlyInline}}</dt>
+ <dd><strong>double</strong> 类型，从{{domxref("CanvasRenderingContext2D.textBaseline")}} 属性标明的水平线到线框的 hanging 基线的距离，使用 CSS 像素计算。</dd>
+ <dt>{{domxref("TextMetrics.alphabeticBaseline")}} {{readonlyInline}}</dt>
+ <dd><strong>double</strong> 类型，从{{domxref("CanvasRenderingContext2D.textBaseline")}} 属性标明的水平线到线框的 alphabetic 基线的距离，使用 CSS 像素计算。</dd>
+ <dt>{{domxref("TextMetrics.ideographicBaseline")}} {{readonlyInline}}</dt>
+ <dd><strong>double</strong> 类型，从{{domxref("CanvasRenderingContext2D.textBaseline")}} 属性标明的水平线到线框的 ideographic 基线的距离，使用 CSS 像素计算。</dd>
+</dl>
+
+<h2 id="Specifications" name="Specifications">规范描述</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">Specification</th>
+   <th scope="col">Status</th>
+   <th scope="col">Comment</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('HTML WHATWG', "the-canvas-element.html#textmetrics", "TextMetrics")}}</td>
+   <td>{{Spec2('HTML WHATWG')}}</td>
+   <td>Initial definition</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="浏览器兼容性">浏览器兼容性</h2>
+
+<div class="hidden">
+<p>The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p>
+</div>
+
+<p>{{Compat("api.TextMetrics")}}</p>
+
+<h2 id="参见">参见</h2>
+
+<ul>
+ <li>创建方法在 {{domxref("CanvasRenderingContext2D")}} 中。</li>
+ <li>The {{HTMLElement("canvas")}} element and its associated interface, {{domxref("HTMLCanvasElement")}}</li>
+</ul>
diff --git a/files/zh-cn/web/api/textmetrics/width/index.html b/files/zh-cn/web/api/textmetrics/width/index.html
new file mode 100644
index 0000000000..9ddc4e35bb
--- /dev/null
+++ b/files/zh-cn/web/api/textmetrics/width/index.html
@@ -0,0 +1,101 @@
+---
+title: TextMetrics.width
+slug: Web/API/TextMetrics/width
+translation_of: Web/API/TextMetrics/width
+---
+<div>{{APIRef("Canvas API")}}</div>
+
+<p>只读的 <code><strong>TextMetrics</strong></code><strong><code><span>.width</span></code></strong> 属性，包含文本先前的宽度（行内盒子的宽度），使用 CSS 像素计算。</p>
+
+<h2 id="Syntax" name="Syntax">语法</h2>
+
+<pre class="syntaxbox"><var>readonly <em>metrics</em></var>.width;</pre>
+
+<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;highlight:[5]">var canvas = document.getElementById("canvas");
+var ctx = canvas.getContext("2d");
+
+var text = ctx.measureText("foo"); // TextMetrics object
+text.width; // 16;
+</pre>
+
+<h2 id="规范描述">规范描述</h2>
+
+<table class="standard-table">
+ <tbody>
+  <tr>
+   <th scope="col">Specification</th>
+   <th scope="col">Status</th>
+   <th scope="col">Comment</th>
+  </tr>
+  <tr>
+   <td>{{SpecName('HTML WHATWG', "scripting.html#dom-textmetrics-width", "TextMetrics.width")}}</td>
+   <td>{{Spec2('HTML WHATWG')}}</td>
+   <td> </td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="浏览器兼容性">浏览器兼容性</h2>
+
+<div>{{CompatibilityTable}}</div>
+
+<div id="compat-desktop">
+<table class="compat-table">
+ <tbody>
+  <tr>
+   <th>Feature</th>
+   <th>Chrome</th>
+   <th>Firefox (Gecko)</th>
+   <th>Internet Explorer</th>
+   <th>Opera</th>
+   <th>Safari</th>
+  </tr>
+  <tr>
+   <td>Basic support</td>
+   <td>4.0</td>
+   <td>{{CompatGeckoDesktop("1.8")}}</td>
+   <td>9.0</td>
+   <td>9.0</td>
+   <td>3.1</td>
+  </tr>
+ </tbody>
+</table>
+</div>
+
+<div id="compat-mobile">
+<table class="compat-table">
+ <tbody>
+  <tr>
+   <th>Feature</th>
+   <th>Android</th>
+   <th>Firefox Mobile (Gecko)</th>
+   <th>IE Mobile</th>
+   <th>Opera Mobile</th>
+   <th>Safari Mobile</th>
+  </tr>
+  <tr>
+   <td>Basic support</td>
+   <td>2.1</td>
+   <td>{{CompatGeckoMobile("1.8")}}</td>
+   <td>{{CompatUnknown}}</td>
+   <td>10.0</td>
+   <td>3.2</td>
+  </tr>
+ </tbody>
+</table>
+</div>
+
+<h2 id="参见">参见</h2>
+
+<ul>
+ <li>{{domxref("TextMetrics")}}</li>
+</ul>