文件列表:

Contributing.md (786, 2023-08-23)
Gemfile (60, 2023-08-23)
Gemfile.lock (2373, 2023-08-23)
LICENSE (11357, 2023-08-23)
Package.swift (625, 2023-08-23)
Relativity.podspec (489, 2023-08-23)
Relativity.xcodeproj/ (0, 2023-08-23)
Relativity.xcodeproj/project.pbxproj (23060, 2023-08-23)
Relativity.xcodeproj/project.xcworkspace/ (0, 2023-08-23)
Relativity.xcodeproj/project.xcworkspace/contents.xcworkspacedata (135, 2023-08-23)
Relativity.xcodeproj/project.xcworkspace/xcshareddata/ (0, 2023-08-23)
Relativity.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist (238, 2023-08-23)
Relativity.xcodeproj/xcshareddata/ (0, 2023-08-23)
Relativity.xcodeproj/xcshareddata/xcschemes/ (0, 2023-08-23)
Relativity.xcodeproj/xcshareddata/xcschemes/Relativity.xcscheme (3582, 2023-08-23)
RelativityVisualization.playground/ (0, 2023-08-23)
RelativityVisualization.playground/Pages/ (0, 2023-08-23)
RelativityVisualization.playground/Pages/FontMetricsVisualization.xcplaygroundpage/ (0, 2023-08-23)
RelativityVisualization.playground/Pages/FontMetricsVisualization.xcplaygroundpage/Contents.swift (1860, 2023-08-23)
RelativityVisualization.playground/Pages/ViewDistributionVisualization.xcplaygroundpage/ (0, 2023-08-23)
RelativityVisualization.playground/Pages/ViewDistributionVisualization.xcplaygroundpage/Contents.swift (2937, 2023-08-23)
RelativityVisualization.playground/Pages/ViewPositionVisualization.xcplaygroundpage/ (0, 2023-08-23)
RelativityVisualization.playground/Pages/ViewPositionVisualization.xcplaygroundpage/Contents.swift (3470, 2023-08-23)
RelativityVisualization.playground/contents.xcplayground (154, 2023-08-23)
RelativityVisualization.playground/playground.xcworkspace/ (0, 2023-08-23)
RelativityVisualization.playground/playground.xcworkspace/contents.xcworkspacedata (135, 2023-08-23)
Sources/ (0, 2023-08-23)
Sources/Info.plist (753, 2023-08-23)
Sources/Relativity/ (0, 2023-08-23)
Sources/Relativity/CGRect+Relativity.swift (1130, 2023-08-23)
Sources/Relativity/DistributionItem.swift (1041, 2023-08-23)
Sources/Relativity/ErrorHandler.swift (1707, 2023-08-23)
Sources/Relativity/Operators.swift (11171, 2023-08-23)
Sources/Relativity/PixelRounder.swift (3393, 2023-08-23)
Sources/Relativity/Relativity.h (1054, 2023-08-23)
... ...

# Relativity [](https://github.com/dfed/Relativity/actions?query=workflow%3ACI+branch%3Amain) [](https://github.com/Carthage/Carthage/) [](https://cocoapods.org/pods/Relativity) [](https://cocoapods.org/pods/Relativity) [](https://cocoapods.org/pods/Relativity) Relativity provides a DSL for programmatic layout that makes it easy to achieve pixel-perfect spacing and alignment. ## Programmatic Layout There are four basic steps to laying out views programmatically. 1. **Create views**. Do this in `init` or `viewDidLoad`. 2. **Create view hierarchy** with `addSubview()`. Do this in `init` or `viewDidLoad`. 3. **Size views**. Do this in `layoutSubviews`. 4. **Position views**. Do this in `layoutSubviews`. ### Positioning Views Each view has nine anchors that are used for alignment.

topLeft	top	topRight
left	middle	right
bottomLeft	bottom	bottomRight

Positioning views is done by aligning the desired anchor on a view to another view’s anchor, plus an offset. A `-->` moves the view on the left side to the position described on the right side. A `<--` moves the view on the right side to the position described on the left side. You can also explicitly align views using the `align(to:xOffset:yOffset)` method in [ViewPosition.swift](Sources/ViewPosition.swift#L105). #### Examples To align view `a` to be 10 points to the left of view `b`: ```swift a.right --> 10.horizontalOffset + b.left ``` To align view `a` to be 10 points to the right of view `b`: ```swift b.right + 10.horizontalOffset <-- a.left ``` To align view `a` to be 10 points below its superview’s top center: ```swift a.top --> 10.verticalOffset + .top ``` For more examples, check out the [ViewPositionVisualization](RelativityVisualization.playground/Pages/ViewPositionVisualization.xcplaygroundpage/Contents.swift) playground page. #### UILabels Relativity makes it easy to position your `UILabel`s using the font’s [cap height](https://en.wikipedia.org/wiki/Cap_height) and [baseline](https://en.wikipedia.org/wiki/Baseline_(typography)) by adding six anchors specifically for labels.

capLeft	cap	capRight
baselineLeft	baseline	baselineRight

If your spec says that the top of your `underlineView` should align with the baseline of label `a`, all you need is: ```swift underlineView.top --> a.baseline ``` For a visual example, check out the [FontMetricsVisualization](RelativityVisualization.playground/Pages/FontMetricsVisualization.xcplaygroundpage/Contents.swift) playground page. ### Flexible distribution of subviews Since views need to be laid out flexibly over various iOS device sizes, Relativity has the ability to easily distribute subviews with flexible positioning along an axis. Subview distribution can be controlled by positioning fixed and flexible spacers in between views. Fixed spaces represent points on screen. Fixed spaces are created by inserting `CGFloatConvertible` (`Int`, `Float`, `CGFloat`, or `Double`) types into the distribution expression, or by initializing a `.fixed(CGFloatConvertible)` enum case directly. Flexible spacers represent proportions of the remaining space in the superview after the subviews and fixed spacers have been accounted for. You can create flexible spacers by surrounding an `Int` with a spring `~` operator, or by initializing the `.flexible(Int)` enum case directly. A `~2~` represents twice the space that `~1~` does. Views, fixed spacers, and flexible spacers are bound together by a bidirectional anchor `<>` operator. #### Examples To equally distribute subviews `a`, `b`, and `c` at equal distances along a horizontal axis: ```swift superview.distributeSubviewsHorizontally() { a <> ~1~ <> b <> ~1~ <> c } ``` To make the space between `a` and `b` twice as large as the space between `b` and `c`: ```swift superview.distributeSubviewsHorizontally() { a <> ~2~ <> b <> ~1~ <> c } ``` To pin `a` to be 8pts from the left side, and distribute `b` and `c` with equal spacing over the remaining space: ```swift superview.distributeSubviewsHorizontally() { 8 <> a <> ~1~ <> b <> ~1~ <> c } ``` To equally distribute subviews `a`, `b`, and `c` at equal distances along a vertical axis, but align the subviews within the left half of `superview`: ```swift superview.distributeSubviewsVertically(within: CGRect(x: 0.0, y: 0.0, width: superview.bounds.midX, height: superview.bounds.height)) { a <> ~1~ <> b <> ~1~ <> c } ``` For a visual example, check out the [ViewPositionVisualization](RelativityVisualization.playground/Pages/ViewPositionVisualization.xcplaygroundpage/Contents.swift) playground page. ### Pixel Rounding Relativity ensures that you never align a frame to a non-integral pixel, so no need to worry about blurry UI! I’ve also vended a public [PixelRounder](Sources/PixelRounder.swift) for those who want to use it for frame sizing. ### Sizing Views Relativity makes it easy to size views based on the space between previously laid-out content. Use the `|--|` operator to determine the size between view anchors. #### Examples To size view `b` to fit between views `a` and `c`: ```swift b.bounds.size = a.topRight |--| c.bottomLeft ``` To size view `b` to fit between views `a` and `c` with a 16 point horizontal inset: ```swift b.bounds.size = a.topRight |--| c.bottomLeft + -16.horizontalOffset ``` To size view `b` to be the same height as view `a`, and fit between `a` and the right side of `a`'s superview: ```swift b.bounds.size = CGSize(width: (a.right |--| .right).width, height: a.bounds.height) ``` ## Requirements * Xcode 10.0 or later. * iOS 9 or later. * Swift 4.2 or later. ## Installation ### CocoaPods To install Relativity in your iOS project with [CocoaPods](http://cocoapods.org), add the following to your `Podfile`: ``` platform :ios, '8.0' pod 'Relativity', '~> 1.0' ``` ### Carthage To install Relativity in your iOS project with [Carthage](https://github.com/Carthage/Carthage), add the following to your `Cartfile`: ```ogdl github "dfed/Relativity" ``` Run `carthage` to build the framework and drag the built `Relativity.framework` into your Xcode project. ### Swift Package Manager To install Relativity in your iOS project with [Swift Package Manager](https://github.com/apple/swift-package-manager), the following lines can be added to your `Package.swift` file: ```swift dependencies: [ .package(url: "https://github.com/dfed/Relativity", from: "2.0.0"), ] ``` ### Submodules To use git submodules, checkout the submodule with `git submodule add git@github.com:dfed/Relativity.git`, drag Relativity.xcodeproj to your project, and add Relativity as a build dependency. ## Contributing I’m glad you’re interested in Relativity, and I’d love to see where you take it. Please read the [contributing guidelines](Contributing.md) prior to submitting a Pull Request. Thanks, and happy positioning! ## Default branch The default branch of this repository is `main`. Between the initial commit and [7b113bc](https://github.com/dfed/Relativity/commit/7b113bc644ebfd5981231f06c946ad9bc9d262f2), the default branch of this repository was `master`. See #19 for more details on why this change was made. ## Attribution Shout out to [Peter Westen](https://twitter.com/pwesten) who inspired the creation of this library.

近期下载者：

相关文件：

评论：[我要评论] [举报此文件]

收藏者：