Please note, this is a STATIC archive of website developer.mozilla.org from 03 Nov 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

مرجع صفت‌های HTML

عنصرها در HTM صفت‌هایی دارند؛ این‌ها مقادیر اضافه‌ای هستند که عنصرها را پیکربندی می‌کنند یا رفتار آنها را در راه‌های گسترده‌ای به‌صورت مناسب با شرایطی که کاربران می‌خواهند تطبیق میدهند.

نام صفت عنصرها توضیح
accept <form>, <input> فهرست انواعی که سرور قبول می‌کند، معمولا از نوع فایل.
accept-charset <form> فهرستی از مجموعه کاراکترهای پشتیبانی شده.
accesskey Global attribute تعیین کلید میانبری از صفحه‌کلید جهت فعال‌سازی یا افزودن focus به عنصر مورد نظر.
action <form> نشانی فایلی که قرار است اطلاعات ارسالی از فرم را پردازش کند.
align <applet>, <caption>, <col>, <colgroup><hr>, <iframe>, <img>, <table>, <tbody><td><tfoot> , <th>, <thead>, <tr> تنظیمات مربوط به چینش عنصر را تعیین می‌کند.
alt

<applet>, <area>, <img>, <input>

متن جایگزین تصویر، زمانی که تصویر قابل نمایش نباشد.
async <script> نشان‌دهنده‌ی این است که اسکریپت باید به صورت نامتقارن اجرا شود.
autocomplete <form>, <input> نشان‌دهنده‌ی این است که آیا کنترل‌های موجود در این فرم قابلیت اختیار مقادیر پیش‌فرض مرورگر را دارند یا خیر.
autofocus <button>, <input>, <keygen>, <select>, <textarea> بعد از بارگذاری صفحه، عنصر مورد نظر focus را به خود می‌گیرد.
autoplay <audio>, <video> پخش صوت یا تصویر به محض آماده شدن.
bgcolor <body>, <col>, <colgroup>, <marquee>, <table>, <tbody>, <tfoot>, <td>, <th>, <tr>

رنگ پیش‌زمینه‌ی عنصر.

یادداشت: این یک صفت قدیمی است که باید از ویژگی background-color در CSS به جای آن استفاده کرد.

border <img>, <object>, <table>

نشان‌دهنده‌ی حاشیه‌ی عنصر مورد نظر.

یادداشت: این یک صفت قدیمی است که باید از ویژگی border در CSS به جای آن استفاده کرد.

buffered <audio>, <video> شامل بازه‌ی زمانی است که محتوای مورد نظر در آن بازه بافر شده است.
challenge <keygen> رشته‌ای از حروف که به همراه کلید عمومی ارسال می‌شود.
charset <meta>, <script> نوع کدگذاری کاراکترهای موجود در صفحه یا اسکریپت را تعیین می‌کند.
checked <command>, <input> نشان‌دهنده‌ی این است که آیا عنصر مورد نظر در زمان بارگذاری صفحه باید انتخاب شود یا خیر.
cite <blockquote>, <del>, <ins>, <q> به نشانی منبع نقل قول اشاره می‌کند.
class Global attribute اغلب به همراه CSS به کار می‌رود تا عنصرهایی با ویژگی‌های مشترک را سبک‌دهی کند.
code <applet> نشانی فایل با پیشوند class که اپلت برای بارگذاری و اجراشدن به آن نیاز دارد را، شامل می‌شود.
codebase <applet> این صفت نشانی مطلق یا نسبی دایرکتوری که فایل‌های با پیشوند class مورد نیاز اپلت هستند، را شامل می‌شود.
color <basefont>, <font>, <hr>

این صفت رنگ متن را با توجه به دو الگوی "نام رنگ" یا "مقدار هگزادسیمال رنگ" مشخص می‌کند.

یادداشت: این یک صفت قدیمی است که باید از ویژگی color در CSS به جای آن استفاده کرد.

cols <textarea> تعداد ستون‌های ناحیه‌ی متنی را مشخص می‌کند.
colspan <td>, <th> تعداد ستون‌های یک سلول (خانه) از جدول را مشخص می‌کند.
content <meta> مقداری که منطبق با http-equiv یا name است.
contenteditable Global attribute نشان‌دهنده‌ی این است که آیا محتوای عنصر قابل ویرایش هستنند یا خیر.
contextmenu Global attribute ID یک <menu> را به عنوان منو تعیین می‌کند.
controls <audio>, <video> نشان‌دهنده‌ی این است که آیا مرورگر دکمه‌های کنترل فایل صوتی یا تصویری را باید نشان بدهد یا خیر.
coords <area> مجموعه‌ای از مقادیر که نشان‌دهنده‌ی مختصات ناحیه‌ی مورد نظر هستند.
data <object> نشانی منبع مورد نیاز را تعیین می‌کند.
datetime <del>, <ins>, <time> نشان‌دهنده‌ی تاریخ و زمان به کار رفته در عنصر مورد نظر است.
default <track> نشان‌دهنده‌ی این است که track قبل از اینکه تنظیمات کاربر تغییر کند، باید فعال شود.
defer <script> نشان‌دهنده‌ی این است که اسکریپت بلافاصله بعد از بارگذاری و تفسیر صفحه باید اجرا شود.
dir Global attribute جهت نوشته‌شدن متن را مشخص می‌کند. مقادیر قابل قبول عبارتند از ltr (چپ به راست)و rtl (راست به چپ)
dirname <input>, <textarea>  
disabled <button>, <command>, <fieldset>, <input>, <keygen>, <optgroup>, <option>, <select>, <textarea> نشان‌دهنده‌ی این است که آیا کاربر امکان تعامل با عنصر مورد نظر را دارد یا خیر.
draggable Global attribute قابلیت کشیده‌شدن عنصر (کلیک بر روی آن و حرکت دادنش) را تعیین می‌کند.
dropzone Global attribute ناحیه‌ای که عنصر کشیده‌شده را می‌توان در آن رها (drop) کرد.
enctype <form> وقتی از method ای مانند POST برای ارسال مقادیر فرم استفاده می‌شود، این صفت نوع محتوای داده‌ای را در فرم تعیین می‌کند.
for <label>, <output> تعیین عنصرهایی که به عنصر مورد نظر تعلق دارند.
form <button>, <fieldset>, <input>, <keygen>, <label>, <meter>, <object>, <output>, <progress>, <select>, <textarea> نشان‌دهنده‌ی فرمی است که مالک (پدر) عنصر مورد نظر است.
headers <td>, <th> IDهای عنصر(های) <th> که به این عنصر مربوط می‌شوند.
height <canvas>, <embed>, <iframe>, <img>, <input>, <object>, <video>

در برخی کاربردها مانند <div>، این یک صفت قدیمی است که باید از ویژگی height در CSS به جای آن استفاده کرد. در سایر موارد مانند <canvas> استفاده از این صفت ضروری است.

hidden Global attribute ارتباط یک عنصر را نشان می‌دهد.
high <meter> پایین‌ترین مرز از بالاترین محدوده را نشان می‌دهد.
href <a>, <area>, <base>, <link> نشانی منبعی که پیوند (لینک) به آن اشاره دارد.
hreflang <a>, <area>, <link> زبان منبعی که پیوند (لینک) به آن اشاره دارد.
http-equiv <meta>  
icon <command> تصویری که نشان‌دهنده‌ی command باشد را تعیین می‌کند.
id Global attribute اغلب با CSS به کار می‌رود تا عنصر مورد نظر را سبک دهی کند. مقدار این صفت باید منحصر به فرد (یکتا) باشد.
ismap <img> نشان‌دهنده‌ی این است که آیا تصویر بخشی از یک image map سمت سرور می‌باشد یا خیر.
itemprop Global attribute  
keytype <keygen> نوع کلید تولید شده را مشخص می‌کند.
kind <track> گونه‌ی متنی track را مشخص می‌کند.
label <track> متنی خوانا برای track مشخص می‌کند.
lang Global attribute زبانی که در عنصر مورد نظر به کار رفته است را مشخص می‌کند.
language <script> زبان اسکریپت را در عنصر مورد نظر تعیین می‌کند.
list <input> فهرستی از گزینه‌های از پیش تعریف شده را برای کاربر مشخص می‌کند.
loop <audio>, <bgsound>, <marquee>, <video> نشان‌دهنده‌ی این است که آیا محتوای مورد نظر (متن، صوت یا تصویر) پس از تمام شدن، دوباره باید اجرا شود یا به نمایش دربیاید یا خیر.
low <meter> بالاترین مرز از پایین‌ترین محدوده را نشان می‌دهد.
manifest <html> نشانی فایل cache manifest (جهت مرور آفلاین صفحات) را در سند مشخص می‌کند.
max <input>, <meter>, <progress> نشان‌دهنده‌ی بیشترین مقدار مجاز است.
maxlength <input>, <textarea> بیشترین تعداد کاراکترها را در عنصر مورد نظر تعیین می‌کند.
media <a>, <area>, <link>, <source>, <style> بخش کوچکی از رسانه که منبع پیوند داده شده برای آن طراحی شده است، را مشخص می‌کند.
method <form> مشخص می‌کند که از کدام متد HTTP برای ارسال داده‌های فرم استفاده شود، که می‌تواند GET (پیش‌فرض) یا POST باشد.
min <input>, <meter> نشان‌دهنده‌ی کمترین مقدار مجاز است.
multiple <input>, <select>

نشان‌دهنده‌ی این است که آیا مقدارهای چندتایی می‌توانند در ورودی‌های email یا file وارد شوند یا خیر.

name <button>, <form>, <fieldset>, <iframe>, <input>, <keygen>, <object>, <output>, <select>, <textarea>, <map>, <meta>, <param>

نام عنصر. برای نمونه از این صفت برای شناسایی فیلدهای مورد نظر که به سمت سرور ارسال شده‌اند استفاده می‌شود.

novalidate <form>

این صفت نشان‌دهنده‌ی این است که هنگام ارسال فرم، داده‌های آن نباید مورد سنجش و ارزیابی قرار بگیرند.

open <details>

نشان‌دهنده‌ی این است که آیا جزییات زمان بارگذاری صفحه نمایش داده می‌شوند یا خیر.

optimum <meter>

نشان‌دهنده‌ی مقدار عددی بهینه است.

pattern <input>

عبارتی منظم را تعریف می‌کند که مقدار عنصر مورد نظر برابر آن مورد سنجش و ارزیابی قرار می‌گیرد.

ping <a>, <area>  
placeholder <input>, <textarea>

با نمایش کادری کوچک به کاربر اطلاع می‌دهد که چه چیزی در فیلد قابل نوشتن است.

poster <video>

نشانی که به یک فریم از فیلم اشاره دارد تا زمانی که کاربر هنوز اقدام به پخش فیلم نکرده است به وی نمایش داده شود.

preload <audio>, <video> نشان‌دهنده‌ی این است که آیا تمام منبع، بخشی از آن یا هیچ چیز باید از قبل از اقدام کاربر برای پخش محتوا، بارگذاری شود.
pubdate <time>

نشان‌دهنده‌ی این است که آیا این تاریخ و زمان مطابق با تاریخ نزدیک‌ترین عنصر <article> والد خود است یا خیر.

radiogroup <command>  
readonly <input>, <textarea>

نشان‌دهنده‌ی این است که آیا این عنصر قابل ویرایش است یا خیر.

rel <a>, <area>, <link> ارتباط بین شی هدف و شی پینوندی را مشخص می‌کند.
required <input>, <select>, <textarea> نشان‌دهنده‌ی این است که آیا این عنصر (از فرم) نیاز به تکمیل شدن از طرف کاربر دارد یا خیر.
reversed <ol> نشان‌دهنده‌ی این است که آیا فهرست باید به ترتیب نزولی نمایش داده شود، بر خلاف ترتیب صعودی.
rows <textarea> تعداد سطرهای ناحیه‌ی متنی را مشخص می‌کند.
rowspan <td>, <th> تعداد سطرهایی که سلول (خانه) جدول باید بر اساس آن ایجاد شود را مشخص می‌‌کند.
sandbox <iframe>  
spellcheck Global attribute نشان‌دهنده‌ی این است که آیا عملیات بررسی واژه‌ها برای این عنصر مجاز است یا خیر.
scope <th>  
scoped <style>  
seamless <iframe>  
selected <option> مقداری را تعیین می‌کند که در زمان بارگذاری صفحه، در فهرست انتخاب شده است.
shape <a>, <area>  
size <input>, <select> عرض عنصر را (بر اساس پیکسل) تعیین می‌کند. اگر عنصر مورد نظر از نوع text یا password باشد این صفت تعداد کاراکترهای عنصر را تعیین می‌کند.
sizes <link>  
span <col>, <colgroup>  
src <audio>, <embed>, <iframe>, <img>, <input>, <script>, <source>, <track>, <video> نشانی فایلی که عنصر مورد نظر از آن به عنوان منبع استفاده می‌کند.
srcdoc <iframe>  
srclang <track>  
start <ol> اولین عدد در فهرست را تعیین می‌کند، اگر غیر از ۱ باشد.
step <input>  
style Global attribute سبک‌های CSS را تعریف می‌کند که در صورت وجود فایل‌های قدیمی بر روی آن‌ها نوشته می‌شوند.
summary <table>  
tabindex Global attribute با ویرایش این صفت، ترتیب انتخاب شدن عنصر‌های صفحه در مرورگر به حالتی که برایش تعیین شود تغییر می‌یابد.
target <a>, <area>, <base>, <form>  
title Global attribute متنی که در یک کادر کوچک با قرار دادن mouse روی عنصر مورد نظر نمایش می‌یابد.
type <button>, <input>, <command>, <embed>, <object>, <script>, <source>, <style>, <menu> نوع عنصر را تعریف می‌کند.
usemap <img><input>, <object>  
value <button>, <option>, <input>, <li>, <meter>, <progress>, <param> مقدار پیش‌فرضی که در زمان بارگذاری صفحه برای عنصر انتخاب می‌شود را تعیین می‌کند.
width <canvas>, <embed>, <iframe>, <img>, <input>, <object>, <video>

در برخی موارد مانند <div> این یک صفت قدیمی به حساب می‌آید که باید از ویژگی width در CSS به جای آن استفاده کرد. در سایر موارد مانند <canvas> این یک صفت ضروری است که باید ذکر شود.

wrap <textarea> نشان‌دهنده‌ی این است که آیا متن باید کوتاه شود یا خیر.

Content versus IDL attributes

In HTML, most attributes have two faces: the content attribute and the IDL attribute.

The content attribute is the attribute as you set it from the content (the HTML code) and you can set it or get it via element.setAttribute() or element.getAttribute(). The content attribute is always a string even when the expected value should be an integer. For example, to set an <input> element's maxlength to 42 using the content attribute, you have to callsetAttribute("maxlength", "42") on that element.

The IDL attribute is also known as a JavaScript property. These are the attributes you can read or set using JavaScript properties like element.foo. The IDL attribute is always going to use (but might transform) the underlying content attribute to return a value when you get it and is going to save something in the content attribute when you set it. In other words, the IDL attributes, in essence, reflect the content attributes.

Most of the time, IDL attributes will return their valules as they are really used. For example, the default type for <input> elements is "text", so if you setinput.type="foobar", the <input> element will be of type text (in the appearance and the behavior) but the "type" content attribute's value will be "foobar". However, thetype IDL attribute will return the string "text".

IDL attributes are not always strings; for example, input.maxlength is a number (a signed long). When using IDL attributes, you read or set values of the desired type, soinput.maxlength is always going to return a number and when you setinput.maxlength ,it wants a number. If you pass another type, it is automatically converted to a number as specified by the standard JavaScript rules for type conversion.

IDL attributes can reflect other types such as unsigned long, URLs, booleans, etc. Unfortunately, there are no clear rules and the way IDL attributes behave in conjunction with their corresponding content attributes depends on the attribute. Most of the time, it will follow the rules laid out in the specification, but sometimes it doesn't. HTML specifications try to make this as developer-friendly as possible, but for various reasons (mostly historical), some attributes  behave oddly (select.size, for example) and you should read the specifications to understand how exactly they behave.

See also

Document Tags and Contributors

 Contributors to this page: teoli, amir.farsi, navid-emami
 Last updated by: teoli,