Document.getElementsByName()

Esta tradução está incompleta. Ajude a traduzir este artigo em inglês

O métodogetElementsByName() do objeto Document retorna uma coleção de elementos NodeList com um dado name no documento.

Sintaxe

var elementos = document.getElementsByName(nome);
  • elementos é uma coleção ativa de NodeList, significando que ele atualiza automaticamente com os novos elementos com o mesmo nome que são adicionados/removidos do documento.
  • nome é um valor do atributo nome dos elemento(s).

Exemplo

<!DOCTYPE html>
<html lang="en">
<title>Exemplo: usando document.getElementsByName</title>

<input type="hidden" name="up">
<input type="hidden" name="down">

<script>
  var up_nomes = document.getElementsByName("up");
  console.log(up_nomes[0].tagName); // exibindo o campo "INPUT"
</script>
</html>

Notas

O atributo name pode somente ser aplicado nos documentos (X)HTML.

A coleção retornada NodeList contém todos os elementos com o respectivo nome, tal como <meta>, <object>, e até os elementos o qual não suporta o atributo nome para todos.

O método getElementsByName trabalha diferentemente em IE10 e anteriores. Além de que, getElementsByName() também retorna elementos que tem um atributo id com o valor especificado. Seja cuidadoso para não usar a mesma string como ambos nome e id.

O método getElementsByName trabalha diferentemente no IE. Portanto, getElementsByName() não retorna todos os elementos no qual não pode ter um atributo nome (tal como <span>).

Ambos IE e Edge retorna um HTMLCollection, e não um NodeList

Especificações

Epecificação Status Comentário
HTML Living Standard
The definition of 'Document.getElementsByName()' in that specification.		 Padrão em tempo real
Document Object Model (DOM) Level 2 HTML Specification
The definition of 'Document.getElementsByName()' in that specification.		 Obsoleto Definição Inicial

Compatibilidade com Nagevagores

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
getElementsByNameChrome Full support 1Edge Full support 12
Notes
Full support 12
Notes
Notes Returns an HTMLCollection, not a NodeList
Firefox Full support YesIE Full support Yes
Notes
Full support Yes
Notes
Notes Returns an HTMLCollection, not a NodeList
Opera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes

Legend

Full support  
Full support
See implementation notes.
See implementation notes.

Veja também

Tópicos relacionados
  1. Document Object Model
  2. Document
  3. Construtor
    1. Document()
  4. Propriedades
    1. alinkColor
    2. all [Traduzir]
    3. anchors
    4. applets [Traduzir]
    5. bgColor
    6. body
    7. characterSet
    8. childElementCount [Traduzir]
    9. children
    10. compatMode
    11. contentType
    12. currentScript
    13. defaultView
    14. designMode
    15. dir [Traduzir]
    16. doctype
    17. documentElement
    18. documentURI
    19. documentURIObject [Traduzir]
    20. domain [Traduzir]
    21. domConfig [Traduzir]
    22. embeds [Traduzir]
    23. fgColor [Traduzir]
    24. firstElementChild [Traduzir]
    25. forms [Traduzir]
    26. fullscreen [Traduzir]
    27. fullscreenEnabled [Traduzir]
    28. head
    29. height
    30. hidden [Traduzir]
    31. images
    32. implementation
    33. lastElementChild [Traduzir]
    34. lastModified [Traduzir]
    35. lastStyleSheetSet [Traduzir]
    36. linkColor [Traduzir]
    37. links [Traduzir]
    38. location
    39. mozSyntheticDocument [Traduzir]
    40. onabort
    41. onafterscriptexecute [Traduzir]
    42. onanimationcancel [Traduzir]
    43. onanimationend [Traduzir]
    44. onanimationiteration [Traduzir]
    45. onauxclick [Traduzir]
    46. onbeforescriptexecute [Traduzir]
    47. onblur
    48. oncancel [Traduzir]
    49. oncanplay [Traduzir]
    50. oncanplaythrough [Traduzir]
    51. onchange
    52. onclick
    53. onclose [Traduzir]
    54. oncontextmenu
    55. oncuechange [Traduzir]
    56. ondblclick [Traduzir]
    57. ondurationchange [Traduzir]
    58. onended [Traduzir]
    59. onerror
    60. onfocus
    61. onformdata [Traduzir]
    62. onfullscreenchange [Traduzir]
    63. onfullscreenerror [Traduzir]
    64. ongotpointercapture [Traduzir]
    65. oninput [Traduzir]
    66. oninvalid [Traduzir]
    67. onkeydown [Traduzir]
    68. onkeypress [Traduzir]
    69. onkeyup
    70. onload
    71. onloadeddata [Traduzir]
    72. onloadedmetadata [Traduzir]
    73. onloadend [Traduzir]
    74. onloadstart [Traduzir]
    75. onlostpointercapture
    76. onmousedown [Traduzir]
    77. onmouseenter [Traduzir]
    78. onmouseleave [Traduzir]
    79. onmousemove [Traduzir]
    80. onmouseout [Traduzir]
    81. onmouseover [Traduzir]
    82. onmouseup [Traduzir]
    83. onoffline [Traduzir]
    84. ononline [Traduzir]
    85. onpause [Traduzir]
    86. onplay [Traduzir]
    87. onpointercancel [Traduzir]
    88. onpointerdown [Traduzir]
    89. onpointerenter [Traduzir]
    90. onpointerleave [Traduzir]
    91. onpointermove [Traduzir]
    92. onpointerout [Traduzir]
    93. onpointerover [Traduzir]
    94. onpointerup [Traduzir]
    95. onreset [Traduzir]
    96. onresize [Traduzir]
    97. onscroll
    98. onselect [Traduzir]
    99. onselectionchange [Traduzir]
    100. onselectstart [Traduzir]
    101. onsubmit [Traduzir]
    102. ontouchcancel [Traduzir]
    103. ontouchstart [Traduzir]
    104. ontransitioncancel [Traduzir]
    105. ontransitionend [Traduzir]
    106. onvisibilitychange [Traduzir]
    107. onwheel [Traduzir]
    108. origin
    109. plugins [Traduzir]
    110. popupNode [Traduzir]
    111. preferredStyleSheetSet [Traduzir]
    112. readyState
    113. referrer
    114. scripts
    115. scrollingElement [Traduzir]
    116. selectedStyleSheetSet [Traduzir]
    117. styleSheetSets [Traduzir]
    118. timeline [Traduzir]
    119. title [Traduzir]
    120. tooltipNode [Traduzir]
    121. URL
    122. visibilityState [Traduzir]
    123. vlinkColor [Traduzir]
    124. width [Traduzir]
    125. xmlEncoding [Traduzir]
    126. xmlVersion [Traduzir]
  5. Métodos
    1. adoptNode() [Traduzir]
    2. append() [Traduzir]
    3. caretRangeFromPoint() [Traduzir]
    4. clear() [Traduzir]
    5. close()
    6. createAttribute() [Traduzir]
    7. createCDATASection() [Traduzir]
    8. createComment() [Traduzir]
    9. createDocumentFragment() [Traduzir]
    10. createElement()
    11. createElementNS()
    12. createEntityReference() [Traduzir]
    13. createEvent() [Traduzir]
    14. createExpression() [Traduzir]
    15. createExpression() [Traduzir]
    16. createNodeIterator() [Traduzir]
    17. createNSResolver() [Traduzir]
    18. createNSResolver() [Traduzir]
    19. createProcessingInstruction() [Traduzir]
    20. createRange() [Traduzir]
    21. createTextNode() [Traduzir]
    22. createTouch() [Traduzir]
    23. createTouchList() [Traduzir]
    24. createTreeWalker() [Traduzir]
    25. enableStyleSheetsForSet() [Traduzir]
    26. evaluate() [Traduzir]
    27. evaluate() [Traduzir]
    28. execCommand() [Traduzir]
    29. exitFullscreen() [Traduzir]
    30. exitPointerLock() [Traduzir]
    31. getAnimations() [Traduzir]
    32. getBoxObjectFor() [Traduzir]
    33. getElementById()
    34. getElementsByClassName()
    35. getElementsByName()
    36. getElementsByTagName()
    37. getElementsByTagNameNS() [Traduzir]
    38. hasFocus()
    39. hasStorageAccess() [Traduzir]
    40. importNode()
    41. mozSetImageElement() [Traduzir]
    42. open() [Traduzir]
    43. prepend() [Traduzir]
    44. queryCommandEnabled() [Traduzir]
    45. queryCommandSupported() [Traduzir]
    46. querySelector()
    47. querySelector()
    48. querySelectorAll()
    49. querySelectorAll() [Traduzir]
    50. registerElement()
    51. releaseCapture() [Traduzir]
    52. requestStorageAccess() [Traduzir]
    53. write() [Traduzir]
    54. writeln()
  6. Eventos
    1. animationcancel [Traduzir]
    2. animationend [Traduzir]
    3. animationiteration [Traduzir]
    4. animationstart [Traduzir]
    5. copy [Traduzir]
    6. cut [Traduzir]
    7. DOMContentLoaded [Traduzir]
    8. drag [Traduzir]
    9. dragend [Traduzir]
    10. dragenter [Traduzir]
    11. dragexit [Traduzir]
    12. dragleave [Traduzir]
    13. dragover [Traduzir]
    14. dragstart [Traduzir]
    15. drop [Traduzir]
    16. gotpointercapture [Traduzir]
    17. keydown
    18. keypress
    19. keyup
    20. lostpointercapture [Traduzir]
    21. paste [Traduzir]
    22. pointercancel [Traduzir]
    23. pointerdown [Traduzir]
    24. pointerenter [Traduzir]
    25. pointerleave [Traduzir]
    26. pointerlockchange [Traduzir]
    27. pointerlockerror [Traduzir]
    28. pointermove [Traduzir]
    29. pointerout [Traduzir]
    30. pointerover [Traduzir]
    31. pointerup [Traduzir]
    32. readystatechange
    33. scroll
    34. touchcancel [Traduzir]
    35. touchend [Traduzir]
    36. touchmove [Traduzir]
    37. touchstart [Traduzir]
    38. transitioncancel [Traduzir]
    39. transitionend [Traduzir]
    40. transitionrun [Traduzir]
    41. transitionstart [Traduzir]
    42. visibilitychange [Traduzir]
  7. Herança:
    1. Node
    2. EventTarget
  8. Páginas relacionadas a DOM
    1. AbortController
    2. AbortSignal
    3. AbstractRange
    4. Attr
    5. ByteString
    6. CDATASection
    7. CSSPrimitiveValue
    8. CSSValue
    9. CSSValueList
    10. CharacterData
    11. ChildNode
    12. Comment
    13. CustomEvent
    14. DOMConfiguration
    15. DOMError
    16. DOMErrorHandler
    17. DOMException
    18. DOMImplementation
    19. DOMImplementationList
    20. DOMImplementationRegistry
    21. DOMImplementationSource
    22. DOMLocator
    23. DOMObject
    24. DOMParser
    25. DOMPoint
    26. DOMPointInit
    27. DOMPointReadOnly
    28. DOMRect
    29. DOMString
    30. DOMTimeStamp
    31. DOMTokenList
    32. DOMUserData
    33. DocumentFragment
    34. DocumentType
    35. Element
    36. ElementTraversal
    37. Entity
    38. EntityReference
    39. Event
    40. EventTarget
    41. HTMLCollection
    42. MutationObserver
    43. Node
    44. NodeFilter
    45. NodeIterator
    46. NodeList
    47. NonDocumentTypeChildNode
    48. ProcessingInstruction
    49. PromiseResolver
    50. Range
    51. StaticRange
    52. Text
    53. TextDecoder
    54. TextEncoder
    55. TimeRanges
    56. TreeWalker
    57. TypeInfo
    58. USVString
    59. UserDataHandler
    60. XMLDocument