BadgeSwift 8.0.0

BadgeSwift 8.0.0

测试已测试
语言语言 SwiftSwift
许可证 MIT
发布最后发布2019 年 4 月
SPM支持 SPM

Evgenii Neumerzhitckii 维护。




  • Evgenii Neumerzhitckii

Swift Badge

Swift 编写的 iOS 和 tvOS 标签控件

Carthage compatible CocoaPods Version License Platform

  • 标签是 UILabel 视图的子类。
  • 可以从 Storyboard 或代码中创建和自定义它。

设置

您有以下三种方式可以在 Xcode 项目中添加 BadgeSwift。

添加源代码(iOS 7+)

只需将 BadgeSwift.swift 文件添加到项目中。

使用 Carthage 设置(iOS 8+)

或者,将 github "evgenyneu/swift-badge" ~> 8.0 添加到 Cartfile 并运行 carthage update

Cocoapods (iOS 8+) 配置

如果您使用Cocoapods,请将以下文本添加到Podfile中,然后运行pod install

use_frameworks!
target 'Your target name'
pod 'BadgeSwift', '~> 8.0'

旧版 Swift 版本

如果您使用旧版本的 Swift,请设置库的上一个版本

使用方法

在 Storyboard 中创建徽章

  • 将一个 Label 拖动到视图中。
  • 在标识检查器中将它的 class 设置为 BadgeSwift
  • 如果使用了 Carthage 或 CocoaPods 安装方法,请将 module 属性设置为 BadgeSwift

Add badge to storyboard

  • 在属性检查器中自定义徽章属性(文本、颜色等)。
  • 如果 Storyboard 未能正确显示徽章,请从 编辑 菜单中单击 刷新所有视图

Change badge properties in attribute inspector

注意:使用 Carthage 安装方法时,无法从 Storyboard 中自定义 Cosmos 视图,请使用代码进行操作。

从代码创建徽章

除非您使用了文件安装方法,否则请将 import BadgeSwift 添加到源代码中。

let badge = BadgeSwift()
view.addSubview(badge)
// Position the badge ...

在演示应用中查看从代码创建和定位徽章的示例(点击此处)。

自定义

// Text
badge.text = "2"

// Insets
badge.insets = CGSize(width: 12, height: 12)

// Font
badge.font = UIFont.preferredFont(forTextStyle: UIFontTextStyle.body)

// Text color
badge.textColor = UIColor.yellow

// Badge color
badge.badgeColor = UIColor.black

// Shadow
badge.shadowOpacityBadge = 0.5
badge.shadowOffsetBadge = CGSize(width: 0, height: 0)
badge.shadowRadiusBadge = 1.0
badge.shadowColorBadge = UIColor.black

// No shadow
badge.shadowOpacityBadge = 0

// Border width and color
badge.borderWidth = 5.0
badge.borderColor = UIColor.magenta

// Customize the badge corner radius.
// -1 if unspecified. When unspecified, the corner is fully rounded. Default: -1.
badge.cornerRadius = 10

示例应用

本项目包含一个示例应用。

BadgeSwift for iOS demo app

Show BadgeSwift in a table view in iOS

Create badge from code BadgeSwift for iOS

替代方案

以下是一些iOS的替代徽章。

感谢以下人员👍

  • amg1976 为添加边框和重新设计绘图做出了贡献。
  • gperdomor 为增加了自定义圆角的功能。
  • acecilia 为移除在扩展中使用徽章时的警告。

许可协议

BadgeSwift 在MIT 许可协议下发布。

欢迎反馈

如果你发现了错误或想改进徽章,请随意创建一个问题。