Module: Native::Helpers

Defined in:
opal/stdlib/native.rb

Instance Method Summary collapse

Instance Method Details

#alias_native(new, old = new, as: nil) ⇒ Object

Exposes a native JavaScript method to Ruby

Examples:


class Element
  extend Native::Helpers

  alias_native :add_class, :addClass
  alias_native :show
  alias_native :hide

  def initialize(selector)
    @native = `$(#{selector})`
  end
end

titles = Element.new('h1')
titles.add_class :foo
titles.hide
titles.show

Parameters:

  • new (String) —

    The name of the newly created method.

  • old (String) (defaults to: new) —

    The name of the native JavaScript method to be exposed. If the name ends with "=" (e.g. foo=) it will be interpreted as a property setter. (default: the value of "new")

  • as (Class) (defaults to: nil) —

    If provided the values returned by the original method will be returned as instances of the passed class. The class passed to "as" is expected to accept a native JavaScript value.



149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
 
# File 'opal/stdlib/native.rb', line 149

def alias_native(new, old = new, as: nil)
  if old.end_with? '='
    define_method new do |value|
      `#{@native}[#{old[0..-2]}] = #{Native.convert(value)}`

      value
    end
  elsif as
    define_method new do |*args, &block|
      value = Native.call(@native, old, *args, &block)
      if value
        as.new(value.to_n)
      end
    end
  else
    define_method new do |*args, &block|
      Native.call(@native, old, *args, &block)
    end
  end
end

#native_accessor(*names) ⇒ Object 



186
187
188
189
 
# File 'opal/stdlib/native.rb', line 186

def native_accessor(*names)
  native_reader(*names)
  native_writer(*names)
end

#native_reader(*names) ⇒ Object 



170
171
172
173
174
175
176
 
# File 'opal/stdlib/native.rb', line 170

def native_reader(*names)
  names.each do |name|
    define_method name do
      Native(`#{@native}[name]`)
    end
  end
end

#native_writer(*names) ⇒ Object 



178
179
180
181
182
183
184
 
# File 'opal/stdlib/native.rb', line 178

def native_writer(*names)
  names.each do |name|
    define_method "#{name}=" do |value|
      Native(`#{@native}[name] = value`)
    end
  end
end