aboutsummaryrefslogtreecommitdiff
path: root/files/pt-br/web/api/location
diff options
context:
space:
mode:
authorPeter Bengtsson <mail@peterbe.com>2020-12-08 14:42:52 -0500
committerPeter Bengtsson <mail@peterbe.com>2020-12-08 14:42:52 -0500
commit074785cea106179cb3305637055ab0a009ca74f2 (patch)
treee6ae371cccd642aa2b67f39752a2cdf1fd4eb040 /files/pt-br/web/api/location
parentda78a9e329e272dedb2400b79a3bdeebff387d47 (diff)
downloadtranslated-content-074785cea106179cb3305637055ab0a009ca74f2.tar.gz
translated-content-074785cea106179cb3305637055ab0a009ca74f2.tar.bz2
translated-content-074785cea106179cb3305637055ab0a009ca74f2.zip
initial commit
Diffstat (limited to 'files/pt-br/web/api/location')
-rw-r--r--files/pt-br/web/api/location/assign/index.html120
-rw-r--r--files/pt-br/web/api/location/index.html184
-rw-r--r--files/pt-br/web/api/location/reload/index.html114
-rw-r--r--files/pt-br/web/api/location/search/index.html55
4 files changed, 473 insertions, 0 deletions
diff --git a/files/pt-br/web/api/location/assign/index.html b/files/pt-br/web/api/location/assign/index.html
new file mode 100644
index 0000000000..e1a1cf8609
--- /dev/null
+++ b/files/pt-br/web/api/location/assign/index.html
@@ -0,0 +1,120 @@
+---
+title: Location.assign()
+slug: Web/API/Location/assign
+tags:
+ - API
+ - HTML-DOM
+ - Location
+ - Referencia
+ - metodo
+translation_of: Web/API/Location/assign
+---
+<p>{{ APIRef("HTML DOM") }}</p>
+
+<p>O método <code><strong>Location.assign()</strong></code> faz com que o navegador carregue o documento na URL especificada e a exiba na janela atual.</p>
+
+<p>Se a tatefa não poder ser executada por alguma violação de segurança, uma {{domxref("DOMException")}} do tipo <code>SECURITY_ERROR</code> será lançada. Isso acontece se a origem do script chamador do método for diferente da origem da página originalmente descrita no objeto {{domxref("Location")}}, geralmente quando o script está hospedado em um dominio diferente.</p>
+
+<p>Se a URL especificada for inválida, uma {{domxref("DOMException")}} do tipo <code>SYNTAX_ERROR</code> será lançada.</p>
+
+<h2 id="Sintaxe">Sintaxe</h2>
+
+<pre class="syntaxbox"><em>location</em>.assign(<em>url</em>);
+</pre>
+
+<h3 id="Parâmetros">Parâmetros</h3>
+
+<dl>
+ <dt><em>url</em></dt>
+ <dd>É uma {{domxref("DOMString")}} contendo a URL da página destino.</dd>
+</dl>
+
+<h2 id="Exemplos">Exemplos</h2>
+
+<pre class="brush: js">// Navega para a página do artigo Location.reload
+document.location.assign('https://developer.mozilla.org/en-US/docs/Web/API/Location.reload');</pre>
+
+<h2 id="Especificações">Especificações</h2>
+
+<table class="standard-table">
+ <tbody>
+ <tr>
+ <th scope="col">Especificação</th>
+ <th scope="col">Status</th>
+ <th scope="col">Comentários</th>
+ </tr>
+ <tr>
+ <td>{{SpecName('HTML WHATWG', "history.html#dom-location-assign", "Location.assign()")}}</td>
+ <td>{{Spec2('HTML WHATWG')}}</td>
+ <td>Sem alterações  no {{SpecName("HTML5 W3C")}}.</td>
+ </tr>
+ <tr>
+ <td>{{SpecName('HTML5 W3C', "browsers.html#dom-location-assign", "Location.assign()")}}</td>
+ <td>{{Spec2('HTML5 W3C')}}</td>
+ <td>Definição inicial.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="Compatibilidade_com_Navegadores">Compatibilidade com Navegadores</h2>
+
+<p>{{ CompatibilityTable() }}</p>
+
+<div id="compat-desktop">
+<table class="compat-table">
+ <tbody>
+ <tr>
+ <th>Característica</th>
+ <th>Chrome</th>
+ <th>Edge</th>
+ <th>Firefox (Gecko)</th>
+ <th>Internet Explorer</th>
+ <th>Opera</th>
+ <th>Safari</th>
+ </tr>
+ <tr>
+ <td>Suporte Básico</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ </tr>
+ </tbody>
+</table>
+</div>
+
+<div id="compat-mobile">
+<table class="compat-table">
+ <tbody>
+ <tr>
+ <th>Característica</th>
+ <th>Android</th>
+ <th>Chrome for Android</th>
+ <th>Edge</th>
+ <th>Firefox Mobile (Gecko)</th>
+ <th>IE Mobile</th>
+ <th>Opera Mobile</th>
+ <th>Safari Mobile</th>
+ </tr>
+ <tr>
+ <td>Suporte Básico</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ </tr>
+ </tbody>
+</table>
+</div>
+
+<h2 id="Veja_também">Veja também</h2>
+
+<ul>
+ <li>A interface {{domxref("Location")}}.</li>
+ <li>Métodos Similares: {{domxref("Location.replace()")}} and {{domxref("Location.reload()")}}.</li>
+</ul>
diff --git a/files/pt-br/web/api/location/index.html b/files/pt-br/web/api/location/index.html
new file mode 100644
index 0000000000..027a8564ec
--- /dev/null
+++ b/files/pt-br/web/api/location/index.html
@@ -0,0 +1,184 @@
+---
+title: Location
+slug: Web/API/Location
+tags:
+ - API
+ - Interface
+ - Location
+translation_of: Web/API/Location
+---
+<p>{{APIRef("HTML DOM")}}</p>
+
+<h2 id="Resumo">Resumo</h2>
+
+<p>A interface <code>Location</code> representa a localização do objeto a qual ele está associado. Mudanças feitas na interface serão refletidas nos objetos relacionados a ela. Tanto a interface {{domxref("Document")}}, como a interface {{domxref("Window")}} , têm este vínculo com a inteface Location, acessível via {{domxref("Document.location")}} e {{domxref("Window.location")}} respectivamente.</p>
+
+<h2 id="Propriedades">Propriedades</h2>
+
+<p><em>A inteface <code>Location</code> não herda nenhuma propriedade, mas implementa as propriedades de </em><em>{{domxref("URLUtils")}}.</em></p>
+
+<dl>
+ <dt>{{domxref("URLUtils.href")}}</dt>
+ <dd>É uma {{domxref("DOMString")}} que contém toda URL.</dd>
+ <dt>{{domxref("URLUtils.protocol")}}</dt>
+ <dd>É uma {{domxref("DOMString")}} que contém o esquema de protocolo da URL, incluindo o final ':'.</dd>
+ <dt>{{domxref("URLUtils.host")}}</dt>
+ <dd>É uma {{domxref("DOMString")}} que contém o <em>host</em>, que é o <em>hostname</em> seguido de ':' e a <em>port</em> da URL.</dd>
+ <dt>{{domxref("URLUtils.hostname")}}</dt>
+ <dd>É uma {{domxref("DOMString")}} que contém o domínio da URL.</dd>
+ <dt>{{domxref("URLUtils.port")}}</dt>
+ <dd>É uma {{domxref("DOMString")}} que contém o número da porta da URL.</dd>
+ <dt>{{domxref("URLUtils.pathname")}}</dt>
+ <dd>É uma {{domxref("DOMString")}} que contém <code>'/', como </code>caractere inicial<code>,</code> seguido do caminho da URL.</dd>
+ <dt>{{domxref("URLUtils.search")}}</dt>
+ <dd>É uma {{domxref("DOMString")}} que contém um <code>'?'</code> seguido dos parâmetros da URL.</dd>
+ <dt>{{domxref("URLUtils.hash")}}</dt>
+ <dd>É uma {{domxref("DOMString")}} que contém um <code>'#'</code> seguido do identificador de fragmento da URL.</dd>
+ <dt>{{domxref("URLUtils.username")}}</dt>
+ <dd>É uma {{domxref("DOMString")}} que contém o nome de usuário especificado antes do nome de domínio.</dd>
+ <dt>{{domxref("URLUtils.password")}}</dt>
+ <dd>É uma {{domxref("DOMString")}} que contém a senha especificada antes do nome de domínio.</dd>
+ <dt>{{domxref("URLUtils.origin")}} {{readOnlyInline}}</dt>
+ <dd>Retorna uma {{domxref("DOMString")}} que contém a forma canônica da origem do local especificado.</dd>
+</dl>
+
+<h2 id="Métodos">Métodos</h2>
+
+<p><em>A inteface <code>Location</code></em><em> não herda nenhum método, mas implementa os métodos de<em> {{domxref("URLUtils")}}</em>.</em></p>
+
+<dl>
+ <dt>{{domxref("Location.assign()")}}</dt>
+ <dd>Carrega o recurso na URL fornecida como parâmetro.</dd>
+ <dt>{{domxref("Location.reload()")}}</dt>
+ <dd>Recarrega o recurso a partir da URL atual. Seu único parâmetro opcional é um {{domxref("Boolean")}}, que, quando verdadeiro (<code>true)</code>, faz com que a página sempre seja recarregada a partir do servidor. Se for falso (<code>false)</code> ou não especificado,  o navegador pode recarregar a página a partir de seu cache.</dd>
+ <dt>{{domxref("Location.replace()")}}</dt>
+ <dd>Substitui o recurso atual pelo recurso presente na URL fornecida. A diferença entre o método <code>assign()</code> é que após usar <code>replace()</code> a página atual não será salva na sessão  {{domxref("History")}}, ou seja, o usuário não será capaz de usar o botão <em>voltar </em>para navegar até a página.</dd>
+ <dt>{{domxref("URLUtils.toString()")}}</dt>
+ <dd>Retorna uma {{domxref("DOMString")}} que contém toda URL. O método é um sinônimo para {{domxref("URLUtils.href")}}, embora não possa ser usado para modificar o valor.</dd>
+</dl>
+
+<h2 id="Especificações">Especificações</h2>
+
+<table class="standard-table">
+ <tbody>
+ <tr>
+ <th scope="col">Especificação</th>
+ <th scope="col">Status</th>
+ <th scope="col">Comentário</th>
+ </tr>
+ <tr>
+ <td>{{SpecName('HTML WHATWG', "history.html#the-location-interface", "Location")}}</td>
+ <td>{{Spec2('HTML WHATWG')}}</td>
+ <td>Nenhuma mudança a partir {{SpecName("HTML5 W3C")}}.</td>
+ </tr>
+ <tr>
+ <td>{{SpecName('HTML5 W3C', "browsers.html#the-location-interface", "Location")}}</td>
+ <td>{{Spec2('HTML5 W3C')}}</td>
+ <td>Definição inicial.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="Compatibilidade_entre_Navegadores">Compatibilidade entre Navegadores</h2>
+
+<p>{{CompatibilityTable}}</p>
+
+<div id="compat-desktop">
+<table class="compat-table">
+ <tbody>
+ <tr>
+ <th>Funcionalidade</th>
+ <th>Chrome</th>
+ <th>Firefox (Gecko)</th>
+ <th>Internet Explorer</th>
+ <th>Opera</th>
+ <th>Safari (WebKit)</th>
+ </tr>
+ <tr>
+ <td>Suporte Básico</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ </tr>
+ <tr>
+ <td><code>origin</code> em <code>Windows.location</code></td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatGeckoDesktop("21")}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ </tr>
+ <tr>
+ <td><code>origin</code> em todos objetos <code>location</code> (mas nos objetos Workers, que usam {{domxref("WorkerLocation")}})</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatGeckoDesktop("26")}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ </tr>
+ <tr>
+ <td><code>username</code> e <code>password</code></td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatGeckoDesktop("26")}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ </tr>
+ </tbody>
+</table>
+</div>
+
+<div id="compat-mobile">
+<table class="compat-table">
+ <tbody>
+ <tr>
+ <th>Funcionalidade</th>
+ <th>Android</th>
+ <th>Firefox Mobile (Gecko)</th>
+ <th>IE Phone</th>
+ <th>Opera Mobile</th>
+ <th>Safari Mobile</th>
+ </tr>
+ <tr>
+ <td>Suporte Básico</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ </tr>
+ <tr>
+ <td><code>origin</code> on <code>Windows.location</code></td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatGeckoMobile("21")}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ </tr>
+ <tr>
+ <td><code>origin</code> on all <code>location</code> objects (mas nos objetos Workers, que usam {{domxref("WorkerLocation")}})</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatGeckoMobile("26")}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ </tr>
+ <tr>
+ <td><code>username</code> e <code>password</code></td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatGeckoMobile("26")}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ </tr>
+ </tbody>
+</table>
+</div>
+
+<h2 id="Veja_também">Veja também</h2>
+
+<ul>
+ <li>Dois métodos que criam um objeto Location: {{domxref("Window.location")}} e {{domxref("Document.location")}}.</li>
+</ul>
diff --git a/files/pt-br/web/api/location/reload/index.html b/files/pt-br/web/api/location/reload/index.html
new file mode 100644
index 0000000000..24d990bbe8
--- /dev/null
+++ b/files/pt-br/web/api/location/reload/index.html
@@ -0,0 +1,114 @@
+---
+title: Location.reload()
+slug: Web/API/Location/reload
+tags:
+ - API
+ - HTML-DOM
+ - Localização
+ - Referencia
+ - metodo
+translation_of: Web/API/Location/reload
+---
+<p>{{ APIRef("HTML DOM") }}</p>
+
+<p>O método <code><strong>Location.reload()</strong></code> recarrega a URL atual. Seu unico parâmetro opcional é um {{domxref("Boolean")}}, que, quando <code>true</code>, faz com que a página sempre seja recarregada do servidor. Se ele é <code>false</code> ou não estiver especificado, o navegador pode carregar ela do cache.</p>
+
+<p>Caso não seja possível recarregar por questões de violação de segurança, uma {{domxref("DOMException")}} do tipo <code>SECURITY_ERROR</code> é jogada. Isso acontece se a origem do script que chama o método é diferente da origem da página originalmente descrita pelo objeto {{domxref("Location")}}, usualmente quando o script é hosteado em um domínio diferente.</p>
+
+<h2 id="Sintaxe">Sintaxe</h2>
+
+<pre class="syntaxbox"><em>object</em>.reload(<em>forcedReload</em>);
+</pre>
+
+<h3 id="Parametros">Parametros</h3>
+
+<dl>
+ <dt><em>forcedReload</em> {{optional_inline}}</dt>
+ <dd>É uma flag {{domxref("Boolean")}}, que quando <code>true</code>, faz com que a página sempre seja recarregada do servidor, se é <code>false ou não for definido, </code>o navegador pode recarregar a página do cache.</dd>
+</dl>
+
+<h2 id="Exemplos">Exemplos</h2>
+
+<pre class="brush: js">// Recarrega a página atual sem usar o cache
+document.location.reload(true);</pre>
+
+<h2 id="Especificações">Especificações</h2>
+
+<table class="standard-table">
+ <tbody>
+ <tr>
+ <th scope="col">Specification</th>
+ <th scope="col">Status</th>
+ <th scope="col">Comment</th>
+ </tr>
+ <tr>
+ <td>{{SpecName('HTML WHATWG', "history.html#dom-location-reload", "Location.reload()")}}</td>
+ <td>{{Spec2('HTML WHATWG')}}</td>
+ <td>Nenhuma mudança do  {{SpecName("HTML5 W3C")}}.</td>
+ </tr>
+ <tr>
+ <td>{{SpecName('HTML5 W3C', "browsers.html#dom-location-reload", "Location.reload()")}}</td>
+ <td>{{Spec2('HTML5 W3C')}}</td>
+ <td>Definição inicial.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="Compatibilidade_de_Navegadores">Compatibilidade de Navegadores</h2>
+
+<p>{{ CompatibilityTable() }}</p>
+
+<div id="compat-desktop">
+<table class="compat-table">
+ <tbody>
+ <tr>
+ <th>Feature</th>
+ <th>Chrome</th>
+ <th>Firefox (Gecko)</th>
+ <th>Internet Explorer</th>
+ <th>Opera</th>
+ <th>Safari</th>
+ </tr>
+ <tr>
+ <td>Basic support</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ </tr>
+ </tbody>
+</table>
+</div>
+
+<div id="compat-mobile">
+<table class="compat-table">
+ <tbody>
+ <tr>
+ <th>Feature</th>
+ <th>Android</th>
+ <th>Chrome for Android</th>
+ <th>Firefox Mobile (Gecko)</th>
+ <th>IE Mobile</th>
+ <th>Opera Mobile</th>
+ <th>Safari Mobile</th>
+ </tr>
+ <tr>
+ <td>Basic support</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ </tr>
+ </tbody>
+</table>
+</div>
+
+<h2 id="Veja_também">Veja também</h2>
+
+<ul>
+ <li>A interface {{domxref("Location")}} que o método pertence.</li>
+ <li>Métodos similares: {{domxref("Location.assign()")}} e {{domxref("Location.replace()")}}.</li>
+</ul>
diff --git a/files/pt-br/web/api/location/search/index.html b/files/pt-br/web/api/location/search/index.html
new file mode 100644
index 0000000000..6cc17724d5
--- /dev/null
+++ b/files/pt-br/web/api/location/search/index.html
@@ -0,0 +1,55 @@
+---
+title: 'Location: search'
+slug: Web/API/Location/search
+tags:
+ - API
+ - Location
+ - Propriedade
+ - Search
+translation_of: Web/API/Location/search
+---
+<div>{{ApiRef("Location")}}</div>
+
+<p>A propriedade <strong><code>search</code></strong> da interface {{domxref("Location")}} é um texto de busca, também chamado de <em>query string</em> ou <em>querystring</em>; isso é, uma {{domxref("USVString")}} contendo um <code>'?'</code> seguido pelos parâmetros da URL.</p>
+
+<p>Os navegadores modernos fornecem o <code><a href="/en-US/docs/Web/API/URLSearchParams/get#Examples">URLSearchParams</a></code> e o <code><a href="/en-US/docs/Web/API/URL/searchParams#Examples">URL.searchParams</a></code> para facilitar a análise dos parâmetros da querystring.</p>
+
+<h2 id="Sintaxe">Sintaxe</h2>
+
+<pre class="syntaxbox"><em>string</em> = <em>object</em>.search;
+<em>object</em>.search = <em>string</em>;
+</pre>
+
+<h2 id="Exemplos">Exemplos</h2>
+
+<pre class="brush: js">// Seleciona o elemento &lt;a id="myAnchor" href="https://developer.mozilla.org/en-US/docs/Location.search?q=123"&gt;
+var anchor = document.getElementById("myAnchor");
+var queryString = anchor.search; // Retorna:'?q=123'
+
+// Análise adicional:
+let params = new URLSearchParams(queryString);
+let q = parseInt(params.get("q")<span class="kwd">); // é o número 123</span>
+</pre>
+
+<h2 id="Especificação">Especificação</h2>
+
+<table class="standard-table">
+ <tbody>
+ <tr>
+ <th scope="col">Especificação</th>
+ <th scope="col">Status</th>
+ <th scope="col">Comentário</th>
+ </tr>
+ <tr>
+ <td>{{SpecName('HTML WHATWG', '#dom-location-search', 'search')}}</td>
+ <td>{{Spec2('HTML WHATWG')}}</td>
+ <td>Definição inicial.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="Compatibilidade_do_navegador">Compatibilidade do navegador</h2>
+
+<div class="hidden">A tabela de compatibilidade nesta página é gerada a partir de dados estruturados. Se deseja contribuir com os dados, por favor consulte <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> e nos envie um pull request.</div>
+
+<p>{{Compat("api.Location.search")}}</p>