UIView

View of the root view controller.

Example

po UIView.root

View of the current view controller.

Example

po UIView.current

Returns the view and all its subviews in sequence.

This method provides an easy way to iterate over a (sub-)tree of the view hierarchy. The views are ordered by nesting level: first the view, then all subviews, then all sub-subviews and so on.

Example

po UIView.current.tree()
po UIView.current.tree().filter { $0.isHidden } // only hidden views
po Array(UIView.current.tree(depth: 2))[2]      // the second subiew

Returns subviews of the given type.

Example

po UIView.current.all(UILabel.self)

Returns the first subview of a given type.

Optionally a condition predicate can be passed. If, like in the third example, the predicate parameter is typed, the method parameter may be omitted. However either of them must be defined.

Example

po UIView.current.first(UILabel.self)
po UIView.current.first(UILabel.self) { $0.text == "Lorem" }
po UIView.current.first { (l: UILabel) in l.text == "Lorem" }

Returns the first subview of the calling type in the given view.

This method is an alternatively flavored UIView.first(_:where:) to not have to type the .self.

Example

po UILabel.first(in: UIView.current)

A Boolean indicating whether the view contains a given text.

The following properties will be checked:

• UILabel.text
• UITextField.text and .placeholer
• UITextView.text
• UIButton.currentTitle

If any of these attributes contains the passed text, the method will return true. All other cases will return false.

Example

po UILabel.first()?.containsText("name")

Returns all views that contain the given text.

Traverses the view hierarchy starting at the receiver and returns all views whose containsText(_:) check returns true.

Example

po UIView.current.grep("o")

Returns all views that contain the given text.

This method is an alternative to grep(_:) to allow for a different calling style.

Example

po UIView.grep("o")
po UIView.grep("o", in: UIView.current)

Returns the first view with the given accessibility identifier.

Traverses the view hierarchy starting at the reciever and returns the first view whose accessibilityIdentifier equals or contains the passed in identifier.

Example

po UIView.current.find(byAccessibilityID: "username_input")

Returns the first view with the given accessibility identifier.

This method is an alternative to find(byAccessibilityID:) to allow for a different calling style.

Example

po UIView.find(byAccessibilityID: "username_input")
po UIView.find(byAccessibilityID: "username_input", in: UIView.current)

Sets the text of the closest UITextField or UITextView.

The .text property of the first UITextField or UITextView found in the view hieararchy, starting at the receiver, is set to the passed text.

Example

po UITextField.first()?.enterText("lldo@lurado.com")

Taps the closest button.

A .touchUpInside event is sent to the first UIButton found in the view hiearchy, starting at the receiver.

Example

po UIButton.first()?.tap()

Slides the closest UISwitch or UISlider.

Looks for the first UISwitch or UISlider in the view hierarchy, starting at the receiver. If a UISwitch is found, a value of 0 deactivates the it, every value other than 0 activates it. Don’t pass any value to toggle the switch.

A UISlider will be set to the vaue you pass.

Example

po UISwitch.first()?.slide(1)
po UISwitch.first()?.slide()

Colors the areas covered by given insets.

Example

po UIView.current.highlight(true, insets: UIEdgeInsets(top: 8, left: 8, bottom: 8, right: 8))
po UIView.current.highlight(false)

Highlights the safe area insets of the receiver.

Basically this is a runtime variant of Interface Builder’s Editor > Canvas > Show Layout Rectangles.

Example

po UIView.current.highlightSafeAreaInsets()
po UIView.current.highlightSafeAreaInsets(false)
po UIView.current.highlightSafeAreaInsets(depth: 5)
po UIView.current.highlightSafeAreaInsets(false, depth: .max)

Highlights the layout margins of the receiver.

Basically this is a runtime variant of Interface Builder’s Editor > Canvas > Show Layout Rectangles.

Example

po UIView.current.highlightLayoutMargins()
po UIView.current.highlightLayoutMargins(false)
po UIView.current.highlightLayoutMargins(depth: 2)
po UIView.current.highlightLayoutMargins(false, depth: .max)

Displays visual view changes that have been made while the program execution was paused.

Normally visual changes to a view from LLDB, like changing the background color, don’t show up until the program execution is continued. Such an update can be forced while the program remains paused by calling this method. Internally this method calls CATransaction.flush().

Example

expr UIView.current.backgroundColor = .orange
// still not red
expr UIView.current.caflush()
// now it's red

Saves a snapshot of the view as image.

The receiving view is rendered as PNG and saved to disk. If no destination path is specified, the image will be saved in the apps temporary directory. On the simulator the image can then directly be opened. As a convenience the necessary shell open command is printed to the console.

Example

po UIView.current.screenshot("/some/absolute/path.png")
shell open /some/absolute/path.png

Displays a semi transparent image on top of the receiver to be able to visually compare it to a reference design.

An UIImageView displaying the image will be created and added as a subview. It will be semi transparent so any differences are easy to spot. The content mode is set to .scaleAspectFit to avoid deformations.

Example

po UIView.current.overlay(UIImage(named: "reference.png"))