Yet another super simple spotlight instruction framework for UIKit iOS.
- Checks if interested view is inside window's bounds
- Supports device rotation / iPad SplitView
- Swift Concurrency
- Swift 6 Concurrency Check Mode ( work in progress )
You don't want to show spotlight on an invisible view, right?
One good thing about Yokoso, is that it checks if the interested view is fully visible to your user.
Otherwise InstructionError.interestedViewOutOfBounds is thrown.
With Yokoso, your tutorial UI/UX is better than ever.
yokoso.mp4
It's super simple. Import the module,
import Yokosoinitialize InstructionManager,
let manager = InstructionManager(overlayBackgroundColor: .overlayBackground)then use InstructionManager's interface to show or close your Instruction.
do {
try instructionManager.show(
.init(
message: .init(
attributedString: attributedString,
backgroundColor: uicolor
),
nextButton: .simple("Next"),
sourceView: label
),
in: view
)
} catch {
if let error = error as? InstructionError {
assertionFailure(error.localizedDescription)
}
}Please refer to the Example app for further customization.
You can use Yokoso for SwiftUI view, at least if you're embedding with UIHostingController.
First you need to retrieve interested view's frame via ObservableObject + GeometryReader.
class ViewModel: ObservableObject {
@Published var interestedViewRect: CGRect?
}
struct YourView: View {
@ObservedObject var viewModel: ViewModel
var body: some View {
GeometryReader { p in
yourLayout
.onAppear {
viewModel.interestedViewRect = p.frame(in: .global)
}
}
}
}Then pass that frame to sourceRect parameter of InstructionManager.show.
try await instructionManager?.show(
.init(
message: .init(attributedString: message, backgroundColor: .v4.monotone8),
nextButton: .custom(...),
sourceView: view,
sourceRect: sourceRect,
blocksTapOutsideCutoutPath: true,
ignoresTapInsideCutoutPath: true
),
in: view
)- iOS 14+
- Swift Package Manager
Any contributions are warmly welcomed.😊
- Feature Request / Pull Request
- Bug Report
- Question!
MIT