diff options
Diffstat (limited to 'files/pt-br/web/api/attr')
-rw-r--r-- | files/pt-br/web/api/attr/index.html | 132 | ||||
-rw-r--r-- | files/pt-br/web/api/attr/localname/index.html | 133 |
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"><button id="example">Click me</button></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> |