jQuery - Método jQuery.ajax (options)
Descrição
o jQuery.ajaxSetup( options ) método define configurações globais para futuras solicitações AJAX.
Sintaxe
Aqui está a sintaxe simples para usar este método -
$.ajaxSetup( options )
Parâmetros
Aqui está a descrição de todos os parâmetros usados por este método -
options- Um conjunto de pares de chave / valor que configuram a solicitação Ajax. Todas as opções são opcionais.
Sr. Não. | Opção e descrição |
---|---|
1 | async Um booleano que indica se a solicitação deve ser executada de maneira assíncrona. O valor padrão é verdadeiro. |
2 | beforeSend Uma função de retorno de chamada executada antes do envio da solicitação. |
3 | complete Uma função de retorno de chamada que é executada sempre que a solicitação termina. |
4 | contentType Uma string contendo um tipo de conteúdo MIME a ser definido para a solicitação. O valor padrão é application / x-www-form-urlencoded. |
5 | data Um mapa ou string que é enviado ao servidor com a solicitação. |
6 | dataFilter Uma função a ser usada para manipular os dados respondidos brutos de XMLHttpRequest. Esta é uma função de pré-filtragem para higienizar a resposta. |
7 | dataType Uma string que define o tipo de dados esperados de volta do servidor (xml, html, json ou script). |
8 | error Uma função de retorno de chamada que é executada se a solicitação falhar. |
9 | global Um booleano que indica se os manipuladores de eventos AJAX globais serão acionados por esta solicitação. O valor padrão é verdadeiro. |
10 | ifModified Um booleano que indica se o servidor deve verificar se a página foi modificada antes de responder à solicitação. |
11 | jsonp Substitua o nome da função de retorno de chamada em uma solicitação jsonp. |
12 | password Uma senha a ser usada em resposta a uma solicitação de autenticação de acesso HTTP. |
13 | processData Um booleano que indica se os dados enviados devem ser convertidos de um formulário de objeto em um formulário de string de consulta. O valor padrão é verdadeiro. |
14 | success Uma função de retorno de chamada que é executada se a solicitação for bem-sucedida. |
15 | timeout Número de milissegundos após o qual a solicitação expirará em caso de falha. |
16 | timeout Defina um tempo limite local (em milissegundos) para a solicitação. |
17 | type Uma string que define o método HTTP a ser usado para a solicitação (GET ou POST). O valor padrão é GET. |
18 | url Uma string contendo o URL para o qual a solicitação é enviada. |
19 | username Um nome de usuário a ser usado em resposta a uma solicitação de autenticação de acesso HTTP. |
20 | xhr Retorno de chamada para criar o objeto XMLHttpRequest. O padrão é ActiveXObject quando disponível (IE), o XMLHttpRequest caso contrário. |
Exemplo
Supondo que temos o seguinte conteúdo HTML no arquivo result.html -
<h1>THIS IS RESULT...</h1>
A seguir está um exemplo simples mostrando o uso desse método. Aqui, usamos o manipulador de sucesso para preencher o HTML retornado -
<html>
<head>
<title>The jQuery Example</title>
<script type = "text/javascript"
src = "https://ajax.googleapis.com/ajax/libs/jquery/2.1.3/jquery.min.js">
</script>
<script type = "text/javascript" language = "javascript">
$(document).ready(function() {
$("#driver").click(function(event){
// Do global setting.
$.ajaxSetup({
url: "result.html"
});
$.ajax( {
success:function(data) {
$('#stage').html(data);
}
});
});
});
</script>
</head>
<body>
<p>Click on the button to load result.html file:</p>
<div id = "stage" style = "background-color:#cc0;">
STAGE
</div>
<input type = "button" id = "driver" value = "Load Data" />
</body>
</html>
Isso produzirá o seguinte resultado -