Quelle est la syntaxe de la méthode $.post en jQuery ?

La méthode $.post() en jQuery permet de poster et/ou demander des données dans une requête HTTP. Le mécanisme de transmission est comparable à celui d'un formulaire HTML avec l'attribut method="post". Voici la syntaxe générale :

$.post(URL, data, callback);

En pratique, la fonction s'utilise généralement sous cette forme :

$.post("url_de_destination",
{
	// Données à transmettre
	champ1: "donnée 1",
	champ2: "donnée 2",
	champ3: "donnée 3"
},
function(data, status)
{
	// Traitement des données reçues (data)
	alert("Data: " + data + "\nStatus: " + status);
});

• Le premier paramètre est l'URL de destination, c'est -à-dire le script qui va traiter les données et éventuellement retourner une réponse.
• Le second paramètre contient les données séparées par des virgules.
• Le troisième paramètre est la fonction (callback) qui va traiter les données reçues. Dans l'exemple ci-dessus la fonction est déclarée dans le corps de la méthode $.post.
• Les données reçues par l'URL de destination sont accessibles dans la variable $_POST en PHP et Request.Form en ASP. Sur l'exemple ci-dessus on va récupérer la chaîne de caractères "donnée 1" dans la variable $_POST['champ1'], la chaîne de caractères "donnée 2" dans la variable $_POST['champ2'], etc.
• Les données retournées par l'URL de destination (si elles existent) seront accessibles dans la variable data. Ces données sont simplement affichées dans la page par le script PHP ou ASP
• Si la transmission s'est bien déroulée, la variable status contiendra la chaîne de caractères "success".

Voici un exemple élémentaire de script PHP de traitement qui retourne les données reçues après les avoir encodées en JSON :

<?php
echo json_encode($_POST);