Procura por um elemento com um determinado ID

# DOMDocument::getElementById

(PHP 5, PHP 7, PHP 8)

DOMDocument::getElementById — Procura por um elemento com um determinado ID

### Descrição

public function DOMDocument::getElementById(string `$elementId`): ?DOMElement

Esta função é semelhante a DOMDocument::getElementsByTagName mas procura por um elemento com um determinado ID.

Para que esta função funcione, será necessário definir alguns atributos de ID com DOMElement::setIdAttribute ou um DTD que define um atributo como tipo ID. Neste último caso, será necessário validar o documento com DOMDocument::validate ou DOMDocument::$validateOnParse antes de usar esta função.

### Parâmetros

`elementId`

  O valor de ID único para um elemento.

### Valor Retornado

Retorna o DOMElement ou `null` se o elemento não for encontrado.

### Exemplos

Exemplo #1 Exemplo de DOMDocument::getElementById()

Os exemplos a seguir usam um arquivo book.xml que contém o seguinte:

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE books [
      <!ELEMENT books   (book+)>
      <!ELEMENT book    (title, author+, xhtml:blurb?)>
      <!ELEMENT title   (#PCDATA)>
      <!ELEMENT blurb   (#PCDATA)>
      <!ELEMENT author  (#PCDATA)>
      <!ATTLIST books   xmlns        CDATA  #IMPLIED>
      <!ATTLIST books   xmlns:xhtml  CDATA  #IMPLIED>
      <!ATTLIST book    id           ID     #IMPLIED>
      <!ATTLIST author  email        CDATA  #IMPLIED>
    ]>
    <?xml-stylesheet type="text/xsl" href="style.xsl"?>
    <books xmlns="http://books.php/" xmlns:xhtml="http://www.w3.org/1999/xhtml">
      <book id="php-basics">
        <title>Princípios do PHP</title>
        <author email="jim.smith@basics.php">Jim Smith</author>
        <author email="jane.smith@basics.php">Jane Smith</author>
        <xhtml:blurb><![CDATA[
    <p><em>Princípios do PHP</em> fornece uma introdução ao PHP.</p>
    ]]></xhtml:blurb>
      </book>
      <book id="php-advanced">
        <title>Programação PHP Avançada</title>
        <author email="jon.doe@advanced.php">Jon Doe</author>
      </book>
    </books>

    <?php

    $doc = new DomDocument;

    // Precisamos validar nosso documento antes de referenciar o ID
    $doc->validateOnParse = true;
    $doc->load('examples/book.xml');

    echo "O elemento cujo ID é 'php-basics' é: " . $doc->getElementById('php-basics')->tagName . "\n";

    ?>

O exemplo acima produzirá:

    O elemento cujo ID é 'php-basics' é: book

### Veja Também

- DOMDocument::getElementsByTagName() - Procura por todos os elementos com uma determinada tag name local

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open