متد ( ) post در jQuery
در این بخش از آموزش JQuery ، متد post را شرح میدهیم.
وسیله متد post ، می توان فایلی را از سرور با استفاده از یک درخواست HTTP POST خواند .
سپس از نتیجه خروجی بر روی صفحه استفاده نمود .
شکل کلی استفاده از این متد بصورت زیر است :
$(selector).post( URL , data , function ( data , status , xhr ) , dataType ) ;
URL : تعیین کننده آدرس فایلی است که می خواهیم اطلاعات را از سرور درخواست کرده و بخوانیم . استفاده از این پارامتر اجباری است .
data : این پارامتر تعیین کننده اطلاعاتی است که می خوهیم همراه درخواست خود به سرور ارسال نماییم.استفاده از این پارامتر اختیاری است .
function : این پارامتر تعیین کننده تابعی است که می خواهید هنگامی که متد ( ) post به پایان رسید ، اجرا شود . این تابع خود می تواند چندین پارامتر نیز داشته باشد :
استفاده از این پارامتر اختیاری است .
- data : در بر گیرنده اطلاعات خروجی از درخواست است .
- status : .این پارامتر تعیین کننده وضعیت درخواست است که می تواند چندین حالت داشته باشد :
success : موفق .
notmodified : هنوز اعمال یا بررسی نشده.
error : اشکال در ارسال یا پردازش درخواست .
timeout : مدت زمان کافی برای اجرای درخواست تمام شده است .
parseerror : خواندن و اجرای درخواست با مشکل مواجه شده است .
- xhr : در بر گیرنده شی XmlHttpRequest است .
dataType : این پارامتر نوع داده ارسالی از طرف سرور را تعیین می کند . به صورت اتوماتیک jQuery ، خودش به صورت پیش فرض نوع این داده را حدس می زند و می تواند یکی از موارد زیر باشد :
استفاده از این پارامتر اختیاری است .
- xml : یک فایل XML.
- html : فایل HTML .
- text : یک متن ساده String .
- Script : درخواست را به صورت یک اسکریپت اجرا کرده و نتیجه را به صورت متن ساده بر می گرداند .
مثال زیر کاربرد متد post را نشان میدهد :
$("button").click(function(){
$.post("demo_test.asp",function(data,status){
alert("Data: " + data + "\nStatus: " + status);
});
});