Document.getElementsByName()

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 ?

Legend

Full support  
Full support
Compatibility unknown  
Compatibility unknown
See implementation notes.
See implementation notes.

Veja também

Última modificação:

, by MDN contributors
Tópicos relacionados
  1. Document Object Model
  2. Document
  3. Construtor
    1. Document()
  4. Propriedades
    1. alinkColor [Traduzir]
    2. all [Traduzir]
    3. anchors
    4. applets [Traduzir]
    5. bgColor
    6. body
    7. characterSet [Traduzir]
    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. onfullscreenchange [Traduzir]
    62. onfullscreenerror [Traduzir]
    63. ongotpointercapture [Traduzir]
    64. oninput [Traduzir]
    65. oninvalid [Traduzir]
    66. onkeydown [Traduzir]
    67. onkeypress [Traduzir]
    68. onkeyup
    69. onload
    70. onloadeddata [Traduzir]
    71. onloadedmetadata [Traduzir]
    72. onloadend [Traduzir]
    73. onloadstart [Traduzir]
    74. onlostpointercapture
    75. onmousedown [Traduzir]
    76. onmouseenter [Traduzir]
    77. onmouseleave [Traduzir]
    78. onmousemove [Traduzir]
    79. onmouseout [Traduzir]
    80. onmouseover [Traduzir]
    81. onmouseup [Traduzir]
    82. onoffline [Traduzir]
    83. ononline [Traduzir]
    84. onpause [Traduzir]
    85. onplay [Traduzir]
    86. onpointercancel [Traduzir]
    87. onpointerdown [Traduzir]
    88. onpointerenter [Traduzir]
    89. onpointerleave [Traduzir]
    90. onpointermove [Traduzir]
    91. onpointerout [Traduzir]
    92. onpointerover [Traduzir]
    93. onpointerup [Traduzir]
    94. onreset [Traduzir]
    95. onresize [Traduzir]
    96. onscroll [Traduzir]
    97. onselect [Traduzir]
    98. onselectionchange [Traduzir]
    99. onselectstart [Traduzir]
    100. onsubmit [Traduzir]
    101. ontouchcancel [Traduzir]
    102. ontouchstart [Traduzir]
    103. ontransitioncancel [Traduzir]
    104. ontransitionend [Traduzir]
    105. onvisibilitychange [Traduzir]
    106. onwheel [Traduzir]
    107. origin
    108. plugins [Traduzir]
    109. popupNode [Traduzir]
    110. preferredStyleSheetSet [Traduzir]
    111. readyState
    112. referrer
    113. scripts
    114. scrollingElement [Traduzir]
    115. selectedStyleSheetSet [Traduzir]
    116. styleSheetSets [Traduzir]
    117. timeline [Traduzir]
    118. title [Traduzir]
    119. tooltipNode [Traduzir]
    120. URL
    121. visibilityState [Traduzir]
    122. vlinkColor [Traduzir]
    123. width [Traduzir]
    124. xmlEncoding [Traduzir]
    125. 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() [Traduzir]
    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. Attr
    4. ByteString
    5. CDATASection
    6. CSSPrimitiveValue
    7. CSSValue
    8. CSSValueList
    9. CharacterData
    10. ChildNode
    11. Comment
    12. CustomEvent
    13. DOMConfiguration
    14. DOMError
    15. DOMErrorHandler
    16. DOMException
    17. DOMImplementation
    18. DOMImplementationList
    19. DOMImplementationRegistry
    20. DOMImplementationSource
    21. DOMLocator
    22. DOMObject
    23. DOMParser
    24. DOMPoint
    25. DOMPointInit
    26. DOMPointReadOnly
    27. DOMRect
    28. DOMString
    29. DOMTimeStamp
    30. DOMTokenList
    31. DOMUserData
    32. DocumentFragment
    33. DocumentType
    34. Element
    35. ElementTraversal
    36. Entity
    37. EntityReference
    38. Event
    39. EventTarget
    40. HTMLCollection
    41. MutationObserver
    42. Node
    43. NodeFilter
    44. NodeIterator
    45. NodeList
    46. NonDocumentTypeChildNode
    47. ProcessingInstruction
    48. PromiseResolver
    49. Range
    50. Text
    51. TextDecoder
    52. TextEncoder
    53. TimeRanges
    54. TreeWalker
    55. TypeInfo
    56. USVString
    57. UserDataHandler
    58. XMLDocument