【PHP8.x】isConnectedプロパティの使い方
isConnectedプロパティの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
isConnectedプロパティは、Dom\DocumentTypeクラスのインスタンスがDOMドキュメントツリーに接続されているかを示す真偽値（boolean）を保持します。
Dom\DocumentTypeノードは文書型宣言、例えばHTMLドキュメントにおける<!DOCTYPE html>のような情報を表します。このisConnectedプロパティは、その文書型ノードが実際にDOMドキュメントの構造に組み込まれているか、またはまだ独立した状態にあるかを示します。
このプロパティの値がtrueであれば、そのDocumentTypeノードは既にDOMドキュメントに属し、ドキュメントツリーの一部として機能します。例えば、DOMDocumentオブジェクトにDocumentTypeノードが追加されると、このプロパティはtrueを返します。
一方、値がfalseの場合は、DocumentTypeノードが単独で作成されたものの、まだどのDOMDocumentオブジェクトにも追加されていない状態、または以前にドキュメントツリーから削除された状態であることを意味します。
DOM操作では、ノードの接続状態を把握することが重要であり、このプロパティを参照することで、処理の分岐や、意図しない挙動の回避、効率的な実装に役立てられるでしょう。
構文(syntax)
1<?php 2 3$dom = new Dom\Document(); 4$dom->loadHTML("<!DOCTYPE html><html><head></head><body></body></html>"); 5 6// Dom\DocumentType ノードを取得 7$documentType = $dom->doctype; 8 9// isConnected プロパティの値にアクセス 10var_dump($documentType->isConnected); 11 12?>
引数(parameters)
引数なし
引数はありません
戻り値(return)
bool
このプロパティは、DOM DocumentTypeノードがDOMツリーに接続されているかどうかを示す真偽値（bool）を返します。trueであれば接続されており、falseであれば接続されていません。