Class: Teacup::Appearance

Inherits:
Stylesheet show all
Defined in:
lib/teacup-ios/appearance.rb

Overview

An interface to style views using the UIAppearance protocol.

Work similarly as the Stylesheet class.

Teacup::Appearance.new do

style UINavigationBar,
  tintColor: UIColor.colorWithRed(0.886, green:0.635, blue:0, alpha: 1)

end

Constant Summary collapse

TeacupAppearanceApplyNotification = 
'TeacupAppearanceApplyNotification'

Instance Attribute Summary

Attributes inherited from Stylesheet

#name

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Stylesheet

[], []=, #app_size, #autoresize, #constrain, #constrain_above, #constrain_below, #constrain_bottom, #constrain_center_x, #constrain_center_y, #constrain_height, #constrain_left, #constrain_right, #constrain_size, #constrain_to_left, #constrain_to_right, #constrain_top, #constrain_width, #constrain_xy, #device, #device_is?, #extends_style?, #flexible_bottom, #flexible_height, #flexible_left, #flexible_right, #flexible_top, #flexible_width, #flip, #get_stylesheet_cache, #iPad, #iPadRetina, #iPhone, #iPhone35, #iPhone4, #iPhone5, #iPhoneRetina, #identity, #import, #import_instance_vars, #imported_stylesheets, #inspect, #pi, #query, #rotate, #run_block, #screen_size, #set_stylesheet_cache, #spin, #stylesheet_cache, stylesheets, #transform_layer, #transform_view, #twist

Constructor Details

#initialize(&block) ⇒ Appearance

disable the stylesheet ‘name’ parameter, and assign the “super secret” stylesheet name



29
30
31
32
33
34
35
36
37
38
39
40
 
# File 'lib/teacup-ios/appearance.rb', line 29

def initialize(&block)
  NSNotificationCenter.defaultCenter.addObserver(self,
          selector: :'apply_appearance:',
          name: UIApplicationDidFinishLaunchingNotification,
          object: nil)
  NSNotificationCenter.defaultCenter.addObserver(self,
          selector: :'apply_appearance:',
          name: TeacupAppearanceApplyNotification,
          object: nil)

  super(&block)
end

Class Method Details

.apply ⇒ Object 



17
18
19
 
# File 'lib/teacup-ios/appearance.rb', line 17

def self.apply
  NSNotificationCenter.defaultCenter.postNotificationName(TeacupAppearanceApplyNotification, object:nil)
end

Instance Method Details

#apply_appearance(notification = nil) ⇒ Object

This block is only run once, and the properties object from when_contained_in is a copy (via Teacup::Style.new), so we remove the when_contained_in property using ‘delete`



75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
 
# File 'lib/teacup-ios/appearance.rb', line 75

def apply_appearance(notification=nil)
  return unless run_block
  NSNotificationCenter.defaultCenter.removeObserver(self, name:UIApplicationDidFinishLaunchingNotification, object:nil)
  NSNotificationCenter.defaultCenter.removeObserver(self, name:TeacupAppearanceApplyNotification, object:nil)

  when_contained_in.each do |klass, properties|
    contained_in = properties.delete(:when_contained_in)
    contained_in = [contained_in] unless contained_in.is_a?(NSArray)
    # make a copy and add nil to the end
    contained_in += [nil]
    appearance = klass.send(:'appearanceWhenContainedIn:', *contained_in)
    Teacup.apply_hash appearance, properties.build, klass
  end
  styles.each do |klass, properties|
    appearance = klass.appearance
    Teacup.apply_hash appearance, properties.build, klass
  end
end

#exclude_instance_vars ⇒ Object 



42
43
44
 
# File 'lib/teacup-ios/appearance.rb', line 42

def exclude_instance_vars
  @exclude_instance_vars ||= super + [:@when_contained_in]
end

#style(*queries) ⇒ Object

Styles that have the ‘when_contained_in` setting need to be kept separate



47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
 
# File 'lib/teacup-ios/appearance.rb', line 47

def style(*queries)
  # do not modify queries, it gets passed to `super`
  if queries[-1].is_a? Hash
    properties = queries[-1]
  else
    # empty style declarations are allowed, but accomplish nothing.
    return
  end

  if properties.include?(:when_contained_in)
    # okay NOW modify queries
    queries.pop
    queries.each do |stylename|
      style = Style.new
      style.stylename = stylename
      style.stylesheet = self
      style.merge!(properties)

      when_contained_in << [stylename, style]
    end
  else
    super
  end
end

#when_contained_in ⇒ Object

Contains a list of styles associated with “containers”. These do not get merged like the usual ‘style` declarations.



23
24
25
 
# File 'lib/teacup-ios/appearance.rb', line 23

def when_contained_in
  @when_contained_in ||= []
end