--- title: الواجهة البرمجية لرقعة الرسم slug: Web/API/Canvas_API tags: - API - رقعة رسم - مرجع - نظرة عامة translation_of: Web/API/Canvas_API ---
{{CanvasSidebar}}

في HTML5، أُضيف عنصر HTML ‏{{HTMLElement("canvas")}} والذي يمكن استخدامه لرسم الرسوميات ببرمجتها عبر جافاسكربت. فمثلا، يمكن استخدامها لرسم الرسوم البيانية، أو تراكبات الصور، أو إنشاء الحركات أو حتى معالجة الفديوهات آنيا وتصييرها.

حصلت تطبيقات موزيلا على دعم <canvas> بدءًا من إصدارة جيكو رقم ١٫٨ (أي فَيَرفُكس ١٫٥). طُوّر هذا العنصر على يد شركة آبل للوحة أوإس إكس وسفاري. يدعم إنترنت إكسبلورر <canvas> بدءًا من الإصدارة التاسعة فما فوق، بينما الإصدارات الأقدم منه تحتاج سكربتا ليعمل عنصر رقعة الرسم بكفاءة، هذا السكربت هو من مشروع جوجل باسم Explorer Canvas. يدعم جوجل كروم وأوبرا ٩ عتصر <canvas> أيضا.

يُستخدم عنصر <canvas> في تقنية WebGL أيضا لرسم الرسومات ثلاثية الأبعاد على صفحات الوب بتسريع عتادي.

مثال

هذه عيّنة مقتطفة من كود يستخدم طريقة {{domxref("CanvasRenderingContext2D.fillRect()")}}.

HTML

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

جافاسكربت

var canvas = document.getElementById('canvas');
var ctx = canvas.getContext('2d');

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

حرّر الكود أدناه لترى التغييرات تحدث آنيا في رقعة الرسم:

{{ EmbedLiveSample('Playable_code', 700, 360) }}

المرجع

الواجهات المتعلقة بِ‍ WebGLRenderingContext مذكورة في مرجع WebGL.

واجهة {{domxref("CanvasCaptureMediaStream")}} لها علاقة أيضا.

الأدلة والدروس

درس رقعة الرسم
درس شامل يغطي كلا من الاستخدام البسيط لرقعة الرسم <canvas> وأيضا مزاياها المتقدمة.
مقتطفات من كود: رقعة الرسم
بعض المقتطفات المخصصة لمطوري الامتدادات والتي تستخدم  <canvas>.
Demo: A basic ray-caster
عرض لحركة تعقّب الأشعة باستخدام رقعة الرسم.
رسم كائنات DOM في رقعة رسم
طريقة رسم محتوى DOM (مثل عناصر HTML) في رقعة رسم.
التعديل على الفديو باستخدام رقعة الرسم
يمكنك بدمج {{HTMLElement("video")}} و{{HTMLElement("canvas")}} التلاعب والتعديل على الفديو آنيا.

الموارد

عامة

المكتبات

المواصفات

المواصفة الحالة تعليق
{{SpecName('HTML WHATWG', 'scripting.html#the-canvas-element', '<canvas>')}} {{Spec2('HTML WHATWG')}}  

طالع أيضا