Skip to content
Size matters, you need a ruler.
Branch: master
Clone or download
Latest commit d941546 Sep 17, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Ruler 3.0.0 Sep 17, 2018
SizeMatters.xcodeproj 2.2.0 (24) Apr 8, 2018
SizeMatters
.gitignore
.swift-version 3.0.0 Sep 17, 2018
LICENSE
README.md
Ruler.podspec

README.md

Ruler

In some cases, we need to distinguish between different devices to set UI, but Adaptive Layout can not do that. So, there is a Ruler.

Requirements

Swift 4, iOS 8.0

(Swift 3, use version 1.0.1)

Example

If we only consider iPhone's width, iPhone 5 has the same width of iPhone 4s, iPhone 6 has a bigger width, iPhone 6 Plus' width even bigger than iPhone 6, and iPhone X's width is the biggest. Only four widths.

But if we consider full screen size of iPhone, there are five models, because iPhone 5's height is different from iPhone 4s'.

If our app is universal, we need consider iPad, there are two models (in points).

So all we need consider five cases as follows:

enum Ruler<T> {
    case iPhoneHorizontal(T, T, T)
    case iPhoneVertical(T, T, T, T, T)
    case iPad(T, T)
    case universalHorizontal(T, T, T, T, T)
    case universalVertical(T, T, T, T, T, T, T)
}

In real world (thanks generics, Ruler can match anything for different sizes of iOS devices):

import Ruler
// size, off course

let width = Ruler.iPhoneHorizontal(10, 20, 30).value
let height = Ruler.iPhoneVertical(5, 10, 20, 30, 40).value

// or color

colorView.backgroundColor = Ruler.universalVertical(UIColor.black, UIColor.red, UIColor.blue, UIColor.green, UIColor.yellow, UIColor.purple, UIColor.cyan).value

// even closures

typealias Greeting = () -> Void

let greeting: Greeting = Ruler.universalVertical(
{ print("Hello!") },
{ print("Hi!") },
{ print("How are you!") },
{ print("How do you do!") },
{ print("好久不见!") },
{ print("你好!") },
{ print("很高兴见到你!") }).value

greeting()

// ...

Special offer

Detect if this device is an iPhone X:

if ScreenModel.isPhoneX {
    print("It's an iPhone X. You're rich!")
}

Installation

Feel free to drag Ruler.swift to your iOS Project. But it's recommended to use Carthage (or CocoaPods).

Carthage

github "nixzhu/Ruler"

CocoaPods

pod 'Ruler'

Contact

NIX @nixzhu

License

Ruler is available under the MIT license. See the LICENSE file for more info.

You can’t perform that action at this time.