English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Método jQuery load()

Métodos AJAX do jQuery

O método load() carrega dados do servidor e coloca o HTML retornado no elemento selecionado.

O método load() é a maneira mais simples de obter dados do servidor. Ele é aproximadamente equivalente a $.get(url, data, callback), exceto que é um método em vez de uma função global e possui um callback implícito.

Método de solicitação:Se você estiver a usardataSe fornecido como objeto, use o método POST. Caso contrário, é assumido como GET.

Sintaxe:

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

Exemplo

Carregar o conteúdo do arquivo ajax_intro.txt no elemento DIV:

$("button").click(function(){
  $("div").load("ajax_intro.txt");
});
Teste e veja‹/›

Diferente de $.get(), o método load() nos permite especificar uma parte do documento remoto a ser inserida:

$("button").click(function(){
  $("div").load("/jquery/ajax_load.html #table");
});
Teste e veja‹/›

Carregar a página do arquivo ajax_post.php e enviar alguns outros dados:

$("button").click(function(){
  let data = {fname:"Seagull", lname:"Anna"};
  $("div").load("ajax_post.php", data);
});
Teste e veja‹/›

Carregar a página do arquivo ajax_post.php, enviar alguns outros dados e exibir uma mensagem de estado de alerta:

$("button").click(function(){
  let data = {fname:"Seagull", lname:"Anna"};
  $("div").load("ajax_post.php", data, function(response, status){
    alert(status);
  });
});
Teste e veja‹/›

Se o pedido AJAX encontrar um erro, mostre uma notificação:

$("button").click(function(){
  let data = {fname:"Seagull", lname:"Anna"};
  $("#success").load("wrong_file.php", data, function(response, status, xhr){
    if(status == "error"){
      let msg = "Desculpe, ocorreu um erro: ";
      $("#error").html(msg + xhr.status + " " + xhr.statusText);
    }
  });
});
Teste e veja‹/›

Valor do Parâmetro

ParâmetrosDescrição
URLEspecificar a URL que você deseja solicitar
data(Opcional) Especificar um objeto puro ou uma string que será enviada ao servidor juntamente com a solicitação
callback(Opcional) Especificar a função de chamada de volta a ser executada quando a solicitação for concluída

Parâmetros:

  • response  -Contém os dados de resultado da solicitação

  • status -Contém o estado da solicitação ("sucesso", "notmodified", "erro", "timeout", ou "parsererror")

  • xhr-Contém o objeto XMLHttpRequest

Métodos AJAX do jQuery