キャンバス API

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

キャンバス API (Canvas API) は JavaScriptHTML<canvas> 要素によってグラフィックを描く方法を提供します。他にも、アニメーション、ゲームのグラフィック、データの可視化、写真加工、リアルタイム動画処理などに使用することができます。

キャンバス API は全体的に 2D グラフィックを対象としています。 WebGL API は、こちらも <canvas> 要素を使用して、ハードウェアで高速化された 2D および 3D グラフィックを描きます。

基本的な例

この単純な例は、キャンバス上に緑の四角形を描きます。

HTML

html
<canvas id="canvas"></canvas>

JavaScript

Document.getElementById() メソッドで、 HTML の <canvas> 要素への参照を取得します。次に、 HTMLCanvasElement.getContext() メソッドで要素のコンテキストを取得します。 — ここに描画されたものが表示されます。

実際の描画は CanvasRenderingContext2D インターフェイスを用いて行われます。 fillStyle プロパティは四角形を緑にします。 fillRect() メソッドはこれを左上から (10, 10) の位置で、幅 150 単位、高さ 100 単位の寸法を与えます。

js
const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");

ctx.fillStyle = "green";
ctx.fillRect(10, 10, 150, 100);

結果

リファレンス

メモ: WebGLRenderingContext に関するインターフェイスは、WebGL に掲載しています。

メモ: OffscreenCanvas はウェブワーカーでも利用できます。

CanvasCaptureMediaStreamTrack は関連するインターフェイスです。

ガイドとチュートリアル

キャンバスのチュートリアル

キャンバス API の基本的な使いかたと高度な機能の両方をカバーする網羅的なチュートリアル。

HTML5 Canvas Deep Dive

キャンバス API および WebGL の実践的な書籍規模の入門です。

Canvas Handbook

キャンバス API の手軽なリファレンス。

キャンバスを使用した動画の操作

<video><canvas> を組み合わせて、動画データをリアルタイムに操作します。

ライブラリー

キャンバス API はとても強力ですが、簡単に利用できるとは限りません。以下に挙げたライブラリーは、キャンバスベースのプロジェクトの作成をより速くより手軽にできるようにします。

  • EaselJS: ゲームやアート作品、その他の高度なグラフィック操作を容易にする、オープンソースのキャンバスライブラリー
  • Fabric.js: SVG のパース機能を持つ、オープンソースのキャンバスライブラリー
  • heatmap.js: キャンバスベースのデータヒートマップを生成するためのオープンソースライブラリー
  • JavaScript InfoVis Toolkit: 対話的なデータの可視化を実現
  • Konva.js: デスクトップおよびモバイルアプリケーション向けの 2D キャンバスライブラリー
  • p5.js: アーティスト、デザイナー、教育者、初心者のためのフル機能を持ったキャンバス描画機能
  • Paper.js: HTML キャンバス上で動作する、オープンソースのベクターグラフィック向けスクリプトフレームワーク
  • Phaser: ブラウザーゲームを強力にするキャンバスと WebGL の軽量、フリーで楽しいオープンソースフレームワーク
  • Pts.js: キャンバスと SVG の創造的なコーディングや視覚化のためのライブラリー
  • Rekapi: キャンバス用のアニメーションキーフレーム API
  • Scrawl-canvas: 2D キャンバス要素を作成したり操作したりするためのオープンソースの JavaScript ライブラリーです。
  • ZIM: 便利でキャンバス上のコンポーネントとコーディングの創造性の制御を提供し、アクセシビリティと数百のカラフルなチュートリアルがあります。
  • Sprig は、キャンバスを使用する、初心者に優しいオープンソースのタイルベースのゲーム開発ライブラリです。

メモ: WebGL を使用する 2D および 3D のライブラリーについては WebGL API を参照してください。

仕様書

Specification
HTML Standard
# the-canvas-element

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
canvas
height
moz-opaque
DeprecatedNon-standard
width

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.
See implementation notes.

関連情報