XCUIElement打印未包含嵌套按钮问题排查求助

示例图片 #

预期行为 #

当屏幕渲染XCUIElement时，满足以下初始条件时，XCUIElement的打印语句应包含嵌套按钮：

• ImageView设置：

isUserInteractionEnabled = YES…
IsAccessibilityElement = YES…

• 嵌套Button设置：

isUserInteractionEnabled = YES…
IsAccessibilityElement = YES…

且Button已加入ImageView的accessibilityElements数组。

当前代码 #

parentImageView.image = UIImage(systemName: "mountain.2")
parentImageView.translatesAutoresizingMaskIntoConstraints = false
parentImageView.addGestureRecognizer(parentImageViewTapGesture)
parentImageView.layer.cornerRadius = 4
parentImageView.layer.borderWidth = 1
parentImageView.layer.borderColor = UIColor.systemBlue.cgColor
parentImageView.clipsToBounds = true
parentImageView.accessibilityLabel = "demo image"
parentImageView.isUserInteractionEnabled = true
parentImageView.isAccessibilityElement = true
addSubview(parentImageView)

favoriteButton.setImage(UIImage(systemName: "heart"), for: .normal)
favoriteButton.backgroundColor = .lightGray
favoriteButton.layer.cornerRadius = 4
favoriteButton.translatesAutoresizingMaskIntoConstraints = false
favoriteButton.addTarget(self, action: #selector(self.favoriteButtonTapped), for: .touchUpInside)
favoriteButton.clipsToBounds = true
favoriteButton.accessibilityLabel = "Nested Button"
favoriteButton.isUserInteractionEnabled = true
parentImageView.addSubview(favoriteButton)

parentImageView.accessibilityElements = [favoriteButton]

当前行为 #

满足上述初始条件时，XCUIElement的打印语句仅包含ImageView，未显示嵌套按钮。

调试打印 #

无后代的ImageView - Image, 0x7fa875d23e80, {{172.7, 292.7}, {45.0, 41.7}}, label: 'demo image'

执行po element.images和po element.buttons的输出：

Find: Descendants matching type Image
    Output: {
      Image, 0x7fa876e14e70, {{-8.0, 99.0}, {136.7, 109.3}}
      Image, 0x7fa876e14f80, {{-8.0, 741.7}, {136.7, 102.3}}
      Image, 0x7fa876e13da0, {{269.7, 737.0}, {136.3, 123.0}}
      Image, 0x7fa876e1a060, {{172.7, 292.7}, {45.0, 41.7}}, label: 'demo image'
    }

Output: {
      Button, 0x7fa875c12740, {{0.0, 47.0}, {68.0, 44.0}}, label: 'myApp UIKit'
      Button, 0x7fa875c24f00, {{338.0, 47.0}, {44.0, 44.0}}, identifier: 'Settings Button', label: 'Settings'
      Button, 0x7fa875c2c800, {{175.0, 533.0}, {40.0, 40.0}}
      Button, 0x7fa875c2cf30, {{183.0, 541.0}, {24.0, 24.0}}
      Button, 0x7fa875c2fa20, {{40.0, 659.3}, {153.0, 44.0}}, label: 'Left'
      Button, 0x7fa875c30cd0, {{197.0, 659.3}, {153.0, 44.0}}, label: 'Right'
    }

对比父ImageView和嵌套按钮的坐标，嵌套按钮未出现在列表中，其中24x24的按钮来自屏幕其他视图。

已尝试的修复 #

尝试了初始条件中各属性的所有组合，包括：

myImageView.accessibilityElements = [imageView, nestedButton]

myImageView.accessibilityElements = [nestedButton]

以及isUserInteractionEnabled = YES/NO（两者均尝试）、IsAccessibilityElement = YES/NO（两者均尝试）等所有可访问性变量的组合，但问题仍未解决。

解决方案 #

核心问题在于：当父视图（parentImageView）的isAccessibilityElement设为true时，它会被识别为一个独立的可访问性元素，此时accessibilityElements数组的配置不会让子元素在XCUI中被单独检测到。正确的调整方案如下：

1. 修改父视图的可访问性设置
   将parentImageView.isAccessibilityElement设为false，这样它就不会作为独立的可访问性节点，而是允许accessibilityElements数组中的子元素被XCUI识别。

2. 保留子按钮的可访问性配置
   确保favoriteButton.isAccessibilityElement保持true，并且正确添加到父视图的accessibilityElements数组中。

3. 保留父视图的交互性（可选）
   如果需要保留父ImageView的点击手势功能，无需修改isUserInteractionEnabled，只需确保手势和子按钮的交互优先级正常即可（默认情况下子按钮会优先响应点击）。

修改后的关键代码片段：

// 调整parentImageView的可访问性设置
parentImageView.isAccessibilityElement = false
parentImageView.accessibilityElements = [favoriteButton]

// favoriteButton的配置保持不变
favoriteButton.isAccessibilityElement = true
favoriteButton.accessibilityLabel = "Nested Button"

4. 额外验证点
   检查favoriteButton的约束是否正确，确保它完全处于parentImageView的 bounds 内，避免因超出范围被clipsToBounds裁剪而无法被识别。

验证方法：

• 使用Xcode的Accessibility Inspector查看视图层级，确认嵌套按钮是否出现在可访问性元素列表中；
• 在调试控制台执行po XCUIApplication().buttons["Nested Button"]，验证是否能定位到该按钮。

内容的提问来源于stack exchange，提问作者Tristan Newman