Atributo de nome HTML
Definição e uso
O name
atributo especifica um nome para um elemento HTML.
Este name
atributo pode ser usado para referenciar o elemento em um JavaScript.
Para um <form>
elemento, o
name
atributo é usado como referência quando os dados são enviados.
Para um <iframe>
elemento, o
name
atributo pode ser usado para direcionar um envio de formulário.
Para um <map>
elemento, o
name
atributo é associado ao atributo <img>
's
usemap
e cria um relacionamento entre a imagem e o mapa.
Para um <meta>
elemento, o
name
atributo especifica um nome para a informação/valor do
content
atributo.
Para um <param>
elemento, o
name
atributo é usado junto com o value
atributo para especificar parâmetros para o plug-in especificado com a <object>
tag.
Aplica-se a
O name
atributo pode ser usado nos seguintes elementos:
Elementos | Atributo |
---|---|
<botão> | nome |
<fieldset> | nome |
<formulário> | nome |
<iframe> | nome |
<entrada> | nome |
<mapa> | nome |
<meta> | nome |
<objeto> | nome |
<saída> | nome |
<param> | nome |
<selecione> | nome |
<textarea> | nome |
Exemplos
Exemplo
Dois botões com nomes iguais, que enviam valores diferentes ao serem clicados:
<form action="/action_page.php" method="get">
Choose your favorite subject:
<button name="subject" type="submit" value="HTML">HTML</button>
<button name="subject" type="submit" value="CSS">CSS</button>
</form>
Exemplo de conjunto de campos
Um <fieldset> com um atributo name:
<fieldset name="personalia">
Name: <input type="text"><br>
Email: <input type="text"><br>
</fieldset>
Exemplo de formulário
Um formulário HTML com um atributo name:
<form
action="/action_page.php"
method="get" name="myForm">
First name: <input type="text" name="fname"><br>
Last name:
<input type="text" name="lname"><br>
<input type="button" onclick="formSubmit()" value="Send form data!">
</form>
Exemplo de iframe
Um <iframe> que atua como destino de um link:
<iframe src="demo_iframe.htm" name="iframe_a"></iframe>
<a href="https://www.w3schools.com" target="iframe_a">W3Schools.com</a>
Exemplo de entrada
Um formulário HTML com três campos de entrada; dois campos de texto e um botão de envio:
<form
action="/action_page.php">
Name: <input type="text" name="fullname"><br>
Email:
<input type="text" name="email"><br>
<input type="submit" value="Submit">
</form>
Exemplo de mapa
Um mapa de imagem, com áreas clicáveis:
<img src="planets.gif"
width="145" height="126"
alt="Planets"
usemap="#planetmap">
<map
name="planetmap">
<area shape="rect" coords="0,0,82,126" href="sun.htm" alt="Sun">
<area shape="circle" coords="90,58,3" href="mercur.htm" alt="Mercury">
<area shape="circle" coords="124,58,8" href="venus.htm" alt="Venus">
</map>
Metaexemplo
Use o atributo name para definir uma descrição, palavras-chave e o autor de um documento HTML:
<head>
<meta name="description" content="Free Web tutorials">
<meta name="keywords" content="HTML,CSS,JavaScript">
<meta name="author" content="Hege Refsnes">
</head>
Exemplo de objeto
Um elemento <object> com um atributo name:
<object data="helloworld.swf" width="400" height="400"
name="obj1"></object>
Exemplo de saída
Faça um cálculo e mostre o resultado em um elemento <output>:
<form oninput="x.value=parseInt(a.value)+parseInt(b.value)">0
<input type="range" id="a" value="50">100
+<input type="number" id="b" value="50">
=<output name="x" for="a b"></output>
</form>
Exemplo de parâmetro
Defina o parâmetro "autoplay" como "true", para que o som comece a tocar assim que a página for carregada:
<object data="horse.wav">
<param name="autoplay" value="true">
</object>
Selecione Exemplo
Uma lista suspensa com um atributo de nome:
<select name="cars">
<option value="volvo">Volvo</option>
<option value="saab">Saab</option>
<option value="opel">Opel</option>
<option value="audi">Audi</option>
</select>
Exemplo de área de texto
Uma área de texto com um atributo de nome:
<form action="/action_page.php">
<textarea name="comment">Enter text here...</textarea>
<input type="submit">
</form>
Suporte ao navegador
O multiple
atributo tem o seguinte suporte do navegador para cada elemento:
Element | |||||
---|---|---|---|---|---|
button | Yes | Yes | Yes | Yes | Yes |
fieldset | Yes | Not supported | Yes | Yes | Yes |
form | Yes | Yes | Yes | Yes | Yes |
iframe | Yes | Yes | Yes | Yes | Yes |
input | 1.0 | 2.0 | 1.0 | 1.0 | 1.0 |
map | Yes | Yes | Yes | Yes | Yes |
meta | Yes | Yes | Yes | Yes | Yes |
object | Yes | Yes | Yes | Yes | Yes |
output | 10.0 | Not supported | 4.0 | 5.1 | 11.0 |
param | Yes | Yes | Yes | Yes | Yes |
select | Yes | Yes | Yes | Yes | Yes |
textarea | Yes | Yes | Yes | Yes | Yes |