Действия на сочетания клавиш в SwiftUI

Модификатор keyboardShortcut добавляет сочетания клавиш:

struct ContentView: View {
    var body: some View {
        Button("Refresh content") {
            print("⌘ + R pressed")
        }
        .keyboardShortcut("r", modifiers: [.command])
    }
}

Теперь по нажатию двух клавиш Command + R выведем сообщение в консоль.

Первый параметр модификатора keyboardShortcut должен быть экземпляром структуры KeyEquivalent, он наследуется от протокола ExpressibleByExtendedGraphemeClusterLiteral и создаёт экземпляр KeyEquivalent со строковым литералом в 1 символ.

init(_ key: KeyEquivalent, modifiers: EventModifiers = .command)

А вот второй параметр modifiers наследуется от структуры EventModifiers. Это уникальный набор клавиш-модификаторов.

В примере выше используем клавишу R и модификатор .command, который устанавливается по умолчанию в SwiftUI.

Рассмотрим пример с переключателем:

struct ContentView: View {

    @State private var isEnabled = false
    
    var body: some View {
        VStack {
            Text("Press ⌘ + T")
            Toggle(isOn: $isEnabled) {
                Text(String(isEnabled))
            }
            .padding()
        }
        .keyboardShortcut("t")
    }
}

Нажимаем на ⌘ + T и меняем положение переключателя. Применяем модификатор ко всем элементам VStack.

Другой пример:

Button("Confirm action") {
    print("Launching starship…")
}
.keyboardShortcut(.defaultAction)

Проперти .defaultAction — стандартная комбинация клавиш для кнопки по умолчанию Enter.

Я положил сочетание клавиш Escape + Option + Shift в константу updateArticles:

struct ContentView: View {

    let updateArticles = KeyboardShortcut(.escape, modifiers: [.option, .shift])
    
    var body: some View {
        Button { 
            print("Sync articles…")
        } label: { 
            VStack(spacing: 30) {
                Image(systemName: "books.vertical")
                    .imageScale(.large)
                Text("Update articles")
            }
        }
        .keyboardShortcut(updateArticles)
    }
}

---

Другие туториалы