شئInput FileUpload كه درجاوااسكريپت ايجاد ميشود، مرتبط با يكي از عناصر HTML <input> صفحه ميباشد .اين شئ داراي ويژگي هاي همان عنصر<input> است كه ميتوان با فرمت شئ گرائي با شئ مذكور روي آن اثر گذاشت .بعبارتي ميتوان مقادير ويژگيهاي آنرا تنظيم ويا بدست آورد.
جدول ويژگي هاي شئInput FileUpload مطابق زير بوده ، ودراين صفحه هركدام دربخش داخلي يا صفحات ديگرتشريح ميشوند.
ويژگي | شرح |
---|---|
accept | مقدار ويژگيaccept را براي دكمه اپلود فايل، تنظيم ويا برگشت ميدهد . |
autofocus | اين ويژگي مشخص ميكند كه آيا بايد دكمه اپلود فايل بطورخودكار پس از بارگذاري فوكوس شود. |
defaultValue | مقدار ويژگيdefaultValue دكمه آپلود فايل را تنظيم ويا برگشت ميدهد . |
disabled | اين ويژگي فعال ويا غير فعال بودن دكمه آپلود فايل را مشخص ميكند .پيش فرض فعال |
files | يك شئFileList را برگشت ميدهد، كه نشان دهنده فايل يا فايلهاي انتخاب شده با آپلود فايل است . |
form | ويژگيform فرمي را كه دكمه اپلود فايل متعلق به آنست مشخص ميكند . |
multiple | ويژگي مشخص ميكند كه كاربر ميتواند بيشترازيك فايل راانتحاب كند يا خير |
name | ويژگيname نامي را براي دكمه آپلود فايل مشخص ميكند. |
required | مشخص ميكند كه انتخاب فايل قبل از ارسال ضروري است يا نه |
type | ويژگيtype نوع دكمه آپلود فايل را مشخص ميكند.
type="file"براي Input FileUpload |
value | مقدار ويژگيvalue مسير يا نام فايل انتخابي را برگشت ميدهد .. |
ويژگيInput FileUpload accept مقدار ويژگيaccept مرتبط با عنصر<input> راتنظيم ويا برگشت ميدهد .شئInput FileUpload نمايانگر يك دكمه آپلود فايل ميباشد .
ويژگيaccept انواع فايلي كه بايد انتخاب و آپلود شوند مشخص مي نمايد .
مثال ـ تغيير ويژگيaccept
// The server will only accept audio files in the file upload document.getElementById("myFile").accept = "audio/*";
ويژگي | ![]() | ![]() | ![]() | ![]() | ![]() |
---|---|---|---|---|---|
accept | Yes | supported | Yes | supported | Yes |
مقدار | شرح |
---|---|
audio/* | همه فايل هاي صوتي مورد نظراست. |
video/* | همه فايل هاي ويدئوئي مورد نظر است. |
image/* | همه فايل هاي تصويري مورد نظراست |
MIME_type | همه نوعMIME معتبر بدون پارامتر |
مثال ـ نمايش نوع فايل هاي قابل پذيرش
var x = document.getElementById("myFile").accept;
مثال ـ تنظيم پذيرش چند نوع فايل
// The server will only accept audio and video files in the file upload document.getElementById("myFile").accept = "audio/*,video/*";
ويژگيInput FileUpload files شئFilelist رابرگشت ميدهد، كه نشان دهنده فايل يا فايلهاي انتخابي با دكمه آپلود فايل است.
از طريق اين شئFilelist ميتوان به نام ،اندازه و محتوي فايلهاي انتخابي دسترسي پيدا كرد .اين ويژگي فقط حالت خواندني دارد.
مثال ـ انتخاب يك يا چند فايل ازطريق دكمه آپلود فايل ونمايش بعضي ازاطلاعات فايلهاي انتخابي
var x = document.getElementById("myFile"); var txt = ""; if ('files' in x) { if (x.files.length == 0) { txt = "Select one or more files."; } else { for (var i = 0; i < x.files.length; i++) { txt += "<br><strong>" + (i+1) + ". file</strong><br>"; var file = x.files[i]; if ('name' in file) { txt += "name: " + file.name + "<br>"; } if ('size' in file) { txt += "size: " + file.size + " bytes <br>"; } } } } document.getElementById ("demo").innerHTML = txt;
ويژگي | ![]() | ![]() | ![]() | ![]() | ![]() |
---|---|---|---|---|---|
files | Yes | 10.0 | Yes | Yes | Yes |
ويژگيInput FileUpload multiple مقدار ويژگيmultiple عنصر<input>مرتبط باشئInput FileUpload را تنظيم ويا برگشت ميدهد .اين ويژگي مشخص ميكند كه آيا ميتوان بيشتر از يك فايل با دكمه آپلود فايل انتخاب كرد ياخير.
هنگاميكه مقداراين ويژگيtrue باشد، كاربر اجازه دارد بيش از يك فايل انتخاب نمايد.درغير اينحالت فقط ميتواند يك فايل انتخاب نمايد.
نكته ـ براي انتخاب چند فايل ، هنگام انتخاب كليدCTRL ويا SHIFT رانگه داريد .
مثال ـ بررسي انتخاب چند فايلي توسط كاربر
var x = document.getElementById("myFile").multiple;
مقدار | شرح |
---|---|
true | false | مشخص ميكند كه آيا كاربر ميتواند بيش از يك فايل انتخاب كند يانه
|
مثال ـ تنظيم دكمه آپلود فايل براي انتخاب چند فايلي
document.getElementById("myEmail").multiple = true;
ويژگيInput FileUpload value مقدار ويژگيvalue عنصر<input>مرتبط باشئInput FileUpload را برگشت ميدهد .اين ويژگي نام ويا مسير فايل انتخابي را كه با دكمه آپلود فايل ، انتخاب شده برگشت ميدهد.
توجه ـ اين ويژگي بخاصر دلايل امنيتي فقط خواندني است.
مثال ـ نمايش مسير يا نام فايل انتخابي
var x = document.getElementById("myFile").value;