Class: MotionKit::UIViewHelpers

Inherits:
Layout show all
Defined in:
lib/motion-kit-ios/helpers/uiview_helpers.rb,
lib/motion-kit-tvos/helpers/uiview_helpers.rb,
lib/motion-kit-ios/helpers/constraints_helpers.rb,
lib/motion-kit-ios/helpers/uiview_frame_helpers.rb,
lib/motion-kit-tvos/helpers/constraints_helpers.rb,
lib/motion-kit-tvos/helpers/uiview_frame_helpers.rb,
lib/motion-kit-ios/helpers/uiview_gradient_helpers.rb,
lib/motion-kit-tvos/helpers/uiview_gradient_helpers.rb,
lib/motion-kit-ios/helpers/uiview_constraints_helpers.rb,
lib/motion-kit-ios/helpers/uiview_autoresizing_helpers.rb,
lib/motion-kit-tvos/helpers/uiview_constraints_helpers.rb,
lib/motion-kit-tvos/helpers/uiview_autoresizing_helpers.rb

Direct Known Subclasses

UIButtonHelpers, UIViewLayout

Instance Attribute Summary

Attributes inherited from BaseLayout

#parent

Instance Method Summary collapse

Methods inherited from Layout

#add_child, #default_root, #remove_child

Methods inherited from TreeLayout

#add, #all, #all_views, #always, #build, #built?, #child_layouts, #create, #create_default_root_context, #first, #forget, #forget_tree, #forget_view, #get, #get_view, #initial, #initial?, #initialize, #last, #last_view, #name_element, #nearest, #next, #nth, #nth_view, #prev, #reapply, #reapply!, #reapply?, #reapply_blocks, #remove, #remove_view, #root, #run_reapply_blocks, view, #view

Methods inherited from BaseLayout

#add_deferred_block, #apply, #apply_with_context, #apply_with_target, #context, #deferred, #deferred_blocks, delegate_method_fix, #has_context?, #initialize, #ipad?, #iphone35?, #iphone47?, #iphone4?, #iphone55?, #iphone?, #is_parent_layout?, #method_missing, #objc_version, #orientation?, #orientation_block, #parent_layout, #retina?, #ruby_version, #run_deferred, #set_parent_layout, #target, #tv?, #v

Methods included from BaseLayoutClassMethods

#layout_for, #memoize, #target_klasses, #targets

Constructor Details

This class inherits a constructor from MotionKit::TreeLayout

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class MotionKit::BaseLayout

Instance Method Details

#_calculate_frame(f, from: from_view, relative_to: point) ⇒ Object 



92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 92

def _calculate_frame(f, from: from_view, relative_to: point)
  if from_view.is_a?(Symbol)
    from_view = self.get_view(from_view)
  end

  from_view_size = from_view.frame.size
  o = from_view.convertPoint([0, 0], toView: target.superview)

  calculate_view = UIView.alloc.initWithFrame([[0, 0], target.frame.size])

  if f.is_a?(Hash)
    f = f.merge(relative: true)
  end
  f = MotionKit.calculate(calculate_view, :frame, f, target.superview)
  f.origin.x += o.x
  f.origin.y += o.y

  case point[:x]
  when :min, :reset
    # pass
  when :mid
    f.origin.x += (from_view_size.width - f.size.width) / 2.0
  when :max
    f.origin.x += from_view_size.width - f.size.width
  when :before
    f.origin.x -= f.size.width
  when :after
    f.origin.x += from_view_size.width
  else
    f.origin.x += point[:x]
  end

  case point[:y]
  when :min, :reset
    # pass
  when :mid
    f.origin.y += (from_view_size.height - f.size.height) / 2.0
  when :max
    f.origin.y += from_view_size.height - f.size.height
  when :above
    f.origin.y -= f.size.height
  when :below
    f.origin.y += from_view_size.height
  else
    f.origin.y += point[:y]
  end

  return f
end

#above(from_view, f = {}) ⇒ Object

The first arg can be a view or a frame

Examples:

frame above(view, [[0, 0], [100, 20]])
frame above(:view, x: 0, y: 0, width: 100, height: 20)
frame above(:view, down: 0, right: 0, width: 100, height: 20)


273
274
275
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 273

def above(from_view, f={})
  _calculate_frame(f, from: from_view, relative_to: { x: :reset, y: :above })
end

#after(from_view, f = {}) ⇒ Object Also known as: right_of

The first arg can be a view or a frame

Examples:

frame after(view, [[0, 0], [100, 20]])
frame after(:view, x: 0, y: 0, width: 100, height: 20)
frame after(:view, down: 0, right: 0, width: 100, height: 20)


301
302
303
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 301

def after(from_view, f={})
  _calculate_frame(f, from: from_view, relative_to: { x: :after, y: :reset })
end

#autoresizing_mask(*values) ⇒ Object Also known as: autoresizingMask 



5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
 
# File 'lib/motion-kit-ios/helpers/uiview_autoresizing_helpers.rb', line 5

def autoresizing_mask(*values)
  value = 0
  values.each do |mask|
    case mask
    when :flexible_left
      value |= UIViewAutoresizingFlexibleLeftMargin
    when :flexible_width
      value |= UIViewAutoresizingFlexibleWidth
    when :flexible_right
      value |= UIViewAutoresizingFlexibleRightMargin
    when :flexible_top
      value |= UIViewAutoresizingFlexibleTopMargin
    when :flexible_height
      value |= UIViewAutoresizingFlexibleHeight
    when :flexible_bottom
      value |= UIViewAutoresizingFlexibleBottomMargin

    when :rigid_left
      value ^= UIViewAutoresizingFlexibleLeftMargin
    when :rigid_width
      value ^= UIViewAutoresizingFlexibleWidth
    when :rigid_right
      value ^= UIViewAutoresizingFlexibleRightMargin
    when :rigid_top
      value ^= UIViewAutoresizingFlexibleTopMargin
    when :rigid_height
      value ^= UIViewAutoresizingFlexibleHeight
    when :rigid_bottom
      value ^= UIViewAutoresizingFlexibleBottomMargin

    when :fill
      value |= UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight
    when :fill_top
      value |= UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleBottomMargin
    when :fill_bottom
      value |= UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleTopMargin
    when :fill_width
      value |= UIViewAutoresizingFlexibleTopMargin | UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleBottomMargin
    when :fill_left
      value |= UIViewAutoresizingFlexibleHeight | UIViewAutoresizingFlexibleRightMargin
    when :fill_right
      value |= UIViewAutoresizingFlexibleHeight | UIViewAutoresizingFlexibleLeftMargin
    when :fill_height
      value |= UIViewAutoresizingFlexibleLeftMargin | UIViewAutoresizingFlexibleHeight | UIViewAutoresizingFlexibleRightMargin

    when :pin_to_top_left
      value |= UIViewAutoresizingFlexibleRightMargin | UIViewAutoresizingFlexibleBottomMargin
    when :pin_to_top
      value |= UIViewAutoresizingFlexibleLeftMargin | UIViewAutoresizingFlexibleRightMargin | UIViewAutoresizingFlexibleBottomMargin
    when :pin_to_top_right
      value |= UIViewAutoresizingFlexibleLeftMargin | UIViewAutoresizingFlexibleBottomMargin
    when :pin_to_left
      value |= UIViewAutoresizingFlexibleTopMargin | UIViewAutoresizingFlexibleBottomMargin | UIViewAutoresizingFlexibleRightMargin
    when :pin_to_center, :pin_to_middle
      value |= UIViewAutoresizingFlexibleTopMargin | UIViewAutoresizingFlexibleBottomMargin | UIViewAutoresizingFlexibleLeftMargin | UIViewAutoresizingFlexibleRightMargin
    when :pin_to_right
      value |= UIViewAutoresizingFlexibleTopMargin | UIViewAutoresizingFlexibleBottomMargin | UIViewAutoresizingFlexibleLeftMargin
    when :pin_to_bottom_left
      value |= UIViewAutoresizingFlexibleRightMargin | UIViewAutoresizingFlexibleTopMargin
    when :pin_to_bottom
      value |= UIViewAutoresizingFlexibleLeftMargin | UIViewAutoresizingFlexibleRightMargin | UIViewAutoresizingFlexibleTopMargin
    when :pin_to_bottom_right
      value |= UIViewAutoresizingFlexibleLeftMargin | UIViewAutoresizingFlexibleTopMargin
    else
      value |= mask
    end
  end

  target.autoresizingMask = value
  value
end

#before(from_view, f = {}) ⇒ Object Also known as: left_of

The first arg can be a view or a frame

Examples:

frame before(view, [[0, 0], [100, 20]])
frame before(:view, x: 0, y: 0, width: 100, height: 20)
frame before(:view, down: 0, right: 0, width: 100, height: 20)


291
292
293
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 291

def before(from_view, f={})
  _calculate_frame(f, from: from_view, relative_to: { x: :before, y: :reset })
end

#below(from_view, f = {}) ⇒ Object

The first arg can be a view or a frame

Examples:

frame below(view, [[0, 0], [100, 20]])
frame below(:view, x: 0, y: 0, width: 100, height: 20)
frame below(:view, down: 0, right: 0, width: 100, height: 20)


282
283
284
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 282

def below(from_view, f={})
  _calculate_frame(f, from: from_view, relative_to: { x: :reset, y: :below })
end

#bottom(value) ⇒ Object 



36
37
38
39
40
41
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 36

def bottom(value)
  f = target.frame
  f.origin.y = MotionKit.calculate(target, :height, value) - f.size.height
  target.frame = f
  return CGRectGetMaxY(f)
end

#center(value) ⇒ Object Also known as: middle 



74
75
76
77
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 74

def center(value)
  target.center = MotionKit.calculate(target, :center, value)
  return target.center
end

#center_x(value) ⇒ Object Also known as: middle_x 



20
21
22
23
24
25
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 20

def center_x(value)
  c = target.center
  c.x = MotionKit.calculate(target, :width, value)
  target.center = c
  return CGRectGetMidX(target.frame)
end

#center_y(value) ⇒ Object Also known as: middle_y 



43
44
45
46
47
48
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 43

def center_y(value)
  c = target.center
  c.y = MotionKit.calculate(target, :height, value)
  target.center = c
  return CGRectGetMidY(target.frame)
end

#compression_priority(value, for_axis: axis) ⇒ Object 



10
11
12
 
# File 'lib/motion-kit-ios/helpers/constraints_helpers.rb', line 10

def compression_priority(value, for_axis: axis)
  content_compression_resistance_priority(value, for_axis: axis)
end

#constraints(add_to_view = nil, &block) ⇒ Object 



5
6
7
8
9
10
11
12
13
14
15
16
17
 
# File 'lib/motion-kit-ios/helpers/uiview_constraints_helpers.rb', line 5

def constraints(add_to_view=nil, &block)
  add_to_view ||= target
  if add_to_view.is_a?(Symbol)
    add_to_view = self.get_view(add_to_view)
  end
  add_to_view.setTranslatesAutoresizingMaskIntoConstraints(false)

  constraints_target = ConstraintsTarget.new(add_to_view)
  deferred(constraints_target) do
    context(constraints_target, &block)
    constraints_target.apply_all_constraints(self, add_to_view)
  end
end

#content_compression_resistance_priority(value, for_axis: axis) ⇒ Object 



5
6
7
8
 
# File 'lib/motion-kit-ios/helpers/constraints_helpers.rb', line 5

def content_compression_resistance_priority(value, for_axis: axis)
  axis = Constraint.axis_lookup(axis)
  target.setContentCompressionResistancePriority(value, forAxis: axis)
end

#content_hugging_priority(value, for_axis: axis) ⇒ Object 



14
15
16
17
 
# File 'lib/motion-kit-ios/helpers/constraints_helpers.rb', line 14

def content_hugging_priority(value, for_axis: axis)
  axis = Constraint.axis_lookup(axis)
  target.setContentHuggingPriority(value, forAxis: axis)
end

#frame(value) ⇒ Object 



87
88
89
90
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 87

def frame(value)
  target.frame = MotionKit.calculate(target, :frame, value)
  return target.frame
end

#from_bottom(from_view = nil, f = nil) ⇒ Object

The first arg can be a view or a frame

Examples:

frame from_bottom(width: 80, height: 22)
frame from_bottom(another_view, width: 80, height: 22)


244
245
246
247
248
249
250
251
252
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 244

def from_bottom(from_view=nil, f=nil)
  if from_view.is_a?(Hash)
    f = from_view
    from_view = nil
  end
  f ||= {}
  from_view ||= target.superview
  _calculate_frame(f, from: from_view, relative_to: { x: :mid, y: :max })
end

#from_bottom_left(from_view = nil, f = nil) ⇒ Object

The first arg can be a view or a frame

Examples:

frame from_bottom_left(width: 80, height: 22)
frame from_bottom_left(another_view, width: 80, height: 22)


230
231
232
233
234
235
236
237
238
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 230

def from_bottom_left(from_view=nil, f=nil)
  if from_view.is_a?(Hash)
    f = from_view
    from_view = nil
  end
  f ||= {}
  from_view ||= target.superview
  _calculate_frame(f, from: from_view, relative_to: { x: :min, y: :max })
end

#from_bottom_right(from_view = nil, f = nil) ⇒ Object

The first arg can be a view or a frame

Examples:

frame from_bottom_right(width: 80, height: 22)
frame from_bottom_right(another_view, width: 80, height: 22)


258
259
260
261
262
263
264
265
266
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 258

def from_bottom_right(from_view=nil, f=nil)
  if from_view.is_a?(Hash)
    f = from_view
    from_view = nil
  end
  f ||= {}
  from_view ||= target.superview
  _calculate_frame(f, from: from_view, relative_to: { x: :max, y: :max })
end

#from_center(from_view = nil, f = nil) ⇒ Object

The first arg can be a view or a frame

Examples:

frame from_center(width: 80, height: 22)
frame from_center(another_view, width: 80, height: 22)


202
203
204
205
206
207
208
209
210
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 202

def from_center(from_view=nil, f=nil)
  if from_view.is_a?(Hash)
    f = from_view
    from_view = nil
  end
  f ||= {}
  from_view ||= target.superview
  _calculate_frame(f, from: from_view, relative_to: { x: :mid, y: :mid })
end

#from_left(from_view = nil, f = nil) ⇒ Object

The first arg can be a view or a frame

Examples:

frame from_left(width: 80, height: 22)
frame from_left(another_view, width: 80, height: 22)


188
189
190
191
192
193
194
195
196
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 188

def from_left(from_view=nil, f=nil)
  if from_view.is_a?(Hash)
    f = from_view
    from_view = nil
  end
  f ||= {}
  from_view ||= target.superview
  _calculate_frame(f, from: from_view, relative_to: { x: :min, y: :mid })
end

#from_right(from_view = nil, f = nil) ⇒ Object

The first arg can be a view or a frame

Examples:

frame from_right(width: 80, height: 22)
frame from_right(another_view, width: 80, height: 22)


216
217
218
219
220
221
222
223
224
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 216

def from_right(from_view=nil, f=nil)
  if from_view.is_a?(Hash)
    f = from_view
    from_view = nil
  end
  f ||= {}
  from_view ||= target.superview
  _calculate_frame(f, from: from_view, relative_to: { x: :max, y: :mid })
end

#from_top(from_view = nil, f = nil) ⇒ Object

The first arg can be a view or a frame

Examples:

frame from_top(width: 80, height: 22)
frame from_top(another_view, width: 80, height: 22)


160
161
162
163
164
165
166
167
168
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 160

def from_top(from_view=nil, f=nil)
  if from_view.is_a?(Hash)
    f = from_view
    from_view = nil
  end
  f ||= {}
  from_view ||= target.superview
  _calculate_frame(f, from: from_view, relative_to: { x: :mid, y: :min })
end

#from_top_left(from_view = nil, f = nil) ⇒ Object

The first arg can be a view or a frame

Examples:

frame from_top_left(width: 80, height: 22)
frame from_top_left(another_view, width: 80, height: 22)


146
147
148
149
150
151
152
153
154
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 146

def from_top_left(from_view=nil, f=nil)
  if from_view.is_a?(Hash)
    f = from_view
    from_view = nil
  end
  f ||= {}
  from_view ||= target.superview
  _calculate_frame(f, from: from_view, relative_to: { x: :min, y: :min })
end

#from_top_right(from_view = nil, f = nil) ⇒ Object

The first arg can be a view or a frame

Examples:

frame from_top_right(width: 80, height: 22)
frame from_top_right(another_view, width: 80, height: 22)


174
175
176
177
178
179
180
181
182
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 174

def from_top_right(from_view=nil, f=nil)
  if from_view.is_a?(Hash)
    f = from_view
    from_view = nil
  end
  f ||= {}
  from_view ||= target.superview
  _calculate_frame(f, from: from_view, relative_to: { x: :max, y: :min })
end

#gradient(&block) ⇒ Object

gradient colors:



6
7
8
9
10
11
12
13
14
15
16
17
18
19
 
# File 'lib/motion-kit-ios/helpers/uiview_gradient_helpers.rb', line 6

def gradient(&block)
  gradient_layer = target.motion_kit_meta[:motionkit_gradient_layer] || begin
    gradient_layer = CAGradientLayer.layer
    gradient_layer.frame = CGRect.new([0, 0], target.frame.size)
    target.layer.insertSublayer(gradient_layer, atIndex:0)
    target.motion_kit_meta[:motionkit_gradient_layer] = gradient_layer

    gradient_layer
  end

  context(gradient_layer, &block)

  gradient_layer
end

#height(value) ⇒ Object Also known as: h 



59
60
61
62
63
64
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 59

def height(value)
  f = target.frame
  f.size.height = MotionKit.calculate(target, :height, value)
  target.frame = f
  return CGRectGetHeight(f)
end

#hugging_priority(value, for_axis: axis) ⇒ Object 



19
20
21
 
# File 'lib/motion-kit-ios/helpers/constraints_helpers.rb', line 19

def hugging_priority(value, for_axis: axis)
  content_hugging_priority(value, for_axis: axis)
end

#origin(value) ⇒ Object 



67
68
69
70
71
72
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 67

def origin(value)
  f = target.frame
  f.origin = MotionKit.calculate(target, :origin, value)
  target.frame = f
  return target.frame.origin
end

#relative_to(from_view, f) ⇒ Object

The first arg must be a view

Examples:

frame relative_to(view, [[0, 0], [100, 20]])
frame relative_to(:view, x: 0, y: 0, width: 100, height: 20)
frame relative_to(:view, down: 0, right: 0, width: 100, height: 20)


311
312
313
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 311

def relative_to(from_view, f)
  _calculate_frame(f, from: from_view, relative_to: { x: :reset, y: :reset })
end

#right(value) ⇒ Object 



13
14
15
16
17
18
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 13

def right(value)
  f = target.frame
  f.origin.x = MotionKit.calculate(target, :width, value) - f.size.width
  target.frame = f
  return CGRectGetMaxX(f)
end

#size(value) ⇒ Object 



80
81
82
83
84
85
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 80

def size(value)
  f = target.frame
  f.size = MotionKit.calculate(target, :size, value)
  target.frame = f
  return target.frame.size
end

#width(value) ⇒ Object Also known as: w 



51
52
53
54
55
56
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 51

def width(value)
  f = target.frame
  f.size.width = MotionKit.calculate(target, :width, value)
  target.frame = f
  return CGRectGetWidth(f)
end

#x(value) ⇒ Object Also known as: left 



5
6
7
8
9
10
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 5

def x(value)
  f = target.frame
  f.origin.x = MotionKit.calculate(target, :width, value)
  target.frame = f
  return CGRectGetMinX(f)
end

#y(value) ⇒ Object Also known as: top 



28
29
30
31
32
33
 
# File 'lib/motion-kit-ios/helpers/uiview_frame_helpers.rb', line 28

def y(value)
  f = target.frame
  f.origin.y = MotionKit.calculate(target, :height, value)
  target.frame = f
  return CGRectGetMinY(f)
end