purplish-layout 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 71e95201b9da629250ed3a65d578f119b9cbafe9
-  data.tar.gz: c15def4fd40a8016509cfc919b79a948a5a295c5
+  metadata.gz: 1de41d16e7133d4c69b33c8351c2419983cdc0b9
+  data.tar.gz: fa932497034eb7ade0549a3810c493bcf1796c09
 SHA512:
-  metadata.gz: c31fc8b5ceee87292c9e509cd3ae5d84bbabfbd15e7208cd575e4d0076d0380ef2bef0d1b83dae52063db658ad20e04a018a715f9ae1baf50f008f0eb161205d
-  data.tar.gz: 300ecb78c82e7a0dfcaee0aa2917000a0e9d6e28400736352811b7ee92ce9d92cfb03de6bb3e80dc8d7aa7ad748600fd86ad029ac58dd50ef26c13818219f85f
+  metadata.gz: 71d5dbd7b5cf0db7fd688f76114ce1e655821c4fb268cbba7fd68cbc691f3aa7257f63dfbda42da9429eaa6a3fc47d6dd36d79e64d2692e96f132bc743d7a066
+  data.tar.gz: f8c63e4ed611fed978e7e59fb31a2028e50cc1fe1e379a24b7bb94c81fe7f6e4da0556c8a8bc6811e4eda085792714c81385d77c01713d2f929b1d793e04e77d

data/README.md

@@ -30,7 +30,7 @@ Send `#constraints` with a block to an array with an even number of elements. Th
 
 If there are n views involved, there should be n*2 elements in the array. The block takes n+1 arguments, and the last object is the dictionary mapping generated from the array (usually unused) and the rest of the elements are constraint proxy objects representing each view, in the order specified in the array.
 
-To avoid confusion, it's best to keep the variable names in the block the same as the string names in the array. This syntax can be improved when Proc#parameters is available.
+To avoid confusion, it's best to keep the variable names in the block the same as the string names in the array.
 
 With the exception of the first view listed in the array, `translatesAutoresizingMaskIntoConstraints` is automatically set to `false` for every view, so you'll want to specify the outermost view as the first pair.
 
@@ -52,11 +52,49 @@ You can mix the 2 creation methods:
 end
 ```
 
+When specifying options argument describing the attribute and direction of layout, you can also use symbols such as `:align_center_y` (for `NSLayoutFormatAlignAllCenterY`). They are interchangeable. The options are available as `:align_left`, `:align_right`, `:align_top`, `:align_bottom`, `:align_leading`, `:align_trailing`, `:align_center_x`, `:align_center_y`, `:align_baseline`.
+
+ie. these are equivalent:
+
+```ruby
+cv.h '|[v1][v2][v3]|', nil, NSLayoutFormatAlignAllCenterY
+cv.h '|[v1][v2][v3]|', nil, :align_center_y
+```
+
+You can write equality “statements” in a single line:
+
+```ruby
+b0.center_y = b1.center_y = b2.center_y = b3.center_y = b4.center_y
+```
+
 There are 2 attributes in the constraint proxies that you would occasionally find useful:
 
 * `last_constraint` returns the last `NSLayoutConstraint` created. It's useful if you want to hold on to a `NSLayoutConstraint` and modify it in an animation.
 * `next_priority` sets the priority for the next `NSLayoutConstraint` you create.
 
+Quirks & Gotchas
+---
+1\. In a better world, the first code example would have been:
+
+```ruby
+[inner_view, post_count_label].constraints do |celf, l, _|
+  celf.h '|[l]|'
+  celf.v '|-m-[l]-m-|', {'m' => 7}
+end
+```
+
+But since `Proc#parameters` isn't available, the syntax to invoke constraints requires duplication of names. This syntax can be improved when `Proc#parameters` is available.
+
+2\. In RubyMotion, local variables aren't shadowed correctly by dynamic variables. So try not to use the same names for the block args as the variables holding your views. Referring to the 1st example, if we use `post_count_label` instead of `l`:
+
+```ruby
+['celf', inner_view, 'post_count_label', post_count_label].constraints do |celf, post_count_label, _|
+  celf.h '|[post_count_label]|'
+  celf.v '|-m-[post_count_label]-m-|', {'m' => 7}
+end
+#At this point, after the block, post_count_label is the constraint proxy, and not the label as one might expect.
+```
+
 Installation
 ---
 1. Add this to your `Gemfile`: `gem 'purplish-layout'`

data/lib/purplish-layout/purplish-layout.rb

@@ -70,6 +70,30 @@ module PurplishLayout
 
     def layout(s, metrics=nil, options=0, views=nil)
       views ||= views_mapping
+      if options != 0
+        options = case options
+                  when :align_left
+                    NSLayoutFormatAlignAllLeft
+                  when :align_right
+                    NSLayoutFormatAlignAllRight
+                  when :align_top
+                    NSLayoutFormatAlignAllTop
+                  when :align_bottom
+                    NSLayoutFormatAlignAllBottom
+                  when :align_leading
+                    NSLayoutFormatAlignAllLeading
+                  when :align_trailing
+                    NSLayoutFormatAlignAllTrailing
+                  when :align_center_x
+                    NSLayoutFormatAlignAllCenterX
+                  when :align_center_y
+                    NSLayoutFormatAlignAllCenterY
+                  when :align_baseline
+                    NSLayoutFormatAlignAllBaseline
+                  else
+                    options
+                  end
+      end
       #Workaround, must wrap views with NSDictionary, otherwise doesn't work for RubyMotion
       c = NSLayoutConstraint.constraintsWithVisualFormat(s, options:options, metrics:metrics, views:NSDictionary.dictionaryWithDictionary(views))
       self.last_constraint = c

data/lib/purplish-layout/version.rb

@@ -1,3 +1,3 @@
 module PurplishLayout
-  VERSION = '0.0.1'
+  VERSION = '0.0.2'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: purplish-layout
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Hwee-Boon Yar
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-02-01 00:00:00.000000000 Z
+date: 2015-02-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: weak_attr_accessor