Class: React::State

Inherits:
Object show all
Defined in:
lib/react/state.rb

Class Attribute Summary collapse

Class Method Summary collapse

Class Attribute Details

.current_observer ⇒ Object (readonly)

Returns the value of attribute current_observer.



37
38
39
 
# File 'lib/react/state.rb', line 37

def current_observer
  @current_observer
end

Class Method Details

.get_state(object, name, current_observer = @current_observer) ⇒ Object 



43
44
45
46
47
 
# File 'lib/react/state.rb', line 43

def get_state(object, name, current_observer = @current_observer)
  # get current value of name for object, remember that the current object depends on this state, current observer can be overriden with last param
  new_observers[current_observer][object] << name if current_observer && !new_observers[current_observer][object].include?(name)
  states[object][name]
end

.initialize_states(object, initial_values) ⇒ Object

initialize objects’ name/value pairs



39
40
41
 
# File 'lib/react/state.rb', line 39

def initialize_states(object, initial_values) # initialize objects' name/value pairs
  states[object].merge!(initial_values || {})
end

.is_observing?(object, name, current_observer) ⇒ Boolean

Returns:

  • (Boolean) 


81
82
83
 
# File 'lib/react/state.rb', line 81

def is_observing?(object, name, current_observer)
  current_observer && observers_by_name[object][name].include?(current_observer)
end

.remove ⇒ Object

call after component is unmounted



101
102
103
104
105
106
107
108
109
 
# File 'lib/react/state.rb', line 101

def remove # call after component is unmounted
  raise "remove called outside of watch block" unless @current_observer
  current_observers[@current_observer].each do |object, names|
    names.each do |name|
      observers_by_name[object][name].delete(@current_observer)
    end
  end
  current_observers.delete(@current_observer)
end

.set_state(object, name, value, delay = nil) ⇒ Object 



58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
 
# File 'lib/react/state.rb', line 58

def set_state(object, name, value, delay=nil)
  states[object][name] = value
  if delay
    @delayed_updates ||= []
    @delayed_updates << [object, name, value]
    @delayed_updater ||= after(0.001) do
      delayed_updates = @delayed_updates
      @delayed_updates = []
      @delayed_updater = nil
      delayed_updates.each do |object, name, value|
        set_state2(object, name, value)
      end
    end
  else
    set_state2(object, name, value)
  end
  value
end

.set_state2(object, name, value) ⇒ Object

set object’s name state to value, tell all observers it has changed. Observers must implement update_react_js_state



49
50
51
52
53
54
55
56
 
# File 'lib/react/state.rb', line 49

def set_state2(object, name, value)  # set object's name state to value, tell all observers it has changed.  Observers must implement update_react_js_state
  object_needs_notification = object.respond_to? :update_react_js_state
  observers_by_name[object][name].dup.each do |observer|
    observer.update_react_js_state(object, name, value)
    object_needs_notification = false if object == observer
  end
  object.update_react_js_state(nil, name, value) if object_needs_notification
end

.set_state_context_to(observer) ⇒ Object

wrap all execution that may set or get states in a block so we know which observer is executing



111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
 
# File 'lib/react/state.rb', line 111

def set_state_context_to(observer) # wrap all execution that may set or get states in a block so we know which observer is executing
  if `typeof window.reactive_ruby_timing !== 'undefined'`
    @nesting_level = (@nesting_level || 0) + 1
    start_time = Time.now.to_f
    observer_name = (observer.class.respond_to?(:name) ? observer.class.name : observer.to_s) rescue "object:#{observer.object_id}"
  end
  saved_current_observer = @current_observer
  @current_observer = observer
  return_value = yield
  return_value
ensure
  @current_observer = saved_current_observer
  @nesting_level = [0, @nesting_level - 1].max if `typeof window.reactive_ruby_timing !== 'undefined'`
  return_value
end

.states ⇒ Object 



127
128
129
 
# File 'lib/react/state.rb', line 127

def states
  @states ||= Hash.new { |h, k| h[k] = {} }
end

.update_states_to_observe(current_observer = @current_observer) ⇒ Object

should be called after the last after_render callback, currently called after components render method



85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
 
# File 'lib/react/state.rb', line 85

def update_states_to_observe(current_observer = @current_observer)  # should be called after the last after_render callback, currently called after components render method
  raise "update_states_to_observer called outside of watch block" unless current_observer
  current_observers[current_observer].each do |object, names|
    names.each do |name|
      observers_by_name[object][name].delete(current_observer)
    end
  end
  observers = current_observers[current_observer] = new_observers[current_observer]
  new_observers.delete(current_observer)
  observers.each do |object, names|
    names.each do |name|
      observers_by_name[object][name] << current_observer
    end
  end
end

.will_be_observing?(object, name, current_observer) ⇒ Boolean

Returns:

  • (Boolean) 


77
78
79
 
# File 'lib/react/state.rb', line 77

def will_be_observing?(object, name, current_observer)
  current_observer && new_observers[current_observer][object].include?(name)
end