tvOS 键盘组件

用于 tvOS 应用程序开发的自定义键盘组件。

功能

此 tvOS 键盘可以在任何 UIViewController 中使用。
您可以使用触控板输入文本、数字和其他字符。
支持所有输入语言。
键盘样式几乎与原生组件相同，但如果开发者希望，可以更改。
能够指定焦点元素，以便从一个组件切换。

Swift Package Manager 安装

Swift Package Manager 是一种用于自动化 Swift 代码分发的工具，并已集成到 swift 编译器中。它还处于早期开发阶段，但 Alamofire 确实支持在受支持的平台上使用它。

一旦你设置好你的 Swift 包，添加 TVOSKeyboard 作为依赖项就像把它添加到你的 Package.swift 的 dependencies 值中一样简单。

dependencies: [
    .package(url: "https://github.com/goldenplan/TVOSKeyboard", .upToNextMajor(from: "0.1.0"))
]

tvOS 键盘使用示例

凭借强大的选项，您可以使用 tvOS 键盘以简单的方式完成困难的任务。例如，以下代码

使用 Storyboard 或代码创建一个键盘组件。

    import TVOSKeyboard
    @IBOutlet weak var keyboardView: KeyboardView!

创建您自己的字符集来输入，或使用预设的字符集之一。

    let eng = KeyboardDescription(code: "en", type: .letters, simbols: "abcdefghijklmnopqrstuvwxyz", label: "abc", spaceName: "space")

创建一个配置对象，并在必要时更改默认值。

    let config = KeyboardConfig()
    config.keyboardDescriptions = [
        eng,
        Presets.rus
    ]
    config.topFocusedElement = button
    config.isUppercasedOnStart = true
    config.allowNumeric = false
    config.allowSimbolic = true
    config.allowSpaceButton = false
    config.allowDeleteButton = false
    config.hideOptionalPanel = false
    keyboardView.config = config
    keyboardView.delegate = self

将您的 ViewController 或其他负责处理来自键盘的数据的对象指定为委托。为此，委托必须首先在 KeyboardViewProtocol 下签名。

public protocol KeyboardViewProtocol: class {
    func addSimbol(_ value: String)
    func deleteSimbol()
    func swipeFromDown()
    func deleteLongPress()
    func updateString(_ cachedString: String)
    func performFocus(element: UIView)
}

要求

tvOS 13.0+
Swift 5.0+

联系方式

如果您发现问题，请开启工单。我们也非常欢迎提交 Pull Request。

许可

TVOSKeyboard 在 MIT 许可下发布。详见 LICENSE。