Interfejs HTMLCanvasElement zapewnia własności i metody pozwalające na manipulację wygladem i prezentacją elementów canvas. Dodatkowo HTMLCanvasElement dziedziczy własności i metody interfejsu HTMLElement.
Własności
Własności dziedziczone są od rodzica, HTMLElement
.
HTMLCanvasElement.height
- Wyrażany w dodatniej
liczbie całkowitej
odpowiada za atrybutheight
elemetu HTML<canvas>
i jest interpretowany w pikselach CSS. Jeśli atrybut nie został określony, lub została przypisana do niego nieprawidłowa wartość, np. negatywna, zostanie użyta domyślna wartość150
. HTMLCanvasElement.width
- Wyrażany w dodatniej
liczbie całkowitej
odpowiada za atrybutwidth
elemetu HTML<canvas>
i jest interpretowany w pikselach CSS. Jeśli atrybut nie został określony, lub została przypisana do niego nieprawidłowa wartość, np. negatywna, zostanie użyta domyślna wartość300
.
Metody
Metody dziedziczone są od rodzica, HTMLElement
.
HTMLCanvasElement.captureStream()
- Zwraca
CanvasCaptureMediaStream
, który jest wideo w czasie rzeczywistym z powierzchni elementu<canvas>
. HTMLCanvasElement.getContext()
- Zwraca pole robocze elementu
<canvas>
, lub null jeśli kontekst nie jest wspierany. Pole robocze pozwala na rysowanie na<canvas>
. Wywołanie getContext z atrybutem"2d"
zwraca obiektCanvasRenderingContext2D
, natomiast wywołanie z"webgl"
(lub"experimental-webgl"
) zwróci obiektWebGLRenderingContext
. Ten kontekst jest dostepny tylko w przeglądarkach obsługujących WebGL.
HTMLCanvasElement.toDataURL()
- Zwraca data-URL reprezentujacy obraz w formacie określonym przez parametr
type
(domyślniepng
). Zwracany obraz jest w rozdzielczości 96dpi. HTMLCanvasElement.toBlob()
- Tworzy obiekt
Blob
reprezentujący obraz zawierający się w<canvas>
; ten plik może być buforowany z dysku lub przechowywany w pamięci wedle uznaniauser agent
. HTMLCanvasElement.transferControlToOffscreen()
- Przenosi kontrolę do obiektu
OffscreenCanvas
, w głównym wątku lub w module roboczym. HTMLCanvasElement.mozGetAsFile()
- Zwraca obiekt
File
reprezentujący obraz zawarty w<canvas>
; plik oparty jest na pamięci, posiada określonąnazwę
. Jeślityp
nie został okreslony, domyslnie jest toimage/png
.
Specyfikacja
Specyfikacja | Status | Komentarz |
---|---|---|
Media Capture from DOM Elements The definition of 'HTMLCanvasElement' in that specification. |
Working Draft |
Dodano metodę |
HTML Living Standard The definition of 'HTMLCanvasElement' in that specification. |
Living Standard |
Metoda Dodano metodę |
HTML 5.1 The definition of 'HTMLCanvasElement' in that specification. |
Recommendation | |
HTML5 The definition of 'HTMLCanvasElement' in that specification. |
Recommendation | Definicja początkowa. |
Zgodność przegladarek
BCD tables only load in the browser
Zobacz też
- HTML element implementing this interface:
<canvas>
.