opal-jquery 0.0.1

data/spec/element/before_spec.rb

@@ -0,0 +1,33 @@
+describe "Element#before" do
+  before do
+    @div = Document.parse <<-HTML
+      <div id="before-spec">
+        <div id="some-header" class="kapow"></div>
+        <div id="foo" class="before-spec-first"></div>
+        <div id="bar" class="before-spec-first"></div>
+        <div id="baz"></div>
+      </div>
+    HTML
+
+    @div.append_to_body
+  end
+
+  after do
+    @div.remove
+  end
+
+  it "should insert the given html string before each element" do
+    el = Document['.before-spec-first']
+    el.size.should == 2
+
+    el.before '<p class="woosh"></p>'
+
+    Document['#foo'].prev.class_name.should == "woosh"
+    Document['#bar'].prev.class_name.should == "woosh"
+  end
+
+  it "should insert the given DOM element before this element" do
+    Document['#baz'].before Document['#some-header']
+    Document['#baz'].prev.id.should == "some-header"
+  end
+end

data/spec/element/class_name_spec.rb

@@ -0,0 +1,82 @@
+describe "Element#class_name" do
+  before do
+    @div = Document.parse <<-HTML
+      <div id="class-name-spec">
+        <div id="foo" class="whiskey"></div>
+        <div id="bar" class="scotch brandy"></div>
+        <div id="baz" class=""></div>
+        <div id="buz"></div>
+
+        <div class="red dark"></div>
+        <div class="red light"></div>
+      </div>
+    HTML
+
+    @div.append_to_body
+  end
+
+  after do
+    @div.remove
+  end
+
+  it "should return the elements' class name" do
+    Document.id('foo').class_name.should == "whiskey"
+    Document.id('bar').class_name.should == "scotch brandy"
+  end
+
+  it "should return an empty string for element with no class name" do
+    Document.id('baz').class_name.should == ""
+    Document.id('buz').class_name.should == ""
+  end
+
+  it "should return class name for first element if more than 1 in set" do
+    Document.find('.red').class_name.should == "red dark"
+  end
+
+  it "should return an empty string for instances with no elements" do
+    Document.find('.no-elements').class_name.should == ""
+  end
+end
+
+describe "Element#class_name=" do
+  before do
+    @div = Document.parse <<-HTML
+      <div id="class-name-set-spec">
+        <div id="foo" class=""></div>
+        <div id="bar" class="oranges"></div>
+
+        <div id="baz" class="banana"></div>
+        <div id="buz" class="banana"></div>
+      </div>
+    HTML
+
+    @div.append_to_body
+  end
+
+  after do
+    @div.remove
+  end
+
+  it "should set the given class name on the element" do
+    Document.id('foo').class_name = "apples"
+    Document.id('foo').class_name.should == "apples"
+  end
+
+  it "should replace any existing class name" do
+    bar = Document.id('bar')
+    bar.class_name.should == "oranges"
+
+    bar.class_name = "lemons"
+    bar.class_name.should == "lemons"
+  end
+
+  it "should set the class name on all elements in instance" do
+    el = Document.find '.banana'
+    el.length.should == 2
+
+    el.class_name = "pop"
+
+    Document.id('baz').class_name.should == "pop"
+    Document.id('buz').class_name.should == "pop"
+  end
+end

data/spec/element/css_spec.rb

@@ -0,0 +1,52 @@
+describe "Element#css" do
+  before do
+    @div = Document.parse <<-HTML
+      <div id="css-spec">
+        <div id="foo" style="background-color:rgb(15,99,30); color:;"></div>
+        <div id="bar"></div>
+        <div id="hash"></div>
+      </div>
+    HTML
+
+    @div.append_to_body
+  end
+
+  after do
+    @div.remove
+  end
+
+  describe "with a given name" do
+    it "returns the value of the CSS property for the given name" do
+      Document.id('foo').css('backgroundColor').should be_kind_of(String)
+    end
+
+    it "should return an empty string when no style property is defined for name" do
+      Document.id('foo').css('color').should be_kind_of(String)
+    end
+  end
+
+  describe "with a name and value" do
+    it "should set the CSS property to the given value" do
+      Document.id('bar').css('backgroundColor', 'blue')
+    end
+
+    it "returns self" do
+      bar = Document.id('bar')
+      bar.css("background", "green").should equal(bar)
+    end
+  end
+
+  describe "with a set of names and values" do
+    it "should set the properties" do
+      hash = Document.id("hash")
+      hash.css(:width => "100px", :height => "200px")
+      hash.css("width").should be_kind_of(String) 
+      hash.css("height").should be_kind_of(String) 
+    end
+
+    it "should return self" do
+      hash = Document.id("hash")
+      hash.css(:border => "1px solid #000").should equal(hash)
+    end
+  end
+end

data/spec/element/display_spec.rb

@@ -0,0 +1,45 @@
+describe "Element display methods" do
+  before do
+    @div = Document.parse <<-HTML
+      <div id="css-spec">
+        <div id="shown"></div>
+        <div id="hidden" style="display: none"></div>
+      </div>
+    HTML
+
+    @div.append_to_body
+  end
+
+  after do
+    @div.remove
+  end
+
+  it "hides an element" do
+    element = Document.id('shown') 
+    element.css('display').should == 'block'
+    element.hide
+    element.css('display').should == 'none'
+  end
+
+  it "shows an element" do 
+    element = Document.id('hidden') 
+    element.css('display').should == 'none'
+    element.show
+    element.css('display').should == 'block'
+  end
+
+  it "toggles on a hidden element" do
+    element = Document.id('hidden') 
+    element.css('display').should == 'none'
+    element.toggle
+    element.css('display').should == 'block'
+  end
+
+  it "toggles off a displayed element" do
+    element = Document.id('shown') 
+    element.css('display').should == 'block'
+    element.toggle
+    element.css('display').should == 'none'
+  end
+  
+end

data/spec/element/inspect_spec.rb

@@ -0,0 +1,26 @@
+describe "Element#inspect" do
+  before do
+    @div = Document.parse <<-HTML
+      <div id="insert-spec">
+        <div id="foo"></div>
+        <div class="bar"></div>
+        <p id="lol" class="bar"></div>
+      </div>
+    HTML
+
+    @div.append_to_body
+  end
+
+  after do
+    @div.remove
+  end
+
+  it "should return a string representation of the elements" do
+    Document.id('foo').inspect.should == '[<div id="foo">]'
+    Document.find('.bar').inspect.should == '[<div class="bar">, <p id="lol" class="bar">]'
+  end
+
+  it "should return '[]' when called on empty element set" do
+    Document['.inspect-spec-none'].inspect.should == '[]'
+  end
+end

data/spec/element/length_spec.rb

@@ -0,0 +1,5 @@
+describe "Element#length" do
+  it "should report the number of elements in the instance" do
+    Element.new.length.should == 1
+  end
+end

data/spec/element/traversing_spec.rb

@@ -0,0 +1,150 @@
+describe Element do
+  before do
+    @div = Document.parse <<-HTML
+      <div id="traversing-spec">
+        <div id="foo" class="traversing-class"></div>
+        <div id="bar" class="traversing-class">
+          <p>Hey</p>
+          <p>There</p>
+        </div>
+        <div id="baz" class="main-content-wrapper">
+          <div><p></p></div>
+        </div>
+      </div>
+    HTML
+
+    @div.append_to_body
+  end
+
+  after do
+    @div.remove
+  end
+
+  describe '#children' do
+    it "should return a new collection of all direct children of element" do
+      Document.id('foo').children.size.should == 0
+      Document.id('bar').children.size.should == 2
+    end
+
+    it "should only return direct children" do
+      c = Document.id('baz').children
+      c.size.should == 1
+    end
+  end
+
+  describe '#each' do
+    it "should loop over each element passing element to block" do
+      result = []
+      Document.find('.traversing-class').each do |e|
+        result << e.id
+      end
+
+      result.should == ['foo', 'bar']
+    end
+
+    it "should not call the block with an empty element set" do
+      Document.find('.bad-each-class').each do
+        raise "shouldn't get here"
+      end
+    end
+  end
+
+  describe '#find' do
+    it "should match all elements within scope of receiver" do
+      foo = Document['#traversing-spec']
+      foo.find('.traversing-class').size.should == 2
+      foo.find('.main-content-wrapper').size.should == 1
+    end
+
+    it "should return an empty collection if there are no matching elements" do
+      bar = Document['#bar']
+      bar.find('.some-non-existant-class').size.should == 0
+    end
+  end
+
+  describe '#first' do
+    it "should return the first element in the receiver" do
+      Document.find('.traversing-class').first.id.should == 'foo'
+      Document.id('baz').first.id.should == 'baz'
+    end
+
+    it "should return nil when receiver has no elements" do
+      Document.find('.some-random-class').first.should == nil
+    end
+  end
+end
+
+describe "Element#next" do
+  before do
+    @div = Document.parse <<-HTML
+      <div id="next-spec">
+        <div id="foo"></div>
+        <div id="bar"></div>
+      </div>
+    HTML
+
+    @div.append_to_body
+  end
+
+  after do
+    @div.remove
+  end
+
+  it "should return the next sibling" do
+    Document.id('foo').next.id.should == "bar"
+  end
+
+  it "should return an empty instance when no next element" do
+    Document.id('bar').next.size.should == 0
+  end
+end
+
+describe "Element#parent" do
+  before do
+    @div = Document.parse <<-HTML
+      <div id="foo">
+        <div id="bar">
+          <div id="baz"></div>
+          <div id="buz"></div>
+        </div>
+      </div>
+    HTML
+
+    @div.append_to_body
+  end
+
+  after do
+    @div.remove
+  end
+
+  it "should return the parent of the element" do
+    Document.id('bar').parent.id.should == "foo"
+    Document.id('baz').parent.id.should == "bar"
+    Document.id('buz').parent.id.should == "bar"
+  end
+end
+
+describe "Element#succ" do
+  before do
+    @div = Document.parse <<-HTML
+      <div id="succ-spec">
+        <div id="foo"></div>
+        <div id="bar"></div>
+      </div>
+    HTML
+
+    @div.append_to_body
+  end
+
+  after do
+    @div.remove
+  end
+
+  it "should return the next sibling" do
+    Document.id('foo').succ.id.should == "bar"
+  end
+
+  it "should return an empty instance when no next element" do
+    Document.id('bar').succ.size.should == 0
+  end
+end

data/spec/element_spec.rb

@@ -0,0 +1,107 @@
+describe Element do
+  before do
+    @div = Document.parse <<-HTML
+      <div id="on-spec">
+        <div id="foo">
+          <div id="bar" class="apples"></div>
+        </div>
+        <div id="baz"></div>
+      </div>
+    HTML
+
+    @div.append_to_body
+  end
+
+  after do
+    @div.remove
+  end
+
+  describe '#on' do
+    it 'adds an event listener onto the elements' do
+      count = 0
+      foo   = Document['#foo']
+
+      foo.on(:click) { count += 1 }
+      count.should == 0
+      foo.trigger(:click)
+      count.should == 1
+      foo.trigger(:click)
+      count.should == 2
+      foo.trigger(:mousedown)
+      count.should == 2
+    end
+
+    it 'takes an optional second parameter to delegate events' do
+      count = 0
+      foo   = Document['#foo']
+      bar   = Document['#bar']
+
+      foo.on(:click, '#bar') { count += 1 }
+      count.should == 0
+      foo.trigger(:click)
+      count.should == 0
+      bar.trigger(:click)
+      count.should == 1
+      bar.trigger(:click)
+      count.should == 2
+      bar.trigger(:mousedown)
+      count.should == 2
+    end
+
+    it 'can listen for non-browser events' do
+      count = 0
+      foo   = Document['#foo']
+
+      foo.on('opal-is-mega-lolz') { count += 1 }
+      count.should == 0
+      foo.trigger('opal-is-mega-lolz')
+      count.should == 1
+      foo.trigger('opal-is-mega-lolz')
+      count.should == 2
+    end
+
+    it 'returns the given handler' do
+      handler = proc {}
+      Document['#foo'].on(:click, &handler).should == handler
+    end
+
+    it 'has an Event instance passed to the handler' do
+      foo = Document['#foo']
+      foo.on :click do |evt|
+        evt.should be_kind_of(Event)
+      end
+      foo.trigger(:click)
+    end
+  end
+
+  describe '#off' do
+    it 'removes event handlers that were added using #on' do
+      count = 0
+      foo   = Document['#foo']
+
+      handler = foo.on(:click) { count += 1 }
+      count.should == 0
+      foo.trigger(:click)
+      count.should == 1
+      foo.off(:click, handler)
+      count.should == 1
+      foo.trigger(:click)
+      count.should == 1
+    end
+
+    it 'removes event handlers added with a selector' do
+      count = 0
+      foo   = Document['#foo']
+      bar   = Document['#bar']
+
+      handler = foo.on(:click, '#bar') { count += 1 }
+      count.should == 0
+      bar.trigger(:click)
+      count.should == 1
+      foo.off(:click, '#bar', handler)
+      count.should == 1
+      bar.trigger(:click)
+      count.should == 1
+    end
+  end
+end