- SwiftUI Cheat Sheet
- Resource
- UIKit equivalent in SwiftUI
- View
- Layout
- Input
- List
- Containers
- Alerts and Action Sheets
- Navigation
- Work with UIKit
- SwiftUI Tutorials (Official)
- Introducing SwiftUI: Building Your First App (Official)
- SwiftUI: Getting Started Raywenderlich
- SwiftUI Essentials (Official)
- SwiftUI - How to setup a project
- About SwiftUI
UIKit | SwiftUI |
---|---|
UILabel | Text |
UIImageView | Image |
UITextField | TextField |
UITextView | No equivalent (use Text/TextField) |
UISwitch | Toggle |
UISlider | Slider |
UIButton | Button |
UITableView | List |
UICollectionView | No equivalent (can be implemented by List) |
UINavigationController | NavigationView |
UITabBarController | TabbedView |
UIAlertController with style .alert | Alert |
UIAlertController with style .actionSheet | ActionSheet |
UIStackView with horizontal axis | HStack |
UIStackView with vertical axis | VStack |
UISegmentedControl | SegmentedControl |
UIStepper | Stepper |
UIDatePicker | DatePicker |
NSAttributedString | No equivalent (use Text) |
To show a text in UI simply write:
Text("Hello World")
To add style
Text("Hello World")
.font(.largeTitle)
.foregroundColor(Color.green)
.lineSpacing(50)
.lineLimit(nil)
.padding()
To format text inside text view
static let dateFormatter: DateFormatter = {
let formatter = DateFormatter()
formatter.dateStyle = .long
return formatter
}()
var now = Date()
var body: some View {
Text("Task due date: \(now, formatter: Self.dateFormatter)")
}
To show image
Image("hello_world") //image name is hello_world
To use system icon
Image(systemName: "cloud.heavyrain.fill")
you can add style to system icon set
Image(systemName: "cloud.heavyrain.fill")
.foregroundColor(.red)
.font(.largeTitle)
Add style to Image
Image("hello_world")
.resizable() //it will sized so that it fills all the available space
.aspectRatio(contentMode: .fill)
.padding(.bottom)
To create Rectangle
Rectangle()
.fill(Color.red)
.frame(width: 200, height: 200)
To create circle
Circle()
.fill(Color.blue)
.frame(width: 50, height: 50)
To use image as a background
Text("Hello World")
.font(.largeTitle)
.background(
Image("hello_world")
.resizable()
.frame(width: 100, height: 100)
)
Gradient background
Text("Hello World")
.background(
LinearGradient(
gradient: Gradient(colors: [.white, .red, .black]),
startPoint: .leading,
endPoint: .trailing
),
cornerRadius: 0
)
Shows child view vertically
VStack {
Text("Hello")
Text("World")
}
Styling
VStack(alignment: .leading, spacing: 20) {
Text("Hello")
Divider()
Text("World")
}
Shows child view horizontally
HStack {
Text("Hello")
Text("World")
}
To create overlapping content use ZStack
ZStack() {
Image("hello_world")
Text("Hello World")
.font(.largeTitle)
.background(Color.black)
.foregroundColor(.white)
}
Toggle lets users move between true and false states
@State var isShowing = true //state
Toggle(isOn: $isShowing) {
Text("Hello World")
}.padding()
To create button
Button(
action: {
// do something
},
label: { Text("Click Me") }
)
To create image Button
Button(
action: {
// do something
},
label: { Image("hello_world") }
)
It heavily relies in state, simply create a state and pass it as it will bind to it
@State var fullName: String = "Joe" //create State
TextField($fullName) // passing it to bind
.textFieldStyle(.roundedBorder) // adds border
To create secure TextField
@State var password: String = "" // create State
SecureField($password) // passing it to bind
.textFieldStyle(.roundedBorder) // adds border
@State var value: Double = 0 // create State
Slider(value: $value, from: -100, through: 100, by: 1)
@State var selectedDate = Date()
DatePicker(
$selectedDate,
maximumDate: Date(),
displayedComponents: .date
)
@State var favoriteColor = 0
var colors = ["Red", "Green", "Blue"]
SegmentedControl(selection: $favoriteColor) {
ForEach(0 ..< colors.count) { index in
Text(self.colors[index])
.tag(index)
}
}
@State var count:Int = 0
Stepper(
onIncrement: { self.count += 1 },
onDecrement: { self.count -= 1 },
label: { Text("Count is \(count)") }
)
or
@State var count:Int = 0
Stepper(value: $count, in: 1...10) {
Text("Count is \(count)")
}
For single tap
Text("Tap me!")
.tapAction {
print("Tapped!")
}
For double tap
Text("Tap me!")
.tapAction(count: 2) {
print("Tapped!")
}
Gesture like TapGesture, LongPressGesture, DragGesture
Text("Tap")
.gesture(
TapGesture()
.onEnded { _ in
// do something
}
)
Text("Drag Me")
.gesture(
DragGesture(minimumDistance: 50)
.onEnded { _ in
// do something
}
)
Text("Long Press")
.gesture(
LongPressGesture(minimumDuration: 2)
.onEnded { _ in
// do something
}
)
To create static scrollable List
List {
Text("Hello world")
Text("Hello world")
Text("Hello world")
}
To create dynamic List
let names = ["Thanos", "Iron man", "Ant man"]
List(names) { name in
Text(name)
}
To add section
List {
Section(header: Text("Good Hero")) {
Text("Thanos")
}
Section(header: Text("Bad Heros")) {
Text("Iron man")
}
}
To make it grouped add .listStyle(.grouped)
List {
Section(header: Text("Good Hero")) {
Text("Thanos")
}
Section(header: Text("Bad Heros")) {
Text("Iron man")
}
}.listStyle(.grouped)
NavigationView is more/less like UINavigationController, It handles navigation between views, shows title, places navigation bar on top.
NavigationView {
Text("Hello")
.navigationBarTitle(Text("World"), displayMode: .inline)
}
For large title use .large
Add bar items to NavigationView
NavigationView {
Text("Hello")
.navigationBarTitle(Text("World"), displayMode: .inline)
.navigationBarItems(
trailing:
Button(
action: { print("Going to Setting") },
label: { Text("Setting") }
)
)
}
TabbedView creates a container similar to UITabBarController with radio-style selection control which determines which View
is presented.
@State private var selection = 0
TabbedView(selection: $selection) {
Text("View A")
.font(.title)
.tabItemLabel(Text("View A")
.font(.caption))
.tag(0)
Text("View B")
.font(.title)
.tabItemLabel(Text("View B")
.font(.caption))
.tag(1)
Text("View C")
.font(.title)
.tabItemLabel(Text("View C")
.font(.caption))
.tag(2)
}
Group creates several views to act as one, also to avoid Stack's 10 View maximum limit.
VStack {
Group {
Text("Hello")
Text("Hello")
Text("Hello")
}
Group {
Text("Hello")
Text("Hello")
}
}
To Show an Alert
Alert(
title: Text("Title"),
message: Text("message"),
dismissButton: .default(Text("Ok!"))
)
To Show Action Sheet
ActionSheet(
title: Text("Title"),
message: Text("Message"),
buttons: [
.default(Text("Ok!"), onTrigger: { print("hello") })
]
)
Navigate via NavigationButton
NavigationView {
NavigationButton(destination: SecondView()) {
Text("Show")
}.navigationBarTitle(Text("First View"))
}
Navigate via tap on List Item
let names = ["Thanos", "Iron man", "Ant man"]
List(names) { name in
NavigationButton(destination: HeroView(name: name)) {
Text(name)
}
}
Navigate via PresentationButton
PresentationButton(Text("Tap"), destination: HeroView())
It's possible to work with UIKit components from SwiftUI or call SwiftUI views as View Controllers from UIKit.
Let's say you have a View Controller named SuperVillainViewController and want to call it from a SwiftUI view, to do that ViewController needs to implement UIViewControllerRepresentable:
struct SuperVillainViewController: UIViewControllerRepresentable {
var controllers: [UIViewController]
func makeUIViewcontroller(context: Context) -> SuperVillainViewController {
// you could have a custom constructor here, I'm just keeping it simple
let vc = SuperVillainViewController()
return vc
}
}
Now you can use it like
NavigationButton(destination: SuperVillainViewController()) {
Text("Click")
}
To use UIView subclasses from within SwiftUI, you wrap the other view in a SwiftUI view that conforms to the UIViewRepresentable protocol. (Reference)
as example
import SwiftUI
import MapKit
struct MapView: UIViewRepresentable {
func makeUIView(context: Context) -> MKMapView {
MKMapView(frame: .zero)
}
func updateUIView(_ view: MKMapView, context: Context) {
let coordinate = CLLocationCoordinate2D(
latitude: 34.011286,
longitude: -116.166868
)
let span = MKCoordinateSpan(latitudeDelta: 2.0, longitudeDelta: 2.0)
let region = MKCoordinateRegion(center: coordinate, span: span)
view.setRegion(region, animated: true)
}
}
struct MapView_Preview: PreviewProvider {
static var previews: some View {
MapView()
}
}