CheatSheetOverlay：自定义快捷键提示层

编辑

跳转Github地址

预估时长 1 min read

项目名称：CheatSheetOverlay

项目简介

CheatSheetOverlay是一个SwiftUI库，用于创建一个可自定义的键盘快捷键提示层。这个库允许开发者在macOS应用中以一种直观的方式展示快捷键，帮助用户快速了解和使用应用中的快捷操作。

功能特点

自定义快捷键：开发者可以使用Label和.keyboardShortcut()修饰符来创建快捷键提示。
快捷键分组：使用GroupBox来对快捷键进行分组，使得提示层更加有序。
激活延迟设置：可以通过revealDelay参数调整快捷键提示层显示的延迟时间。
激活键自定义：可以通过activationKey参数自定义触发快捷键提示层显示的按键。

使用方法

以下是如何在项目中使用CheatSheetOverlay的示例代码：

创建快捷键提示项：

Label("Copy", systemImage: "doc.on.doc")
    .keyboardShortcut("c")

将快捷键分组：

GroupBox("Text Commands") {
    Label("Copy", systemImage: "doc.on.doc")
        .keyboardShortcut("c")
    Label("Paste", systemImage: "arrow.right.doc.on.clipboard")
        .keyboardShortcut("v")
    Label("Cut", systemImage: "scissors")
        .keyboardShortcut("x")
}

将快捷键提示层添加到视图中：

ContentView()
    .cheatSheet {
        GroupBox("Text Commands") {
            Label("Copy", systemImage: "doc.on.doc")
                .keyboardShortcut("c")
            Label("Paste", systemImage: "arrow.right.doc.on.clipboard")
                .keyboardShortcut("v")
            Label("Cut", systemImage: "scissors")
                .keyboardShortcut("x")
        }

        GroupBox {
            Label("Print", systemImage: "printer")
                .keyboardShortcut("p")
            Label("Go Wild", systemImage: "sparkles")
                .keyboardShortcut(.return, modifiers: [.control, .option, .shift, .command])
        }
    }

调整快捷键提示层的显示延迟：

ContentView()
    .cheatSheet(revealDelay: 0.75) { /* ... */ }

自定义激活快捷键提示层的按键：

ContentView()
    .cheatSheet(activationKey: .command) { /* ... */ }

安装方法

将CheatSheetOverlay添加到项目中作为Swift包：

.package(url: "https://github.com/ryanslikesocool/CheatSheetOverlay", from: "0.2.0"),

项目地址

项目位于GitHub上，可以通过以下链接访问：CheatSheetOverlay GitHub。

FlowStacks：为SwiftUI导航添加超能力

FlowStacks是一个SwiftUI库，它扩展了NavigationStack API，允许开发者使用统一的API进行页面推送、展示sheet和全屏覆盖，支持iOS、tvOS、watchOS和macOS。

最近更新 2024-12-13

PartialSheet：自定义SwiftUI部分模态弹窗

PartialSheet是一个基于SwiftUI的自定义组件，用于展示基于内容大小的部分模态弹窗，支持滑动、自定义颜色和键盘兼容性，适用于iOS和MacOS。

最近更新 2024-12-31

WaterTracker：跨平台纯SwiftUI开发的喝水追踪应用

WaterTracker是一款跨iOS、iPadOS和watchOS平台的喝水追踪应用，使用SwiftUI开发，支持HealthKit和CloudKit数据同步，无广告、无内购。

最近更新 2024-12-09

独立开发者

独立开发者