DeckKit 0.7.0

DeckKit 0.7.0

Daniel Saidi 维护。



DeckKit 0.7.0

DeckKit Logo

Version Swift 5.6 MIT License Twitter: @danielsaidi Mastodon: @danielsaidi@mastodon.social

关于 DeckKit

DeckKit 可帮助您使用 SwiftUI 创建基于卡片的 app。结果可以看起来像这样,也可以完全不同

DeckKit 卡片可以高度自定义。您可以更改标准卡片视图的颜色、字体、圆角半径等,还可以使用完全自定义的视图。

DeckKit 支持 iOS 13macOS 11tvOS 13watchOS 6

安装

可以使用 Swift 包管理器安装 DeckKit

https://github.com/danielsaidi/DeckKit.git

如果您偏好没有外部依赖项的情况,也可以直接将源代码复制到您的应用中。

入门

在线文档有一个 入门指南,它将帮助您开始使用此库。

在 DeckKit 中,Deck 可用于定义实现了 DeckItem 协议的项目集合。

例如,考虑一个如下所示的 Hobby 类型

struct Hobby: DeckItem {
    
    var name: String
    var text: String

    var id: String { name }
}

现在,您可以创建一个包含爱好并显示在 DeckView 中的卡片集合。

struct MyView: View {

    @State
    var deck = Deck(
        name: "Hobbies",
        items: [
            Hobby(name: "Music", text: "I love music!"), 
            Hobby(name: "Movies", text: "I also love movies!"), 
            Hobby(name: "Programming", text: "Not to mention programming!")
        ]
    )

    var body: some View {
        DeckView(deck: $deck) {
            // Create a view for the hobby here
        }.padding()
    }
}

DeckView 函数接受一个可选的 DeckViewConfiguration 参数,可用于以各种方式配置视图。例如,您可以使用它来控制视觉方向、可见项数量等。

您还可以提供在卡片被拖拽到前后左右边缘时触发的额外操作。

有关更多信息,请参阅在线文档 DeckKit 文档入门指南

文档

在线文档提供了文章、代码示例等内容,让您了解库的各部分。

示例应用

该项目包含一个示例应用,让您可在 iOS 和 macOS 上探索库。要尝试它,只需打开并运行 Demo/Demo.xcodeproj

支持此库

您可以通过GitHub Sponsor赞助此项目,或联系以获得付费支持。

联系方式

如果您有任何疑问或想要以任何方式贡献力量,请随时联系。

许可证

DeckKit遵循MIT许可证。有关更多信息,请参阅LICENSE文件。