ConstraintDescription.swift 26 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587
  1. //
  2. // SnapKit
  3. //
  4. // Copyright (c) 2011-2015 SnapKit Team - https://github.com/SnapKit
  5. //
  6. // Permission is hereby granted, free of charge, to any person obtaining a copy
  7. // of this software and associated documentation files (the "Software"), to deal
  8. // in the Software without restriction, including without limitation the rights
  9. // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  10. // copies of the Software, and to permit persons to whom the Software is
  11. // furnished to do so, subject to the following conditions:
  12. //
  13. // The above copyright notice and this permission notice shall be included in
  14. // all copies or substantial portions of the Software.
  15. //
  16. // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  17. // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  18. // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  19. // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  20. // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  21. // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  22. // THE SOFTWARE.
  23. #if os(iOS)
  24. import UIKit
  25. #else
  26. import AppKit
  27. #endif
  28. /**
  29. Used to expose the final API of a `ConstraintDescription` which allows getting a constraint from it
  30. */
  31. public protocol ConstraintDescriptionFinalizable: class {
  32. var constraint: Constraint { get }
  33. }
  34. /**
  35. Used to expose priority APIs
  36. */
  37. public protocol ConstraintDescriptionPriortizable: ConstraintDescriptionFinalizable {
  38. func priority(priority: Float) -> ConstraintDescriptionFinalizable
  39. func priority(priority: Double) -> ConstraintDescriptionFinalizable
  40. func priority(priority: CGFloat) -> ConstraintDescriptionFinalizable
  41. func priority(priority: UInt) -> ConstraintDescriptionFinalizable
  42. func priority(priority: Int) -> ConstraintDescriptionFinalizable
  43. func priorityRequired() -> ConstraintDescriptionFinalizable
  44. func priorityHigh() -> ConstraintDescriptionFinalizable
  45. func priorityMedium() -> ConstraintDescriptionFinalizable
  46. func priorityLow() -> ConstraintDescriptionFinalizable
  47. }
  48. /**
  49. Used to expose multiplier & constant APIs
  50. */
  51. public protocol ConstraintDescriptionEditable: ConstraintDescriptionPriortizable {
  52. func multipliedBy(amount: Float) -> ConstraintDescriptionEditable
  53. func multipliedBy(amount: Double) -> ConstraintDescriptionEditable
  54. func multipliedBy(amount: CGFloat) -> ConstraintDescriptionEditable
  55. func multipliedBy(amount: Int) -> ConstraintDescriptionEditable
  56. func multipliedBy(amount: UInt) -> ConstraintDescriptionEditable
  57. func dividedBy(amount: Float) -> ConstraintDescriptionEditable
  58. func dividedBy(amount: Double) -> ConstraintDescriptionEditable
  59. func dividedBy(amount: CGFloat) -> ConstraintDescriptionEditable
  60. func dividedBy(amount: Int) -> ConstraintDescriptionEditable
  61. func dividedBy(amount: UInt) -> ConstraintDescriptionEditable
  62. func offset(amount: Float) -> ConstraintDescriptionEditable
  63. func offset(amount: Double) -> ConstraintDescriptionEditable
  64. func offset(amount: CGFloat) -> ConstraintDescriptionEditable
  65. func offset(amount: Int) -> ConstraintDescriptionEditable
  66. func offset(amount: UInt) -> ConstraintDescriptionEditable
  67. func offset(amount: CGPoint) -> ConstraintDescriptionEditable
  68. func offset(amount: CGSize) -> ConstraintDescriptionEditable
  69. func offset(amount: EdgeInsets) -> ConstraintDescriptionEditable
  70. func inset(amount: Float) -> ConstraintDescriptionEditable
  71. func inset(amount: Double) -> ConstraintDescriptionEditable
  72. func inset(amount: CGFloat) -> ConstraintDescriptionEditable
  73. func inset(amount: Int) -> ConstraintDescriptionEditable
  74. func inset(amount: UInt) -> ConstraintDescriptionEditable
  75. func inset(amount: EdgeInsets) -> ConstraintDescriptionEditable
  76. }
  77. /**
  78. Used to expose relation APIs
  79. */
  80. public protocol ConstraintDescriptionRelatable: class {
  81. func equalTo(other: ConstraintItem) -> ConstraintDescriptionEditable
  82. func equalTo(other: View) -> ConstraintDescriptionEditable
  83. #if os(iOS)
  84. func equalTo(other: UILayoutSupport) -> ConstraintDescriptionEditable
  85. #endif
  86. func equalTo(other: Float) -> ConstraintDescriptionEditable
  87. func equalTo(other: Double) -> ConstraintDescriptionEditable
  88. func equalTo(other: CGFloat) -> ConstraintDescriptionEditable
  89. func equalTo(other: Int) -> ConstraintDescriptionEditable
  90. func equalTo(other: UInt) -> ConstraintDescriptionEditable
  91. func equalTo(other: CGSize) -> ConstraintDescriptionEditable
  92. func equalTo(other: CGPoint) -> ConstraintDescriptionEditable
  93. func equalTo(other: EdgeInsets) -> ConstraintDescriptionEditable
  94. func lessThanOrEqualTo(other: ConstraintItem) -> ConstraintDescriptionEditable
  95. func lessThanOrEqualTo(other: View) -> ConstraintDescriptionEditable
  96. #if os(iOS)
  97. func lessThanOrEqualTo(other: UILayoutSupport) -> ConstraintDescriptionEditable
  98. #endif
  99. func lessThanOrEqualTo(other: Float) -> ConstraintDescriptionEditable
  100. func lessThanOrEqualTo(other: Double) -> ConstraintDescriptionEditable
  101. func lessThanOrEqualTo(other: CGFloat) -> ConstraintDescriptionEditable
  102. func lessThanOrEqualTo(other: Int) -> ConstraintDescriptionEditable
  103. func lessThanOrEqualTo(other: UInt) -> ConstraintDescriptionEditable
  104. func lessThanOrEqualTo(other: CGSize) -> ConstraintDescriptionEditable
  105. func lessThanOrEqualTo(other: CGPoint) -> ConstraintDescriptionEditable
  106. func lessThanOrEqualTo(other: EdgeInsets) -> ConstraintDescriptionEditable
  107. func greaterThanOrEqualTo(other: ConstraintItem) -> ConstraintDescriptionEditable
  108. func greaterThanOrEqualTo(other: View) -> ConstraintDescriptionEditable
  109. #if os(iOS)
  110. func greaterThanOrEqualTo(other: UILayoutSupport) -> ConstraintDescriptionEditable
  111. #endif
  112. func greaterThanOrEqualTo(other: Float) -> ConstraintDescriptionEditable
  113. func greaterThanOrEqualTo(other: Double) -> ConstraintDescriptionEditable
  114. func greaterThanOrEqualTo(other: CGFloat) -> ConstraintDescriptionEditable
  115. func greaterThanOrEqualTo(other: Int) -> ConstraintDescriptionEditable
  116. func greaterThanOrEqualTo(other: UInt) -> ConstraintDescriptionEditable
  117. func greaterThanOrEqualTo(other: CGSize) -> ConstraintDescriptionEditable
  118. func greaterThanOrEqualTo(other: CGPoint) -> ConstraintDescriptionEditable
  119. func greaterThanOrEqualTo(other: EdgeInsets) -> ConstraintDescriptionEditable
  120. }
  121. /**
  122. Used to expose chaining APIs
  123. */
  124. public protocol ConstraintDescriptionExtendable: ConstraintDescriptionRelatable {
  125. var left: ConstraintDescriptionExtendable { get }
  126. var top: ConstraintDescriptionExtendable { get }
  127. var bottom: ConstraintDescriptionExtendable { get }
  128. var right: ConstraintDescriptionExtendable { get }
  129. var leading: ConstraintDescriptionExtendable { get }
  130. var trailing: ConstraintDescriptionExtendable { get }
  131. var width: ConstraintDescriptionExtendable { get }
  132. var height: ConstraintDescriptionExtendable { get }
  133. var centerX: ConstraintDescriptionExtendable { get }
  134. var centerY: ConstraintDescriptionExtendable { get }
  135. var baseline: ConstraintDescriptionExtendable { get }
  136. #if os(iOS)
  137. @available(iOS 8.0, *)
  138. var firstBaseline: ConstraintDescriptionExtendable { get }
  139. @available(iOS 8.0, *)
  140. var leftMargin: ConstraintDescriptionExtendable { get }
  141. @available(iOS 8.0, *)
  142. var rightMargin: ConstraintDescriptionExtendable { get }
  143. @available(iOS 8.0, *)
  144. var topMargin: ConstraintDescriptionExtendable { get }
  145. @available(iOS 8.0, *)
  146. var bottomMargin: ConstraintDescriptionExtendable { get }
  147. @available(iOS 8.0, *)
  148. var leadingMargin: ConstraintDescriptionExtendable { get }
  149. @available(iOS 8.0, *)
  150. var trailingMargin: ConstraintDescriptionExtendable { get }
  151. @available(iOS 8.0, *)
  152. var centerXWithinMargins: ConstraintDescriptionExtendable { get }
  153. @available(iOS 8.0, *)
  154. var centerYWithinMargins: ConstraintDescriptionExtendable { get }
  155. #endif
  156. }
  157. /**
  158. Used to internally manage building constraint
  159. */
  160. internal class ConstraintDescription: ConstraintDescriptionExtendable, ConstraintDescriptionEditable, ConstraintDescriptionFinalizable {
  161. internal var left: ConstraintDescriptionExtendable { return self.addConstraint(ConstraintAttributes.Left) }
  162. internal var top: ConstraintDescriptionExtendable { return self.addConstraint(ConstraintAttributes.Top) }
  163. internal var right: ConstraintDescriptionExtendable { return self.addConstraint(ConstraintAttributes.Right) }
  164. internal var bottom: ConstraintDescriptionExtendable { return self.addConstraint(ConstraintAttributes.Bottom) }
  165. internal var leading: ConstraintDescriptionExtendable { return self.addConstraint(ConstraintAttributes.Leading) }
  166. internal var trailing: ConstraintDescriptionExtendable { return self.addConstraint(ConstraintAttributes.Trailing) }
  167. internal var width: ConstraintDescriptionExtendable { return self.addConstraint(ConstraintAttributes.Width) }
  168. internal var height: ConstraintDescriptionExtendable { return self.addConstraint(ConstraintAttributes.Height) }
  169. internal var centerX: ConstraintDescriptionExtendable { return self.addConstraint(ConstraintAttributes.CenterX) }
  170. internal var centerY: ConstraintDescriptionExtendable { return self.addConstraint(ConstraintAttributes.CenterY) }
  171. internal var baseline: ConstraintDescriptionExtendable { return self.addConstraint(ConstraintAttributes.Baseline) }
  172. #if os(iOS)
  173. @available(iOS 8.0, *)
  174. internal var firstBaseline: ConstraintDescriptionExtendable { return self.addConstraint(ConstraintAttributes.FirstBaseline) }
  175. @available(iOS 8.0, *)
  176. internal var leftMargin: ConstraintDescriptionExtendable { return self.addConstraint(ConstraintAttributes.LeftMargin) }
  177. @available(iOS 8.0, *)
  178. internal var rightMargin: ConstraintDescriptionExtendable { return self.addConstraint(ConstraintAttributes.RightMargin) }
  179. @available(iOS 8.0, *)
  180. internal var topMargin: ConstraintDescriptionExtendable { return self.addConstraint(ConstraintAttributes.TopMargin) }
  181. @available(iOS 8.0, *)
  182. internal var bottomMargin: ConstraintDescriptionExtendable { return self.addConstraint(ConstraintAttributes.BottomMargin) }
  183. @available(iOS 8.0, *)
  184. internal var leadingMargin: ConstraintDescriptionExtendable { return self.addConstraint(ConstraintAttributes.LeadingMargin) }
  185. @available(iOS 8.0, *)
  186. internal var trailingMargin: ConstraintDescriptionExtendable { return self.addConstraint(ConstraintAttributes.TrailingMargin) }
  187. @available(iOS 8.0, *)
  188. internal var centerXWithinMargins: ConstraintDescriptionExtendable { return self.addConstraint(ConstraintAttributes.CenterXWithinMargins) }
  189. @available(iOS 8.0, *)
  190. internal var centerYWithinMargins: ConstraintDescriptionExtendable { return self.addConstraint(ConstraintAttributes.CenterYWithinMargins) }
  191. #endif
  192. // MARK: initializer
  193. init(fromItem: ConstraintItem) {
  194. self.fromItem = fromItem
  195. self.toItem = ConstraintItem(object: nil, attributes: ConstraintAttributes.None)
  196. }
  197. // MARK: equalTo
  198. internal func equalTo(other: ConstraintItem) -> ConstraintDescriptionEditable {
  199. return self.constrainTo(other, relation: .Equal)
  200. }
  201. internal func equalTo(other: View) -> ConstraintDescriptionEditable {
  202. return self.constrainTo(other, relation: .Equal)
  203. }
  204. #if os(iOS)
  205. internal func equalTo(other: UILayoutSupport) -> ConstraintDescriptionEditable {
  206. return self.constrainTo(other, relation: .Equal)
  207. }
  208. #endif
  209. internal func equalTo(other: Float) -> ConstraintDescriptionEditable {
  210. return self.constrainTo(other, relation: .Equal)
  211. }
  212. internal func equalTo(other: Double) -> ConstraintDescriptionEditable {
  213. return self.constrainTo(Float(other), relation: .Equal)
  214. }
  215. internal func equalTo(other: CGFloat) -> ConstraintDescriptionEditable {
  216. return self.constrainTo(Float(other), relation: .Equal)
  217. }
  218. internal func equalTo(other: Int) -> ConstraintDescriptionEditable {
  219. return self.constrainTo(Float(other), relation: .Equal)
  220. }
  221. internal func equalTo(other: UInt) -> ConstraintDescriptionEditable {
  222. return self.constrainTo(Float(other), relation: .Equal)
  223. }
  224. internal func equalTo(other: CGSize) -> ConstraintDescriptionEditable {
  225. return self.constrainTo(other, relation: .Equal)
  226. }
  227. internal func equalTo(other: CGPoint) -> ConstraintDescriptionEditable {
  228. return self.constrainTo(other, relation: .Equal)
  229. }
  230. internal func equalTo(other: EdgeInsets) -> ConstraintDescriptionEditable {
  231. return self.constrainTo(other, relation: .Equal)
  232. }
  233. // MARK: lessThanOrEqualTo
  234. internal func lessThanOrEqualTo(other: ConstraintItem) -> ConstraintDescriptionEditable {
  235. return self.constrainTo(other, relation: .LessThanOrEqualTo)
  236. }
  237. internal func lessThanOrEqualTo(other: View) -> ConstraintDescriptionEditable {
  238. return self.constrainTo(other, relation: .LessThanOrEqualTo)
  239. }
  240. #if os(iOS)
  241. internal func lessThanOrEqualTo(other: UILayoutSupport) -> ConstraintDescriptionEditable {
  242. return self.constrainTo(other, relation: .LessThanOrEqualTo)
  243. }
  244. #endif
  245. internal func lessThanOrEqualTo(other: Float) -> ConstraintDescriptionEditable {
  246. return self.constrainTo(other, relation: .LessThanOrEqualTo)
  247. }
  248. internal func lessThanOrEqualTo(other: Double) -> ConstraintDescriptionEditable {
  249. return self.constrainTo(Float(other), relation: .LessThanOrEqualTo)
  250. }
  251. internal func lessThanOrEqualTo(other: CGFloat) -> ConstraintDescriptionEditable {
  252. return self.constrainTo(Float(other), relation: .LessThanOrEqualTo)
  253. }
  254. internal func lessThanOrEqualTo(other: Int) -> ConstraintDescriptionEditable {
  255. return self.constrainTo(Float(other), relation: .LessThanOrEqualTo)
  256. }
  257. internal func lessThanOrEqualTo(other: UInt) -> ConstraintDescriptionEditable {
  258. return self.constrainTo(Float(other), relation: .LessThanOrEqualTo)
  259. }
  260. internal func lessThanOrEqualTo(other: CGSize) -> ConstraintDescriptionEditable {
  261. return self.constrainTo(other, relation: .LessThanOrEqualTo)
  262. }
  263. internal func lessThanOrEqualTo(other: CGPoint) -> ConstraintDescriptionEditable {
  264. return self.constrainTo(other, relation: .LessThanOrEqualTo)
  265. }
  266. internal func lessThanOrEqualTo(other: EdgeInsets) -> ConstraintDescriptionEditable {
  267. return self.constrainTo(other, relation: .LessThanOrEqualTo)
  268. }
  269. // MARK: greaterThanOrEqualTo
  270. internal func greaterThanOrEqualTo(other: ConstraintItem) -> ConstraintDescriptionEditable {
  271. return self.constrainTo(other, relation: .GreaterThanOrEqualTo)
  272. }
  273. internal func greaterThanOrEqualTo(other: View) -> ConstraintDescriptionEditable {
  274. return self.constrainTo(other, relation: .GreaterThanOrEqualTo)
  275. }
  276. #if os(iOS)
  277. internal func greaterThanOrEqualTo(other: UILayoutSupport) -> ConstraintDescriptionEditable {
  278. return self.constrainTo(other, relation: .GreaterThanOrEqualTo)
  279. }
  280. #endif
  281. internal func greaterThanOrEqualTo(other: Float) -> ConstraintDescriptionEditable {
  282. return self.constrainTo(other, relation: .GreaterThanOrEqualTo)
  283. }
  284. internal func greaterThanOrEqualTo(other: Double) -> ConstraintDescriptionEditable {
  285. return self.constrainTo(Float(other), relation: .GreaterThanOrEqualTo)
  286. }
  287. internal func greaterThanOrEqualTo(other: CGFloat) -> ConstraintDescriptionEditable {
  288. return self.constrainTo(Float(other), relation: .GreaterThanOrEqualTo)
  289. }
  290. internal func greaterThanOrEqualTo(other: Int) -> ConstraintDescriptionEditable {
  291. return self.constrainTo(Float(other), relation: .GreaterThanOrEqualTo)
  292. }
  293. internal func greaterThanOrEqualTo(other: UInt) -> ConstraintDescriptionEditable {
  294. return self.constrainTo(Float(other), relation: .GreaterThanOrEqualTo)
  295. }
  296. internal func greaterThanOrEqualTo(other: CGSize) -> ConstraintDescriptionEditable {
  297. return self.constrainTo(other, relation: .GreaterThanOrEqualTo)
  298. }
  299. internal func greaterThanOrEqualTo(other: CGPoint) -> ConstraintDescriptionEditable {
  300. return self.constrainTo(other, relation: .GreaterThanOrEqualTo)
  301. }
  302. internal func greaterThanOrEqualTo(other: EdgeInsets) -> ConstraintDescriptionEditable {
  303. return self.constrainTo(other, relation: .GreaterThanOrEqualTo)
  304. }
  305. // MARK: multiplier
  306. internal func multipliedBy(amount: Float) -> ConstraintDescriptionEditable {
  307. self.multiplier = amount
  308. return self
  309. }
  310. internal func multipliedBy(amount: Double) -> ConstraintDescriptionEditable {
  311. return self.multipliedBy(Float(amount))
  312. }
  313. internal func multipliedBy(amount: CGFloat) -> ConstraintDescriptionEditable {
  314. return self.multipliedBy(Float(amount))
  315. }
  316. internal func multipliedBy(amount: Int) -> ConstraintDescriptionEditable {
  317. return self.multipliedBy(Float(amount))
  318. }
  319. internal func multipliedBy(amount: UInt) -> ConstraintDescriptionEditable {
  320. return self.multipliedBy(Float(amount))
  321. }
  322. internal func dividedBy(amount: Float) -> ConstraintDescriptionEditable {
  323. self.multiplier = 1.0 / amount;
  324. return self
  325. }
  326. internal func dividedBy(amount: Double) -> ConstraintDescriptionEditable {
  327. return self.dividedBy(Float(amount))
  328. }
  329. internal func dividedBy(amount: CGFloat) -> ConstraintDescriptionEditable {
  330. return self.dividedBy(Float(amount))
  331. }
  332. internal func dividedBy(amount: Int) -> ConstraintDescriptionEditable {
  333. return self.dividedBy(Float(amount))
  334. }
  335. internal func dividedBy(amount: UInt) -> ConstraintDescriptionEditable {
  336. return self.dividedBy(Float(amount))
  337. }
  338. // MARK: offset
  339. internal func offset(amount: Float) -> ConstraintDescriptionEditable {
  340. self.constant = amount
  341. return self
  342. }
  343. internal func offset(amount: Double) -> ConstraintDescriptionEditable {
  344. return self.offset(Float(amount))
  345. }
  346. internal func offset(amount: CGFloat) -> ConstraintDescriptionEditable {
  347. return self.offset(Float(amount))
  348. }
  349. internal func offset(amount: Int) -> ConstraintDescriptionEditable {
  350. return self.offset(Float(amount))
  351. }
  352. internal func offset(amount: UInt) -> ConstraintDescriptionEditable {
  353. return self.offset(Float(amount))
  354. }
  355. internal func offset(amount: CGPoint) -> ConstraintDescriptionEditable {
  356. self.constant = amount
  357. return self
  358. }
  359. internal func offset(amount: CGSize) -> ConstraintDescriptionEditable {
  360. self.constant = amount
  361. return self
  362. }
  363. internal func offset(amount: EdgeInsets) -> ConstraintDescriptionEditable {
  364. self.constant = amount
  365. return self
  366. }
  367. // MARK: inset
  368. internal func inset(amount: Float) -> ConstraintDescriptionEditable {
  369. let value = CGFloat(amount)
  370. self.constant = EdgeInsets(top: value, left: value, bottom: -value, right: -value)
  371. return self
  372. }
  373. internal func inset(amount: Double) -> ConstraintDescriptionEditable {
  374. let value = CGFloat(amount)
  375. self.constant = EdgeInsets(top: value, left: value, bottom: -value, right: -value)
  376. return self
  377. }
  378. internal func inset(amount: CGFloat) -> ConstraintDescriptionEditable {
  379. self.constant = EdgeInsets(top: amount, left: amount, bottom: -amount, right: -amount)
  380. return self
  381. }
  382. internal func inset(amount: Int) -> ConstraintDescriptionEditable {
  383. let value = CGFloat(amount)
  384. self.constant = EdgeInsets(top: value, left: value, bottom: -value, right: -value)
  385. return self
  386. }
  387. internal func inset(amount: UInt) -> ConstraintDescriptionEditable {
  388. let value = CGFloat(amount)
  389. self.constant = EdgeInsets(top: value, left: value, bottom: -value, right: -value)
  390. return self
  391. }
  392. internal func inset(amount: EdgeInsets) -> ConstraintDescriptionEditable {
  393. self.constant = EdgeInsets(top: amount.top, left: amount.left, bottom: -amount.bottom, right: -amount.right)
  394. return self
  395. }
  396. // MARK: priority
  397. internal func priority(priority: Float) -> ConstraintDescriptionFinalizable {
  398. self.priority = priority
  399. return self
  400. }
  401. internal func priority(priority: Double) -> ConstraintDescriptionFinalizable {
  402. return self.priority(Float(priority))
  403. }
  404. internal func priority(priority: CGFloat) -> ConstraintDescriptionFinalizable {
  405. return self.priority(Float(priority))
  406. }
  407. func priority(priority: UInt) -> ConstraintDescriptionFinalizable {
  408. return self.priority(Float(priority))
  409. }
  410. internal func priority(priority: Int) -> ConstraintDescriptionFinalizable {
  411. return self.priority(Float(priority))
  412. }
  413. internal func priorityRequired() -> ConstraintDescriptionFinalizable {
  414. return self.priority(1000.0)
  415. }
  416. internal func priorityHigh() -> ConstraintDescriptionFinalizable {
  417. return self.priority(750.0)
  418. }
  419. internal func priorityMedium() -> ConstraintDescriptionFinalizable {
  420. #if os(iOS)
  421. return self.priority(500.0)
  422. #else
  423. return self.priority(501.0)
  424. #endif
  425. }
  426. internal func priorityLow() -> ConstraintDescriptionFinalizable {
  427. return self.priority(250.0)
  428. }
  429. // MARK: Constraint
  430. internal var constraint: Constraint {
  431. if self.concreteConstraint == nil {
  432. if self.relation == nil {
  433. fatalError("Attempting to create a constraint from a ConstraintDescription before it has been fully chained.")
  434. }
  435. self.concreteConstraint = ConcreteConstraint(
  436. fromItem: self.fromItem,
  437. toItem: self.toItem,
  438. relation: self.relation!,
  439. constant: self.constant,
  440. multiplier: self.multiplier,
  441. priority: self.priority)
  442. }
  443. return self.concreteConstraint!
  444. }
  445. // MARK: Private
  446. private let fromItem: ConstraintItem
  447. private var toItem: ConstraintItem {
  448. willSet {
  449. if self.concreteConstraint != nil {
  450. fatalError("Attempting to modify a ConstraintDescription after its constraint has been created.")
  451. }
  452. }
  453. }
  454. private var relation: ConstraintRelation? {
  455. willSet {
  456. if self.concreteConstraint != nil {
  457. fatalError("Attempting to modify a ConstraintDescription after its constraint has been created.")
  458. }
  459. }
  460. }
  461. private var constant: Any = Float(0.0) {
  462. willSet {
  463. if self.concreteConstraint != nil {
  464. fatalError("Attempting to modify a ConstraintDescription after its constraint has been created.")
  465. }
  466. }
  467. }
  468. private var multiplier: Float = 1.0 {
  469. willSet {
  470. if self.concreteConstraint != nil {
  471. fatalError("Attempting to modify a ConstraintDescription after its constraint has been created.")
  472. }
  473. }
  474. }
  475. private var priority: Float = 1000.0 {
  476. willSet {
  477. if self.concreteConstraint != nil {
  478. fatalError("Attempting to modify a ConstraintDescription after its constraint has been created.")
  479. }
  480. }
  481. }
  482. private var concreteConstraint: ConcreteConstraint? = nil
  483. private func addConstraint(attributes: ConstraintAttributes) -> ConstraintDescription {
  484. if self.relation == nil {
  485. self.fromItem.attributes += attributes
  486. }
  487. return self
  488. }
  489. private func constrainTo(other: ConstraintItem, relation: ConstraintRelation) -> ConstraintDescription {
  490. if other.attributes != ConstraintAttributes.None {
  491. let toLayoutAttributes = other.attributes.layoutAttributes
  492. if toLayoutAttributes.count > 1 {
  493. let fromLayoutAttributes = self.fromItem.attributes.layoutAttributes
  494. if toLayoutAttributes != fromLayoutAttributes {
  495. NSException(name: "Invalid Constraint", reason: "Cannot constrain to multiple non identical attributes", userInfo: nil).raise()
  496. return self
  497. }
  498. other.attributes = ConstraintAttributes.None
  499. }
  500. }
  501. self.toItem = other
  502. self.relation = relation
  503. return self
  504. }
  505. private func constrainTo(other: View, relation: ConstraintRelation) -> ConstraintDescription {
  506. return constrainTo(ConstraintItem(object: other, attributes: ConstraintAttributes.None), relation: relation)
  507. }
  508. #if os(iOS)
  509. private func constrainTo(other: UILayoutSupport, relation: ConstraintRelation) -> ConstraintDescription {
  510. return constrainTo(ConstraintItem(object: other, attributes: ConstraintAttributes.None), relation: relation)
  511. }
  512. #endif
  513. private func constrainTo(other: Float, relation: ConstraintRelation) -> ConstraintDescription {
  514. self.constant = other
  515. return constrainTo(ConstraintItem(object: nil, attributes: ConstraintAttributes.None), relation: relation)
  516. }
  517. private func constrainTo(other: Double, relation: ConstraintRelation) -> ConstraintDescription {
  518. self.constant = other
  519. return constrainTo(ConstraintItem(object: nil, attributes: ConstraintAttributes.None), relation: relation)
  520. }
  521. private func constrainTo(other: CGSize, relation: ConstraintRelation) -> ConstraintDescription {
  522. self.constant = other
  523. return constrainTo(ConstraintItem(object: nil, attributes: ConstraintAttributes.None), relation: relation)
  524. }
  525. private func constrainTo(other: CGPoint, relation: ConstraintRelation) -> ConstraintDescription {
  526. self.constant = other
  527. return constrainTo(ConstraintItem(object: nil, attributes: ConstraintAttributes.None), relation: relation)
  528. }
  529. private func constrainTo(other: EdgeInsets, relation: ConstraintRelation) -> ConstraintDescription {
  530. self.constant = other
  531. return constrainTo(ConstraintItem(object: nil, attributes: ConstraintAttributes.None), relation: relation)
  532. }
  533. }