このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
キャンバスの基本的な使い方
このチュートリアルを、<canvas> というHTML の要素を見てみることから始めましょう。このページの最後では、ブラウザーでキャンバス 2D コンテキストの設定し、最初の例を描画する方法を学びます。
<canvas> 要素
<canvas width="150" height="150"></canvas>一見すると、<canvas> は<img> 要素と似ていますが、src 属性とalt 属性がない点が明確に異なります。一方、<canvas> にはwidth とheight の 2 つの属性のみがあります。これらはどちらもオプションで、DOMプロパティを用いて設定することもできます。を利用できます。width 属性とheight 属性が指定されていない場合、キャンバスは幅300 ピクセル、高さ150 ピクセルで初期化されます。要素の大きさはCSS で変更できますが、画像を描画される際にはそのレイアウト上の大きさに合わせて拡縮されます。 CSS での大きさは初期のキャンバスの比率を考慮しないため、歪んで表示されることになります。
メモ:画像が歪んでいると感じた時は、 CSS を使用するのではなく、width およびheight 属性を<canvas> の属性に明示的に指定してください。
id は<canvas> 要素に固有の属性ではありませんが、HTML のグローバル属性の一つで、（class のように）すべての HTML 要素に適用することができます。常にid を設定するようにすると、スクリプトから要素を特定しやすくなります。
<canvas> 要素は通常の画像と同じようにスタイル付けすることができます（margin、border、background など）。しかし、これらのルールは、実際にキャンバス上に描画されるものには影響しません。これをどう扱うかについては、このチュートリアルの専用の章で紹介します。スタイルのルールが何も適用されていない場合、キャンバスは完全に透明なものとして描画されます。
アクセシブルコンテンツ
<canvas> 要素は、<img>、<video>、<audio>、<picture> 要素と同様に、メディアが読み込まれなかったり、ユーザーが意図通りに使いこなすことができなかったりした場合に表示される代替テキストを提供することで、アクセシビリティを確保しなければなりません。その種類のメディアに合った代替コンテンツ、キャプション、代替テキストを常に提供しなければなりません。
代替コンテンツを提供する方法はとても直観的です。<canvas> 要素の中にコンテンツを挿入するだけで、画面リーダーやスパイダー、他にも自動化されたボットがアクセスします。既定では、ブラウザーはコンテナーの中にあるコンテンツを無視し、<canvas> が対応していない場合を除き、キャンバスを正常にレンダリングします。
例えば、キャンバスの内容を説明するテキストを提供したり、動的に描画されるコンテンツの静的な画像を提供したりすることができます。次のようになります。
<canvas width="150" height="150"> 現在の株価: $3.15 + 0.15</canvas><canvas width="150" height="150"> <img src="images/clock.png" width="150" height="150" alt="時計" /></canvas>キャンバスに対応しているさまざまなブラウザーで使用するように指示しても、キャンバスをまったく読めないユーザーの助けにはなりません。有益な代替テキストまたは部分 DOM を使用することで、アクセスできない要素にアクセシビリティが追加されます。
</canvas> タグが必要
代替コンテンツを内部に持つ関係上、<img> 要素と異なって<canvas> 要素は閉じタグ (</canvas>) が必須です。タグを閉じなかった場合は、残りのページ全てが代替コンテンツと見なされ、結果として表示されなくなります。
代替コンテンツが必要でない場合は、単に<canvas role="presentation" …></canvas> とすれば対応するブラウザーですべて利用することができます。これはキャンバスが純粋に表現目的である場合にのみ使用しましょう。
描画コンテキスト
<canvas> は固定された大きさの描画可能領域を作成できます。この領域は、1 つ以上の描画コンテキストとして表現され、そのコンテキストを通じて描画領域を操作します。このチュートリアルでは、二次元グラフィックスを描画するためのコンテキストについてのみ解説しますが、これ以外の描画コンテキストも存在します。例えばWebGL はOpenGL ES に基づいて、三次元グラフィックを扱います。
初期状態ではキャンバスは空です。何かを表示するには、まずスクリプトで描画コンテキストを取得する必要があります。<canvas> 要素にはgetContext() というメソッドがあり、描画コンテキストを取得したり描画機能を呼び出したりするのに使います。getContext() には 1 つの引数があり、コンテキストの種類を指定します。このチュートリアルで扱っているような二次元のグラフィックでは、"2d" を指定するとCanvasRenderingContext2D を取得することができます。
const canvas = document.getElementById("tutorial");const ctx = canvas.getContext("2d");スクリプトの最初の行では、 DOM 内から<canvas> 要素を表すノードを取得するためにdocument.getElementById() メソッドを呼び出しています。要素のノードを取得したら、getContext() メソッドを使用して描画コンテキストにアクセスすることができます。
対応しているかどうかの確認
<canvas> 要素に対応していないブラウザーでは、代替コンテンツが表示されます。スクリプトからは、getContext() メソッドの有無を調べることで、ブラウザーが対応しているかどうかを確認することができます。確認するためのコードは以下のようになります。
const canvas = document.getElementById("tutorial");if (canvas.getContext) { const ctx = canvas.getContext("2d"); // 描画するコードをここに} else { // キャンバスに未対応の場合のコードをここに}スケルトンテンプレート
ここでは、この後の例で開始点として使用する、最小限のテンプレートを紹介します。
メモ:スクリプトを HTML に埋め込むのは、よいやり方ではありません。この例では分かりやすさのために、仕方なく埋め込んでいます。
<!doctype html><html lang="ja"> <head> <meta charset="utf-8" /> <title>Canvas tutorial</title> <style> canvas { border: 1px solid black; } </style> </head> <body> <canvas width="150" height="150"></canvas> <script> function draw() { const canvas = document.getElementById("tutorial"); if (canvas.getContext) { const ctx = canvas.getContext("2d"); } } window.addEventListener("load", draw); </script> </body></html>スクリプトにはdraw() という関数が含まれており、ページの読み込みが完了したときに一度実行されます。これは文書でload イベントを待ち受けすることで実現できます。この関数、または同様の関数は、setTimeout()、setInterval()、その他のイベントハンドラーを使用した場合でも、ページが最初に読み込まれたときに限り、呼び出すことができます。
ここでは、テンプレートが実際にどのように見えるかを説明します。このように、最初は白紙の状態です。
単純な描画
まず始めに、交差する 2 つの矩形を描き、そのうちの 1 つにアルファ透過をさせる簡単な例を見てみましょう。これがどのように機能するかは、後の例でさらに詳しく見ていきましょう。
<!doctype html><html lang="ja"> <head> <meta charset="UTF-8" /> <title>キャンバスの実験</title> </head> <body> <canvas width="150" height="150"></canvas> <script type="application/javascript"> function draw() { const canvas = document.getElementById("canvas"); if (canvas.getContext) { const ctx = canvas.getContext("2d"); ctx.fillStyle = "rgb(200 0 0)"; ctx.fillRect(10, 10, 50, 50); ctx.fillStyle = "rgb(0 0 200 / 50%)"; ctx.fillRect(30, 30, 50, 50); } } draw(); </script> </body></html>この例は次のように動作します。