waterui 0.3.0

A modern UI framework for Rust
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

import CWaterUI

#if canImport(UIKit)
  import UIKit
#elseif canImport(AppKit)
  import AppKit
#endif

@MainActor
final class WuiControlAccessibility {
  private let label: WuiComputedObservation<WuiStyledStr>

  init(
    consuming label: CWaterUI.WuiLabel,
    target: PlatformView,
    additionalTargets: [PlatformView] = [],
    visualLabel: PlatformView
  ) {
    guard let accessibilityLabel = label.accessibility_label else {
      fatalError("WaterUI control label has no accessibility signal")
    }
    var targets: [PlatformView] = []
    targets.reserveCapacity(additionalTargets.count + 1)
    targets.append(target)
    targets.append(contentsOf: additionalTargets)
    let observation = WuiComputedObservation(
      WuiComputed<WuiStyledStr>(accessibilityLabel)
    ) { value, _ in
      Self.apply(value.toString(), to: targets)
    }
    self.label = observation

    Self.hideVisualLabelFromAccessibility(visualLabel)
    Self.apply(observation.value.toString(), to: targets)
  }

  private static func apply(_ label: String, to targets: [PlatformView]) {
    for target in targets {
      #if canImport(UIKit)
        target.isAccessibilityElement = true
        target.accessibilityLabel = label
      #elseif canImport(AppKit)
        target.setAccessibilityElement(true)
        target.setAccessibilityLabel(label)
        target.toolTip = label
      #endif
    }
  }

  private static func hideVisualLabelFromAccessibility(_ visualLabel: PlatformView) {
    #if canImport(UIKit)
      visualLabel.accessibilityElementsHidden = true
    #elseif canImport(AppKit)
      visualLabel.setAccessibilityElement(false)
      visualLabel.setAccessibilityChildren([])
    #endif
  }
}