NKButton
A fully customizable UIButton
Example
To run the example project, clone the repo, and run pod install from the Example directory first.
Installation
NKButton is available through Swift Package Manager (Recommended) and CocoaPods:
pod 'NKButton'
Usage
Creation and basic customization:
let button = NKButton()
button.title = "Button"
button.setTitleColor(.black, for: .normal) // set title color for normal state
button.setTitleColor(.white, for: .highlighted) // set title color for highlight state
button.setTitleFont(normalFont, for: .normal)
button.setTitleFont(boldFont, for: .highlight)
button.setBackgroundColor(.blue, for: .normal) // set background color for normal state
button.setBackgroundColor(.green, for: .highlighted) // set background color for highlight state
button.spacing = 10.0 // space between icon and title
button.imageAlignment = .top // icon alignment
button.underlineTitleDisabled = true // no underline text when `Settings > Accessibility > Button Shapes` is ON
button.isRoundedButton = true
button.cornerRadius = 10.0
button.extendSize = CGSize(width: 50, height: 20) // size that will be included in sizeThatFits
Add border:
button.setBorderColor(.black, for: .normal) // set border color for normal state
button.setBorderColor(.white, for: .highlighted) // set border color for highlight state
button.setBorderSize(1.0, for: .normal) // border stroke size
button.setBorderSize(2.0, for: .highlighted)
Add shadow:
button.setShadowColor(.blue, for: .normal) // set shadow color for normal state
button.setShadowColor(.green, for: .highlighted) // set shadow color for highlight state
button.shadowOffset = CGSize(width: 0, height: 5)
button.shadowOpacity = 0.6
button.shadowRadius = 10
Add gradient color:
button.setGradientColor([UIColor(white: 1.0, alpha: 0.5), UIColor(white: 1.0, alpha: 0.0)], for: .normal) // set gradient color for normal state
button.setGradientColor([UIColor(white: 1.0, alpha: 0.0), UIColor(white: 1.0, alpha: 0.5)], for: .highlighted) // set gradient color for highlight state
Set loading state:
button.loadingIndicatorStyle = .ballBeat // loading indicator style
button.loadingIndicatorAlignment = .atImage // loading indicator alignment
button.hideImageWhileLoading = true
button.hideTitleWhileLoading = false
button.isLoading = true // show loading indicator in the button, and button will be disabled automatically until setting isLoading = false
Flashing:
button.startFlashing()
button.startFlashing(flashDuration: 0.25, intensity: 0.9, repeatCount: 10)
Subscript syntax:
button.titleColors[.normal] = .black
button.titleFonts[.normal] = normalFont
button.titleFonts[.highlight] = boldFont
button.backgroundColors[.normal] = .white
button.backgroundColors[.highlight] = .yellow
button.borderColors[.normal] = .gray
button.borderColors[[.highlight, .selected]] = .black
button.shadowColors[.normal] = .black
Dependency
NKButton uses NVActivityIndicatorView for loading indicator, so it currently has 32 animation types.
NKButton uses FrameLayoutKit for content layout so you can customize the layout easily
Author
Nam Kennic, [email protected]
License
NKButton is available under the MIT license. See the LICENSE file for more info.
2 Sep 6, 2022
93 Aug 14, 2022
169 Sep 14, 2022
277 Dec 17, 2022
3.3k Dec 31, 2022
1.3k Dec 27, 2022
1.5k Dec 30, 2022
637 Dec 30, 2022
13 Aug 20, 2022
166 Dec 21, 2022
4k Jan 6, 2023
397 Nov 16, 2022
14 Dec 30, 2022
4 Nov 2, 2022
1.4k Jan 5, 2023
585 Dec 28, 2022
352 Dec 4, 2022
336 Nov 26, 2022
83 Oct 11, 2022
720 Nov 17, 2022
1.4k Dec 25, 2022
932 Dec 12, 2022
68 Nov 12, 2022
8 May 13, 2022
129 Mar 19, 2022
1.4k Dec 1, 2022
566 Dec 9, 2022