واحد وثمانون عنصرًا من 139 تحمل دورًا أصلًا، وإعادة كتابته غير موصى بها.

أتحتاج أصلًا إلى كتابة هذا الـrole؟

عنصر HTML

دور ARIA

لا حاجة إليه، فالعنصر يحمل هذا الدور أصلًا

وهذا ترميز صحيح لا خطأ. غير أن المواصفة تعدّ إسناد الدور الضمني للعنصر أمرًا غير موصى به، لأنه لا يضيف شيئًا وقد يتخلّف عن العنصر إن تغيّر الترميز لاحقًا.

الدور الضمني: button
يقبل: مجموعة محدّدة فقط

تقول المواصفة: Roles: checkbox , combobox , gridcell , link , menuitem , menuitemcheckbox , menuitemradio , option , radio , separator , slider , switch , tab , or treeitem . ( button is also allowed, but NOT RECOMMENDED .) Global aria-* attributes and any aria-* attributes applicable to the allowed roles. If the button is the first child of a select element: No role or aria-* attributes

أي العناصر يمنحك هذا الدور

تحمله أصلًا بلا أي سمة

button, input type=button, input type=image, input type=reset, input type=submit

تقبله إن طلبته

a with href, area without href, img, input type=image, input type=reset, input type=submit

ما يقوله الجدول في مجموعه

عنصر HTML مشمول: 139
تحمل دورًا أصلًا: 81
لا تقبل دورًا آخر: 51
قاعدتها مشروطة: 10

أنفع الأجوبة عادةً أنك لا تحتاج إلى دور البتة. فواحد وثمانون من العناصر المئة والتسعة والثلاثين تحمل دورًا أصلًا، وترويسة الجدول نفسها تقول إن كتابته في الترميز غير موصى بها: فعنصر button زرٌّ بالفعل، وh1 عنوانٌ بالفعل.

وعشرة عناصر قواعدها متعلقة بمحيطها، وهذه الصفحة تأبى أن تحكم فيها بدل أن تخمّن. فـtd وth وtr تتوقف على دور الجدول الحاوي لها، وdiv على كونه ابنًا مباشرًا لـdl، وfigure على وجود figcaption فيه.

كل عناصر الجدول

ابحث

المعروض 139 / 139

العنصر	الدور الضمني	يقبل
a with href	link	button, checkbox, menuitem, menuitemcheckbox, menuitemradio, option, radio, switch, tab, treeitem
a without href	generic	أي دور
abbr	لا شيء	أي دور
address	group	أي دور
area with href	link	لا دور سوى دوره
area without href	generic	button, link
article	article	application, document, feed, main, none, presentation, region
aside	complementary	feed, none, note, presentation, region, search
audio	لا شيء	application
autonomous custom element	لا شيء	مشروط
b	generic	أي دور
base	لا شيء	لا دور سوى دوره
bdi	generic	أي دور
bdo	generic	أي دور
blockquote	blockquote	أي دور
body	generic	لا دور سوى دوره
br	لا شيء	none, presentation
button	button	checkbox, combobox, gridcell, link, menuitem, menuitemcheckbox, menuitemradio, option, radio, separator, slider, switch, tab, treeitem
canvas	لا شيء	أي دور
caption	caption	لا دور سوى دوره
cite	لا شيء	أي دور
code	code	أي دور
col	لا شيء	لا دور سوى دوره
colgroup	لا شيء	لا دور سوى دوره
data	generic	أي دور
datalist	listbox	لا دور سوى دوره
dd	لا شيء	لا دور سوى دوره
del	deletion	أي دور
details	group	لا دور سوى دوره
dfn	term	أي دور
dialog	dialog	alertdialog
div	generic	مشروط
dl	لا شيء	group, list, none, presentation
dt	لا شيء	listitem
em	emphasis	أي دور
embed	لا شيء	application, document, img, image, none, presentation
fieldset	group	none, presentation, radiogroup
figcaption	لا شيء	group, none
figure	figure	مشروط
footer	لا شيء	group, presentation, none
form	form	none, presentation, search
form-associated custom element	لا شيء	مشروط
h1 to h6	heading	none, presentation, tab
head	لا شيء	لا دور سوى دوره
header	لا شيء	group, none, presentation
hgroup	group	أي دور
hr	separator	none, presentation
html	generic	لا دور سوى دوره
i	generic	أي دور
iframe	لا شيء	application, document, img, image, none, presentation
img	لا شيء	button, checkbox, link, math, menuitem, menuitemcheckbox, menuitemradio, meter, option, progressbar, radio, scrollbar, separator, slider, switch, tab, treeitem
img with no accessible name	لا شيء	مشروط
input type=button	button	checkbox, combobox, gridcell, link, menuitem, menuitemcheckbox, menuitemradio, option, radio, separator, slider, switch, tab, treeitem
input type=checkbox	checkbox	menuitemcheckbox, option, switch
input type=color	لا شيء	لا دور سوى دوره
input type=date	لا شيء	لا دور سوى دوره
input type=datetime-local	لا شيء	لا دور سوى دوره
input type=email with no list attribute	textbox	لا دور سوى دوره
input type=file	لا شيء	لا دور سوى دوره
input type=hidden	لا شيء	لا دور سوى دوره
input type=image	button	button, checkbox, gridcell, link, menuitem, menuitemcheckbox, menuitemradio, option, radio, separator, slider, switch, tab, treeitem
input type=month	لا شيء	لا دور سوى دوره
input type=number	spinbutton	لا دور سوى دوره
input type=password	لا شيء	لا دور سوى دوره
input type=radio	radio	menuitemradio
input type=range	slider	لا دور سوى دوره
input type=reset	button	button, checkbox, combobox, gridcell, link, menuitem, menuitemcheckbox, menuitemradio, option, radio, separator, slider, switch, tab, treeitem
input type=search , with no list attribute	searchbox	لا دور سوى دوره
input type=submit	button	button, checkbox, combobox, gridcell, link, menuitem, menuitemcheckbox, menuitemradio, option, radio, separator, slider, switch, tab, treeitem
input type=tel , with no list attribute	textbox	لا دور سوى دوره
input type=text or with a missing or invalid type , with no list attribute	textbox	combobox, searchbox, spinbutton
input type=text , search , tel , url , email , or with a missing or invalid type , with a list attribute	combobox	لا دور سوى دوره
input type=time	لا شيء	لا دور سوى دوره
input type=url with no list attribute	textbox	لا دور سوى دوره
input type=week	لا شيء	لا دور سوى دوره
ins	insertion	أي دور
kbd	لا شيء	أي دور
label	لا شيء	مشروط
legend	لا شيء	لا دور سوى دوره
li	لا شيء	لا دور سوى دوره
link	لا شيء	لا دور سوى دوره
main	main	لا دور سوى دوره
map	لا شيء	لا دور سوى دوره
mark	لا شيء	أي دور
math	math	لا دور سوى دوره
menu	list	group, listbox, menu, menubar, none, presentation, radiogroup, tablist, toolbar, tree
meta	لا شيء	لا دور سوى دوره
meter	meter	لا دور سوى دوره
nav	navigation	menu, menubar, none, presentation, tablist
noscript	لا شيء	لا دور سوى دوره
object	لا شيء	application, document, img, image
ol	list	group, listbox, menu, menubar, none, presentation, radiogroup, tablist, toolbar, tree
optgroup	group	لا دور سوى دوره
option element that is in a list of options or that represents a suggestion in a datalist	option	لا دور سوى دوره
output	status	أي دور
p	paragraph	أي دور
param	لا شيء	لا دور سوى دوره
picture	لا شيء	لا دور سوى دوره
pre	generic	أي دور
progress	progressbar	لا دور سوى دوره
q	generic	أي دور
rp	لا شيء	أي دور
rt	لا شيء	أي دور
ruby	لا شيء	أي دور
s	deletion	أي دور
samp	generic	أي دور
script	لا شيء	لا دور سوى دوره
search	search	form, group, none, presentation, region
section	region	alert, alertdialog, application, banner, complementary, contentinfo, dialog, document, feed, group, log, main, marquee, navigation, none, note, presentation, search, status, tabpanel
select (with NO multiple attribute and NO size attribute having value greater than 1 )	combobox	menu
select (with a multiple attribute or a size attribute having value greater than 1 )	listbox	لا دور سوى دوره
selectedcontent	generic	مشروط
slot	لا شيء	لا دور سوى دوره
small	generic	أي دور
source	لا شيء	لا دور سوى دوره
span	generic	أي دور
strong	strong	أي دور
style	لا شيء	لا دور سوى دوره
sub	subscript	أي دور
summary	لا شيء	لا دور سوى دوره
sup	superscript	أي دور
SVG	graphics-document	أي دور
table	table	أي دور
tbody	rowgroup	أي دور
td	لا شيء	مشروط
template	لا شيء	لا دور سوى دوره
textarea	textbox	لا دور سوى دوره
tfoot	rowgroup	أي دور
th	لا شيء	مشروط
thead	rowgroup	أي دور
time	time	أي دور
title	لا شيء	لا دور سوى دوره
tr	row	مشروط
track	لا شيء	لا دور سوى دوره
u	generic	أي دور
ul	list	group, listbox, menu, menubar, none, presentation, radiogroup, tablist, toolbar, tree
var	لا شيء	أي دور
video	لا شيء	application
wbr	لا شيء	none, presentation

كل ما هنا مأخوذ من جدول استعمال سمات ARIA حسب عنصر HTML في مواصفة ARIA in HTML، ويحمل كل صف نصّ المواصفة نفسه. ولا يُرفع شيء. أُخذت اللقطة في 2026-08-03

متوفر أيضًا بلغات أخرى: English · Español · Português · Français

أدوار ARIA: أي عنصر يحتاج دورًا وأيّها يحمله أصلًا

ابحث عن أي عنصر HTML وأي دور ARIA لتعرف: أينبغي لك كتابته، أم يجوز لك، أم أن العنصر هو ذلك الشيء أصلًا.

ما دور ARIA؟

دور ARIA يخبر التقنيات المساعدة بما يكونه جزء من الترميز: زرًّا أو منطقة تنقّل أو عنوانًا أو مربّع حوار. وتكتبه هكذا role="button"، فيغيّر طريقة إعلان قارئ الشاشة عنه وما يستطيع المستخدم فعله به.

تعرّف WAI-ARIA الأدوار نفسها. وتجيب مواصفة ثانية هي ARIA in HTML عن السؤال الذي يأتي به الناس فعلًا — أي الأدوار يجوز وضعها على أي عنصر HTML — وتفعل ذلك في جدول يغطي 139 عنصرًا. وهذا الجدول هو أساس هذه الصفحة، وهو الجدير بالقراءة، لأن الأدوار ليست متبادلة بين العناصر.

وأنفع ما فيه يكاد يمرّ دون انتباه: فواحد وثمانون من تلك العناصر تحمل دورًا أصلًا بلا أي سمة، وترويسة الجدول نفسها تقول إن إسنادها في الترميز غير موصى به. فعنصر button زرٌّ بالفعل، وh1 عنوانٌ بالفعل بمستواه. وفي أغلب الأحيان يكون الجواب الصحيح عن «أي دور أضع هنا» هو: لا دور.

طريقة الاستخدام

اكتب العنصر. اسم الوسم وحده، ولا تضرّ أقواس الزاوية ولا الحروف الكبيرة. وحيث تقيّد المواصفة عنصرًا يقودك الاسم المجرّد إلى الصف المقيَّد: فكتابة a تعطيك قاعدة a with href.
اكتب الدور الذي كنت ستضعه. تحصل على واحد من أربعة أجوبة: العنصر يحمله أصلًا، أو هو مسموح، أو غير مسموح هنا، أو القاعدة مشروطة فلا جواب قاطع.
ثم انظر الفهرس العكسي أسفله. يعدّد العناصر التي تحمل ذلك الدور أصلًا بلا سمة، منفصلةً عمّا يقبله منها إن طلبته. وهذا في الغالب أفضل سبيل لحلّ المسألة.

الزائد ليس هو الخطأ

كتابة role="button" على عنصر button ترميزٌ صحيح. ليست خطأً ولا تكسر شيئًا. وإنما تعدّها المواصفة غير موصى بها لأنها لا تضيف شيئًا ولأنها قد تتخلّف: فإن غيّرت العنصر لاحقًا بقي الدور يصف شيئًا لم يعد موجودًا. وتذكر هذه الصفحة تلك الحالة حكمًا مستقلًّا بدل خلطها بالأخطاء الحقيقية، لأن إخبار أحدهم بأن ترميزه السليم معطوب أسوأ من السكوت.

أما الحالات الممنوعة حقًّا فشأن آخر. فواحد وخمسون عنصرًا لا تقبل دورًا سوى الذي تحمله — main وbody وhtml وbase وcaption وأمثالها — فـrole="navigation" على main غير مسموح ببساطة. وسبعة وثلاثون آخر لا تقبل إلا مجموعة محدّدة: فـa with href يقبل button وcheckbox وmenuitem وmenuitemcheckbox وmenuitemradio وoption وradio وswitch وtab أو tree، لا غير. وواحد وأربعون عنصرًا، وهي الصفحات البيضاء مثل span وabbr، تقبل أي دور كان.

ويبقى الأدوار نفسها، وقد سمّى الجدول منها خمسة وسبعين. فإن احتجت إلى واحد فالفهرس العكسي هو الطريق المختصر: اسأل أي العناصر زرٌّ أصلًا قبل أن تقرّر صنع زرّ من div.

عشرة عناصر لا تحكم فيها هذه الصفحة

عشر من القواعد الـ139 مكتوبة بشرط، والأداة تأبى أن تحكم فيها بدل أن تخمّن. فـtd وth وtr تتوقف على دور عنصر table الحاوي لها. وdiv يتوقف على كونه ابنًا مباشرًا لـdl. وfigure يتوقف على وجود figcaption في ذريّته. وlabel يتوقف على ارتباطه بعنصر قابل للتسمية.

وفي كل تلك الحالات تمتنع المواصفة عن إعطاء قاعدة مطلقة، فالأداة التي تخرج بنعم أو لا واثقة إنما تخترع قاعدة. ويُعرض نصّ المواصفة نفسه بدلًا من ذلك ليُقرأ في ضوء ترميزك الحقيقي. وهذا هو الجواب الأمين، ولهذا تعرض الصفحة النصّ الأصلي لكل عنصر لا خلاصتها هي فحسب.

وحدّان آخران يستحقان الذكر: هذا جدول العناصر وحده، ولمواصفة ARIA in HTML جدولان آخران، أحدهما عن خصائص HTML والآخر عن الذريّات التي يسمح بها كل دور، وليس واحد منهما مشمولًا هنا. ثم إن الصفحة تخبرك بما هو مسموح لا بما هو صواب: فالدور المسموح قد يظلّ الدور الخطأ، ولا جدول يعرف هل يسلك مكوّنك فعلًا سلوك تبويب.

لماذا هي مجانية؟

الجدول يسافر مع الصفحة في بضعة كيلوبايتات، وكل بحث يجري في متصفحك أنت. فلا يُرفع شيء مما تكتبه، ولا يُسجَّل شيء، ولا حساب عليك إنشاؤه.

بلا تسجيل، وبلا حدود، وبلا علامة مائية على أي شيء تنسخه.