DOMAttr 類別

(PHP 5, PHP 7, PHP 8)

簡介

DOMAttr 表示 DOMElement 物件中的屬性。

類別概要

class DOMAttr extends DOMNode {

/* 繼承的常數 */

public const int DOMNode::DOCUMENT_POSITION_DISCONNECTED = 0x1;

public const int DOMNode::DOCUMENT_POSITION_PRECEDING = 0x2;

公開常數整數 DOMNode::DOCUMENT_POSITION_FOLLOWING = 0x4;

公開常數整數 DOMNode::DOCUMENT_POSITION_CONTAINS = 0x8;

公開常數整數 DOMNode::DOCUMENT_POSITION_CONTAINED_BY = 0x10;

公開常數整數 DOMNode::DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC = 0x20;

/* 屬性 */

公開唯讀字串 $name;

公開唯讀布林值 $specified;

公開字串 $value;

公開唯讀可為空 DOMElement $ownerElement;

公開唯讀混合 $schemaTypeInfo;

/* 繼承的屬性 */

公開唯讀字串 $nodeName;

公開可為空字串 $nodeValue;

公開唯讀整數 $nodeType;

公開唯讀可為空 DOMNode $parentNode;

公開唯讀可為空 DOMElement $parentElement;

公開唯讀 DOMNodeList $childNodes;

public readonly ?DOMNode $firstChild;

public readonly ?DOMNode $lastChild;

public readonly ?DOMNode $previousSibling;

public readonly ?DOMNode $nextSibling;

public readonly ?DOMNamedNodeMap $attributes;

public readonly bool $isConnected;

public readonly ?DOMDocument $ownerDocument;

public readonly ?string $namespaceURI;

public string $prefix;

public readonly ?string $localName;

public readonly ?string $baseURI;

public string $textContent;

/* 方法 */

public __construct(string $name, string $value = "")

public isId(): bool

/* 繼承的方法 */

public DOMNode::appendChild(DOMNode $node): DOMNode|false

public DOMNode::C14N(
    布林值 $exclusive = false,
    布林值 $withComments = false,
    ?陣列 $xpath = null,
    ?陣列 $nsPrefixes = null
): 字串|false

公開 DOMNode::C14NFile(
    字串 $uri,
    布林值 $exclusive = false,
    布林值 $withComments = false,
    ?陣列 $xpath = null,
    ?陣列 $nsPrefixes = null
): 整數|false

公開 DOMNode::cloneNode(布林值 $deep = false): DOMNode|false

公開 DOMNode::compareDocumentPosition(DOMNode $other): 整數

公開 DOMNode::contains(DOMNode|DOMNameSpaceNode|null $other): 布林值

公開 DOMNode::getLineNo(): 整數

公開 DOMNode::getNodePath(): ?字串

公開 DOMNode::getRootNode(?陣列 $options = null): DOMNode

公開 DOMNode::hasAttributes(): 布林值

公開 DOMNode::hasChildNodes(): 布林值

公開 DOMNode::insertBefore(DOMNode $node, ?DOMNode $child = null): DOMNode|false

公開 DOMNode::isDefaultNamespace(字串 $namespace): 布林值

公開 DOMNode::isEqualNode(?DOMNode $otherNode): 布林值

公開 DOMNode::isSameNode(DOMNode $otherNode): 布林值

公開 DOMNode::isSupported(字串 $feature, 字串 $version): 布林值

公開 DOMNode::lookupNamespaceURI(?字串 $prefix): ?字串

公開 DOMNode::lookupPrefix(字串 $namespace): ?字串

公開 DOMNode::normalize(): 無

公開 DOMNode::removeChild(DOMNode $child): DOMNode|false

公開 DOMNode::replaceChild(DOMNode $node, DOMNode $child): DOMNode|false

公開 DOMNode::__sleep(): 陣列

公開 DOMNode::__wakeup(): void

}

屬性

name: 屬性的名稱。
ownerElement: 包含此屬性的元素，或 null。
schemaTypeInfo: 尚未實作，永遠為 null。
specified: 尚未實作，永遠為 true。
value: 屬性的值。

注意事項:
注意，設定值時 XML 實體會被展開。因此 & 字元具有特殊含義。當 value 包含 & 時，將 value 設定為自身將會失敗。為了避免實體展開，請改用 DOMElement::setAttribute()。

參見

» W3C Attr 規範

在除錯 DOMAttr 相關程式碼時請小心。檢索 schemaTypeInfo 屬性時會產生 E_WARNING，因為它尚未實作。像 Eclipse 這樣的 IDE 會檢查物件及其成員元素。結合已註冊的錯誤處理程式，會將 E_WARNING 轉換為 Exception，您的除錯工作階段將會意外結束。這在我使用「Makegood」插件在 Eclipse 中除錯 PHPUnit 測試案例時造成了一些麻煩。

一個可能的解決方法是在除錯期間使用 error_reporting(0) 關閉錯誤處理。在完成除錯工作階段後移除該語句。

錯誤追蹤器中的相關記錄： https://bugs.php.net/bug.php?id=61858
以及一個 xdebug 追蹤器記錄： http://bugs.xdebug.org/view.php?id=910

上

下

chregu at php dot net ¶

15 年前

也請參考繼承自 DOMNode 類別的屬性 ( https://php.dev.org.tw/manual/en/class.domnode.php )，例如 namespaceURI、prefix、localName 等等，尤其是在處理命名空間屬性時。

＋新增註記

DOMAttr 類別

簡介

類別概要

屬性

參見

目錄

發現問題了嗎？

使用者貢獻的註記 2 則註記