isomorfeus-react 16.8.9 → 16.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d87683e6af7a40a9c820e65e73bdca513e770fb22dc298ac1eb5fc643694c8fc
-  data.tar.gz: ed99bccaffec6a4e3e40f2974b77320f467977f18d04fb3671d3fc8fa7c2db8a
+  metadata.gz: a7055c4d0f51f9fe1035227468603837022020c562bab7b75c75dbfce892ccf3
+  data.tar.gz: a0fe000bd455105057f9b5136c446a705036240ef5ab322f86b4f5ae9529b1b8
 SHA512:
-  metadata.gz: 3d7fa25dd6ba783c514f64a91f8a01e70f39d6a208580c977e92501e6617a6447c5b0d04c0c387abedc6a7f59b2505ab1aeaabf080a9f9168f5af9be2391d3ba
-  data.tar.gz: 0ce87684545abfcee53fb6e2a3f307e1262c92a3cc1d55fcf9aebbdbe994a07f99c0fa2ce2ff4b3e7628710f692f02a26238b46f619643402ff089985b455133
+  metadata.gz: 9f3c731f47da42dfcc9d072b9c7c7d9f676ce1ba33331c6b905d2ac9a66c0905058e693eb7b5426fbee13204786f10a94e6c8a5dba3a3a0a3abb8cbd99ff5e25
+  data.tar.gz: eed0e49409eb5bd1f3ce5a29cc2efbbebed244edbf2b978c7284b478e118c3fa5ae70fca87d02cc9d9aefae21cf52431044b542c1b13e3398c5d444a07d814e2

data/README.md

@@ -21,7 +21,6 @@ Component Types:
 - [Class Component](https://github.com/isomorfeus/isomorfeus-react/blob/master/ruby/docs/class_component.md)
 - [Pure Component](https://github.com/isomorfeus/isomorfeus-react/blob/master/ruby/docs/pure_component.md)
 - [Function and Memo Component](https://github.com/isomorfeus/isomorfeus-react/blob/master/ruby/docs/function_component.md)
-- [Redux Component](https://github.com/isomorfeus/isomorfeus-react/blob/master/ruby/docs/redux_component.md)
 - [Lucid App, Lucid Component](https://github.com/isomorfeus/isomorfeus-react/blob/master/ruby/docs/lucid_component.md)
 - [LucidMaterial App, LucidMaterial Component](https://github.com/isomorfeus/isomorfeus-react/blob/master/ruby/docs/lucid_material_component.md) - support for [MaterialUI](https://material-ui.com)
 - [React Javascript Component](https://github.com/isomorfeus/isomorfeus-react/blob/master/ruby/docs/javascript_component.md)

data/lib/browser/delegate_native.rb

@@ -0,0 +1,70 @@
+module Browser
+  module DelegateNative
+    # Provides a default initializer. This should be overridden in all but the
+    # simplest cases.
+    def initialize native
+      @native = native
+    end
+
+    # Fall back to native properties. If the message sent to this element is not
+    # recognized, it checks to see if it is a property of the native element. It
+    # also checks for variations of the message name, such as:
+    #
+    #   :supported? => [:supported, :isSupported]
+    #
+    # If a property with the specified message name is found and it is a
+    # function, that function is invoked with `args`. Otherwise, the property
+    # is returned as is.
+    def method_missing message, *args, &block
+      property_name = property_for_message(message)
+      property = `#@native[#{property_name}]`
+
+      # translate setting a property
+      if message.end_with? '='
+        return `#@native[#{property_name}] = args[0]`
+      end
+
+      # If the native element doesn't have this property, bubble it up
+      super unless `#{property_name} in #@native`
+
+      if `property === false`
+        return false
+      elsif `typeof(property) === 'number' && isNaN(property)`
+        return nil
+      else
+        property = `property == null ? nil : property`
+      end
+
+      # If it's a method, call it. Otherwise, return it.
+      if `typeof(property) === 'function'`
+        `property.apply(#@native, args)`
+      else
+        property
+      end
+    end
+
+    def respond_to_missing? message, include_all
+      return true if message.end_with? '='
+      return true if property_for_message(message)
+
+      false
+    end
+
+    def property_for_message message
+      camel_cased_message = message
+        .gsub(/_\w/) { |match| `match[1]`.upcase }
+        .sub(/=$/, '')
+
+      # translate `supported?` to `supported` or `isSupported`
+      if message.end_with? '?'
+        camel_cased_message = camel_cased_message.chop
+        property_type = `typeof(#@native[camel_cased_message])`
+        if property_type == 'undefined'
+          camel_cased_message = "is#{camel_cased_message[0].upcase}#{camel_cased_message[1..-1]}"
+        end
+      end
+
+      camel_cased_message
+    end
+  end
+end

data/lib/browser/element.rb

@@ -0,0 +1,176 @@
+module Browser
+  autoload :FileList, 'browser/file_list'
+  autoload :Iterable, 'browser/iterable'
+
+  # Wrap a native DOM element
+  class Element
+    include EventTarget
+    include DelegateNative
+
+    @tags = Hash.new(self)
+
+    def self.element *tags, &block
+      tags.each do |tag|
+        @tags
+          .fetch(tag) { @tags[tag] = const_set(tag.capitalize, Class.new(self)) }
+          .class_exec(&block)
+      end
+    end
+
+    def self.new(native)
+      element = @tags[`(#{native}.tagName || '')`.downcase].allocate
+      element.initialize native
+      element
+    end
+
+    # @param native [JS] The native DOM element to wrap
+    def initialize native
+      @native = native
+    end
+
+    # Replace all child elements with the given element
+    #
+    # @param element [Browser::Element] The Browser element with which to replace
+    #   this element's contents
+    def inner_dom= element
+      clear
+      append element
+    end
+
+    # The contents of this element as an HTML string
+    #
+    # @return [String] the HTML representation of this element's contents
+    def inner_html
+      `#@native.innerHTML`
+    end
+
+    # Use the supplied HTML string to replace this element's contents
+    #
+    # @param html [String] the HTML with which to replace this elements contents
+    def inner_html= html
+      `#@native.innerHTML = html`
+    end
+
+    # This element's direct child elements
+    #
+    # @return [Array<Browser::Element>] list of this element's children
+    def children
+      elements = []
+
+      %x{
+        var children = #@native.children;
+        for(var i = 0; i < children.length; i++) {
+          elements[i] = #{Element.new(`children[i]`)};
+        }
+      }
+
+      elements
+    end
+
+    # Determine whether this element has any contents
+    #
+    # @return [Boolean] true if the element has no children, false otherwise
+    def empty?
+      `#@native.children.length === 0`
+    end
+
+    # Remove all contents from this element. After this call, `empty?` will
+    # return `true`.
+    #
+    # @return [Browser::Element] self
+    def clear
+      if %w(input textarea).include? type
+        `#@native.value = null`
+      else
+        children.each do |child|
+          remove_child child
+        end
+      end
+
+      self
+    end
+
+    # Remove the specified child element
+    #
+    # @param child [Browser::Element] the child element to remove
+    def remove_child child
+      `#@native.removeChild(child['native'] ? child['native'] : child)`
+    end
+
+    # This element's type. For example: "div", "span", "p"
+    #
+    # @return [String] the HTML tag name for this element
+    def type
+      `#@native.nodeName`.downcase
+    end
+
+    # Append the specified element as a child element
+    #
+    # @param element [Browser::Element, JS] the element to insert
+    def append node
+      `#@native.appendChild(node['native'] ? node['native'] : node)`
+      self
+    end
+
+    # Methods for <input /> elements
+
+    # A checkbox's checked status
+    #
+    # @return [Boolean] true if the checkbox is checked, false otherwise
+    def checked?
+      `!!#@native.checked`
+    end
+
+    # Get the currently selected file for this input. This is only useful for
+    # file inputs without the `multiple` property set.
+    #
+    # @return [Browser::File] the file selected by the user
+    def file
+      files.first
+    end
+
+    # Get the currently selected files for this input. This is only useful for
+    # file inputs with the `multiple` property set.
+    #
+    # @return [Browser::FileList] the currently selected files for this input
+    def files
+      FileList.new(`#@native.files`)
+    end
+
+    # Determine whether this is the same element
+    #
+    # @return [boolean] true if the element is the same, false otherwise
+    def ==(other)
+      `#@native === #{other.to_n}`
+    end
+
+    # Set the specified attribute to the specified value
+    def []= attribute, value
+      `#@native.setAttribute(#{attribute}, #{value})`
+    end
+
+    # Return the specified attribute
+    #
+    # @return [String] the value for the specified attribute
+    def [] attribute
+      `#@native.getAttribute(#{attribute})`
+    end
+
+    def query_selector selector
+      result = super
+
+      Element.new(result) if result
+    end
+
+    def query_selector_all selector
+      Iterable.new(super).map { |element| Element.new(element) }
+    end
+
+    # The native representation of this element.
+    #
+    # @return [JS] the native element wrapped by this object.
+    def to_n
+      @native
+    end
+  end
+end

data/lib/browser/element/canvas.rb

@@ -0,0 +1,17 @@
+module Browser
+  class Element
+    element :canvas do
+      def context(type='2d')
+        Context.new(`#@native.getContext(#{type})`)
+      end
+
+      class Context
+        include DelegateNative
+
+        def initialize native
+          @native = native
+        end
+      end
+    end
+  end
+end

data/lib/browser/element/media.rb

@@ -0,0 +1,78 @@
+module Browser
+  class Element
+    element :video, :audio do
+      def buffered
+        TimeRanges.new(`#@native.buffered`)
+      end
+
+      def played
+        TimeRanges.new(`#@native.played`)
+      end
+
+      def seekable
+        TimeRanges.new(`#@native.seekable`)
+      end
+
+      def network_state
+        case `#@native.networkState`
+        when `HTMLMediaElement.NETWORK_EMPTY` then :no_data
+        when `HTMLMediaElement.NETWORK_IDLE` then :idle
+        when `HTMLMediaElement.NETWORK_LOADING` then :loading
+        when `HTMLMediaElement.NETWORK_NO_SOURCE` then :no_source
+        end
+      end
+    end
+
+    element :video do
+      def fullscreen
+        fullscreen = %w(
+          requestFullScreen
+          requestFullscreen
+          webkitRequestFullScreen
+          webkitRequestFullscreen
+          mozRequestFullScreen
+          msRequestFullscreen
+        ).find { |prop| `!!#@native[prop]` }
+
+        if fullscreen
+          `#@native[fullscreen]()`
+        else
+          warn "[#{self.class}] Cannot determine the method to full-screen a video"
+          super
+        end
+      end
+      alias request_fullscreen fullscreen
+    end
+
+    class TimeRanges
+      include Enumerable
+
+      def initialize native
+        @native = native
+      end
+
+      def to_n
+        @native
+      end
+
+      def each
+        `#@native.length`.times do |i|
+          yield TimeRange.new(`#@native.start(i)`, `#@native.end(i)`)
+        end
+
+        self
+      end
+    end
+
+    class TimeRange
+      attr_reader :start, :end
+
+      def initialize start, _end
+        @start = start
+        @end = _end
+      end
+
+      alias begin start
+    end
+  end
+end

data/lib/browser/event.rb

@@ -0,0 +1,92 @@
+module Browser
+  # Wrapper for JS events
+  class Event
+    # @param [JS] the native event to wrap
+    def initialize native
+      @native = native
+    end
+
+    # Prevent the runtime from executing this event's default behavior. For
+    # example, prevent navigation after clicking a link.
+    #
+    # @return [Browser::Event] self
+    def prevent
+      `#@native.preventDefault()`
+      self
+    end
+
+    # Prevent the runtime from bubbling this event up the hierarchy. This is
+    # typically used to keep an event local to the element on which it was
+    # triggered, such as keeping a click event on a button from unintentionally
+    # triggering a handler on a parent element.
+    #
+    # @return self
+    def stop_propagation
+      `#@native.stopPropagation()`
+      self
+    end
+
+    # @return [Boolean] true if `prevent` has been called on this event, false
+    #   otherwise
+    def prevented?
+      `#@native.defaultPrevented`
+    end
+
+    # @return [Boolean] true if the Meta/Command/Windows key was pressed when
+    #   this event fired, false otherwise
+    def meta?
+      `#@native.metaKey`
+    end
+
+    # @return [Boolean] true if the Shift key was pressed when this event fired,
+    #   false otherwise
+    def shift?
+      `#@native.shiftKey`
+    end
+
+    # @return [Boolean] true if the Ctrl key was pressed when this event fired,
+    #   false otherwise
+    def ctrl?
+      `#@native.ctrlKey`
+    end
+
+    # @return [Boolean] true if the Alt key was pressed when this event fired,
+    #   false otherwise
+    def alt?
+      `#@native.altKey`
+    end
+
+    # The target for this event
+    #
+    # @return [Browser::Element] the element on which this event was triggered
+    # @todo Handle non-DOM events here
+    def target
+      Element.new(`#@native.target`)
+    end
+
+    # @return [Numeric] the key code associated with this event. Only useful for
+    #   keyboard-based events.
+    def code
+      `#@native.keyCode`
+    end
+
+    # Return properties on the event not covered by Ruby methods.
+    def method_missing name, *args
+      property = name.gsub(/_[a-z]/) { |match| match[-1, 1].upcase }
+      value = `#@native[property]`
+
+      if `!!value && #{Proc === value}`
+        value.call(*args)
+      elsif `value == null`
+        nil
+      else
+        value
+      end
+    end
+
+    # @return [JS] the native event wrapped by this object.
+    def to_n
+      @native
+    end
+  end
+end