可编程子窗口操作功能说明书

一、功能概述

本功能提供了一系列方法用于操作元素的子节点，特别是针对 iframe 元素的处理，能够获取元素的所有子节点（包括文本节点、注释节点、iframe 内容文档），并支持获取子窗口实例和接口。

二、方法说明

1. contents() 方法

 $cq('#子窗口').contents();
    

功能：获取元素的所有子节点，对于 iframe 元素，会尝试获取其内部文档的子节点，但受同域限制。如果出现跨域情况，会捕获异常并在控制台输出警告信息。

返回值：返回一个包含子节点的新 实例，支持链式调用。

2. childwindow() 方法

 
$cq('#子窗口').childwindow();
    

功能：调用 contents() 方法，与 contents() 方法功能相同，获取元素的所有子节点。

返回值：返回一个包含子节点的新 实例，支持链式调用。

3. 子窗口集合() 方法

 
$cq('#子窗口').子窗口集合();
    

功能：调用 contents() 方法，与 contents() 方法功能相同，获取元素的所有子节点。

返回值：返回一个包含子节点的新 实例，支持链式调用。

4. childwindowinstance() 方法

 
$cq('#子窗口').childwindowinstance();
    

功能：获取元素集合中第一个元素的子窗口实例。

返回值：返回元素集合中第一个元素的 contentWindow 对象。

5. 子窗口接口() 方法

 
$cq('#子窗口').子窗口接口();
    

功能：获取元素集合中第一个元素的子窗口接口。

返回值：返回元素集合中第一个元素的 contentWindow 对象。

三、注意事项

• 在使用 contents() 方法处理 iframe 元素时，由于同域限制，跨域的 iframe 无法访问其内部内容，会捕获异常并在控制台输出警告信息。
• childwindow()、子窗口集合() 方法实际上是对 contents() 方法的调用，功能相同。
• childwindowinstance() 和 子窗口接口() 方法只返回元素集合中第一个元素的子窗口实例或接口。