jQuery - jQuery.ajax (options), méthode

La description

le jQuery.ajax( options ) charge une page distante à l'aide d'une requête HTTP.

$ .ajax () renvoie la XMLHttpRequest qu'il crée. Dans la plupart des cas, vous n'aurez pas besoin de cet objet pour le manipuler directement, mais il est disponible si vous devez abandonner la demande manuellement.

Syntaxe

Voici la syntaxe simple pour utiliser cette méthode -

$.ajax( options )

Paramètres

Voici la description de tous les paramètres utilisés par cette méthode -

  • options- Un ensemble de paires clé / valeur qui configurent la requête Ajax. Toutes les options sont facultatives.

N ° Sr. Option et description
1 async

Un booléen indiquant s'il faut exécuter la demande de manière asynchrone. La valeur par défaut est true.
2 beforeSend

Une fonction de rappel qui est exécutée avant l'envoi de la demande.
3 complete

Une fonction de rappel qui s'exécute chaque fois que la demande se termine.
4 contentType

Une chaîne contenant un type de contenu MIME à définir pour la demande. La valeur par défaut est application / x-www-form-urlencoded.
5 data

Une carte ou une chaîne envoyée au serveur avec la demande.
6 dataFilter

Une fonction à utiliser pour gérer les données de réponse brutes de XMLHttpRequest. Il s'agit d'une fonction de pré-filtrage pour nettoyer la réponse.
sept dataType

Une chaîne définissant le type de données attendues du serveur (xml, html, json ou script).
8 error

Une fonction de rappel qui est exécutée si la demande échoue.
9 global

Un booléen indiquant si les gestionnaires d'événements AJAX globaux seront déclenchés par cette requête. La valeur par défaut est true.
dix ifModified

Un booléen indiquant si le serveur doit vérifier si la page est modifiée avant de répondre à la demande.
11 jsonp

Remplacez le nom de la fonction de rappel dans une requête jsonp.
12 password

Un mot de passe à utiliser en réponse à une demande d'authentification d'accès HTTP.
13 processData

Un booléen indiquant s'il faut convertir les données soumises d'un formulaire objet en un formulaire de chaîne de requête. La valeur par défaut est true.
14 success

Une fonction de rappel qui est exécutée si la demande réussit.
15 timeout

Nombre de millisecondes après lequel la demande expirera en cas d'échec.
16 timeout

Définissez un délai d'expiration local (en millisecondes) pour la demande.
17 type

Une chaîne définissant la méthode HTTP à utiliser pour la requête (GET ou POST). La valeur par défaut est GET.
18 url

Une chaîne contenant l'URL à laquelle la demande est envoyée.
19 username

Un nom d'utilisateur à utiliser en réponse à une demande d'authentification d'accès HTTP.
20 xhr

Rappel pour créer l'objet XMLHttpRequest. Par défaut, ActiveXObject lorsqu'il est disponible (IE), XMLHttpRequest dans le cas contraire.

Exemple

En supposant que nous ayons le contenu HTML suivant dans le fichier result.html -

<h1>THIS IS RESULT...</h1>

Voici un exemple simple montrant l'utilisation de cette méthode. Ici, nous utilisons le gestionnaire de succès pour remplir le HTML renvoyé -

<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){
               $.ajax( {
                  url:'result.html',
                  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:blue;">
         STAGE
      </div>
		
      <input type = "button" id = "driver" value = "Load Data" />
   </body>
</html>

Cela produira le résultat suivant -

jquery-ajax.htm