aboutsummaryrefslogtreecommitdiff
path: root/files/pt-br/web/api/attr
diff options
context:
space:
mode:
Diffstat (limited to 'files/pt-br/web/api/attr')
-rw-r--r--files/pt-br/web/api/attr/index.html132
-rw-r--r--files/pt-br/web/api/attr/localname/index.html133
2 files changed, 265 insertions, 0 deletions
diff --git a/files/pt-br/web/api/attr/index.html b/files/pt-br/web/api/attr/index.html
new file mode 100644
index 0000000000..683dda4847
--- /dev/null
+++ b/files/pt-br/web/api/attr/index.html
@@ -0,0 +1,132 @@
+---
+title: Attr
+slug: Web/API/Attr
+tags:
+ - API
+ - DOM
+ - Gecko DOM
+ - JavaScript
+translation_of: Web/API/Attr
+---
+<p>{{APIRef("DOM")}}<br>
+ Este tipo representa um atributo de elemento DOM como um objeto. Na maioria dos métodos DOM, você provavelmente irá retornar diretamente o atributo como uma string (e.g., {{domxref("Element.getAttribute()")}}, mas certas funções (e.g., {{domxref("Element.getAttributeNode()")}}) ou meios de iteração retornam tipos <code>Attr</code>.</p>
+
+<p>{{InheritanceDiagram}}</p>
+
+<div class="warning"><strong>Aviso:</strong> Começando no Gecko 7.0 {{geckoRelease("7.0")}}, os que serão removidos mostram mensagens de aviso no console. Você deve revisar seu código de acordo. Veja <a href="https://developer.mozilla.org/pt-BR/docs/Web/API/Attr$edit#Deprecated_properties_and_methods">métodos e propriedades descontinuadas</a> para uma lista completa.</div>
+
+<h2 id="Propriedades">Propriedades</h2>
+
+<p> </p>
+
+<dl>
+ <dt>{{domxref("Attr.name", "name")}} {{readOnlyInline}}</dt>
+ <dd>O nome do Atributo.</dd>
+</dl>
+
+<p> </p>
+
+<p> </p>
+
+<dl>
+ <dt>{{domxref("Attr.namespaceURI", "namespaceURI")}} {{readOnlyInline}}</dt>
+ <dd>Uma {{domxref("DOMString")}} representando o namespace URI do atributo, ou <code>null</code> se não há namespace</dd>
+ <dt>{{domxref("Attr.localName", "localName")}} {{readOnlyInline}}</dt>
+ <dd>Uma {{domxref("DOMString")}} representando a parte local do nome qualificado do atributo.</dd>
+ <dt>{{domxref("Attr.prefix", "prefix")}} {{readOnlyInline}}</dt>
+ <dd>Uma {{domxref("DOMString")}} representando o prefixo do namespace do atributo ou <code>null</code> se nenhum prefixo foi especificado.</dd>
+ <dt>{{domxref("Attr.ownerElement", "ownerElement")}} {{readOnlyInline}}</dt>
+ <dd>
+ <p>O elemento que possui o atributo.</p>
+ </dd>
+</dl>
+
+<p> </p>
+
+<div class="note">
+<p><strong>Nota:</strong> DOM Level 4 removeu esta propriedade. Foi suposto que como você recebe um objeto <code>Attr</code> de um {{domxref("Element")}}, você já deve saber qual é o elemento associado.<br>
+ Como isto não é sempre verdadeiro em casos como objetos <code>Attr</code> sendo retornados pelo {{domxref("Document.evaluate")}}, o DOM Living Standard reintroduziu a propriedade.</p>
+
+<p>Gecko mostra uma mensagem de descontinuação começando no Gecko 7.0 {{geckoRelease("7.0")}}. Esta mensagem foi removida novamente no Gecko 49.0 {{geckoRelease("49.0")}}.</p>
+</div>
+
+<h2 id="Propriedades_e_métodos_descontinuados">Propriedades e métodos descontinuados</h2>
+
+<p>As seguintes propriedades e métodos foram descontinuados. Quando disponíveis, são substituidas adequadamente.</p>
+
+<dl>
+ <dt><code>attributes</code></dt>
+ <dd>Esta propriedade agora sempre retorna <code>NULL</code>.</dd>
+ <dt><code>childNodes</code></dt>
+ <dd>Esta propriedade agora sempre retorna <code>NULL</code>.</dd>
+ <dt><code>firstChild</code></dt>
+ <dd>Esta propriedade agora sempre retorna <code>NULL</code>.</dd>
+ <dt><code>lastChild</code></dt>
+ <dd>Esta propriedade agora sempre retorna <code>NULL</code>.</dd>
+ <dt><code>nextSibling</code></dt>
+ <dd>Esta propriedade agora sempre retorna <code>NULL</code>.</dd>
+ <dt><code>nodeName</code></dt>
+ <dd>Use {{domxref("Attr.name")}} no lugar.</dd>
+ <dt><code>nodeType</code></dt>
+ <dd>Esta propriedade agora sempre retorna 2 (<code>ATTRIBUTE_NODE</code>).</dd>
+ <dt><code>nodeValue</code></dt>
+ <dd>Use {{domxref("Attr.value")}} no lugar.</dd>
+ <dt><code>ownerDocument</code></dt>
+ <dd>Provavelmente você nunca utilizou isto, então você não se importa que isso vai desaparecer.</dd>
+ <dt><code>ownerElement</code></dt>
+ <dd>Desde que você obtenha o objeto <code>Attr</code> de um {{domxref("Element")}}, você já conhece os elementos associados.</dd>
+ <dt><code>parentNode</code></dt>
+ <dd>Esta propriedade agora sempre retorna <code>NULL</code>.</dd>
+ <dt><code>previousSibling</code></dt>
+ <dd>Esta propriedade agora sempre retorna <code>NULL</code>.</dd>
+ <dt><code>specified</code></dt>
+ <dd>Esta propriedade agora sempre retorna <code>true</code>.</dd>
+ <dt><code>textContent</code></dt>
+ <dd>Use {{domxref("Attr.value")}} no lugar.</dd>
+</dl>
+
+<p>Os seguintes métodos foram reprovados:</p>
+
+<dl>
+ <dt><code>appendChild()</code></dt>
+ <dd>Modifique o valor de {{domxref("Attr.value")}} no lugar.</dd>
+ <dt><code>cloneNode()</code></dt>
+ <dd>Provavelmente você nunca utilizou isto, então você não se importa que isso vai desaparecer.</dd>
+ <dt><code>createAttribute()</code></dt>
+ <dd>Use {{domxref("Element.setAttribute()")}} no lugar.</dd>
+ <dt><code>createAttributeNS()</code></dt>
+ <dd>Use {{domxref("Element.setAttributeNS()")}} no lugar.</dd>
+ <dt><code>getAttributeNode()</code></dt>
+ <dd>Use {{domxref("Element.getAttribute()")}} no lugar.</dd>
+ <dt><code>getAttributeNodeNS()</code></dt>
+ <dd>Use {{domxref("Element.getAttributeNS()")}} no lugar.</dd>
+ <dt><code>hasAttributes() </code>{{obsolete_inline("21.0")}}</dt>
+ <dd>Este método agora sempre retorna false.</dd>
+ <dt><code>hasChildNodes()</code></dt>
+ <dd>Este método agora sempre retorna false.</dd>
+ <dt><code>insertBefore()</code></dt>
+ <dd>Modifique o valor de  {{domxref("Attr.value")}} no lugar.</dd>
+ <dt><code>isSupported()</code></dt>
+ <dd>Provavelmente você nunca utilizou isto, então você não se importa que isso vai desaparecer.</dd>
+ <dt><code>isEqualNode()</code></dt>
+ <dd>Provavelmente você nunca utilizou isto, então você não se importa que isso vai desaparecer.</dd>
+ <dt><code>normalize()</code></dt>
+ <dd>Provavelmente você nunca utilizou isto, então você não se importa que isso vai desaparecer.</dd>
+ <dt><code>removeAttributeNode()</code></dt>
+ <dd>Use {{domxref("Element.removeAttribute()")}} no lugar.</dd>
+ <dt><code>removeChild()</code></dt>
+ <dd>Modifique o valor de {{domxref("Attr.value")}} no lugar.</dd>
+ <dt><code>replaceChild()</code></dt>
+ <dd>Modifique o valor de {{domxref("Attr.value")}} no lugar.</dd>
+ <dt><code>setAttributeNode()</code></dt>
+ <dd>Use {{domxref("Element.setAttribute()")}} no lugar.</dd>
+ <dt><code>setAttributeNodeNS()</code></dt>
+ <dd>Use {{domxref("Element.setAttributeNS()")}} no lugar.</dd>
+</dl>
+
+<h2 id="Especificações">Especificações</h2>
+
+<ul>
+ <li><a class="external" href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-637646024" title="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-637646024">Document Object Model Core level 3: Interface Attr</a></li>
+ <li><a class="external" href="http://www.w3.org/TR/dom/#interface-attr">Document Object Model 4: Interface Attr</a></li>
+</ul>
diff --git a/files/pt-br/web/api/attr/localname/index.html b/files/pt-br/web/api/attr/localname/index.html
new file mode 100644
index 0000000000..54b7bad202
--- /dev/null
+++ b/files/pt-br/web/api/attr/localname/index.html
@@ -0,0 +1,133 @@
+---
+title: Attr.localName
+slug: Web/API/Attr/localName
+tags:
+ - API
+ - DOM
+ - Propriedade
+ - Referencia
+translation_of: Web/API/Attr/localName
+---
+<div>{{APIRef("DOM")}}</div>
+
+<p>A propriedade read-only <code><strong>Attr.localName</strong></code> retorna a parte do local de um nome qualificado de elemento.</p>
+
+<div class="note">
+<p>Antes do DOM4 essa API foi definida dentro da interface {{domxref("Node")}}.</p>
+</div>
+
+<h2 id="Sintaxe">Sintaxe</h2>
+
+<pre class="syntaxbox"><var>name</var> = <var>attribute</var>.localName
+</pre>
+
+<h3 id="Valor_de_retorno">Valor de retorno</h3>
+
+<p>Uma {{domxref("DOMString")}} representando a parte local do nome qualificado do atributo.</p>
+
+<h2 id="Exemplo">Exemplo</h2>
+
+<p>O seguinte exemplo mostra "id" em um diálogo de alerta.</p>
+
+<h3 id="Conteúdo_HTML">Conteúdo HTML</h3>
+
+<pre class="brush: html">&lt;button id="example"&gt;Click me&lt;/button&gt;</pre>
+
+<h3 id="Conteúdo_JavaScript">Conteúdo JavaScript</h3>
+
+<pre class="brush: js">const element = document.querySelector("#example");
+element.addEventListener("click", function() {
+  const attribute = element.attributes[0];
+  alert(attribute.localName);
+});
+</pre>
+
+<p>{{ EmbedLiveSample('Example','100%',30) }}</p>
+
+<h2 id="Notas">Notas</h2>
+
+<p>O nome local de um atributo é a parte do nome qualificado do atributo the vem depois da vírgula. Nome qualificados são tipicamente utilizados em XML como parte do namespace(s) de um documento XML em particular.</p>
+
+<div class="note">
+<p><strong>Nota:</strong> No {{Gecko("1.9.2")}} e anteriores, a propriedade retorna uma versão em letras maiúsculas do nome local para o atributo DOM do HTML (oposto a atributos XHTML no DOM do XML). Em versões posteriores, em conformidade com o HTML5, a propriedade retorna no caso de armazenamento interno do DOM, que é em letras minúsculas para ambos os atributos HTML no DOM do HTML  e XHTML no DOM do XML.</p>
+</div>
+
+<h2 id="Especificações">Especificações</h2>
+
+<table class="standard-table">
+ <thead>
+ <tr>
+ <th scope="col">Especificação</th>
+ <th scope="col">Status</th>
+ <th scope="col">Comment</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>{{SpecName('DOM4', '#interface-attr', 'Attr.localName')}}</td>
+ <td>{{Spec2('DOM4')}}</td>
+ <td>Definição inicial</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="Browser_compatibility">Browser compatibility</h2>
+
+<p>{{CompatibilityTable}}</p>
+
+<div id="compat-desktop">
+<table class="compat-table">
+ <tbody>
+ <tr>
+ <th>Recurso</th>
+ <th>Chrome</th>
+ <th>Firefox (Gecko)</th>
+ <th>Internet Explorer</th>
+ <th>Opera</th>
+ <th>Safari</th>
+ </tr>
+ <tr>
+ <td>Suporte básico</td>
+ <td>46.0<sup>[1]</sup></td>
+ <td>{{CompatGeckoDesktop("48.0")}}<sup>[1]</sup></td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ </tr>
+ </tbody>
+</table>
+</div>
+
+<div id="compat-mobile">
+<table class="compat-table">
+ <tbody>
+ <tr>
+ <th>Feature</th>
+ <th>Android</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>{{CompatUnknown}}</td>
+ <td>{{CompatGeckoMobile("48.0")}}<sup>[1]</sup></td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ </tr>
+ </tbody>
+</table>
+</div>
+
+<p>[1] Essa API foi disponibilizada anteriormente na API {{domxref("Node")}}.</p>
+
+<h2 id="Veja_também">Veja também</h2>
+
+<ul>
+ <li>{{domxref("Attr.namespaceURI")}}</li>
+ <li>{{domxref("Attr.prefix")}}</li>
+ <li>{{domxref("Element.localName")}}</li>
+ <li>{{domxref("Node.localName")}}</li>
+</ul>