Class: Ruflet::Control

Inherits:

Object

Object
Ruflet::Control

show all

Defined in:: lib/ruflet_ui/ruflet/control.rb

Direct Known Subclasses

Constant Summary collapse

HOST_EXPANDED_TYPES =

%w[view row column].freeze

Instance Attribute Summary collapse

#children ⇒ Object readonly

Returns the value of attribute children.
#id ⇒ Object readonly

Returns the value of attribute id.
#props ⇒ Object readonly

Returns the value of attribute props.
#runtime_page ⇒ Object

Returns the value of attribute runtime_page.
#type ⇒ Object readonly

Returns the value of attribute type.
#wire_id ⇒ Object

Returns the value of attribute wire_id.

Class Method Summary collapse

.generate_id ⇒ Object

Instance Method Summary collapse

#emit(event_name, event) ⇒ Object
#has_handler?(event_name) ⇒ Boolean
#initialize(type:, id: nil, **props) ⇒ Control constructor

A new instance of Control.
#on(event_name, &block) ⇒ Object
#to_patch ⇒ Object

Constructor Details

#initialize(type:, id: nil, **props) ⇒ `Control`

Returns a new instance of Control.

# File 'lib/ruflet_ui/ruflet/control.rb', line 20

def initialize(type:, id: nil, **props)
  @type = type.to_s.downcase
  @id = (id || props.delete(:id) || "ctrl_#{self.class.generate_id}").to_s
  @children = []
  @handlers = {}
  @wire_id = nil
  @props = normalize_props(extract_handlers(preprocess_props(props)))
end

Instance Attribute Details

#children ⇒ `Object` (readonly)

Returns the value of attribute children.



17
18
19

# File 'lib/ruflet_ui/ruflet/control.rb', line 17

def children
  @children
end

#id ⇒ `Object` (readonly)

Returns the value of attribute id.



17
18
19

# File 'lib/ruflet_ui/ruflet/control.rb', line 17

def id
  @id
end

#props ⇒ `Object` (readonly)

Returns the value of attribute props.



17
18
19

# File 'lib/ruflet_ui/ruflet/control.rb', line 17

def props
  @props
end

#runtime_page ⇒ `Object`

Returns the value of attribute runtime_page.



18
19
20

# File 'lib/ruflet_ui/ruflet/control.rb', line 18

def runtime_page
  @runtime_page
end

#type ⇒ `Object` (readonly)

Returns the value of attribute type.



17
18
19

# File 'lib/ruflet_ui/ruflet/control.rb', line 17

def type
  @type
end

#wire_id ⇒ `Object`

Returns the value of attribute wire_id.



18
19
20

# File 'lib/ruflet_ui/ruflet/control.rb', line 18

def wire_id
  @wire_id
end

Class Method Details

.generate_id ⇒ `Object`

# File 'lib/ruflet_ui/ruflet/control.rb', line 78

def generate_id
  if defined?(SecureRandom) && SecureRandom.respond_to?(:hex)
    SecureRandom.hex(4)
  else
    format("%08x", rand(0..0xffff_ffff))
  end
end

Instance Method Details

#emit(event_name, event) ⇒ `Object`

# File 'lib/ruflet_ui/ruflet/control.rb', line 38

def emit(event_name, event)
  handler = @handlers[normalized_event_name(event_name)]
  return false unless handler

  handler.call(event)
  true
end

#has_handler?(event_name) ⇒ `Boolean`

Returns:

(Boolean)



46
47
48

# File 'lib/ruflet_ui/ruflet/control.rb', line 46

def has_handler?(event_name)
  @handlers.key?(normalized_event_name(event_name))
end

#on(event_name, &block) ⇒ `Object`

# File 'lib/ruflet_ui/ruflet/control.rb', line 29

def on(event_name, &block)
  name = normalized_event_name(event_name)
  validate_event_name!(name)
  @handlers[name] = block
  @props["on_#{name}"] = true
  runtime_page&.update(self, "on_#{name}": true) if wire_id
  self
end

#to_patch ⇒ `Object`

Raises:

(ArgumentError)

# File 'lib/ruflet_ui/ruflet/control.rb', line 50

def to_patch
  wire_type = schema_wire_type_for_class
  if wire_type.nil?
    compact_type_key = type.delete("_")
    wire_type = type_map[type] || type_map[compact_type_key]
  end
  raise ArgumentError, "Unknown control type: #{type}" unless wire_type
  patch = {
    "_c" => wire_type,
    "_i" => wire_id
  }

  internals = {}
  internals["host_positioned"] = true if type == "stack"
  internals["host_expanded"] = true if HOST_EXPANDED_TYPES.include?(type)
  patch["_internals"] = internals unless internals.empty?

  props.each { |k, v| patch[k] = serialize_value(v) }
  patch["controls"] = children.map(&:to_patch) unless children.empty?
  if ENV["RUFLET_DEBUG"] == "1" && type == "floatingactionbutton"
    Kernel.warn("[to_patch] #{patch.inspect}")
  end
  patch
end

Class: Ruflet::Control

Direct Known Subclasses

Constant Summary collapse

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(type:, id: nil, **props) ⇒ Control

Instance Attribute Details

#children ⇒ Object (readonly)

#id ⇒ Object (readonly)

#props ⇒ Object (readonly)

#runtime_page ⇒ Object

#type ⇒ Object (readonly)

#wire_id ⇒ Object