Browse files

Merge pull request #7 from karllo/pt-br

tradução completa da página jQuery.get()
  • Loading branch information...
2 parents 0cf4d22 + ce1ed79 commit 5d64dea7ce1e038afd8a6ec40351300f6d332064 @luiztiago luiztiago committed May 31, 2011
Showing with 30 additions and 30 deletions.
  1. +30 −30 docs/jQuery.get/index.html
View
60 docs/jQuery.get/index.html
@@ -5,7 +5,7 @@
<h1 class="jq-clearfix">jQuery.get()</h1>
<div class="entry-meta jq-clearfix">
- Categories:
+ Categorias:
<span class="category"><a href="http://api.jquery.com/category/ajax/" title="View all posts in Ajax">Ajax</a> &gt; <a href="http://api.jquery.com/category/ajax/shorthand-methods/" title="View all posts in Shorthand Methods">Shorthand Methods</a></span>
@@ -14,41 +14,41 @@ <h1 class="jq-clearfix">jQuery.get()</h1>
</div>
<div id="jQuery-get1" class="entry method">
<h2 class="jq-clearfix roundTop section-title">
-<span class="name">jQuery.get( url, [ data ], [ success(data, textStatus, jqXHR) ], [ dataType ] )</span> <span class="returns">Returns: <a class="return" href="http://api.jquery.com/Types/#jqXHR">jqXHR</a></span>
+<span class="name">jQuery.get( url, [ data ], [ success(data, textStatus, jqXHR) ], [ dataType ] )</span> <span class="returns">Retorna: <a class="return" href="http://api.jquery.com/Types/#jqXHR">jqXHR</a></span>
</h2>
<div class="jq-box roundBottom entry-details">
-<p class="desc"><strong>Description: </strong>Load data from the server using a HTTP GET request.</p>
+<p class="desc"><strong>Descrição: </strong>Carrega dados a partir do servidor usando uma requisição HTTP GET.</p>
<ul class="signatures"><li class="signature" id="jQuery-get-url-data-successdata- textStatus- jqXHR-dataType">
<h4 class="name">
-<span class="versionAdded">version added: <a href="/category/version/1.0/">1.0</a></span>jQuery.get( url, [ data ], [ success(data, textStatus, jqXHR) ], [ dataType ] )</h4>
-<p class="arguement"><strong>url</strong>A string containing the URL to which the request is sent.</p>
-<p class="arguement"><strong>data</strong>A map or string that is sent to the server with the request.</p>
-<p class="arguement"><strong>success(data, textStatus, jqXHR)</strong>A callback function that is executed if the request succeeds.</p>
-<p class="arguement"><strong>dataType</strong>The type of data expected from the server. Default: Intelligent Guess (xml, json, script, or html).</p>
+<span class="versionAdded">adicionado na versão: <a href="/category/version/1.0/">1.0</a></span> jQuery.get( url, [ data ], [ success(data, textStatus, jqXHR) ], [ dataType ] )</h4>
+<p class="arguement"><strong>url</strong> Uma string contendo a URL a qual a requisição é enviada.</p>
+<p class="arguement"><strong>data</strong> Um map ou string que é enviado ao servidor com a requisição.</p>
+<p class="arguement"><strong>success(data, textStatus, jqXHR)</strong> Uma função callback que é executada se a requisição for bem sucedida.</p>
+<p class="arguement"><strong>dataType</strong> O tipo de dado esperado do servidor. Default: Hipótese Inteligente (xml, json, script, or html).</p>
</li></ul>
<div class="longdesc">
-<p>This is a shorthand Ajax function, which is equivalent to:</p>
+<p>Essa é uma simplificação de uma função Ajax, que é equivalente a:</p>
<pre>$.ajax({
url: <em>url</em>,
data: <em>data</em>,
success: <em>success</em>,
dataType: <em>dataType</em>
});
</pre>
-<p>The <code>success</code> callback function is passed the returned data, which will be an XML root element, text string, JavaScript file, or JSON object, depending on the MIME type of the response. It is also passed the text status of the response. </p>
-<p><strong>As of jQuery 1.5</strong>, the <code>success</code> callback function is also passed a <a href="http://api.jquery.com/jQuery.get/#jqxhr-object">"jqXHR" object</a> (in <strong>jQuery 1.4</strong>, it was passed the <code>XMLHttpRequest</code> object). However, since JSONP and cross-domain GET requests do not use <abbr title="XMLHTTPRequest">XHR</abbr>, in those cases the <code>(j)XHR</code> and <code>textStatus</code> parameters passed to the success callback are undefined.</p>
-<p>Most implementations will specify a success handler:</p>
+<p>A função callback <code>success</code> passa os dados retornados, os quais serão um elemento root XML, string de texto, arquivo JavaScript , ou objeto JSON, dependendo do MIME type da resposta. Também é passado o status de texto da resposta. </p>
+<p><strong>A partir da jQuery 1.5</strong>, a função callback <code>success</code> também passa o objeto <a href="http://api.jquery.com/jQuery.get/#jqxhr-object">"jqXHR" </a> (na <strong>jQuery 1.4</strong>, era passado o objeto <code>XMLHttpRequest</code> ). No entanto, desde que JSONP e requisições GET cross-domain não usam <abbr title="XMLHTTPRequest">XHR</abbr>, nesses casos os parâmetros <code>(j)XHR</code> e <code>textStatus</code> passados para o success callback são indefinidos.</p>
+<p>A maioria das implementações irão especificar o handler success:</p>
<pre>$.get('ajax/test.html', function(data) {
$('.result').html(data);
alert('Load was performed.');
});
</pre>
-<p>This example fetches the requested HTML snippet and inserts it on the page.</p>
-<h4 id="jqxhr-object">The jqXHR Object</h4>
-<p><strong>As of jQuery 1.5</strong>, all of jQuery's Ajax methods return a superset of the <code>XMLHTTPRequest</code> object. This jQuery XHR object, or "jqXHR," returned by <code>$.get()</code> implements the Promise interface, giving it all the properties, methods, and behavior of a Promise (see <a href="http://api.jquery.com/category/deferred-object/">Deferred object</a> for more information). For convenience and consistency with the callback names used by <code><a href="http://api.jquery.com/jQuery.ajax/">$.ajax()</a></code>, it provides <code>.error()</code>, <code>.success()</code>, and <code>.complete()</code> methods. These methods take a function argument that is called when the request terminates, and the function receives the same arguments as the correspondingly-named <code>$.ajax()</code> callback.</p>
-<p>The Promise interface in jQuery 1.5 also allows jQuery's Ajax methods, including <code>$.get()</code>, to chain multiple <code>.success()</code>, <code>.complete()</code>, and <code>.error()</code> 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.</p>
-<pre>// Assign handlers immediately after making the request,
- // and remember the jqxhr object for this request
+<p>Esse exemplo busca um bloco de código HTML requisitado e o insere na página.</p>
+<h4 id="jqxhr-object">O Objeto jqXHR </h4>
+<p><strong>A partir da jQuery 1.5</strong>,todos os métodos Ajax do jQuery retornam um superset do objeto <code>XMLHTTPRequest</code>. Esse objeto jQuery XHR , ou "jqXHR," retornados pelo <code>$.get()</code> implementam a interface Promise, dando-os todas as propriedades, métodos e comportamentos da Promise (veja <a href="http://api.jquery.com/category/deferred-object/">Deferred object</a> para mais informação). Por conveniência e consistência com os nomes de callback usados por <code><a href="http://api.jquery.com/jQuery.ajax/">$.ajax()</a></code>, ele fornece os métodos <code>.error()</code>, <code>.success()</code>, e <code>.complete()</code> . Esses métodos recebem um argumento de função que é chamado quando a requisição é finalizada, e a função recebe os mesmos argumentos do callback com nome correspondente <code>$.ajax()</code> .</p>
+<p>A interface Promise no jQuery 1.5 também permite que métodos Ajax do jQuery, incluindo <code>$.get()</code>, encadear múlltiplos callbacks <code>.success()</code>, <code>.complete()</code>, e <code>.error()</code> em uma única requisição, e ainda atribuir esses callbacks depois que a requisição possa ter sido concluída. Se a requisição já estiver completa, o callback é disparado imediatamente.</p>
+<pre>// Atribui handlers imediatamente após fazer a requisição,
+ // e grava o objeto jqxhr para aquela requisição
var jqxhr = $.get("example.php", function() {
alert("success");
})
@@ -58,49 +58,49 @@ <h4 id="jqxhr-object">The jqXHR Object</h4>
// perform other work here ...
- // Set another completion function for the request above
+ // Define outra função de conclusão para a requisição acima
jqxhr.complete(function(){ alert("second complete"); });</pre>
</div>
-<h3 id="notes-0">Additional Notes:</h3>
+<h3 id="notes-0">Notas adicionais:</h3>
<div class="longdesc"><ul>
-<li>Due to browser security restrictions, most "Ajax" requests are subject to the <a title="Same Origin Policy on Wikipedia" href="http://en.wikipedia.org/wiki/Same_origin_policy">same origin policy</a>; the request can not successfully retrieve data from a different domain, subdomain, or protocol.</li>
-<li>If a request with jQuery.get() returns an error code, it will fail silently unless the script has also called the global <a href="http://api.jquery.com/ajaxError/">.ajaxError() </a> method or. As of jQuery 1.5, the <code>.error()</code> method of the <code>jqXHR</code> object returned by jQuery.get() is also available for error handling.</li>
-<li>Script and JSONP requests are not subject to the same origin policy restrictions.</li>
+<li>Devido a restrições de segurança dos browsers, a maioria das requisições "Ajax" estão sujeitas a <a title="Same Origin Policy on Wikipedia" href="http://en.wikipedia.org/wiki/Same_origin_policy">política de mesma origem</a>; a requisição pode não ser bem sucedida ao recuperar dados de um domínio diferente, subdomínio, ou protocolo.</li>
+<li>Se uma requisição com jQuery.get() retorna um código de erro, ela irá falhar silenciosamente a não ser que o script também tenha chamado o método global <a href="http://api.jquery.com/ajaxError/">.ajaxError() </a> ou. A partir da jQuery 1.5, o método <code>.error()</code> do objeto <code>jqXHR</code> retornado pelo jQuery.get() também esta disponível para tratamento de erros.</li>
+<li>Script e requisições JSONP não estão suijeitos às restrições da política de mesma origem.</li>
</ul></div>
-<h3>Examples:</h3>
+<h3>Exemplos:</h3>
<div class="entry-examples" id="entry-examples">
<div id="example-0">
-<h4>Example: <span class="desc">Request the test.php page, but ignore the return results.</span>
+<h4>Exemplo: <span class="desc">Requisita a página test.php page, mas ignora o resultado retornado.</span>
</h4>
<pre class="prettyprint"><code class="example">$.get("test.php");</code></pre>
</div>
<div id="example-1">
-<h4>Example: <span class="desc">Request the test.php page and send some additional data along (while still ignoring the return results).</span>
+<h4>Exemplo: <span class="desc">Requisita a página test.php e envia alguns dados adicionais junto (enquanto continua ignorando o resultado retornado).</span>
</h4>
<pre class="prettyprint"><code class="example">$.get("test.php", { name: "John", time: "2pm" } );</code></pre>
</div>
<div id="example-2">
-<h4>Example: <span class="desc">pass arrays of data to the server (while still ignoring the return results).</span>
+<h4>Exemplo: <span class="desc">passa arrays de dados para o servidor (nquanto continua ignorando o resultado retornado).</span>
</h4>
<pre class="prettyprint"><code class="example">$.get("test.php", { 'choices[]': ["Jon", "Susan"]} );</code></pre>
</div>
<div id="example-3">
-<h4>Example: <span class="desc">Alert out the results from requesting test.php (HTML or XML, depending on what was returned).</span>
+<h4>Exemplo: <span class="desc">Alerta na tela os resultados vindos da requisição feita ao test.php (HTML ou XML, dependendo do que foi retornado).</span>
</h4>
<pre class="prettyprint"><code class="example">$.get("test.php", function(data){
alert("Data Loaded: " + data);
});</code></pre>
</div>
<div id="example-4">
-<h4>Example: <span class="desc">Alert out the results from requesting test.cgi with an additional payload of data (HTML or XML, depending on what was returned).</span>
+<h4>Example: <span class="desc">Alerta na tela os resultados vindos da requisição feita ao test.cgi com uma carga adicional de dados (HTML ou XML, dependendo do que foi retornado).</span>
</h4>
<pre class="prettyprint"><code class="example">$.get("test.cgi", { name: "John", time: "2pm" },
function(data){
alert("Data Loaded: " + data);
});</code></pre>
</div>
<div id="example-5">
-<h4>Example: <span class="desc"> Gets the test.php page contents which has been returned in json format (&lt;?php echo json_encode(array("name"=&gt;"John","time"=&gt;"2pm")); ?&gt;).</span>
+<h4>Exemplo: <span class="desc"> Acessa o conteúdo da página test.php o qual foi retornado no formato json (&lt;?php echo json_encode(array("name"=&gt;"John","time"=&gt;"2pm")); ?&gt;).</span>
</h4>
<pre class="prettyprint"><code class="example">$.get("test.php", { "func": "getNameAndTime" },
function(data){

0 comments on commit 5d64dea

Please sign in to comment.