DOMDocument::createAttribute

(PHP 5, PHP 7, PHP 8)

DOMDocument::createAttribute — Yeni bir öznitelik düğümü oluşturur

Açıklama

public DOMDocument::createAttribute(string $localName): DOMAttr|false

Yeni bir DOMAttr nesnesi oluşturur. Bu düğüm, DomNode::append_child() gibi bir yöntemle belgeye yerleştirilmedikçe belgede gösterilmez.

Bağımsız Değişkenler

localName: Özniteliğin ismi.

Dönen Değerler

Bir hata oluşursa false yoksa yeni bir DOMAttr nesnesi döner.

Hatalar/İstisnalar

DOM_INVALID_CHARACTER_ERR: localName geçersiz karakter içeriyorsa oluşur.

Ayrıca Bakınız

DOMNode::appendChild() - Listenin sonuna yeni bir çocuk ekler
DOMDocument::createAttributeNS() - Yeni bir isim alanlı öznitelik düğümü oluşturur
DOMDocument::createCDATASection() - Yeni bir CDATA düğümü oluşturur
DOMDocument::createComment() - Yeni bir açıklama düğümü oluşturur
DOMDocument::createDocumentFragment() - Yeni bir belge bölütü oluşturur
DOMDocument::createElement() - Yeni bir eleman düğümü oluşturur
DOMDocument::createElementNS() - İsim alanlı bir eleman düğümü oluşturur
DOMDocument::createEntityReference() - Yeni bir öğe bildirimi düğümü oluşturur
DOMDocument::createProcessingInstruction() - Yeni bir işlem komutu düğümü oluşturur
DOMDocument::createTextNode() - Yeni bir metin düğümü oluşturur

add a note

User Contributed Notes 2 notes

down

Beerkeeper ¶

13 years ago


Just in case it isn't clear (like I had), an example:

<?php

$domDocument = new DOMDocument('1.0', "UTF-8");
$domElement = $domDocument->createElement('field','some random data');
$domAttribute = $domDocument->createAttribute('name');

// Value for the created attribute
$domAttribute->value = 'attributevalue';

// Don't forget to append it to the element
$domElement->appendChild($domAttribute);

// Append it to the document itself
$domDocument->appendChild($domElement);

?>

Will output:
<?xml version="1.0" encoding="UTF-8"?>
<field name="attributevalue">some random data</field>

down

-7

Skateside ¶

11 years ago


This may be obvious to most people, but it gave me a few minutes of head-scratching before I figured it out, but ampersands need to be properly escaped as HTML entities.

<?php
$doc= new DOMDocument('1.0', "UTF-8");

$invalid_elem = $doc->createElement('field', 'incorrect attribute');
$invalid_attr = $doc->createAttribute('name');
$invalid_attr->value = 'foo&bar';
$invalid_elem->appendChild($invalid_attr);
$doc->appendChild($invalid_elem);

$valid_elem = $doc->createElement('field', 'correct attribute');
$valid_attr = $doc->createAttribute('name');
$valid_attr->value = 'foo&amp;bar';
$valid_elem->appendChild($valid_attr);
$doc->appendChild($valid_elem);

?>

Will output:
<?xml version="1.0" encoding="UTF-8"?>
<field name="foo">incorrect attribute</field>
<field name="foo&bar">correct attribute</field>

As near as I can figure out, no exception is thrown for an invalid attribute. This will affect DOMDocuments created as HTML as well as XML.

add a note