متد ()load

این متد ساده ولی بسیار قدرتمند است.
متد  ()load داده را از سرور بارگزاری کرده و داده برگشتی را داخل عنصر انتخاب شده قرار می دهد.

$(selector).load(URL,data,callback);

پارامتر URL  الزامی بوده و مشخص کننده آدرسی است که می خواهید آن را بارگزاری کنید.
پارامتر data اختیاری بوده و مشخص کننده مجموعه ای از جفت کلید/مقدار querystring  است که میخواهید به همراه درخواست ارسال کنید.
پارامتر callback  اختیاری بوده  نام تابعی را که می خواهید بعد از پایان متد ()load فراخوانی شود را مشخص می کند.
در بخش زیر، محتوای مثال بعدی قرار داده شده است:  "demo_test.txt":

\

<h2>jQuery & AJAX  </h2>
<p id="p1">This is some text in a paragraph.</p>

همچنین می توانید سلکتورهای jQuery  را به پارامتر url اضافه کنید.
مثال زیر محتوای عنصری با id=p1 را از فایل demo_test.txt داخل عنصر <div> بارگزاری  می کن

$("#div1").load("demo_test.txt");

پارامتر callback  اختیاری بوده  نام تابعی را که می خواهید بعد از پایان متد ()load فراخوانی شود را مشخص می کند. تابع بازگشتی می تواند پارامترهای مختلفی بپذیرد:

  • responseTxt  - حاوی محتوای نهایی خواهد بود، اگر فراخوانی موفقیت آمیز باشد.
  • statusTxt  - حاوی وضعیت فراخوانی است.
  • xhr  - حاوی شی XMLHttpRequest  است.

مثال زیر پس از اتمام اجرای متد load() ، یک پیغام هشدار نمایش می دهد. اگر متد ()load موفقیت آمیز باشد، این پیغام " بارگزاری محتوای خارجی باموفقیت انجام شد. " نمایش داده خواهد شد. اگر مشکلی رخ داده باشد نیز پیغام خطا نشان خواهد داد:

$("button").click(function(){
    $("#div1").load("demo_test.txt", function(responseTxt, statusTxt, xhr){
        if(statusTxt == "success")
            alert(" بارگزاری محتوای خارجی باموفقیت انجام شد");
        if(statusTxt == "error")
            alert("Error: " + xhr.status + ": " + xhr.statusText);
    });
}); 

خلاصه درس

متد  ()load داده را از سرور بارگزاری کرده و داده برگشتی را داخل عنصر انتخاب شده قرار می دهد.

توسعه دهندگان
آریان آذر