Module: Dommy::Internal::ReflectedAttributes

Included in:
HTMLElement, SVGElement
Defined in:
lib/dommy/internal/reflected_attributes.rb

Overview

IDL-attribute reflection for HTMLElement and SVGElement subclasses.

Two layers:

  1. Instance helpers (reflected_string / set_reflected_string / reflected_boolean / set_reflected_boolean) delegate to the host element's standard attribute API (get_attribute / set_attribute / has_attribute? / remove_attribute), so case-sensitivity is inherited from the host's namespace — HTML lowercases, SVG keeps the spec name (viewBox).

    • String: property mirrors the attribute value. Missing → "".
    • Boolean: property is true iff the attribute is present. Setting true writes ""; setting false removes the attribute.

  2. A class-level DSL (reflect_string / reflect_boolean) that declares reflected attributes once and generates BOTH the snake_case getter/setter pair AND a js_key => ruby_name registry entry. A shared __js_get__ / __js_set__ consults that registry, so bridge property access needs no hand-written case arm. This keeps the Ruby accessor, the JS getter, and the JS setter from drifting apart (the same class of bug the js_methods macro prevents for __js_call__).

    reflect_string :cx, :cy, :r
reflect_string view_box: "viewBox", class_name: { attr: "class" }
reflect_boolean :disabled, :required

    Identifier defaults (override via a String or Hash value):

    - js_key (camelCase IDL name) = camelize(ruby_name)
- attr   (content attribute)  = camelize(ruby_name)
- String value overrides attr only:  text_anchor: "text-anchor"
- Hash value overrides either:       tabindex: { js: "tabIndex" }

Defined Under Namespace

Modules: ClassMethods

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.included(base) ⇒ Object 



38
39
40
 
# File 'lib/dommy/internal/reflected_attributes.rb', line 38

def self.included(base)
  base.extend(ClassMethods)
end

Instance Method Details

#__js_get__(key) ⇒ Object

Bridge property read: route reflected keys to their accessor (which a subclass may have overridden with coercion), else up the super chain.



98
99
100
101
102
103
 
# File 'lib/dommy/internal/reflected_attributes.rb', line 98

def __js_get__(key)
  prop = self.class.reflected_property_map[key]
  return __send__(prop) if prop

  super
end

#__js_set__(key, value) ⇒ Object 



105
106
107
108
109
110
 
# File 'lib/dommy/internal/reflected_attributes.rb', line 105

def __js_set__(key, value)
  prop = self.class.reflected_property_map[key]
  return __send__(:"#{prop}=", value) if prop

  super
end