tutoriais mais recente desenvolvimento web
 

jQuery ajax() Method

❮ jQuery AJAX Métodos

Exemplo

Alterar o texto de um <div> elemento usando um AJAX pedido:

$("button").click(function(){
    $.ajax({url: "demo_test.txt", success: function(result){
        $("#div1").html(result);
    }});
});
Tente você mesmo "

Definição e Uso

O ajax() método é usado para realizar um AJAX pedido (HTTP assíncrona).

Todos jQuery AJAX métodos usar o ajax() método. Este método é usado principalmente para pedidos em que os outros métodos não podem ser utilizados.


Sintaxe

$.ajax({name:value, name:value, ... })

Os parâmetros especifica um ou mais pares nome / valor para o pedido de AJAX.

Possíveis nomes / valores na tabela abaixo:

Nome Valor / Descrição
async Um valor booleano que indica se o pedido deve ser tratado assíncrona ou não. O padrão é verdadeiro
beforeSend( xhr ) A função a ser executada antes que o pedido é enviado
cache Um valor booleano que indica se o navegador deve armazenar em cache as páginas solicitadas. O padrão é verdadeiro
complete( xhr,status ) A função a ser executada quando o pedido for concluído (após funções êxito e de erro)
contentType O tipo de conteúdo usado quando o envio de dados para o servidor. O padrão é: "application/x-www-form-urlencoded"
context Especifica o valor "this" para todas as funções de retorno de chamada relacionados AJAX
data Especifica os dados a serem enviados para o servidor
dataFilter( data , type ) A função usada para lidar com os dados de resposta bruto do XMLHttpRequest
dataType O tipo de dados esperado da resposta do servidor.
error( xhr,status,error ) A função a ser executada se a solicitação falhar.
global Um valor booleano que determina se ou não para acionar evento global AJAX alças para o pedido. O padrão é verdadeiro
ifModified Um valor booleano que especifica se o pedido só é bem sucedido se a resposta foi alterado desde a última solicitação. O padrão é: false.
jsonp Uma cadeia substituindo a função de retorno de chamada em um jsonp pedido
jsonpCallback Especifica um nome para a função de retorno de chamada em um jsonp pedido
password Especifica uma senha a ser usada em uma solicitação de autenticação de acesso HTTP.
processData Um valor booleano que determina se ou não os dados enviados com o pedido deve ser transformado em uma cadeia de consulta. O padrão é verdadeiro
scriptCharset Especifica o conjunto de caracteres para o pedido
success( result,status,xhr ) A função a ser executada quando o pedido for bem-sucedido
timeout O tempo limite local (em milissegundos) para a solicitação
traditional Um valor booleano que determina se ou não usar o estilo tradicional de serialização param
type Especifica o tipo de solicitação. (GET ou POST)
url Especifica o URL para enviar o pedido para. O padrão é a página atual
username Especifica um nome de usuário para ser usado em uma solicitação de autenticação de acesso HTTP
xhr A função usada para criar o XMLHttpRequest objeto

Tente você mesmo - Exemplos

Faça uma síncrona AJAX pedido
Como usar a configuração assíncrona para especificar uma solicitação síncrona

Fazer um AJAX pedido com um tipo de dados especificado
Como usar o dataType configuração para especificar o tipo de dados para o pedido.

Fazer um AJAX pedido com um erro
Como usar a configuração de erro para lidar com erros em um AJAX pedido.


❮ Métodos jQuery AJAX