KGNUserInterface is a collection of the core user interface resources.
github "kgn/KGNUserInterface"
In addition to including the above frameworks KGNUserInterface also includes several helper methods, classes, and structs build on-top of these frameworks.
KGNUserInterface defines a π constant that represents a CGFloat value for pi.
addSubViewController is a helper method that encapsulates all of the logic to properly add a view controller as a child view controller.
self.addSubViewController(launchScreenViewController)The Style struct is a collection of useful structs. There are several namespaces beneath the Style struct including.
This top level static defines a default PreferredFontManager. You can also provide your own PreferredFontManager in order to customize the fonts used throughout your app.
This top level static defines a default Gregorian calendar. You can also provide your own calendar in order to customize the dates used throughout your app.
This struct includes color statics like Style.Color.White. You can extend this struct to add your own colors for use throughout your app.
extension Style.Color {
static let Black = UIColor(hex: 0x1A1A1A)
public static let ButtonGradientTop = UIColor(hex: 0x4DC4FF)
public static let ButtonGradientBottom = UIColor(hex: 0xA147FF)
public static let BlackGradientTop = Style.Color.Black.colorWithAlphaComponent(0)
public static let BlackGradientBottom = Style.Color.Black.colorWithAlphaComponent(0.5)
}This struct includes gradient statics like Style.Gradient.BlackAndWhite. You can extend this struct to add your own gradients for use throughout your app.
This struct includes size statics like Style.Size.OnePixel. You can extend this struct to add your own sizes for use throughout your app.
extension Style.Size {
public static let CircleProgressStroke: CGFloat = 1
public static let CircleProgressSize: CGFloat = 64
public static let CircleProgressStartAngle: CGFloat = -π*0.25
}This struct includes animation value statics like Style.Animation.Duration. You can extend this struct to add your own animation values for use throughout your app.
This struct includes shadow value statics like Style.Shadow.Opacity. You can extend this struct to add your own shadow values for use throughout your app.
This struct also as an Apply method to apply the shadow to a view.
Style.Shadow.Apply(view)This struct includes formatter methods Style.Format.Date. You can extend this struct to add your own formatting methods for use throughout your app.
cell.dateLabel.text = Style.Format.Date(creationDate, includeTime: true)KGNUserInterface defines a Label subclass of PreferredFontLabel, a Button subclass of PreferredFontButton, and a TextField subclass of PreferredFontTextField. All subclasses set the preferredFontManager property to Style.PreferredFontManager.
Label and TextField expose properties to control the width and height intrinsic content size without having to subclass through allowIntrinsicWidth and allowIntrinsicHeight.
TextField also has an auto complete feature that suggests text to the user as they type. To add auto complete suggestions simply set the autoCompleteValues property to an array of values. For example, the following code will auto complete email address domains as the user types:
let textField = TextField()
textField.autoCompleteValues = [
"@aol.com",
"@me.com",
"@mac.com",
"@gmail.com",
"@yahoo.com"
]
By default the suggestions are case insensitive, if the auto complete should be case sensitive simply set textField.autoCompleteIgnoreCase = false.
- Tests
- Travis
- Badges
- Carthage
- Description (Add new classes to readme)
- Documentation
- Prebuilt Frameworks
- Travis Test Matrix