jQuery.post()

demo

jQuery.post( url [, data ] [, success(data, textStatus, jqXHR) ] [, dataType ] )Returns: jqXHR

Description: Load data from the server using a HTTP POST request.

• version added: 1.0jQuery.post( url [, data ] [, success(data, textStatus, jqXHR) ] [, dataType ] )
  
  
  
  
  • url
    Type: String
    A string containing the URL to which the request is sent.
  • data
    Type: PlainObject or String
    A plain object or string that is sent to the server with the request.
  • success(data, textStatus, jqXHR)
    Type: Function()
    A callback function that is executed if the request succeeds. Required if dataType is provided, but can be null in that case.
  • dataType
    Type: String
    The type of data expected from the server. Default: Intelligent Guess (xml, json, script, text, html).
    
  
  

This is a shorthand Ajax function, which is equivalent to:

1. $.ajax({
   
2. type: "POST",
   
3. url: url,
   
4. data: data,
   
5. success: success,
   
6. dataType: dataType
   
7. });

复制代码

The success callback function is passed the returned data, which will be an XML root element or a text string depending on the MIME type of the response. It is also passed the text status of the response.
As of jQuery 1.5, the success callback function is also passed a "jqXHR" object (in jQuery 1.4, it was passed the XMLHttpRequest object).
Most implementations will specify a success handler:

1. $.post('ajax/test.html', function(data) {
   
2. $('.result').html(data);
   
3. });

复制代码

This example fetches the requested HTML snippet and inserts it on the page.
Pages fetched with POST are never cached, so the cache and ifModified options in jQuery.ajaxSetup() have no effect on these requests.

The jqXHR ObjectAs of jQuery 1.5, all of jQuery's Ajax methods return a superset of the XMLHTTPRequest object. This jQuery XHR object, or "jqXHR," returned by $.get() implements the Promise interface, giving it all the properties, methods, and behavior of a Promise (see Deferred object for more information). The jqXHR.done() (for success), jqXHR.fail() (for error), and jqXHR.always() (for completion, whether success or error) methods take a function argument that is called when the request terminates. For information about the arguments this function receives, see the jqXHR Object section of the $.ajax() documentation.
The Promise interface also allows jQuery's Ajax methods, including $.get(), to chain multiple .done(), .fail(), and .always() callbacks on a single request, and even to assign these callbacks after the request may have completed. If the request is already complete, the callback is fired immediately.

1. // Assign handlers immediately after making the request,
   
2. // and remember the jqxhr object for this request
   
3. var jqxhr = $.post("example.php", function() {
   
4. alert("success");
   
5. })
   
6. .done(function() { alert("second success"); })
   
7. .fail(function() { alert("error"); })
   
8. .always(function() { alert("finished"); });
   
9. // perform other work here ...
   
10. // Set another completion function for the request above
    
11. jqxhr.always(function(){ alert("second finished"); });

复制代码

Deprecation NoticeThe jqXHR.success(), jqXHR.error(), and jqXHR.complete() callback methods introduced in jQuery 1.5 are deprecated as of jQuery 1.8. To prepare your code for their eventual removal, use jqXHR.done(), jqXHR.fail(), and jqXHR.always() instead.


Additional Notes:

• Due to browser security restrictions, most "Ajax" requests are subject to the same origin policy; the request can not successfully retrieve data from a different domain, subdomain, or protocol.
• If a request with jQuery.post() returns an error code, it will fail silently unless the script has also called the global .ajaxError() method. Alternatively, as of jQuery 1.5, the .error() method of the jqXHR object returned by jQuery.post() is also available for error handling.
  

Examples:
Example: Request the test.php page, but ignore the return results.

$.post("test.php");

Example: Request the test.php page and send some additional data along (while still ignoring the return results).

1	$.post("test.php", { name: "John", time: "2pm" } );

Example: Pass arrays of data to the server (while still ignoring the return results).

1	$.post("test.php", { 'choices[]': ["Jon", "Susan"] });

Example: Send form data using ajax requests

1	$.post("test.php", $("#testform").serialize());

Example: Alert the results from requesting test.php (HTML or XML, depending on what was returned).

1. $.post("test.php", function(data) {
   
2. alert("Data Loaded: " + data);
   
3. });

复制代码

Example: Alert the results from requesting test.php with an additional payload of data (HTML or XML, depending on what was returned).

1. $.post("test.php", { name: "John", time: "2pm" })
   
2. .done(function(data) {
   
3. alert("Data Loaded: " + data);
   
4. });

复制代码

Example: Post to the test.php page and get content which has been returned in json format (<?php echo json_encode(array("name"=>"John","time"=>"2pm")); ?>).

1. $.post("test.php", { "func": "getNameAndTime" },
   
2. function(data){
   
3. console.log(data.name); // John
   
4. console.log(data.time); // 2pm
   
5. }, "json");

复制代码

Example: Post a form using ajax and put results in a div

1. <!doctype html>
   
2. <html lang="en">
   
3. <head>
   
4. <meta charset="utf-8">
   
5. <title>jQuery.post demo</title>
   
6. <script src="http://code.jquery.com/jquery-1.9.1.js"></script>
   
7. </head>
   
8. <body>
   
9. <form action="/" id="searchForm">
   
10. <input type="text" name="s" placeholder="Search..." />
    
11. <input type="submit" value="Search" />
    
12. </form>
    
13. <!-- the result of the search will be rendered inside this div -->
    
14. <div id="result"></div>
    
15. <script>
    
16. /* attach a submit handler to the form */
    
17. $("#searchForm").submit(function(event) {
    
18. /* stop form from submitting normally */
    
19. event.preventDefault();
    
20. /* get some values from elements on the page: */
    
21. var $form = $( this ),
    
22. term = $form.find( 'input[name="s"]' ).val(),
    
23. url = $form.attr( 'action' );
    
24. /* Send the data using post */
    
25. var posting = $.post( url, { s: term } );
    
26. /* Put the results in a div */
    
27. posting.done(function( data ) {
    
28. var content = $( data ).find( '#content' );
    
29. $( "#result" ).empty().append( content );
    
30. });
    
31. });
    
32. </script>
    
33. </body>
    
34. </html>

复制代码

demo

Let's have this php file on server named ajax_2.php

1. <?php
   
2. $str = 'Response...';
   
3. if (isset($_GET['s']) && ($_GET['s']!= '')){
   
4.     echo '<p><div id="content">' . $_GET['s'] .
   
5.          ' - ' . $_GET['s'] .'</div></p>';
   
6. }else{
   
7.     echo '<p><div id="content">' . $_POST['s'] . ' + ' . $_POST['s'];
   
8.     echo '<b>...</b>' .'</div></p>';
   
9. }
   
10. ?>

复制代码

Then create another php file to be accessible from clients, file named as ajax_1.php

1. <!doctype html>
   
2. <html lang="en">
   
3. <head>
   
4. <meta charset="utf-8">
   
5. <title>jQuery.post demo</title>
   
6. <!-- script src="http://ajax.googleapis.com/ajax/libs/jquery/1.10.2/jquery.min.js"></script -->
   
7. <script src="http://code.jquery.com/jquery-1.9.1.js"></script>
   
8. </head>
   
9. <body>
   
10. <form action="ajax_2.php" id="searchForm" >
    
11. <input type="text" name="s" placeholder="Search..." />
    
12. <input type="submit" value="Search" />
    
13. </form>
    
14. ------
    
15. 
    
16. <!-- the result of the search will be rendered inside this div -->
    
17. <div id="result"></div>
    
18. <script>
    
19. 
    
20. /* attach a submit handler to the form */
    
21. $("#searchForm").submit(function(event) {
    
22. 
    
23.     /* stop form from submitting normally */
    
24.     event.preventDefault();
    
25.     /* get some values from elements on the page: */
    
26.     var $form = $(this),
    
27.     term = $form.find('input[name="s"]').val(),
    
28.     url = $form.attr('action');
    
29.     /* Send the data using post */
    
30.     var posting = $.post(url, {s: term});
    
31.     /* Put the results in a div */
    
32.     posting.done(function(data) {
    
33.         var content = $(data).get(0).outerHTML;
    
34.         content = '13579' + content;
    
35.         $("#result").empty().append(content);
    
36.     });
    
37.     alert('Res:|' + $("#result").html() + '|');
    
38.     $("#result"). append("55555");
    
39. });
    
40. </script>
    
41. </body>
    
42. </html>

复制代码

You may active the submition while you click the button.