الفرق بين المراجعتين لصفحة: «HTML/audio»
طلا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط ←بطاقة العنصر: : تصحيح جملة عبر نفيها ضمن الجدول |
||
| (مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:العنصر <code><audio></code>}}</noinclude> | <noinclude>{{DISPLAYTITLE:العنصر <code><audio></code>}}</noinclude> | ||
يُستعمَل العنصر <code><audio></code> لتضمين المحتوى الصوتي في المستندات، وقد يحتوي على ملف مصدري واحد أو أكثر التي تُمثَّل باستخدام الخاصية <code>src</code> أو عبر العنصر <code><nowiki><source></nowiki></code>، وسيختار المتصفح أنسب الملفات الصوتية لتشغيلها. | يُستعمَل العنصر <code><audio></code> لتضمين المحتوى الصوتي في المستندات، وقد يحتوي على ملف مصدري واحد أو أكثر التي تُمثَّل باستخدام الخاصية <code>src</code> أو عبر العنصر <code><nowiki><source></nowiki></code>، وسيختار المتصفح [[HTML/Media Formats|أنسب الملفات الصوتية لتشغيلها]]. | ||
المثال الآتي يستخدم العنصر <code><audio></code> مع الخاصية <code>[[#autoplay|autoplay]]</code> لتشغيل الصوت تلقائيًا مع تحديد رابط URL للملف المصدري عبر الخاصية <code>src</code>: | المثال الآتي يستخدم العنصر <code><audio></code> مع الخاصية <code>[[#autoplay|autoplay]]</code> لتشغيل الصوت تلقائيًا مع تحديد رابط URL للملف المصدري عبر الخاصية <code>src</code>: | ||
| سطر 22: | سطر 22: | ||
|- | |- | ||
! scope="row" | المحتوى المسموح | ! scope="row" | المحتوى المسموح | ||
| إذا كان للعنصر الخاصية <code>src</code> فيمكن أن يحتوي على عنصر <code>[[HTML/track|<track>]]</code> واحد أو أكثر يتبعه محتوى عادي لا يتضمن العنصرين <code><audio></code> و <code>[[HTML/video|<video>]]</code>. | | إذا كان للعنصر الخاصية <code>src</code>، فيمكن أن يحتوي على عنصر <code>[[HTML/track|<track>]]</code> واحد أو أكثر يتبعه محتوى عادي لا يتضمن العنصرين <code><audio></code> و <code>[[HTML/video|<video>]]</code>. | ||
أما إذا | أما إذا لم يكن له الخاصية <code>src</code>، فيمكن أن يحتوي على عنصر <code>[[HTML/source|<nowiki><source></nowiki>]]</code> واحد أو أكثر، يتبعه عنصر <code>[[HTML/track|<track>]]</code> واحد أو أكثر ويتبعه محتوى عادي لا يتضمن العنصر <code><audio></code> و <code>[[HTML/video|<video>]]</code>. | ||
|- | |- | ||
! scope="row" | الوسم المختصر | ! scope="row" | الوسم المختصر | ||
المراجعة الحالية بتاريخ 08:35، 4 يناير 2019
يُستعمَل العنصر <audio> لتضمين المحتوى الصوتي في المستندات، وقد يحتوي على ملف مصدري واحد أو أكثر التي تُمثَّل باستخدام الخاصية src أو عبر العنصر <source>، وسيختار المتصفح أنسب الملفات الصوتية لتشغيلها.
المثال الآتي يستخدم العنصر <audio> مع الخاصية autoplay لتشغيل الصوت تلقائيًا مع تحديد رابط URL للملف المصدري عبر الخاصية src:
<audio src="khamsat.mp3" autoplay>
لا يدعم متصفحك العنصر <code>audio</code>.
</audio>
أما المثال الآتي ففيه العنصر <audio> مع استخدام خاصية controls لإضافة أزرار للتحكم بالمقطع، وسيُحدَّد رابط URL للمقطع عبر العنصر <source>:
<audio controls="controls">
<source src="khamsat.ogg" type="audio/ogg">
<source src="khamsat.mp3" type="audio/mpeg">
لا يدعم متصفحك العنصر <code>audio</code>.
</audio>
بطاقة العنصر
| تصنيفات المحتوى | عنصر تنظيمي أو عنصر عادي أو عنصر يحتوي وسائط مضمّنة أو عنصر تفاعلي. |
|---|---|
| المحتوى المسموح | إذا كان للعنصر الخاصية src، فيمكن أن يحتوي على عنصر <track> واحد أو أكثر يتبعه محتوى عادي لا يتضمن العنصرين <audio> و <video>.
أما إذا لم يكن له الخاصية |
| الوسم المختصر | لا يمكن حذف أيّ من وسمَي البداية أو النهاية. |
| العناصر الأب | أي عنصر يقبل العناصر التضمينية. |
| واجهة DOM | HTMLAudioElement
|
دعم المتصفحات
| Chrome | Firefox | Edge | Safari | Opera |
|---|---|---|---|---|
| مدعوم | مدعوم | مدعوم | مدعوم | مدعوم |
بعض الخاصيات المُضافة حديثًا في HTML5 لا تعمل في جميع المتصفحات.
الخاصيات
يمكن استخدام الخاصيات العامة في هذا العنصر.
autoplay
هذه الخاصية منطقية (Boolean) وإذا اُستعملت (حتى لو كانت قيمتها "false"!) فسيبدأ تشغيل المقطع الصوتي في أسرع وقت ممكن، دون الانتظار حتى يكتمل تنزيل الملف الصوتي كله.
لاحظ أنَّ المواقع التي تُشغِّل الصوت تلقائيًا (أو تُشغِّل مقاطع الفيديو التي لها صوت) يمكن أن تزعج المستخدمي، لذا يجب تفادي استخدام هذه الخاصية إلا عند الضرورة، وإذا كان لا بُدّ فيجب أن تجعل هذه الميزة اختيارية وتطلب من المستخدم تفعيله. لكن قد تستفيد من هذه الميزة لو كان الغرض الرئيسي من الصفحة هو تشغيل مقطع صوتي معيّن.
buffered
خاصية قابلة للقراءة لتحديد ما هي المجالات التي نُزِّلَت من المقطع الصوتي، إذ تحتوي هذه الخاصية على كائن TimeRanges.
controls
إذا كان هذه الخاصية موجودة، فسيوفر المتصفح عناصر تحكم ليسمح عبرها للمستخدم بالتحكم بتشغيل الصوت، بما في ذلك مستوى الصوت والانتقال إلى مواضع مختلفة في المقطع الصوتي والإيقاف المؤقت والتشغيل...
loop
هذه الخاصية منطقية (Boolean)، فإن كانت موجودةً فسيُعاد تشغيل المقطع من البداية بعد الوصول إلى نهايته.
المثال الآتي يستخدم العنصر <audio> مع الخاصية loop لإعادة تشغيل المقطع بعد انتهائه:
<audio src="khamsat.mp3" controls="controls" loop="loop">
لا يدعم متصفحك العنصر <code>audio</code>.
</audio>
muted
هذه الخاصية منطقية (Boolean) تُشير إذا ما كان المقطع مكتوم الصوت بادئ الأمر. القيمة الافتراضية هي false.
المثال الآتي يستخدم العنصر <audio> مع الخاصية mute لكتم الصوت تلقائيًا:
<audio src="khamsat.mp3" controls="controls" muted="muted">
لا يدعم متصفحك العنصر <code>audio</code>.
</audio>
played
هذه الخاصية قابلة للقراءة وتحتوي على كائن TimeRanges الذي يُشير إلى المجالات التي شغّلها المستخدم من المقطع الصوتي.
preload
الغرض من هذه الخاصية هو إعطاء المتصفح فكرة عمّا يظنه مطور الصفحة أفضل لتجربة المستخدم، وتأخذ إحدى القيم الآتية:
none: يجب ألّا يُحمَّل المقطع الصوتي مسبقًا.metadata: يجب أن تُحمَّل البيانات الوصفية (مثل طول المقطع) فقط.auto: تُشير إلى أنَّ المقطع الصوتي يمكن أن يُحمَّل حتى لو كان من المتوقع ألّا يشغله المستخدم.- إذا كانت القيمة هي سلسلة نصية فارغة فهي تكافئ الخاصية auto.
إذا لم تُضبَط قيمة هذه الخاصية، فستؤخذ القيمة الافتراضية من المتصفح (ولكل متصفح قيمة افتراضية خاصة به)، لكن تنصح المواصفة المتصفحات أن تكون القيمة الافتراضية هي metadata.
لاحظ أنَّ الخاصية autoplay لها أولوية على الخاصية preload، فلو حُدِّدَت الخاصية autoplay فمن المنطقي أن يبدأ المتصفح تنزيل المقطع الصوتي مباشرةً.
يجدر بالذكر أنَّ المواصفة لم تُجبِر المتصفح على اتباع قيمة هذه الخاصية، فهي مجرد تلميحة عمّا يريده مطوِّر الصفحة.
المثال الآتي يستخدم العنصر <audio> مع الخاصية preload للطلب من المتصفح ألّا يحمّل المقطع الصوتي عند تحميل الصفحة:
<audio src="example.ogg" preload="none">
Your browser does not support the <code>audio</code> element.
</audio>
src
تحتوي هذه الخاصية على رابط URL للملف الصوتي الذي سيُحمَّل، وهذه الخاصية اختيارية، ويمكنك استخدام العنصر <source> داخل العنصر <audio> لتحديد رابط URL للمقطع (أو المقاطع) الصوتية التي ترغب في تضمينها.
volume
مستوى الصوت التي سيُشغَّل فيه المقطع، ويتراوح بين 0.0 (صامت) إلى 1.0 (أعلى مستوى).
ملاحظات الاستخدام
يمكن إضافة المحتوى البديل للمتصفحات التي لا تدعم العنصر <audio> بين وسم البداية <audio> ووسم الإغلاق </audio>.
أبسط طريقة لإضافة عناصر التحكم هي باستخدام خاصية controls (انظر قسم الأمثلة)؛ ولإضافة عناصر تحكم متقدمة، فيمكن ذلك عبر Medial API.
يمكنك أيضًا استخدام Web Audio API لتوليد الصوت أو تعديله عبر JavaScript.
وصحيحٌ أنَّ بإمكان عنصر <video> عرض الترجمات المُصاحبة للمقطع (subtitles) عبر العنصر <track>، لكن عناصر <audio> لا تستطيع فعل ذلك، وسيتم تجاهل أيّ عنصر <track> ضمن وسم البداية <audio> ووسم الإغلاق </audio>.
مصادر ومواصفات
- معيار HTML Living Standard.
- مواصفة HTML5.