WMobileKit 5.1.1

WMobileKit 5.1.1

TestsTested
LangLanguage SwiftSwift
License Custom
ReleasedLast Release Oct 2017
SwiftSwift Version 3.2
SPMSupports SPM

Maintained by James Romo, Jordan Ross, Jeff Scaturro.


Downloads

Total8,215
Week0
Month50

Installs

Apps11
Test Targets1
powered by Segment

GitHub

Stars2
Watchers14
Forks4
Issues0
Contributors14
Pull Requests1

Code

Files25
LOCLines of Code 5,488


 
Depends on:
SnapKit= 3.2.0
SDWebImage= 4.0.0
 

  • By
  • James Romo, Jordan Ross, Jeff Scaturro, Todd Tarbox, Brian Blanchard and Bryan Rezende




BuddyBuild

WMobileKit is a Swift library containing various custom UI components to provide functionality outside of the default libraries. Each component is customizable and featured in a sample app to demonstrate its functionality!

Index

Features

Controls

Component Demo
WRadio
Web-like radio button that can be tied to a group and automatically select/deselect as expected from a normal radio button. The size and color of the outer and inner circle can be changed as well as the highlight.
WSwitch
Custom switch control emulating Apple's custom switches. Adds the ability to change sizes, colors, and sliding behaviors.

Information Views

Component Demo
WBadge
Custom number badge that provides the ability to change color, spacing, shape, location, and how the number displays/expands.
WSpinner
Custom progress spinner allowing for custom colors, the addition of images.
WUserLogoView
An image used to represent a user. Can use either a name which is hashed into a color or and image that is cropped to fit the view.
WAutoLayoutView
View that automatically adds as many of the provided views as possible to each row as determined by the controller's width and wraps to the next row for any remaining views while adjusting the height to fit the content.

Modal Components

Component Demo
WActionSheet
Custom action sheets providing the ability to include a picker view, automatically scale to content, scroll, include a cancel button, and tap to dismiss.
WBanner
Static banners that display information over content from the top or bottom. Can be automatically dismissed or on tap.
WLoadingModal
Displays a loading view over content. Can dim the background view and will disappear after a set period of time.
WToast
Toast that displays from the top/bottom or sides and can be customized to dismiss on tap or via a timer. The color, text, and transparency can be customized.

Navigation

Component Demo
WPagingSelectorControl
Custom paging control that allows scrolling headers, automatically spaced headers and button actions to display a view controller.
WPagingSelectorVC
View controller leveraging the WPagingSelectorControl.
WSideMenuVC
Custom side menu drawer. Displays view controllers as cells that can be tapped to swap the main view.

Text Inputs

Component Demo
WAutoCompleteTextView
Text view that provides suggestions as you type.
WMarkdownTextView
Text view that interprets and displays markdown text.
WTextField
UITextField with expanded functionality.
WTextView
UITextView with expanded functionality.

Miscellaneous/Utilities

Component Description
WSizeVC
Base view controller that responds to and sends size change related events. Supports iPad Pro/Air split views.
WTheme
Component that allows for simple theme creation that can be used throughout an app.
WUtils
Random useful methods.

Usage

To use the library in your app, add the following import to your file:

import WMobileKit

To run the example project, run ./setup.sh in the root directory.
Alternatively, you can run pod install from the Example directory.

Requirements

  • use_frameworks! must be at the top of your Podfile (since this is a Swift pod)
  • iOS 8.0+
  • Xcode 9.0
  • Objective-C, Swift 3.2

Installation

Add the following to your Podfile:

pod "WMobileKit"

Sample App Setup

Run the following in the root directory

./setup.sh

Contributions

A release is automatically created with each pull request. Please bump the WMobileKit.podspec,
Source/Info.plist, and Example/WMobileKitExample/Info.plist using version_bump.sh
according to semantic versioning.

Example: (5.1.0 is the old version 5.1.1 is the new version)

./version_bump.sh 5.1.0 5.1.1

Known Issues

use_frameworks missing

Error:

[!] Pods written in Swift can only be integrated as frameworks; this feature is still in beta. Add `use_frameworks!` to your Podfile or target to opt into using it. The Swift Pod being used is: WMobileKit
    Warning: Command failed:  Use --force to continue.

Solution:

  • Add use_frameworks to the top of your Podfile

License

WMobileKit is available under the Apache license. See the LICENSE file for more info.

Authors

  • James Romo
  • Jordan Ross
  • Jeff Scaturro
  • Todd Tarbox
  • Brian Blanchard
  • Bryan Rezende