diff --git a/.gitignore b/.gitignore index d1d581a3..c865bbb7 100644 --- a/.gitignore +++ b/.gitignore @@ -13,3 +13,4 @@ example_rails_app/vendor *.ipr *.iws *~ +website/output diff --git a/website/README b/website/README new file mode 100644 index 00000000..8c0a32b5 --- /dev/null +++ b/website/README @@ -0,0 +1,27 @@ +The RSpec website is built with webby-0.9.2. You should be able to build and +see it with these simple steps (standing in the same directory as this +README): + +== Build the site + +webby build + +== Rebuild the site + +webby rebuild + +== Start the webserver + +webby heel:start + +== Stop the webserver + +webby heel:stop + +== Learn about other tasks + +webby -T + +== Learn about the webby command + +webby -h diff --git a/website/Sitefile b/website/Sitefile new file mode 100644 index 00000000..cdeb5dbf --- /dev/null +++ b/website/Sitefile @@ -0,0 +1,7 @@ + +task :default => :build + +desc 'deploy the site to the webserver' +task :deploy => [:build, 'deploy:rsync'] + +# EOF diff --git a/website/layouts/default.rhtml b/website/layouts/default.rhtml new file mode 100644 index 00000000..b678f311 --- /dev/null +++ b/website/layouts/default.rhtml @@ -0,0 +1,64 @@ +--- +extension: html +filter: erb +--- + + + + + RSpec-<%= rspec_version %>: <%= @page.title %> + + + + + + + + + + + + + + +
+ + + <%= breadcrumb_menu(@page) %> + +
+ <%= @content %> + + +
+
+ + + + + diff --git a/website/lib/breadcrumbs.rb b/website/lib/breadcrumbs.rb new file mode 100644 index 00000000..7166763d --- /dev/null +++ b/website/lib/breadcrumbs.rb @@ -0,0 +1,28 @@ +# breadcrumbs.rb + +module BreadcrumbsHelper + # call-seq: + # breadcrumbs( page ) => html + # + # Create breadcrumb links for the current page. This will return an HTML + # object. + # + def breadcrumbs( page ) + list = ["
  • #{h(page.title)}
    • "] + loop do + page = @pages.parent_of(page) + break if page.nil? + list << "
  • #{link_to_page(page)}
    • " + end + list.reverse! + + html = "\n" + html + end +end # module Breadcrumbs + +Webby::Helpers.register(BreadcrumbsHelper) + +# EOF diff --git a/website/lib/rspec_extras.rb b/website/lib/rspec_extras.rb new file mode 100644 index 00000000..0a53bc54 --- /dev/null +++ b/website/lib/rspec_extras.rb @@ -0,0 +1,131 @@ +module Webby + module Resources + class DB + def immediate_children( page, opts = {} ) + root = page.dir == "" ? "" : "#{page.dir}/" + rgxp = Regexp.new "\\A#{root}[^/]+$" + keys = @db.keys.find_all {|k| rgxp =~ k} + + ary = keys.map {|k| @db[k]} + ary.flatten! + + return ary unless opts.has_key? :sort_by + + m = opts[:sort_by] + ary.sort! {|a,b| a.__send__(m) <=> b.__send__(m)} + ary.reverse! if opts[:reverse] + ary + end + end + + class Resource + def link + "#{title}" + end + + def order + (@_meta_data['order'] || 10000).to_i + end + + def path_from_root + resources = [] + resource = self + while(resource) + resources << resource + resource = Webby::Resources.pages.parent_of(resource) + end + resources.reverse + end + + def siblings + Webby::Resources.pages.siblings(self).reject{|p| p.title.nil?} + end + + def immediate_children + Webby::Resources.pages.immediate_children(self).reject{|p| p.title.nil?}.select{|p| p.filename == 'index'} + end + end + end + + require File.dirname(__FILE__) + '/../../example_rails_app/vendor/plugins/rspec/lib/spec/version' + + class Renderer + def rspec_version + Spec::VERSION::STRING + end + + def svn_tag + Spec::VERSION::TAG + end + + def breadcrumb_menu(page) + '
    ' + breadcrumbs(page) + menu(page) + '
    ' + end + + def breadcrumbs(page) + b = binding + ERB.new(<<-EOF, nil, '-').result(b) +
    + +
    + EOF + end + + def menu(page) + pages = if page.filename == 'index' + (page.siblings + page.immediate_children).sort{|a,b| a.order <=> b.order} + else + [] + end + + b = binding + ERB.new(<<-EOF, nil, '-').result(b) +
    + +
    + EOF + end + + end +end + +# This patches a bug in webby-0.8.2 in which the coderay method fails to add a +# newline resulting in webby formatting problems. +module Webby::Helpers::CodeRayHelper + alias :orig_coderay :coderay + + def coderay( *args, &block ) + orig_coderay *args, &block + buffer = eval('_erbout', block.binding) + pos = buffer.length + buffer[pos..-1] = "\n" + return + end +end diff --git a/website/src/404.html b/website/src/404.html new file mode 100644 index 00000000..eff660b9 --- /dev/null +++ b/website/src/404.html @@ -0,0 +1,30 @@ + + + + + + + The page you were looking for doesn't exist (404) + + + + + +
    +

    The page you were looking for doesn't exist.

    +

    You may have mistyped the address or the page may have moved.

    +
    + + \ No newline at end of file diff --git a/website/src/422.html b/website/src/422.html new file mode 100644 index 00000000..b54e4a3c --- /dev/null +++ b/website/src/422.html @@ -0,0 +1,30 @@ + + + + + + + The change you wanted was rejected (422) + + + + + +
    +

    The change you wanted was rejected.

    +

    Maybe you tried to change something you didn't have access to.

    +
    + + \ No newline at end of file diff --git a/website/src/500.html b/website/src/500.html new file mode 100644 index 00000000..0e9c14f4 --- /dev/null +++ b/website/src/500.html @@ -0,0 +1,30 @@ + + + + + + + We're sorry, but something went wrong (500) + + + + + +
    +

    We're sorry, but something went wrong.

    +

    We've been notified about this issue and we'll take a look at it shortly.

    +
    + + \ No newline at end of file diff --git a/website/src/archive.page b/website/src/archive.page new file mode 100644 index 00000000..232058e2 --- /dev/null +++ b/website/src/archive.page @@ -0,0 +1,16 @@ +--- +title: Archive +order: 8 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +Here are docs for previous versions. + +

    +1.0.8
    +0.9.4 +

    diff --git a/website/src/changes.page b/website/src/changes.page new file mode 100644 index 00000000..76164921 --- /dev/null +++ b/website/src/changes.page @@ -0,0 +1,8 @@ +--- +title: CHANGES +order: 3 +filter: + - erb + - textile +--- +
    <%= IO.read '../example_rails_app/vendor/plugins/rspec/History.txt' %>
    \ No newline at end of file diff --git a/website/src/community/contribute.page b/website/src/community/contribute.page new file mode 100644 index 00000000..45f1ee89 --- /dev/null +++ b/website/src/community/contribute.page @@ -0,0 +1,72 @@ +--- +title: Contribute +order: 1 +filter: + - erb + - textile +--- + +h2. Contribute to RSpec + +There are several ways in which you can contribute to RSpec. + +h2. Mailing Lists + +One easy way you can contribute is to join and participate in our mailing lists: + +"http://rubyforge.org/mail/?group_id=797":http://rubyforge.org/mail/?group_id=797 + +* rspec-users is for anyone who use RSpec to discuss any topics related to +the use of the tools +* rspec-devel is for those interested in the ongoing development of RSpec and +those who wish to make personal contributions + +While we don't wish to restrict the content on either list, we do ask that +off topic posts are so marked ([OT] in the subject line). + +h2. Feature Requests and Bug Reports + +Use the "Lighthouse":http://rspec.lighthouseapp.com/ for all +feature requests, bug reports and patches. Please be sure to assign appropriate +tags (featurerequest, bug, patch, expectations, mocks, runner, rails, textmate, +etc) + +"Lighthouse tracker":http://rspec.lighthouseapp.com/ + +Wherever feasible, submit a complete spec we can run - something like: + +<% coderay do -%> +describe "My Problem" do + it "can be reproduced as follows" do + # Why doesn't this work? + # (This is just a silly example) + true.should be_true + end +end +<% end -%> + +This will make us more likely to look at it quickly. + +If you're reporting a bug, make sure you include the following: +* rspec version (either a versioned release or svn revision number) +* rails version (if you're using the rspec_on_rails plugin) +* any other relevant versions, OSes, etc +* a failing spec AND code - we need to be able to reproduce the failure. While code snippets are better than nothing, what we really prefer is modifications to RSpec's own specs, as a unified diff file. + +h3. Patches + +Interested in a new feature that you've already written or want to write? +We want your patches! + +Here are some guidelines. + +* patch against http://rspec.rubyforge.org/svn/trunk (not a released gem) +* include specs! +* include docs! +* run "rake pre_commit" on your patched source +* create a patch with "svn diff > something_rather_descriptive.diff" +* create a new ticket in the "Lighthouse tracker":http://rspec.lighthouseapp.com/ +* attach the diff file to the ticket (DON'T FORGET TO ASSIGN THE "patch" tag) + +%{font-weight:bold; color:red}WARNING:% When you add new files, you have to +'svn add' them before running pre_commit. \ No newline at end of file diff --git a/website/src/community/index.page b/website/src/community/index.page new file mode 100644 index 00000000..a16fede5 --- /dev/null +++ b/website/src/community/index.page @@ -0,0 +1,350 @@ +--- +title: Community +order: 6 +filter: + - erb + - textile +--- + +h2. The Core Team + +* "Dave Astels":http://daveastels.com/ +* "Steven Baker":http://blog.lavalamp.ca/ +* "David Chelimsky":http://blog.davidchelimsky.net/ +* "Aslak Hellesøy":http://blog.aslakhellesoy.com/ +* "Pat Maddox":http://evang.eli.st/blog +* "Dan North":http://dannorth.net/ +* "Brian Takita":http://www.pivotalblabs.com/ + + + + + + + + + + + + + +
    David and AslakDave AstelsPat
    +     + +h2. Contributors + +In alphabetical order (by last name) + +* Daniel De Aguiar +** Patch [#15446] Removed duplicate word in with_steps_for comment. +* Chris Anderson +** Patch to return strings in response to :to_param (in generated controller/view specs) +** Patch to add --skip-migration option to rspec_scaffold generator +* Ruy Asan +** Patch [#10698] Running with --drb executes specs twice (fix included) +** Initial code for 'switch between source and spec file' command in Spec::Mate (Patch [#10791]) +* Sinclair Bain +** Patch (sort of) [#15608] Story problem if parenthesis used in Given, When, Then or And +** Patch [#11101] StringHelpers.starts_with?(prefix) assumes a string parameter for _prefix_ +** Patch for bug [#10577] Rails with Oracle breaks 0.9.2 +* Ken Barker +** Patch [#10921] Allow verify_rcov to accept greater than threshold coverage %'s via configuration +** Patch [#10920] Added support for not implemented examples +* Jonathon Barnes +** Tighter integration with Test::Unit for ActiveRecord fixtures. Speed up fixtures. +* François Beausoleil +** Patch [#10260] Spec::Mocks::Mock#inspect returns way too much data +* Wilson Bilkovich +** lambda {...}.should_change(obj, :message) +** ar_subclass.should_have(n).errors_on(:attribute) +** mock_model in Spec::Rails +* Ola Bini +** Paired with Aslak to iron out minor JRuby issues. +* Mike Breen +** Patch [#13098] Error running "script/spec_server" after upgrading from 1.0.5 to 1.0.8 +* Ryan Carmelo Briones +** Patch [#396] controllers/application.rb <=> spec/controllers/application_controller_spec.rb when using Alternate File +* Jake Cahoon +** Patch #417 - Added additional characters to be escaped in step strings +* Roman Chernyatchik +** Patch [#325] Spectask works better with multiple versions of ruby +* Wincent Colaiuta +** Patch LH[#281] Invert sense of "spec --diff" +** Patch [#11254] RSpec syntax coloring and function pop-up integration in TextMate +** Patch [#11252] Should be able to re-load file containing shared behaviours without raising an exception +** Patch [#12010] Nicer failure message formatting +** Patch [#14923] Nested shared behaviours get executed twice +** Patch LH[#393] should_receive no longer alters the method visibility when partially mocking an object +* Bob Cotton +** Patch LH[#222] ExampleGroupFactory.default resets previously registered types. +** Patch LH[#224] Nested ExampleGroups do not have a spec_path +** Patch LH[#186] reintroduce ExampleGroup.description_options +** Patch LH[#134] ExampleMatcher should match against before(:all) +** Patch [#13118] Rinda support for Spec::Distributed +** Support for context_setup and context_teardown (now before(:all) and after(:all)) +** Patch [#9678] Custom runner command line switch, and multi-threaded runner +** Patch [#9605] Patch for ER 9472, shared behaviour +** Patch [#11868] Add ability for pending to optionally hold a failing block and to fail when it passes +** Patch [#12484] Allow an ExampleGroup's Description to flow through to the Formatter +* Lachie Cox +** Initial Rails support +** Diffing enhancements for Objects and custom formats +* Ryan Davis +** Patch LH[#321] Add eval of block passed to raise_error matcher +** Assorted patches for integration with autotest +* Jonathan del Strother +** Patch LH[#486] Avoid 'invalid option -O' in autotest +* Ian Dees +** Patch LH[#183] quiet the Story Runner backtrace +** Patch [#11917] Cleaner Spec::Ui error for failed Selenium connection +* Rick DeNatale +** Patch LH[#332] hash_including mock argument matcher +* Craig Demyanovich +** Patch LH[#241] Add support for should_not render_template +** Zach Dennis +** Patch LH[#324] Consolidate :steps_for and :steps +** Patch LH[#487] Add mock_model#as_new_record +* James Deville +** Patch [#13451] Add a null_object option to mock_model +** Patch for [#13065] Named routes throw a NoMethodError in Helper specs +* Steven Duncan +** Documentation for rake task +* Eloy Duran +** Patch [#11921] Adds the correct controller_name from derived_controller_name() to the ViewExampleGroupController +* Ienaga Eiji +** Patch [#12156] smooth open mate patch +* Martin Emde +** Fix describe Object, "description contains a # in it" +* Dayo Esho +** Patch LH[#217] and_yield clobbers return value from block +* Lindsay Evans +** Patch for Spec::Rails on Windows +* Nicholas Evans +** Patch [#10410] redirect_to does not behave consistently with regards to query string parameter ordering +* Jens-Christian Fischer +** Patch [#14388] protect_against_forgery? helper method not being picked up by rspec_on_rails +* Sean Geoghegan +** Patch [#380] to add --loadby:random option +* gmarik +** Patch LH[#174] to make generated view specs work properly for nested controllers +* David Goodlad +** Patch for allowing non-Strings as partial_paths in view/specs +** Patch for file mappings for rspec/autotest integration +* James Edward Gray II +** Patch to improve syntax highlighting in TextMate +* Corey Haines +** Patch [#343] include_text matcher for rails +* Coda Hale +** Patch [#279] Autotest never calls the :red hook +* Kyle Hargraves +** Patch [#367] Yellow pending steps in story's text formatter +** Patch [#142] verify_rcov fails with latest rcov +** Patch [#10951] Odd instance variable name in rspec_model template +** Patch [#11608] Exclude rspec_on_rails from plugin spec runs +** Patch [#12066] Docfix for mocks/mocks.page +** Patch [#12300] rr integration +* Bryan Helmkamp +** Patch LH[#162] Tweak format of generated spec.opts to be more obvious +** Patch LH[#163] Generate a comment about alternate mocking frameworks +** Patch LH[#16] Have SimpleMatchers expose their description for specdocs +** Patch [#14399] Show pending reasons in HTML report +** Patch [#14095] Don't have ./script/generate rspec create previous_failures.txt +* Chris Hoffman +** Patch for spec:translate task in Spec::Rails +* Chad Humphries +** Patch [#10921] Allow verify_rcov to accept greater than threshold coverage %'s via configuration +** Patch [#10920] Added support for not implemented examples +* Jake Howerton +** Port of Kevin Clark's ARTS to RSpec +* Eiji Ienaga +** Patch LH[#404] Fixed error in documentation +* Gerrit Kaiser +** Patch LH[#230] mock(:null_object=>true) plays nice with HTML +* Shintaro Kakutani +** Patch LH[#235] ActionView::Base.base_view_path isn't clear against Rails 2.0.2 +** Patch [#13814] RSpec on Rails w/ fixture-scenarios +** Patches for coloured progress
    +** Assorted Rails patches +* Nick Kallen +** Tighter integration with Test::Unit for ActiveRecord fixtures. Speed up fixtures. +* Erik Kastner +** Patch to rename file_list to spec_file_list in spectask.rake (to avoid conflicts w/ other tools) +* Brandon Keepers +** Patch [#15465] Edge rails #8115 changed plugin loading, causing conflict between rspec and rails plugin +** Patch [#13881] Dynamically include Helpers that are included on ActionView::Base +* Kero +** Patch to add step_upcoming to story listeners. +* Rich Kilmer +** Underscore syntactic sugar +* Ryan Kinderman +** Patch [#12935] Remove requirement that mocha must be installed as a gem when used as mocking framework. +* Josh Knowles +** Patch LH[#197] Use ActiveSupport's Inflector (when available) to make 'should have' read a bit better. +** Patch LH[#193] support 'string_or_response.should have_text(...)' +** Patch [#149] Update contribute page to point towards lighthouse +** Patch [#147] Allow stories to use Spec::Matchers +** Patch [#10245] Patch to HTML escape the behavior name when using HTML Formatter +** Patch [#11221] Autotest support does not work w/o Rails Gem installed +* Jens Krämer +** Patch [#12701] Allow checking of content captured with content_for in view specs +* Michal Kwiatkowski +** Patch to get RSpec to work w/ Heckle +/- 1.2 +* Jarkko Laine +** LH[#132] Plain Text stories should support Given and Given: +* Luis Lavena +** LH[#244] No coloured output on Windows due missing RUBYOPT +* Alexander Lang +** Patch [#198] clean up story steps after each story +* Matthijs Langenberg +** Patch [#12682] Not correctly aliasing original 'stub!' and 'should_receive' methods for ApplicationController +** Patch [#12719] rspec_on_rails should not include pagination helper +* Evan Light +** Patch [#13913] Scenario should treat no code block as pending +* Mikko Lehtonen +** Patch LH[#178] small annoyances running specs with warnings enabled +* Will Leinweber +** Patch [#13339] Add the ability for spec_parser to parse describes with :behaviour_type set (with Dav Yaginuma) +* Ian Leitch +** Patch LH[#226] Add lib/ specs to 'rake stats' +** Patch [#11888] rspec_on_rails spews out warnings when assert_select is used with an XML response +** Patch [#12817] Cannot include same shared behaviour when required with absolute paths. +** Patch [#13952] Fix for performance regression introduced in r2096 +** Patch [#13943] ProfileFormatter (Top 10 slowest examples) +** Patch [#14023] Small optimization for heavily proxied objects. +* Jay Levitt +** Patch [#13143] ActionView::Helpers::RecordIdentificationHelper should be included if present +** Patch [#13016] [DOC] Point out that view specs render, well, a view +* Tim Lucas +** Patch [#10631] redirect_to matcher doesn't respect request.host +* Riley Lynch +** Patches for the rake task +* Ben Mabey +** Patch for story runner exit code. +* Dan Manges +** Fixed visibility problem for ActionController::Base#render in Spec::Rails +* Mike Mangino +** Patch [#14043] Change output ordering to show pending before errors +** Patch for [#13370] Weird mock expectation error +** Patch for [#13065] Named routes throw a NoMethodError in Helper specs +* Micah Martin +** Spec::Rails patches for partials +* James Mead +** Modified mocha to allow for its use outside of test/unit +* Adam Meehan +** Patch LH[#267] Setting mock_model object id with stubs hash +** Patch LH[#448] fix to_param in mock_model returning auto id when passed stubbed id +* Mathias Meyer +** Patch LH[#548] Previously stubbed method doesn't fail on should_not_receive +* Saimon Moore +** Patch LH[#14] Adding support for by_at_least/by_at_most in Change matcher. +* Curtis Miller +** [#13336] Helper directory incorrect for rake stats in statsetup task +* Kyosuke MOROHASHI +** Patch [#11807] Daemonize spec_server and rake tasks to manage them. +* Rick Olson +** Patch to get rspec_on_rails working with rails edge (>= 8862) +* Bret Pettichord +** Patch [#10473] obj.should exist (new matcher) +* Tim Pope +** Patch LH[#413] Disable color codes on STDOUT when STDOUT.tty? is false +* Matt Patterson +* Patch [#440] to add failing example of before filters running twice. +* Carl Porth +** Patch [#12174] mishandling of paths with spaces in spec_mate switch_command +** Patch [#12237] (tiny) added full path to mate in switch_command +** Patch [#12722] the alternate file command does not work in rails views due to scope +* Jay Phillips +** Patch [#11615] Partial mock methods give ambiguous failures when given a method name as a String +** Patch [#13274] ThrowSymbol recognized a NameError triggered by Kernel#method_missing as a thrown Symbol +* Yurii Rashkovskii +** Patch [#13833] ActionView::Helpers::JavaScriptMacrosHelper removed after 1.2.3 +** Patch to improve generated descriptions for the "be" matcher +** Patch [#12611] should_not redirect_to implementation +* Luke Redpath +** TextMate bundle +** Readable HTML output! +* Patrick Ritchie +** Patch LH[#274] support --drb in spec.opts +* Steve Ross +** Patch [#9132] Rakefile spec:doc can fail without preparing database +* Arthur Schreiber +** Patch LH[#457] PositiveOperatorMatcher and NegativeOperatorMatcher fail when #send is overwritten +* Nick Sieger +** Spec::Rails patches for stats +* Daniel Siemssen +** Spec::Rails patches for spec_server +* Nathan Sobo +** Specmate + drb fix +* Jon Strother +** Patch LH[#344] spec_server reloads fixtures +* Trevor Squires +** Patch LH[#12] Fix for TM when switching to alternate file +* Nathan Sutton +** Patch [#15659] GivenScenario fails when it is a RailsStory +* Kouhei Sutou +** Patches for Emacs +** Handling of Interrupt +* Antti Tarvainen +** Patch LH[#333] Fixed bug where rspec loads files repeatedly when running heckle +** Patch LH[#280] Fixed bug where heckle runs rspec runs heckle runs rspec etc. +** Patch [#14254] Improved error handling for Object#should and Object#should_not +** Patch [#14186] Remove dead code from message_expecation.rb +** Patch [#14183] Tiny improvement on mock_spec.rb +** Patch [#14208] Fix to Mock#method_missing raising NameErrors instead of MockExpectationErrors +** Patch [#14255] Fixed examples in mock_spec.rb and shared_behaviour_spec.rb +** Patch [#14156] False positives with should_not +** Patch [#14170] route_for and params_from internal specs fixed +** Patch [#14142] Fix for bug #11602: Nested #have_tag specifications fails on the wrong line number +** Patch [#10315] to fix pre_commit bug 10313 - pre_commit_rails: doesn't always build correctly +** Patch [#11500] Documentation: no rails integration specs in 1.0 +* Scott Taylor +** Patch [#11919] Making non-implemented specs easy in textmate +** Patch [#13078] Develop rspec with autotest +** Patch [#12986] Autotest Specs + Refactoring +** Patch [#11509] Documentation - RSpec requires hpricot +** Patch [#9509] allow spaced options in spec.opts +** Patch [#9510] Added html formatter spec file for Ruby 1.8.6 +** Patch [#9511] Clarification to README file in spec/ +** Patch [#9852] Patch for RSpec's Website using Webgen 0.4.2 +** Patch [#9925] Changed ".rhtml" to "template" in REST spec generator +** Patch [#9926] Rakefile - RSPEC_DEPS constant as an Array of Hashes instead of an Array of Arrays +** Patch [#10636] Added spec for OptionParser in Runner (Patch from Scott Taylor) +** Patch LH[#326] Deprecation warnings for specs that assume auto-inclusion of modules +** Patch LH[#524] Privatize Have#method_missing and enhance its respond_to? +** Patch LH[#485] Add file and line numbers to pending specs +* Steve Tendon +** Patch [#9458] The rspec_scaffold generator does not take into account class nesting +* Jonathan Tron +** Patch for Spec::Rails resource_generator +** Patch for RSpec.tmbundle to make it work with RSpec installed as a plugin +* Mark Van Holstyn +** Patch LH[#15] Reverse loading of ActionView::Base helper modules +** Patch [#134] Only load spec inside spec_helper.rb +* Mike Vincent +** Patch LH[#181] Regression on generators due to internal changes in rails edge +* Rupert Voelcker +** Patch [#13567] patch to allow stubs to yield consecutive values +** Patch [#13559] reverse version of route_for +* Florian Weber +** RSpec.tmbundle and the spec_server that comes with Spec::Rails are based on Florian's TDDMate +* Nikolai Weibull +** Core patches for spec names +* Jim Weirich +** Modified flexmock to allow for its use outside of test/unit +** Supplied plugin patch to support flexmock directly in rspec +* Ian White +** Patch LH[#271] Since @template.finder, isolation mode doesn't work +** Patch for [#11545] Rspec doesn't handle should_receive on ActiveRecord associations +* Joseph Wilk +** Patch LH[#300] Showing Story/Scenario Failure Fix for HTML Story formatter +** Patch LH[#439] Showing Story/Scenario Failure Fix for Plain Text Story formatter +* Mike Williams +** Patch LH[#276] to support the lib directory in rails apps with the Textmate Alternate File command. +** Core patches for arbitrary comparisons like 5.should_be < 6 +* Chad Wooley +** Patch to mocks to make it possible to specify raised exception instance +* Dav Yaginuma +** Patch [#13339] Add the ability for spec_parser to parse describes with :behaviour_type set (with Will Leinweber) + + +If you think your name ought to be here, please contact the RSpec team. diff --git a/website/src/css/blueprint/License.txt b/website/src/css/blueprint/License.txt new file mode 100644 index 00000000..12a1b17b --- /dev/null +++ b/website/src/css/blueprint/License.txt @@ -0,0 +1,21 @@ +Copyright (c) 2007 Olav Bjorkoy (http://bjorkoy.com) + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sub-license, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice, and every other copyright notice found in this +software, and all the attributions in every file, and this permission notice +shall be included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. + diff --git a/website/src/css/blueprint/Readme.txt b/website/src/css/blueprint/Readme.txt new file mode 100644 index 00000000..dd708e50 --- /dev/null +++ b/website/src/css/blueprint/Readme.txt @@ -0,0 +1,100 @@ +Blueprint CSS framework 0.5 (http://bjorkoy.com/blueprint) +---------------------------------------------------------------- + +Welcome to Blueprint! This is a CSS framework designed to +cut down on your CSS development time. It gives you a solid +foundation to build your own CSS on. Here are some of the +features BP provides out-of-the-box: + +* An easily customizable grid +* Sensible default typography +* A typographic baseline +* Perfected browser CSS reset +* A stylesheet for printing +* Absolutely no bloat + + +Setup instructions +---------------------------------------------------------------- + +Here's how you set up Blueprint on your site. + +1) Upload BP to your server, and place it in whatever folder + you'd like. A good choice would be your CSS folder. + +2) Add the following lines to every section of your + site. Make sure the link path is correct (here, BP is in my CSS folder): + + + + +3) That's it! Blueprint is now ready to shine. + + +How to use Blueprint +---------------------------------------------------------------- + +Here's a quick primer on how to use BP: +http://code.google.com/p/blueprintcss/wiki/Tutorial + +Each file is also heavily commented, so you'll +learn a lot by reading through them. + + +Files in Blueprint +---------------------------------------------------------------- + +The framework has a few files you should check out. Every file +contains lots of (hopefully) clarifying comments. + +* screen.css + This is the main file of the framework. It imports other CSS + files from the "lib" directory, and should be included on + every page. + +* print.css + This file sets some default print rules, so that printed versions + of your site looks better than they usually would. It should be + included on every page. + +* lib/grid.css + This file sets up the grid (it's true). It has a lot of classes + you apply to divs to set up any sort of column-based grid. + +* lib/typography.css + This file sets some default typography. It also has a few + methods for some really fancy stuff to do with your text. + +* lib/reset.css + This file resets CSS values that browsers tend to set for you. + +* lib/buttons.css + Provides some great CSS-only buttons. + +* lib/compressed.css + A compressed version of the core files. Use this on every live site. + See screen.css for instructions. + + +Credits +---------------------------------------------------------------- + +Many parts of BP are directly inspired by other peoples work. +You may thank them for their brilliance. However, *do not* ask +them for support or any kind of help with BP. + +* Jeff Croft [jeffcroft.com] +* Nathan Borror [playgroundblues.com] +* Christian Metts [mintchaos.com] +* Wilson Miner [wilsonminer.com] +* The Typogrify Project [code.google.com/p/typogrify] +* Eric Meyer [meyerweb.com/eric] +* Angus Turnbull [twinhelix.com] +* Khoi Vinh [subtraction.com] + +Questions, comments, suggestions or bug reports all go to +olav at bjorkoy dot com. Thanks for your interest! + + +== By Olav Bjorkoy +== http://bjorkoy.com diff --git a/website/src/css/blueprint/lib/buttons.css b/website/src/css/blueprint/lib/buttons.css new file mode 100644 index 00000000..93c409bb --- /dev/null +++ b/website/src/css/blueprint/lib/buttons.css @@ -0,0 +1,112 @@ +/* -------------------------------------------------------------- + + Buttons.css + * Version: 0.5 (28/8/2007) + * Website: http://code.google.com/p/blueprintcss/ + + Created by Kevin Hale [particletree.com] + * particletree.com/features/rediscovering-the-button-element + + W3C: "Buttons created with the BUTTON element function + just like buttons created with the INPUT element, + but they offer richer rendering possibilities." + + Usage: + + + + + Change Password + + + + Cancel + + +-------------------------------------------------------------- */ + +a.button, button { + display:block; + float:left; + margin:0 0.583em 0.667em 0; + padding:5px 10px 6px 7px; /* Links */ + + border:0.1em solid #dedede; + border-top:0.1em solid #eee; + border-left:0.1em solid #eee; + + background-color:#f5f5f5; + font-family:"Lucida Grande", Tahoma, Arial, Verdana, sans-serif; + font-size:100%; + line-height:130%; + text-decoration:none; + font-weight:bold; + color:#565656; + cursor:pointer; +} +button { + width:auto; + overflow:visible; + padding:4px 10px 3px 7px; /* IE6 */ +} +button[type] { + padding:5px 10px 5px 7px; /* Firefox */ + line-height:17px; /* Safari */ +} +*:first-child+html button[type] { + padding:4px 10px 3px 7px; /* IE7 */ +} +button img, a.button img{ + margin:0 3px -3px 0 !important; + padding:0; + border:none; + width:16px; + height:16px; +} + + +/* Button colors +-------------------------------------------------------------- */ + +/* Standard */ +button:hover, a.button:hover{ + background-color:#dff4ff; + border:0.1em solid #c2e1ef; + color:#336699; +} +a.button:active{ + background-color:#6299c5; + border:1px solid #6299c5; + color:#fff; +} + +/* Positive */ +.positive { + color:#529214; +} +a.positive:hover, button.positive:hover { + background-color:#E6EFC2; + border:0.1em solid #C6D880; + color:#529214; +} +a.positive:active { + background-color:#529214; + border:0.1em solid #529214; + color:#fff; +} + +/* Negative */ +.negative { + color:#d12f19; +} +a.negative:hover, button.negative:hover { + background:#fbe3e4; + border:0.1em solid #fbc2c4; +} +a.negative:active { + background-color:#d12f19; + border:0.1em solid #d12f19; + color:#fff; +} diff --git a/website/src/css/blueprint/lib/compressed.css b/website/src/css/blueprint/lib/compressed.css new file mode 100644 index 00000000..7769242c --- /dev/null +++ b/website/src/css/blueprint/lib/compressed.css @@ -0,0 +1,137 @@ +/* Blueprint Compressed Version */ + + +/* reset.css */ +html,body,div,span,applet,object,iframe, h1,h2,h3,h4,h5,h6,p,blockquote,pre, a,abbr,acronym,address,big,cite,code, del,dfn,em,font,img,ins,kbd,q,s,samp, strike,strong,sub,sup,tt,var, dl,dt,dd,ol,ul,li, fieldset,form,label,legend, table,caption,tbody,tfoot,thead,tr,th,td{margin:0;padding:0;border:0;font-weight:inherit;font-style:inherit;font-size:100%;font-family:inherit;vertical-align:baseline;} +body{line-height:1;color:#333;background:white;} +table{border-collapse:separate;border-spacing:0;} +caption,th,td{text-align:left;font-weight:normal;} +blockquote:before,blockquote:after,q:before,q:after{content:"";} +blockquote,q{quotes:"" "";} + + +/* typography.css */ +body{font-size:12px;line-height:18px;} +h1,h2,h3, h4,h5,h6{font-family:Constantia,"Palatino Linotype",Palatino,Georgia,"Times New Roman",Times,serif;} +body{font-family:Frutiger,Univers,"Helvetica Neue","Lucida Grande",Calibri,Helvetica,Verdana,sans-serif;} +pre{font-family:Corbel,Verdana,"Bitstream Vera Sans",sans-serif;} +code{font-family:Consolas,"Bitstream Vera Sans Mono","Courier New",Monaco,Courier,monospace;} +h1,h2,h3,h4,h5,h6{color:#111;clear:both;} +h1{font-size:30px;line-height:36px;padding:0 0 18px 0;} +h2{font-size:20px;line-height:36px;} +h3{font-size:16px;line-height:36px;} +h4{font-size:14px;font-weight:bold;} +h5{font-size:12px;font-weight:bold;} +h6{font-size:12px;} +p{margin:0 0 18px 0;text-align:justify;} +p.last{margin-bottom:0;} +p img{float:left;margin:18px 18px 18px 0;padding:0;} +p img.top{margin-top:0;} +a{color:#125AA7;text-decoration:underline;} +a:hover{color:#000;} +ul,ol{margin:0 0 18px 18px;} +ul{list-style-type:circle;} +ol{list-style-type:decimal;} +dl{margin:0 0 18px 0;} +dl dt{font-weight:bold;} +blockquote{margin:0 0 18px 18px;color:#666;font-style:italic;} +strong{font-weight:bold;} +em{font-style:italic;} +pre{margin-bottom:18px;background:#eee;border:1px solid #ddd;padding:16px;} +hr{background:#B2CCFF;color:#B2CCFF;clear:both;float:none;width:100%;height:2px;margin:0 0 16px 0;border:none;} +table{margin-bottom:16px;border-top:1px solid #ddd;border-left:1px solid #ddd;} +th,td{height:13px;padding:2px 4px;border-bottom:1px solid #ddd;border-right:1px solid #ddd;} +th{font-weight:bold;} +p.small{font-size:10px;margin-bottom:18px;} +p.large{font-size:14px;line-height:36px;} +p.quiet{color:#666;} +.hide{display:none;} +.alt{color:#666;font-family:"Warnock Pro","Goudy Old Style","Palatino","Book Antiqua",Georgia,serif;font-size:1.2em;line-height:1%;font-style:italic;} +.dquo{margin-left:-.7em;} +p.incr,.incr p{font-size:10px;line-height:1.44em;margin-bottom:18px;} +.caps{font-variant:small-caps;letter-spacing:1px;text-transform:lowercase;font-size:1.2em;line-height:1%;font-weight:bold;} + + +/* grid.css */ +body{text-align:center;margin:36px 0;} +.container{text-align:left;position:relative;padding:0;margin:0 auto;width:950px;} +.column{float:left;margin-right:10px;padding:0;} +* html .column{overflow-x:hidden;} +.border{padding-right:4px;margin-right:5px;border-right:1px solid #ddd;} +.span-1{width:30px;} +.span-2{width:70px;} +.span-3{width:110px;} +.span-4{width:150px;} +.span-5{width:190px;} +.span-6{width:230px;} +.span-7{width:270px;} +.span-8{width:310px;} +.span-9{width:350px;} +.span-10{width:390px;} +.span-11{width:430px;} +.span-12{width:470px;} +.span-13{width:510px;} +.span-14{width:550px;} +.span-15{width:590px;} +.span-16{width:630px;} +.span-17{width:670px;} +.span-18{width:710px;} +.span-19{width:750px;} +.span-20{width:790px;} +.span-21{width:830px;} +.span-22{width:870px;} +.span-23{width:910px;} +.span-24{width:950px;margin:0;} +.last{margin-right:0;} +.append-1{padding-right:40px;} +.append-2{padding-right:80px;} +.append-3{padding-right:120px;} +.append-4{padding-right:160px;} +.append-5{padding-right:200px;} +.append-6{padding-right:240px;} +.append-7{padding-right:280px;} +.append-8{padding-right:320px;} +.append-9{padding-right:360px;} +.append-10{padding-right:400px;} +.append-11{padding-right:440px;} +.append-12{padding-right:480px;} +.prepend-1{padding-left:40px;} +.prepend-2{padding-left:80px;} +.prepend-3{padding-left:120px;} +.prepend-4{padding-left:160px;} +.prepend-5{padding-left:200px;} +.prepend-6{padding-left:240px;} +.prepend-7{padding-left:280px;} +.prepend-8{padding-left:320px;} +.prepend-9{padding-left:360px;} +.prepend-10{padding-left:400px;} +.prepend-11{padding-left:440px;} +.prepend-12{padding-left:480px;} +img{margin:0 0 18px 0;} +.pull-1{margin-left:-40px;} +.pull-2{margin-left:-80px;} +.pull-3{margin-left:-120px;} +.pull-4{margin-left:-160px;} +.push-0{margin:0 0 0 18px;float:right;} +.push-1{margin:0 -40px 0 18px;float:right;} +.push-2{margin:0 -80px 0 18px;float:right;} +.push-3{margin:0 -120px 0 18px;float:right;} +.push-4{margin:0 -160px 0 18px;float:right;} +.pull-1,.pull-2,.pull-3,.pull-4, .push-1,.push-2,.push-3,.push-4{overflow-x:visible;} + + +/* buttons.css */ +a.button,button{display:block;float:left;margin:0 0.583em 0.667em 0;padding:5px 10px 6px 7px;border:0.1em solid #dedede;border-top:0.1em solid #eee;border-left:0.1em solid #eee;background-color:#f5f5f5;font-family:"Lucida Grande",Tahoma,Arial,Verdana,sans-serif;font-size:100%;line-height:130%;text-decoration:none;font-weight:bold;color:#565656;cursor:pointer;} +button{width:auto;overflow:visible;padding:4px 10px 3px 7px;} +button[type]{padding:5px 10px 5px 7px;line-height:17px;} +*:first-child+html button[type]{padding:4px 10px 3px 7px;} +button img,a.button img{margin:0 3px -3px 0 !important;padding:0;border:none;width:16px;height:16px;} +button:hover,a.button:hover{background-color:#dff4ff;border:0.1em solid #c2e1ef;color:#336699;} +a.button:active{background-color:#6299c5;border:1px solid #6299c5;color:#fff;} +.positive{color:#529214;} +a.positive:hover,button.positive:hover{background-color:#E6EFC2;border:0.1em solid #C6D880;color:#529214;} +a.positive:active{background-color:#529214;border:0.1em solid #529214;color:#fff;} +.negative{color:#d12f19;} +a.negative:hover,button.negative:hover{background:#fbe3e4;border:0.1em solid #fbc2c4;} +a.negative:active{background-color:#d12f19;border:0.1em solid #d12f19;color:#fff;} + diff --git a/website/src/css/blueprint/lib/grid.css b/website/src/css/blueprint/lib/grid.css new file mode 100644 index 00000000..aca76b34 --- /dev/null +++ b/website/src/css/blueprint/lib/grid.css @@ -0,0 +1,149 @@ +/* -------------------------------------------------------------- + + Grid.css + * Version: 0.5 (28/8/2007) + * Website: http://code.google.com/p/blueprintcss/ + + Based on work by: + * Olav Bjorkoy [bjorkoy.com] + * Nathan Borror [playgroundblues.com] + * Jeff Croft [jeffcroft.com] + * Christian Metts [mintchaos.com] + * Khoi Vinh [subtraction.com] + + By default, the grid is 950px wide, with 24 columns + spanning 30px, and a 10px margin between columns. + + If you need fewer or more columns, use this + formula to find the new total width: + + Total width = (columns * 30) - 10 + +-------------------------------------------------------------- */ + +body { + text-align: center; /* IE6 Fix */ + margin:36px 0; +} + +/* A container should group all your columns. */ +.container { + text-align: left; + position: relative; + padding: 0; + margin: 0 auto; /* Centers layout */ + width: 950px; /* Total width */ +} + + +/* Columns +-------------------------------------------------------------- */ + +/* Use this class together with the .span-x classes + to create any compsition of columns in a layout. + Nesting columns works like a charm (remember .first and .last). */ + +.column { + float: left; + margin-right: 10px; + padding: 0; +} +* html .column { overflow-x: hidden; } /* IE6 fix */ + +/* Add this class to a column if you want a border on its + right hand side. This should be customized to fit your needs. */ + +.border { + padding-right: 4px; + margin-right: 5px; + border-right: 1px solid #ddd; +} + + +/* Use these classes to set how wide a column should be. */ +.span-1 { width: 30px; } +.span-2 { width: 70px; } +.span-3 { width: 110px; } +.span-4 { width: 150px; } +.span-5 { width: 190px; } +.span-6 { width: 230px; } +.span-7 { width: 270px; } +.span-8 { width: 310px; } +.span-9 { width: 350px; } +.span-10 { width: 390px; } +.span-11 { width: 430px; } +.span-12 { width: 470px; } +.span-13 { width: 510px; } +.span-14 { width: 550px; } +.span-15 { width: 590px; } +.span-16 { width: 630px; } +.span-17 { width: 670px; } +.span-18 { width: 710px; } +.span-19 { width: 750px; } +.span-20 { width: 790px; } +.span-21 { width: 830px; } +.span-22 { width: 870px; } +.span-23 { width: 910px; } +.span-24 { width: 950px; margin: 0; } + +/* The last element in a multi-column block needs this class. */ +.last { margin-right: 0; } + +/* Add these to a column to append empty cols. */ +.append-1 { padding-right: 40px; } +.append-2 { padding-right: 80px; } +.append-3 { padding-right: 120px; } +.append-4 { padding-right: 160px; } +.append-5 { padding-right: 200px; } +.append-6 { padding-right: 240px; } +.append-7 { padding-right: 280px; } +.append-8 { padding-right: 320px; } +.append-9 { padding-right: 360px; } +.append-10 { padding-right: 400px; } +.append-11 { padding-right: 440px; } +.append-12 { padding-right: 480px; } + +/* Add these to a column to prepend empty cols. */ +.prepend-1 { padding-left: 40px; } +.prepend-2 { padding-left: 80px; } +.prepend-3 { padding-left: 120px; } +.prepend-4 { padding-left: 160px; } +.prepend-5 { padding-left: 200px; } +.prepend-6 { padding-left: 240px; } +.prepend-7 { padding-left: 280px; } +.prepend-8 { padding-left: 320px; } +.prepend-9 { padding-left: 360px; } +.prepend-10 { padding-left: 400px; } +.prepend-11 { padding-left: 440px; } +.prepend-12 { padding-left: 480px; } + + + +/* Images +-------------------------------------------------------------- */ + +/* Remember the baseline (typography.css). */ +img { margin: 0 0 18px 0; } + + +/* Use these classes to make an image flow into the column before + or after it. This techique can also be used on other objects. */ + +.pull-1 { margin-left: -40px; } +.pull-2 { margin-left: -80px; } +.pull-3 { margin-left: -120px; } +.pull-4 { margin-left: -160px; } + +.push-0 { margin: 0 0 0 18px; float: right; } /* Right aligns the image. */ +.push-1 { margin: 0 -40px 0 18px; float: right; } +.push-2 { margin: 0 -80px 0 18px; float: right; } +.push-3 { margin: 0 -120px 0 18px; float: right; } +.push-4 { margin: 0 -160px 0 18px; float: right; } + +.pull-1, .pull-2, .pull-3, .pull-4, +.push-1, .push-2, .push-3, .push-4 { + overflow-x: visible; /* Overrides previous IE6 fix (needs improvement). */ +} + +/* EOF */ + diff --git a/website/src/css/blueprint/lib/img/grid.png b/website/src/css/blueprint/lib/img/grid.png new file mode 100644 index 00000000..21bc173d Binary files /dev/null and b/website/src/css/blueprint/lib/img/grid.png differ diff --git a/website/src/css/blueprint/lib/img/icons/cross.png b/website/src/css/blueprint/lib/img/icons/cross.png new file mode 100644 index 00000000..1514d51a Binary files /dev/null and b/website/src/css/blueprint/lib/img/icons/cross.png differ diff --git a/website/src/css/blueprint/lib/img/icons/textfield_key.png b/website/src/css/blueprint/lib/img/icons/textfield_key.png new file mode 100644 index 00000000..a9d5e4f8 Binary files /dev/null and b/website/src/css/blueprint/lib/img/icons/textfield_key.png differ diff --git a/website/src/css/blueprint/lib/img/icons/tick.png b/website/src/css/blueprint/lib/img/icons/tick.png new file mode 100644 index 00000000..a9925a06 Binary files /dev/null and b/website/src/css/blueprint/lib/img/icons/tick.png differ diff --git a/website/src/css/blueprint/lib/reset.css b/website/src/css/blueprint/lib/reset.css new file mode 100644 index 00000000..6aa02f55 --- /dev/null +++ b/website/src/css/blueprint/lib/reset.css @@ -0,0 +1,40 @@ +/* -------------------------------------------------------------- + + Reset.css + * Version: 0.5 (28/8/2007) + * Website: http://code.google.com/p/blueprintcss/ + + Original by Eric Meyer: + * meyerweb.com/eric/thoughts/2007/05/01/reset-reloaded/ + +-------------------------------------------------------------- */ + +html, body, div, span, applet, object, iframe, +h1, h2, h3, h4, h5, h6, p, blockquote, pre, +a, abbr, acronym, address, big, cite, code, +del, dfn, em, font, img, ins, kbd, q, s, samp, +strike, strong, sub, sup, tt, var, +dl, dt, dd, ol, ul, li, +fieldset, form, label, legend, +table, caption, tbody, tfoot, thead, tr, th, td { + margin: 0; + padding: 0; + border: 0; + font-weight: inherit; + font-style: inherit; + font-size: 100%; + font-family: inherit; + vertical-align: baseline; +} + +body { line-height: 1; color: #333; background: white; } + +/* Tables still need 'cellspacing="0"' in the markup. */ +table { border-collapse: separate; border-spacing: 0; } +caption, th, td { text-align: left; font-weight: normal; } + +/* Remove possible quote marks (") from ,
    . */ +blockquote:before, blockquote:after, q:before, q:after { content: ""; } +blockquote, q { quotes: "" ""; } + +/* EOF */ diff --git a/website/src/css/blueprint/lib/typography.css b/website/src/css/blueprint/lib/typography.css new file mode 100644 index 00000000..f04c4883 --- /dev/null +++ b/website/src/css/blueprint/lib/typography.css @@ -0,0 +1,161 @@ +/* -------------------------------------------------------------- + + Typography.css + * Version: 0.5 (28/8/2007) + * Website: http://code.google.com/p/blueprintcss/ + + Based on work by: + * Olav Bjorkoy [bjorkoy.com] + * Nathan Borror [playgroundblues.com] + * Jeff Croft [jeffcroft.com] + * Christian Metts [mintchaos.com] + * Wilson Miner [wilsonminer.com] + + Read more about using a baseline here: + * alistapart.com/articles/settingtypeontheweb + +-------------------------------------------------------------- */ + +body { + font-size: 12px; + line-height: 18px; /* All elements should be a multiple of this value. */ +} + + +/* Default fonts */ +h1,h2,h3, +h4,h5,h6 { font-family: Constantia, "Palatino Linotype", Palatino, Georgia, "Times New Roman", Times, serif; } +body { font-family: Frutiger, Univers, "Helvetica Neue", "Lucida Grande", Calibri, Helvetica, Verdana, sans-serif; } +pre { font-family: Corbel, Verdana, "Bitstream Vera Sans", sans-serif; } +code { font-family: Consolas, "Bitstream Vera Sans Mono", "Courier New", Monaco, Courier, monospace; } + + +/* Headings +-------------------------------------------------------------- */ + +h1,h2,h3,h4,h5,h6 { + color:#111; + clear:both; +} + +h1 { font-size: 30px; line-height:36px; padding:0 0 18px 0; } +h2 { font-size: 20px; line-height:36px; } +h3 { font-size: 16px; line-height:36px; } +h4 { font-size: 14px; font-weight:bold; } +h5 { font-size: 12px; font-weight:bold; } +h6 { font-size: 12px; } + + +/* Text elements +-------------------------------------------------------------- */ + +p { margin: 0 0 18px 0; text-align:justify; } +p.last { margin-bottom:0; } +p img { float: left; margin:18px 18px 18px 0; padding:0; } +p img.top { margin-top:0; } /* Use this if the image is at the top of the

    . */ + +a { color: #125AA7; text-decoration: underline; } +a:hover { color: #000; } + +ul, ol { margin: 0 0 18px 18px; } +ul { list-style-type: circle; } +ol { list-style-type: decimal; } +dl { margin: 0 0 18px 0; } +dl dt { font-weight: bold; } + +blockquote { margin: 0 0 18px 18px; color: #666; font-style: italic; } +strong { font-weight: bold; } +em { font-style: italic; } +pre { margin-bottom: 18px; background: #eee; border:1px solid #ddd; padding:16px; } + +/* Use this to create a horizontal ruler across a column. */ +hr { + background: #B2CCFF; + color: #B2CCFF; + clear: both; + float: none; + width: 100%; + height: 2px; + margin: 0 0 16px 0; + border: none; +} + + +/* Tables +-------------------------------------------------------------- */ + +table { margin-bottom: 16px; border-top:1px solid #ddd; border-left:1px solid #ddd; } +th,td { height: 13px; padding:2px 4px; border-bottom:1px solid #ddd; border-right:1px solid #ddd; } +th { font-weight:bold; } + + +/* Some default classes +-------------------------------------------------------------- */ + +p.small { font-size: 10px; margin-bottom: 18px; } +p.large { font-size: 14px; line-height:36px; } +p.quiet { color: #666; } +.hide { display: none; } + + +/* Extra fancy typography +-------------------------------------------------------------- */ + +/* For great looking type, use this code instead of asdf: + asdf + Best used on prepositions and ampersands. */ + +.alt { + color: #666; + font-family: "Warnock Pro", "Goudy Old Style","Palatino","Book Antiqua", Georgia, serif; + font-size: 1.2em; + line-height: 1%; /* Maintain correct baseline */ + font-style: italic; +} + +/* For great looking quote marks in titles, replace "asdf" with: + “asdf” + (That is, when the title starts with a quote mark). + (You may have to change this value depending on your font size). */ + +.dquo { margin-left: -.7em; } + + +/* Reduced size type with incremental leading + (http://www.markboulton.co.uk/journal/comments/incremental_leading/) + + This could be used for side notes. For smaller type, you don't necessarily want to + follow the 1.5x vertical rhythm -- the line-height is too much. + + Using this class, it reduces your font size and line-height so that for + every four lines of normal sized type, there is five lines of the sidenote. eg: + + New type size in em's: + 10px (wanted side note size) / 12px (existing base size) = 0.8333 (new type size in ems) + + New line-height value: + 12px x 1.5 = 18px (old line-height) + 18px x 4 = 72px + 72px / 5 = 14.4px (new line height) + 14.4px / 10px = 1.44 (new line height in em's) */ + +p.incr, .incr p { + font-size: 10px; + line-height: 1.44em; + margin-bottom: 18px; /* Still 1.5 x normal font size as baseline */ +} + + +/* Surround uppercase words and abbreviations with this class. + Based on work by Jørgen Arnor Gårdsø Lom [http://twistedintellect.com/] */ + +.caps { + font-variant: small-caps; + letter-spacing: 1px; + text-transform: lowercase; + font-size:1.2em; + line-height:1%; + font-weight:bold; +} + +/* EOF */ diff --git a/website/src/css/blueprint/print.css b/website/src/css/blueprint/print.css new file mode 100644 index 00000000..69271f38 --- /dev/null +++ b/website/src/css/blueprint/print.css @@ -0,0 +1,79 @@ +/* -------------------------------------------------------------- + + Blueprint CSS Framework Print Styles + * Version: 0.5 (28/8/2007) + * Website: http://code.google.com/p/blueprintcss/ + + This file creates CSS styles for printing documents. + Include this in the of every page. See the + Readme file in this directory for further instructions. + + Some additions you'll want to make, + customized to your markup: + + #heder, #footer, #navigation { display:none; } + +-------------------------------------------------------------- */ + +body { + line-height: 1.5; + color:#000; + background: none; + font-size: 11pt; +} + +h1,h2,h3, +h4,h5,h6 { font-family: Constantia, "Palatino Linotype", Palatino, Georgia, "Times New Roman", Times, serif; } +body { font-family: Frutiger, Univers, "Helvetica Neue", "Lucida Grande", Calibri, Helvetica, Arial, sans-serif; } +pre { font-family: Corbel, Verdana, "Bitstream Vera Sans", sans-serif; } +code { font-family: Consolas, "Bitstream Vera Sans Mono", "Courier New", Monaco, Courier, monospace; } + +img { + float:left; + margin:1.5em 1.5em 1.5em 0; +} +p img.top { + margin-top: 0; +} + +hr { + background:#ccc; + color:#ccc; + width:100%; + height:2px; + margin:2em 0; + padding:0; + border:none; +} +blockquote { + margin:1.5em 0; + padding:1em; + border:0.2em solid #ccc; + font-style:italic; + font-size:0.9em; +} + +.small, .small p { font-size: 0.9em; } +.large, .large p { font-size: 1.1em; } +.quiet, .quiet p { color: #999; } +.hide { display:none; } + +a:link, a:visited { + background: transparent; + font-weight: bold; + text-decoration: underline; +} + +a:link:after, a:visited:after { + content: " (" attr(href) ") "; + font-size: 90%; +} + +/* If you're having trouble printing relative links, uncomment and customize this: + (note: This is valid CSS3, but it still won't go through the W3C CSS Validator) */ + +/* a[href^="/"]:after { + content: " (http://www.yourdomain.com" attr(href) ") "; +} */ + + diff --git a/website/src/css/blueprint/screen.css b/website/src/css/blueprint/screen.css new file mode 100644 index 00000000..83af3269 --- /dev/null +++ b/website/src/css/blueprint/screen.css @@ -0,0 +1,30 @@ +/* -------------------------------------------------------------- + + Blueprint CSS Framework Screen Styles + * Version: 0.5 (28/8/2007) + * Website: http://code.google.com/p/blueprintcss/ + + This is the main CSS-file for the framework. + Include this in the of every page. See the + Readme file in this directory for further instructions. + +-------------------------------------------------------------- */ + +@import 'lib/reset.css'; +@import 'lib/typography.css'; +@import 'lib/grid.css'; +@import 'lib/buttons.css'; + + +/* Compressed version (re-compress if you change the core files): + [http://teenage.cz/acidofil/tools/cssformat.php] + + Comment out @import statements above, and + add this line instead, when your site has launched + (compresses ca 60% of the core files in BP): + @import 'lib/compressed.css'; */ + + +/* Uncomment the line below to see the grid and baseline. */ +/* .container { background: url(lib/img/grid.png); } */ +/* .container { background: url(lib/img/baseline.png); } */ diff --git a/website/src/css/breadcrumbs.css b/website/src/css/breadcrumbs.css new file mode 100644 index 00000000..86b7470d --- /dev/null +++ b/website/src/css/breadcrumbs.css @@ -0,0 +1,91 @@ +div.breadcrumb-menu { + height: 4.3em; + background-color: black; + width: 100%; +} + +div.breadcrumb-menu ul { + display: block; + margin: 0; + padding: 0; +} + +div.breadcrumb-menu ul li { + display: block; + float: left; +} + +div.breadcrumb-menu ul li a, +div.breadcrumb-menu ul li span { + display: block; + padding: 0.6em 1em 0.6em 1em; + line-height: 1em; + height: 0.9em; +} + +div.breadcrumbs { + position: relative; + top: 0; + left: 0; + height: 2.1em; + background-color: #EFEFEF; + z-index: 10; +} + +div.breadcrumbs ul li { + background-position: center right; + background-repeat: no-repeat; + padding-right: 20px; +} + +div.breadcrumbs ul li.selected { + background-image: none; + padding-right: 0; +} + +div.breadcrumbs ul li.current { + background-image: none; +} + +div.breadcrumbs ul li a { + color: black; + background-color: #EFEFEF; +} + +div.breadcrumbs ul li a:hover { + background-color: #E0E0E0; +} + +div.breadcrumbs ul li.selected a, +div.breadcrumbs ul li.selected a:hover { + color: white; + background-color: black; +} + +div.breadcrumbs ul li.hovered a, +div.breadcrumbs ul li.hovered a:hover { + color: white; + background-color: #AAAAAA; +} + +div.menu { + position: absolute; + background-color: black; + color: white; + z-index: 20; + overflow: hidden; +} + +div.menu ul li a { + color: white; +} + +div.menu ul li a:hover { + text-decoration: underline; +} + +div.menu ul li.current { + padding: 0.6em 1em 0.6em 1em; + line-height: 1em; + background-color: green; +} diff --git a/website/src/css/coderay.css b/website/src/css/coderay.css new file mode 100644 index 00000000..7d16f0b0 --- /dev/null +++ b/website/src/css/coderay.css @@ -0,0 +1,111 @@ +.CodeRay { + padding: 0em; + margin: 1.3em; + background-color: #eee; + border: 1px solid #aaa; + font: 1.1em Monaco, 'Courier New', 'Terminal', monospace; + color: #100; +} + +.CodeRay pre { + padding: 0px; + margin: 0px; + background-color: transparent; + border: none; +} + +div.CodeRay { } + +span.CodeRay { white-space: pre; border: 0px; padding: 2px } + +table.CodeRay { border-collapse: collapse; width: 100%; padding: 2px } +table.CodeRay td { padding: 2px 4px; vertical-align: top } + +.CodeRay .line_numbers, .CodeRay .no { + background-color: #def; + color: gray; + text-align: right; +} +.CodeRay .line_numbers tt { font-weight: bold } +.CodeRay .no { padding: 0px 4px } + +ol.CodeRay { font-size: 10pt } +ol.CodeRay li { white-space: pre } + +.CodeRay .debug { color:white ! important; background:blue ! important; } + +.CodeRay .af { color:#00C } +.CodeRay .an { color:#007 } +.CodeRay .av { color:#700 } +.CodeRay .aw { color:#C00 } +.CodeRay .bi { color:#509; font-weight:bold } +.CodeRay .c { color:#666; } + +.CodeRay .ch { color:#04D } +.CodeRay .ch .k { color:#04D } +.CodeRay .ch .dl { color:#039 } + +.CodeRay .cl { color:#B06; font-weight:bold } +.CodeRay .co { color:#036; font-weight:bold } +.CodeRay .cr { color:#0A0 } +.CodeRay .cv { color:#369 } +.CodeRay .df { color:#099; font-weight:bold } +.CodeRay .di { color:#088; font-weight:bold } +.CodeRay .dl { color:black } +.CodeRay .do { color:#970 } +.CodeRay .ds { color:#D42; font-weight:bold } +.CodeRay .e { color:#666; font-weight:bold } +.CodeRay .en { color:#800; font-weight:bold } +.CodeRay .er { color:#F00; background-color:#FAA } +.CodeRay .ex { color:#F00; font-weight:bold } +.CodeRay .fl { color:#60E; font-weight:bold } +.CodeRay .fu { color:#06B; font-weight:bold } +.CodeRay .gv { color:#d70; font-weight:bold } +.CodeRay .hx { color:#058; font-weight:bold } +.CodeRay .i { color:#00D; font-weight:bold } +.CodeRay .ic { color:#B44; font-weight:bold } + +.CodeRay .il { background: #eee } +.CodeRay .il .il { background: #ddd } +.CodeRay .il .il .il { background: #ccc } +.CodeRay .il .idl { font-weight: bold; color: #888 } + +.CodeRay .in { color:#B2B; font-weight:bold } +.CodeRay .iv { color:#33B } +.CodeRay .la { color:#970; font-weight:bold } +.CodeRay .lv { color:#963 } +.CodeRay .oc { color:#40E; font-weight:bold } +.CodeRay .of { color:#000; font-weight:bold } +.CodeRay .op { } +.CodeRay .pc { color:#038; font-weight:bold } +.CodeRay .pd { color:#369; font-weight:bold } +.CodeRay .pp { color:#579 } +.CodeRay .pt { color:#339; font-weight:bold } +.CodeRay .r { color:#080; font-weight:bold } + +.CodeRay .rx { background-color:#fff0ff } +.CodeRay .rx .k { color:#808 } +.CodeRay .rx .dl { color:#404 } +.CodeRay .rx .mod { color:#C2C } +.CodeRay .rx .fu { color:#404; font-weight: bold } + +.CodeRay .s { background-color:#fff0f0 } +.CodeRay .s .s { background-color:#ffe0e0 } +.CodeRay .s .s .s { background-color:#ffd0d0 } +.CodeRay .s .k { color:#D20 } +.CodeRay .s .dl { color:#710 } + +.CodeRay .sh { background-color:#f0fff0 } +.CodeRay .sh .k { color:#2B2 } +.CodeRay .sh .dl { color:#161 } + +.CodeRay .sy { color:#A60 } +.CodeRay .sy .k { color:#A60 } +.CodeRay .sy .dl { color:#630 } + +.CodeRay .ta { color:#070 } +.CodeRay .tf { color:#070; font-weight:bold } +.CodeRay .ts { color:#D70; font-weight:bold } +.CodeRay .ty { color:#339; font-weight:bold } +.CodeRay .v { color:#036 } +.CodeRay .xt { color:#444 } diff --git a/website/src/css/default.css b/website/src/css/default.css new file mode 100644 index 00000000..890fd7ac --- /dev/null +++ b/website/src/css/default.css @@ -0,0 +1,233 @@ +/* CSS Document by JM (ISeeYou-Designs.com) */ + +body { + background-color:#fff; + font-family:"Trebuchet MS",arial,sans-serif; + font-size:62.5%; + color:#777; + margin:0; + padding:0; +} + +td { + vertical-align: top; +} + +pre { + font-size: 12px; + color: #333; +} +a { + text-decoration:none; + color:#222; +} +a:hover { + color:#c00; +} +acronym { + cursor:help; + border-bottom:1px dotted #ddd; +} +#container { + font-size:1.2em; + width:94%; + margin:0 auto; + border-right:3px double #000; +} +#header { + color:#444; + margin:0; + padding:10px; +} +#header h1 { + font-family:"Trebuchet MS",arial,sans-serif; + font-size:2em; + color:#333; + margin:0; + font-weight:normal; +} +#header h1 strong { + color:#c00; +} +#header h2 { + margin:30px 0 0 0; + font-size:1em; + font-weight:normal; + color:#999; +} +#header h2 strong { + color:#c00; +} +#navigation { + text-align:right; + margin:0 18px 10px auto; + padding:0; +} +#navigation li { + margin:0; + padding:0; + list-style:none; + display:inline; +} +#navigation li a, #navigation li span { + padding:5px 5px 2px 5px; + margin:0 1px 0 1px; + color:#666; + text-decoration:none; + font-weight:bold; + border-bottom:1px solid #c00; +} +#navigation li a:hover { + color:#C00; + border-bottom:1px solid #ddd; +} +#navigation li.webgen-menu-item-selected span, #navigation li.webgen-menu-submenu-inhierarchy span { + color: #000; + border-bottom: 0px; +} +#navigation li.webgen-menu-submenu-inhierarchy a { + color: #000; +} +#navigation li.webgen-menu-submenu-inhierarchy a:hover { + color: #C00; +} +#content { + margin:20px 0 20px 10px; + padding:0; +} +#content p { + padding:2px 20px; + text-align:justify; + line-height:1.4em; +} +#content h1 { + display:block; + margin:50px 0 0 10px; + padding:0; + font-family:"Trebuchet MS",arial,sans-serif; + font-size:1.8em; + color:#c00; + border-color:#ddd; + border-style:solid; + border-width:0 0 1px 0; +} +#content h2 { + display:block; + margin:20px 20px 0 0px; + padding:0; + font-family:"Trebuchet MS",arial,sans-serif; + font-size:1.1em; + letter-spacing:2px; + color:#444; + border-color:#c00; + border-style:solid; + border-width:0 0 1px 0; +} +#content h2 + pre { + margin-top: 2em; +} +#content .post_info { + text-align:right; + margin:0 25px 5px 25px; + padding:2px; + font-size:0.8em; + font-family:arial,sans-serif; + color:#aaa; + line-height:0.9em; + word-spacing:1px; + border-top:1px solid #ddd; +} +#content .post_info a { + text-transform:uppercase; +} +#content blockquote { + margin:10px 60px; + padding:5px; + font-family:"Trebuchet MS",arial,sans-serif; + font-size:0.9em; + color:#444; + border:1px solid #ddd; + background-color:#eee; +} +#content blockquote p { + margin:0; + padding:0; + text-indent:0; +} +#content code { + font-family:monospace; + font-size:1.3em; +} +#content pre { + padding:4px; + margin:18px; + border:1px solid #444; +} +#content ul { + margin-left:-8px; + font-family:arial,sans-serif; +} +#content li { + padding:3px; +} +#footer { + font-size:0.9em; + font-family:arial,sans-serif; + margin:60px 18px 20px 0; + padding:5px; + border-top:1px solid #c00; +} +#footer p { + text-align:right; + line-height:1.1em; + color:#bbb; + font-size:0.9em; + font-family:arial,sans-serif; + margin:0; + padding:0; +} +#footer span { + color:#888; +} +#footer a { + color:#888; +} +#footer a:hover { + color:#aaa; +} + +/* Ruby code, style similar to vibrant ink */ +pre.ruby { + font-size: 10px; + font-family: monospace; + color: white; + background-color: black; + padding: 0.1em 0 0.2em 0; +} + +.keyword { color: #FF6600; } +.constant { color: #339999; } +.attribute { color: white; } +.global { color: white; } +.module { color: white; } +.class { color: white; } +.string { color: #66FF00; } +.ident { color: white; } +.method { color: #FFCC00; } +.number { color: white; } +.char { color: white; } +.comment { color: #9933CC; } +.symbol { color: white; } +.regex { color: #44B4CC; } +.punct { color: white; } +.escape { color: white; } +.interp { color: white; } +.expr { color: white; } + +.offending { background-color: gray; } +.linenum { + width: 75px; + padding: 0.1em 1em 0.2em 0; + color: #000000; + background-color: #FFFBD3; +} \ No newline at end of file diff --git a/website/src/css/site.css b/website/src/css/site.css new file mode 100644 index 00000000..5315cd2a --- /dev/null +++ b/website/src/css/site.css @@ -0,0 +1,59 @@ +--- +extension: css +filter: erb +layout: nil # no layout + +color: + border: "#ddd" + header: "#111" + link: "#125AA7" + link-hover: "#000" + blockquote: "#666" + box-bg: "#eee" + highlight: "#B2CCFF" + quiet: "#666" + alt: "#666" +--- + +body { + font-family: Verdana, "Bitstream Vera Sans", sans-serif; +} + +/* Headings + * --------------------------------------------------------------------- */ +h1,h2,h3,h4,h5,h6 { color: <%= @page.color['header'] %>; } + +/* Text Elements + * --------------------------------------------------------------------- */ +a { color: <%= @page.color['link'] %>; } +a:hover { color: <%= @page.color['link-hover'] %>; } +blockquote { color: <%= @page.color['blockquote'] %>; } + +pre { + background: <%= @page.color['box-bg'] %>; + border: 1px solid <%= @page.color['border'] %>; +} + +hr { + background: <%= @page.color['highlight'] %>; + color: <%= @page.color['highlight'] %>; +} + +/* Tables + * --------------------------------------------------------------------- */ +table { + border-top: 1px solid <%= @page.color['border'] %>; + border-left: 1px solid <%= @page.color['border'] %>; +} +th,td { + border-bottom: 1px solid <%= @page.color['border'] %>; + border-right: 1px solid <%= @page.color['border'] %>; +} + +/* Default Classes + * --------------------------------------------------------------------- */ +p.quiet { color: <%= @page.color['quiet'] %>; } +.alt { color: <%= @page.color['alt'] %>; } + + +/* EOF */ diff --git a/website/src/dispatch.cgi b/website/src/dispatch.cgi new file mode 100755 index 00000000..0ca19d07 --- /dev/null +++ b/website/src/dispatch.cgi @@ -0,0 +1,10 @@ +#!/System/Library/Frameworks/Ruby.framework/Versions/1.8/usr/bin/ruby + +require File.dirname(__FILE__) + "/../config/environment" unless defined?(RAILS_ROOT) + +# If you're using RubyGems and mod_ruby, this require should be changed to an absolute path one, like: +# "/usr/local/lib/ruby/gems/1.8/gems/rails-0.8.0/lib/dispatcher" -- otherwise performance is severely impaired +require "dispatcher" + +ADDITIONAL_LOAD_PATHS.reverse.each { |dir| $:.unshift(dir) if File.directory?(dir) } if defined?(Apache::RubyRun) +Dispatcher.dispatch \ No newline at end of file diff --git a/website/src/dispatch.fcgi b/website/src/dispatch.fcgi new file mode 100755 index 00000000..507ec327 --- /dev/null +++ b/website/src/dispatch.fcgi @@ -0,0 +1,24 @@ +#!/System/Library/Frameworks/Ruby.framework/Versions/1.8/usr/bin/ruby +# +# You may specify the path to the FastCGI crash log (a log of unhandled +# exceptions which forced the FastCGI instance to exit, great for debugging) +# and the number of requests to process before running garbage collection. +# +# By default, the FastCGI crash log is RAILS_ROOT/log/fastcgi.crash.log +# and the GC period is nil (turned off). A reasonable number of requests +# could range from 10-100 depending on the memory footprint of your app. +# +# Example: +# # Default log path, normal GC behavior. +# RailsFCGIHandler.process! +# +# # Default log path, 50 requests between GC. +# RailsFCGIHandler.process! nil, 50 +# +# # Custom log path, normal GC behavior. +# RailsFCGIHandler.process! '/var/log/myapp_fcgi_crash.log' +# +require File.dirname(__FILE__) + "/../config/environment" +require 'fcgi_handler' + +RailsFCGIHandler.process! diff --git a/website/src/dispatch.rb b/website/src/dispatch.rb new file mode 100755 index 00000000..1cf66a09 --- /dev/null +++ b/website/src/dispatch.rb @@ -0,0 +1,10 @@ +# #!/System/Library/Frameworks/Ruby.framework/Versions/1.8/usr/bin/ruby +# +# require File.dirname(__FILE__) + "/../config/environment" unless defined?(RAILS_ROOT) +# +# # If you're using RubyGems and mod_ruby, this require should be changed to an absolute path one, like: +# # "/usr/local/lib/ruby/gems/1.8/gems/rails-0.8.0/lib/dispatcher" -- otherwise performance is severely impaired +# require "dispatcher" +# +# ADDITIONAL_LOAD_PATHS.reverse.each { |dir| $:.unshift(dir) if File.directory?(dir) } if defined?(Apache::RubyRun) +# Dispatcher.dispatch \ No newline at end of file diff --git a/website/src/documentation/before_and_after.page b/website/src/documentation/before_and_after.page new file mode 100644 index 00000000..8d678b45 --- /dev/null +++ b/website/src/documentation/before_and_after.page @@ -0,0 +1,104 @@ +--- +title: Before and After +order: 1 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +h3. before(:each) and after(:each) + +RSpec provides methods that let you set up and tear down state before(:each) +and after(:each) example. + +<% coderay do -%> +describe Account do + before(:each) do + @account = Account.new + end + + it "should have a balance of $0" do + @account.balance.should == Money.new(0) + end + + after(:each) do + # this is here as an example, but is not really + # necessary. Since each example is run in its + # own object, instance variables go out of scope + # between each example. + @account = nil + end +end +<% end -%> + +Note that after(:each) is rarely needed, and should only really be used when concerned +that some state might be leaking into your other examples. + +h3. before(:all) and after(:all) + +For expensive operations, like opening browsers using Spec::Ui, RSpec also allows +you to set up and tear down state before(:all) and after(:all) examples in any +given behaviour. + +<% coderay do -%> +describe "Search page" do + before(:all) do + @browser = Watir::Browser.new + end + + it "should find all contacts" do + ... + end + + after(:all) do + @browser.kill! rescue nil + end +end +<% end -%> + +h3. Global after and before blocks + +Sometimes you have some generic code you want to run before or after every single one of your +examples. Such global before and after blocks can be defined in the RSpec configuration, which +typically lives in a spec_helper.rb file that is required from other spec files. Example: + +<% coderay do -%> +Spec::Runner.configure do |config| + config.before(:all) {} + config.before(:each) {} + config.after(:all) {} + config.after(:each) {} +end +<% end -%> + +Global before blocks get run before local ones. Global after blocks get run after local ones. + +You can also specify that a before or after block should only be weaved into certain behaviours, +in a similar way to how global includes are declared: + +<% coderay do -%> +Spec::Runner.configure do |config| + config.before(:each, :type => :controller) do + login_aslak + end +end +<% end -%> + +h3. When before and after raise errors + +If a before block raises an error, none of the following before blocks (if any) or the example itself will get run. +If an after block raises an error, the remaining ones will still be run. + +h3. %{font-weight:bold; color:red}WARNING ABOUT before(:all) and after(:all)% + +It is very tempting to use before(:all) and after(:all) for situations in which it +is not appropriate. before(:all) shares some (not all) state across multiple examples. This means +that the examples become bound together, which is an absolute no-no in testing. You +should really only ever use before(:all) to set up things that are global collaborators +but not the things that you are describing in the examples. + +The most common cases of abuse are database access and/or fixture setup. Every example +that accesses the database should start with a clean slate, otherwise the examples become +brittle and start to lose their value with false negatives and, worse, false positives. \ No newline at end of file diff --git a/website/src/documentation/expectations.page b/website/src/documentation/expectations.page new file mode 100644 index 00000000..18ec04be --- /dev/null +++ b/website/src/documentation/expectations.page @@ -0,0 +1,14 @@ +--- +title: Expectations +order: 2 +filter: + - erb + - textile +--- + +h2. Spec::Expectations and Spec::Matchers + +When RSpec executes specifications, it defines #should and #should_not on +every object in the system. These methods are your entry to the magic of RSpec. + +See Spec::Expectations and Spec::Matchers in the "RDoc":../rdoc/index.html for more information. \ No newline at end of file diff --git a/website/src/documentation/index.page b/website/src/documentation/index.page new file mode 100644 index 00000000..cb95f9f3 --- /dev/null +++ b/website/src/documentation/index.page @@ -0,0 +1,285 @@ +--- +title: Documentation +order: 1 +filter: + - erb + - textile +--- + +h2. Executable Examples + +RSpec provides a Domain Specific Language with which you can express executable +examples of the expected behaviour of a system. + +Imagine that you were talking to a customer requesting software for her bank. +Part of that conversation might well look like this: + +

    +You:      Describe an account when it is first created.
+Customer: It should have a balance of $0.
+
    + +Here's how we express that conversation in RSpec: + +<% coderay do -%>describe Account, " when first created" do + it "should have a balance of $0" do + ... + end +end +<% end -%> + +When you execute this example, RSpec can provide a report like this: + +
    +Account, when first created
+- should have a balance of $0
+
    + +So we use RSpec to #describe Behaviour of a system using Examples +of how #it should work. + +h2. A Bit More Detail + +Here's how the example might look with some more code filled in: + +<% coderay do -%>describe Account, " when first created" do + + before do + @account = Account.new + end + + it "should have a balance of $0" do + @account.balance.should eql(Money.new(0, :dollars)) + end + + after do + @account = nil + end + +end +<% end -%> + +The #describe method returns an ExampleGroup object, +which contains a group of examples of a particular behaviour of the system +that you wish to describe. Technically, an ExampleGroup is the +equivalent of a fixture in xUnit-speak. It is a metaphor for the context in +which you will execute your example - a set of known objects in a known +starting state. + +The #it method returns an Example object, which represents +an example of the behaviour your are trying to describe. + +The #before and #after methods are just +like #setup and #teardown in xUnit. You use them to +set up the state _before_ each example is executed, and tear down any +resources _after_ each example. + +h2. #before and #after + +You can use #before and/or #after to define code +that executes before and after each example or only once per +ExampleGroup: + +<% coderay do -%>describe Thing do + before(:all) do + # This is run once and only once, before all of the examples + # and before any before(:each) blocks. + end + + before(:each) do + # This is run before each example. + end + + before do + # :each is the default, so this is the same as before(:each) + end + + it "should do stuff" do + ... + end + + it "should do more stuff" do + ... + end + + after(:each) do + # this is before each example + end + + after do + # :each is the default, so this is the same as after(:each) + end + + after(:all) do + # this is run once and only once after all of the examples + # and after any after(:each) blocks + end + +end +<% end -%> + +Warning: The use of #before(:all) and #after(:all) is +generally discouraged because it introduces dependencies between the Examples. +Still, it might prove useful for very expensive operations if you know what you are doing. + +h2. Helper Methods + +You can write helper methods directly within an Example Group: + +<% coderay do -%>describe "..." do + + it "..." do + helper_method + end + + def helper_method + ... + end + +end +<% end -%> + +h2. Reusable Helper Methods + +You can include helper methods in multiple ExampleGroups by expressing them within +a module, and then including that module in your ExampleGroup: + +<% coderay do -%>module AccountExampleHelperMethods + def helper_method + ... + end +end + +describe "A new account" do + include AccountExampleHelperMethods + before do + @account = Account.new + end + + it "should have a balance of $0" do + helper_method + @account.balance.should eql(Money.new(0, :dollars)) + end +end +<% end -%> + +h2. Shared Example Groups + +You can create shared example groups and include those groups into other groups. + +Suppose you have some behavior that applies to all editions of your product, +both large and small. + +First, factor out the "shared" behavior: + +<% coderay do -%> +describe "all editions", :shared => true do + it "should behave like all editions" do + end +end +<% end -%> + +then when you need define the behavior for the Large and Small editions, +reference the shared behavior using the 'it_should_behave_like' method. + +<% coderay do -%>describe "SmallEdition" do + it_should_behave_like "all editions" + + it "should also behave like a small edition" do + end +end + +describe "LargeEdition" do + it_should_behave_like "all editions" + + it "should also behave like a large edition" do + end +end +<% end -%> + +it_should_behave_like will search for an ExampleGroup by its description string, in +this case, "all editions" + +All of the following are included from a shared behavior: + +* before(:all) +* before(:each) +* after(:each) +* after(:all) +* all included modules +* all methods + +Shared example groups may not extend classes. + +Multiple shared example groups may be referenced in one (non-shared) group. + +Shared example groups may be included in other shared groups: + +<% coderay do -%>describe "All Employees", :shared => true do + it "should be payable" do + @employee.should respond_to(:calculate_pay) + end +end + +describe "All Managers", :shared => true do + it_should_behave_like "All Employees" + it "should be bonusable" do + @employee.should respond_to(:apply_bonus) + end +end + +describe Officer do + before(:each) do + @employee = Officer.new + new + it_should_behave_like "All Managers" + + it "should be optionable" do + @employee.should respond_to(:grant_options) + end +end + +$ spec officer_spec.rb + +Officer +- should be payable +- should be bonusable +- should be optionable +<% end -%> + +h2. Pending Examples + +There are three ways to mark an example as "pending." + +h3. Leave out the block: + +<% coderay do -%> +it "should say foo" +<% end -%> + +The output will say PENDING (Not Yet Implemented). + +h3. Use the pending method with no block: + +<% coderay do -%> +it "should say foo" do + pending("get the vocal chords working") + subject.should say("foo") +end +<% end -%> + +The output will say PENDING (get the vocal chords working). + +h3. Use the pending method with a block: + +<% coderay do -%> +it "should say foo" do + pending("get the vocal chords working") do + subject.should say("foo") + end +end +<% end -%> + +The output will say PENDING (get the vocal chords working), and the +example will fail telling you to it is FIXED as soon as the body of +the block raises no errors. diff --git a/website/src/documentation/mocks/index.page b/website/src/documentation/mocks/index.page new file mode 100644 index 00000000..691c3168 --- /dev/null +++ b/website/src/documentation/mocks/index.page @@ -0,0 +1,59 @@ +--- +title: Spec::Mocks +order: 6 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +Mock objects are imitation objects that give you declarative control over +their behaviour in the course of the execution of an example. Defining +"message expectations":message_expectations.html and "method stubs":stubs.html +on mock objects allows you to specify how one object collaborates with others +before those other objects exist. + +You can also use mock objects to isolate your examples from services that are +complex to set up or expensive to run, thereby keeping your suite of examples +running quickly. + +RSpec ships with a built-in mock object framework that lets you create +mock objects in your examples or add mock-object-like behaviour to your +existing objects. + +h3. Creating a mock object + +You create a mock object with the mock method: + +<% coderay do -%> +my_mock = mock(name) +<% end -%> + +This creates a new mock with the given name (a string) and registers it. +When the example finishes, all registered mocks are verified. + +<% coderay do -%> +my_mock = mock(name, stubs_and_options) +<% end -%> + +As above, but allows you to set stub return values for specific messages and +options that tweak the mock's behaviour. Currently the only supported option +is :null_object. Setting this to true instructs the mock to +ignore (quietly consume) any messages it hasn't been told to expect - and +return itself. + +<% coderay do -%> +my_mock = mock("blah", :null_object => true) +<% end -%> + +h3. Notes + +There are many different viewpoints about the meaning of mocks and stubs. If +you are interested in learning more, here is some recommended reading: + +* Mock Objects: "http://www.mockobjects.com/":http://www.mockobjects.com/ +* Endo-Testing:"http://www.mockobjects.com/files/endotesting.pdf":http://www.mockobjects.com/files/endotesting.pdf +* Mock Roles, Not Objects: "http://www.mockobjects.com/files/mockrolesnotobjects.pdf":http://www.mockobjects.com/files/mockrolesnotobjects.pdf +* Test Double Patterns: "http://xunitpatterns.com/Test%20Double%20Patterns.html":http://xunitpatterns.com/Test%20Double%20Patterns.html +* Mocks aren't stubs: "http://www.martinfowler.com/articles/mocksArentStubs.html":http://www.martinfowler.com/articles/mocksArentStubs.html diff --git a/website/src/documentation/mocks/message_expectations.page b/website/src/documentation/mocks/message_expectations.page new file mode 100644 index 00000000..127cd497 --- /dev/null +++ b/website/src/documentation/mocks/message_expectations.page @@ -0,0 +1,321 @@ +--- +title: Message Expectations +order: 1 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +A message expectation (a.k.a. mock method) is an expectation that an object +should receive a specific message during the execution of an example. + +h3. Expecting Messages + +<% coderay do -%> +my_mock.should_receive() +<% end -%> + +The message argument is a symbol that is the name of a message +that you want the mock to expect. + +<% coderay do -%> +my_mock.should_not_receive(:msg) +<% end -%> + +An exception is raised if the message is ever received. +This is equivalent to not specifying the reception of :msg, +but it's more declarative and useful for humans. + +h3. Expecting Arguments + +<% coderay do -%> +my_mock.should_receive(:msg).with() +my_mock.should_receive(:msg).once.with() +<% end -%> + +for example: + +<% coderay do -%> +my_mock.should_receive(:msg).with(1, 2, 3) +my_mock.should_receive(:msg).once.with(1, 2, 3) +<% end -%> + +The args argument is a series of arguments (e.g. 1, 2, 3) that are +expected to be passed as arguments to the associated message. + +<% coderay do -%> +my_mock.should_receive(:msg).with(:no_args) +<% end -%> + +The message (msg) is expected to be passed no arguments. + +<% coderay do -%> +my_mock.should_receive(:msg).with(:any_args) +<% end -%> + +Any arguments (and any number of arguments) are to be accepted. This includes +cases where no arguments are provided. *This is the default when no with() +clause is specified.* Even so, sometimes you want to be explicit about it. + +h3. Argument Constraints + +Constraints can be placed on individual arguments which are looser than value +equivalence (as above). + +h4. :anything + +accepts any value for this argument, e.g.: + +<% coderay do -%> +my_mock.should_receive(:msg).with(1, :anything, "A") +<% end -%> + +h4. :numeric + +accepts any numeric value for this argument, e.g.: + +<% coderay do -%> +my_mock.should_receive(:msg).with(a, :numeric, "b") +<% end -%> + +h4. :boolean + +accepts a boolean value for this argument, e.g.: + +<% coderay do -%> +my_mock.should_receive(:msg).with(a, :boolean, "b") +<% end -%> + +h4. :string + +accepts any string for this argument, e.g.: + +<% coderay do -%> +my_mock.should_receive(:msg).with(a, :string, "b") +<% end -%> + +h4. duck_type(message(s)) + +accepts any object that responds to the prescribed message(s), e.g.: + +<% coderay do -%> +#accepts a Fixnum for the second arg +my_mock.should_receive(:msg).with(a, duck_type(:abs, :div), "b") +<% end -%> + +h4. /regular expressions/ + +matches a String against a regular expression. If a regular expression is submitted, compares the two expressions for equality + +<% coderay do -%> +my_mock.should_receive(:msg).with(/bcd/) + +my_mock.msg "abcde" #passes +my_mock.msg /bcd/ #passes +my_mock.msg "def" #fails +my_mock.msg /bcde/ #fails +<% end -%> + +h3. Receive Counts + +The implicit expectation is that the message passed to should_receive will +be called once. You can make the expected counts explicit using the following: + +h4. Precise Counts + +<% coderay do -%> +my_mock.should_receive(:msg).once +<% end -%> + +An exception is raised if the message is never received, or it is received more than once. + +<% coderay do -%> +my_mock.should_receive(:msg).twice +<% end -%> + +An exception is raised if the message is received anything but two times. + +<% coderay do -%> +my_mock.should_receive(:msg).exactly(n).times +<% end -%> + +An exception is raised if the message is received anything but n times. + +h4. Relative Counts - at_least + +<% coderay do -%> +my_mock.should_receive(:msg).at_least(:once) +<% end -%> + +An exception is raised if the message is never received. + +<% coderay do -%> +my_mock.should_receive(:msg).at_least(:twice) +<% end -%> + +An exception is raised if the message is never received or is received only once. + +<% coderay do -%> +my_mock.should_receive(:msg).at_least(n).times +<% end -%> + +An exception is raised if the message is received fewer than n times. + +h4. Relative Counts - at_most + +<% coderay do -%> +my_mock.should_receive(:msg).at_most(:once) +<% end -%> + +An exception is raised if the message is received more than once (does not raise if message is never receieved). + +<% coderay do -%> +my_mock.should_receive(:msg).at_most(:twice) +<% end -%> + +An exception is raised if the message is received more than twice (does not raise if message is never receieved). + +<% coderay do -%> +my_mock.should_receive(:msg).at_most(n).times +<% end -%> + +An exception is raised if the message is received more than n times (does not raise if message is never receieved). + +h4. Explicitly Imprecise Counts + +<% coderay do -%> +my_mock.should_receive(:msg).any_number_of_times +<% end -%> + +The message can be received 0 or more times. + +h3. Return Values + +h4. Single return value + +<% coderay do -%> +my_mock.should_receive(:msg).once.and_return() +<% end -%> + +Each time the expected message is received, value will be returned as the result. + +h4. Consecutive return values + +<% coderay do -%> +and_return(, , ..., ) +<% end -%> + +When the expected message is received, value-i will be returned as +the result for the ith reception of the message. After the message has been +received i times, value-n is returned for all +subsequent receives. + +h4. Computed return value + +<% coderay do -%> +my_mock.should_receive(:msg).once.and_return {...} +<% end -%> + +When the expected message is received, the result of evaluating the supplied +block will be returned as the result. The block is passed any arguments passed +as arguments of the message. This capability can be used to compute return +values based on the arguments. For example: + +<% coderay do -%> +my_mock.should_receive(:msg).with(:numeric, :numeric) once.and_return {|a, b| a + b} +<% end -%> + +h3. Raising and Throwing + +<% coderay do -%> +my_mock.should_receive(:msg).once.and_raise() +<% end -%> + +Tells the mock to raise an exception instead of returning a value. +<exception> may be any Exception class, an instance of +any Exception class, or a String (in which case a RuntimeError will be raised +with that String as its message). + +<% coderay do -%> +my_mock.should_receive(:msg).once.and_throw() +<% end -%> + +Tells the mock to throw a symbol instead of returning a value. + +h3. Yielding + +<% coderay do -%> +my_mock.should_receive(:msg).once.and_yield(, , ..., ) +<% end -%> + +When the expected message is received, the mock will yield the values to the passed block. + +To mock a method which yields values multiple times, and_yield can be chained. + +<% coderay do -%> +my_mock.should_receive(:msg).once.and_yield(, , ..., ). + and_yield(, , ..., ). + and_yield(, , ..., ) +<% end -%> + +h3. Ordering + +There are times when you want to specify the order of messages sent to a mock. +It shouldn't be the case very often, but it can be handy at times. + +Labeling expectations as being ordered is done by the ordered call: + +<% coderay do -%> +my_mock.should_receive(:flip).once.ordered +my_mock.should_receive(:flop).once.ordered +<% end -%> + +If the send of flop is seen before flip the specification will fail. + +Of course, chains of ordered expectations can be set up: + +<% coderay do -%> +my_mock.should_receive(:one).ordered +my_mock.should_receive(:two).ordered +my_mock.should_receive(:three).ordered +<% end -%> + +The expected order is the order in which the expectations are declared. + +Order-independent expectations can be set anywhere in the expectation sequence, in any order. +Only the order of expectations tagged with the ordered call is significant. +Likewise, calls to order-independent methods can be made in any order, even interspersed with +calls to order-dependent methods. For example: + +<% coderay do -%> +my_mock.should_receive(:zero) +my_mock.should_receive(:one).ordered +my_mock.should_receive(:two).ordered +my_mock.should_receive(:one_and_a_half) + +# This will pass: +my_mock.one +my_mock.one_and_a_half +my_mock.zero +my_mock.two +<% end -%> + +h3. Arbitrary Handling of Received Messages + +You can supply a block to a message expectation. When the message is received +by the mock, the block is passed any arguments and evaluated. The result is +the return value of the block. For example: + +<% coderay do -%> +my_mock.should_receive(:msg) { |a, b| + a.should be_true + b.should_not include('mice') + "Chunky bacon!" +} +<% end -%> + +This allows arbitrary argument validation and result computation. It's handy and kind of cool to be able to +do this, but it is advised to not use this form in most situations. Mocks should not be functional. +They should be completely declarative. That said, it's sometimes useful to give them some minimal behaviour. diff --git a/website/src/documentation/mocks/other_frameworks.page b/website/src/documentation/mocks/other_frameworks.page new file mode 100644 index 00000000..d0e01dfa --- /dev/null +++ b/website/src/documentation/mocks/other_frameworks.page @@ -0,0 +1,61 @@ +--- +title: Other Mock/Stub Frameworks +order: 4 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +If you prefer to use a mocking framework other than RSpec's built in framework, you +can do this quite simply. RSpec currently supports use of the following frameworks +out of the box (in alphabetical order): + +* "flexmock":http://flexmock.rubyforge.org/ +* "mocha":http://mocha.rubyforge.org +* "rr":http://rubyforge.org/projects/pivotalrb/ + +RSpec supports use of a single framework per project, because these frameworks (including) +RSpec's own, tend to add methods to Object that might or might not work well together. To +choose a mock framework other than rspec, simply add the following to spec/spec_helper.rb +(or any file that gets loaded when you run your examples): + +<% coderay do -%> +Spec::Runner.configure do |config| + config.mock_with :rr +end +<% end -%> + +Valid options are :flexmock, :mocha, :rspec (of course), +and :rr. + +h2. Even more "other" frameworks + +If you have a different framework that is not supported directly by RSpec, you can easily +choose that framework instead by creating an adapter and telling RSpec where to find it. +Here is RSpec's own adapter as an example: + +<% coderay do -%><%= IO.read "../example_rails_app/vendor/plugins/rspec/plugins/mock_frameworks/rspec.rb" %><% end -%> + +This file must require any libraries or resources that implement the framework, and then define +a Spec::Plugins::MockFramework module with the following methods: + +* setup_mocks_for_rspec is called before each example is run. +* verify_mocks_for_rspec is called after each example is run. Use this if you want +RSpec to automatically verify your mocks after each example. You must supply this method either +way, but you can leave it empty if your framework doesn't support auto-verification. +* teardown_mocks_for_rspec is guaranteed to be run after each example even when there +are errors. Use this to ensure that there is no state shared across example, clearing out changes +to static resources like class-level mock expectations, etc. + +Once you have defined your adapter, you can then tell RSpec to use your adapter like so: + +<% coderay do -%> +Spec::Runner.configure do |config| + config.mock_with '/path/to/my/adapater.rb' +end +<% end -%> + + + diff --git a/website/src/documentation/mocks/partial_mocks.page b/website/src/documentation/mocks/partial_mocks.page new file mode 100644 index 00000000..7c6b3aa5 --- /dev/null +++ b/website/src/documentation/mocks/partial_mocks.page @@ -0,0 +1,30 @@ +--- +title: Mock Object behaviour on Real Objects +order: 3 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +RSpec allows you to add mock object behaviour to real objects, so you can set +"message expectations":message_expectations.html and "method stubs":stubs.html +on any object in your system. + +One common use of this support is isolating examples from ActiveRecord (and +therefore the database) in Ruby on Rails examples. + +<% coderay do -%> +MyModel.should_receive(:find).with(id).and_return(@mock_model_instance) +<% end -%> + +Controlling the behaviour of the class level methods (for example, having them +return a mock object instead of a real instance of the model class) allows you +to describe your controllers and views in isolation from the instance level +logic of your model classes. This means that you can change the validation +rules for a model, for example, and drive that in the model examples without +affecting the controller and view examples. + +This also helps to keep the context of your example completely in view (no +having to look at fixtures/xyz.yml to understand what's going on). \ No newline at end of file diff --git a/website/src/documentation/mocks/stubs.page b/website/src/documentation/mocks/stubs.page new file mode 100644 index 00000000..b9fce97f --- /dev/null +++ b/website/src/documentation/mocks/stubs.page @@ -0,0 +1,66 @@ +--- +title: Method Stubs +order: 2 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +A method stub is an implementation of a method that returns a canned response. + +The main difference between a method stub and a "message +expectation":message_expectations.html is that message expectations verify +interactions that you expect, while method stubs just sit there and return +values. + +h3. Setting an explicit return value + +This is the simplest (and recommended) approach to stubbing. + +<% coderay do -%> +my_instance.stub!(:msg).and_return(value) +MyClass.stub!(:msg).and_return(value) +<% end -%> + +h3. Calculating a return value + +<% coderay do -%> +my_instance.stub!(:msg).and_return { ... } +MyClass.stub!(:msg).and_return { ... } +<% end -%> + +While this is possible, it is generally to be avoided. Calculating a value to +return defeats the declarative nature of stubs. + +h3. Multiple return values + +<% coderay do -%> +my_instance.stub!(:msg).and_return("1",2) +MyClass.stub!(:msg).and_return("1",2) +<% end -%> + +This will return "1" the first time it is called and 2 every subsequent call. Like +calculated return values, this is a little un-stubby, but it can be a handy feature +once in a while. + +h3. Mixing method stubs and message expectations + +In some cases it can be helpful to stub a default return value, but set a +message expectation for a specific set of args. For example: + +<% coderay do -%> +A.stub!(:msg).and_return(:default_value) +A.should_receive(:msg).with(:arg).and_return(:special_value) +A.msg +=> :default_value +A.msg(:any_other_arg) +=> :default_value +A.msg(:arg) +=> :special_value +A.msg(:any_other_other_arg) +=> :default_value +A.msg +=> :default_value +<% end -%> \ No newline at end of file diff --git a/website/src/documentation/rails/generators.page b/website/src/documentation/rails/generators.page new file mode 100644 index 00000000..2ee5068c --- /dev/null +++ b/website/src/documentation/rails/generators.page @@ -0,0 +1,31 @@ +--- +title: Generators +order: 3 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +Spec::Rails contains generators that you can use to generate models and RESTful controllers +in a similar fashion to Rails' builtin generators. The only difference is that they generate specs instead +of tests and fixtures will be put under the spec folder. Example: + +
    +ruby script/generate rspec_scaffold purchase order_id:integer created_at:datetime amount:decimal
+
    + +or + +
    +ruby script/generate rspec_model person
+
    + +or + +
    +ruby script/generate rspec_controller person
+
    + +For more information on each generator, just run them without any arguments. \ No newline at end of file diff --git a/website/src/documentation/rails/index.page b/website/src/documentation/rails/index.page new file mode 100644 index 00000000..3b6f0450 --- /dev/null +++ b/website/src/documentation/rails/index.page @@ -0,0 +1,100 @@ +--- +title: Spec::Rails +order: 7 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +A Rails plugin that brings RSpec to Rails. + +h3. Features + +* Use RSpec to independently specify models, views, controllers and helpers. +* Integrated fixture loading. +* Special generators for models and controllers that generate specs instead of tests. +* Special RSpec matchers for even more readable specs. + +h3. Vision + +For people for whom TDD is a brand new concept, the testing support built into Rails is a huge +leap forward. The fact that it's built right in is fantastic, and Rails +apps are generally much easier to maintain than they would have been without such support. + +For those of us coming from a history with TDD, and now BDD, the existing support +presents some problems related to dependencies across specs. To that end, RSpec +supports 4 types of specs. This is largely inspired by Test::Rails, which is +the rails testing framework built into "ZenTest":http://zentest.rubyforge.org. +We've also built in first class mocking and stubbing support in order to +break dependencies across these different concerns. + +h2. Different Types of Example Groups + +Spec::Rails supports different ExampleGroup subclasses for the following types of specs: + +h3. Model Examples + +These are the equivalent of unit tests in Rails' built in testing. Ironically +(for the traditional TDD'er) these are the only specs that we feel should actually interact +with the database. "Learn more ...":writing/models.html. + +h3. Controller Examples + +These align somewhat with functional tests in rails, except +that they do not actually render views (though you can force rendering of views +if you prefer). Instead of setting expectations about what goes on a page, you +set expectations about what templates get rendered. "Learn more...":writing/controllers.html. + +h3. View Examples + +This is the other half of Rails' functional testing. View specs allow +you to set up assigns (thanks to ZenTest). "Learn more ...":writing/views.html. + +h3. Helper Examples + +... let you specify directly methods that live in your helpers. "Learn more ...":writing/helpers.html. + +h3. User Stories for Integration Testing + +RSpec 1.1 introduces a Story Runner for running Scenarios related to User Stories. +This release ships with a new (and somewhat experimental) rails-specific extension +that supports running scenarios for you rails app. This RailsStory derives from +ActionController::IntegrationTest, which gives you access to all the services of +Rails Integration Testing within RSpec Stories/Scenarios. "Learn more ...":writing/stories.html. + +h2. Fixtures + +You can use fixture in any of your specs, be they model, view, controller, or helper. If you have fixtures that you want to use +globally, you can set them in spec/spec_helper.rb. See that file for more information. + +h2. Naming conventions + +For clarity and consistency, RSpec uses a slightly different naming convention +for directories and Rake tasks than what you get from the Test::Unit testing built into rails. + +<% coderay do -%> +project + | + +--app + | + +--components + | + +--... + | + +--spec + | + +-- spec_helper.rb + | + +-- controllers + | + +-- helpers + | + +-- models + | + +-- views +<% end -%> + +The Rake tasks are named accordingly. + diff --git a/website/src/documentation/rails/runners.page b/website/src/documentation/rails/runners.page new file mode 100644 index 00000000..114fe31c --- /dev/null +++ b/website/src/documentation/rails/runners.page @@ -0,0 +1,74 @@ +--- +title: Runners +order: 4 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +h3. Standard spec command + +
    +script/spec path/to/directory/with/specs
+script/spec path/to/individual_spec.rb
+
    + +h3. Run specs fast with −−drb (recommended) + +Loading the entire Rails environment every time a spec is executed is quite slow. +To speed things up, Spec::Rails installs a daemon script that loads the local Rails app +and listens for incoming connections via DRb. + +Open up a separate shell and start the spec server: + +
    +script/spec_server
+
    + +Now you can run specs with the −−drb flag. +If you're using Rake you should add −−drb to the spec/spec.opts file. + +Note that there are some classes and modules that, by default, won't get reloaded +by Rails, which means they won't be reloaded by spec_server. There are a number +of strategies available for coercing Rails to reload files every time in a given +environment. See the Rails documentation for more information. + +h3. Running specs with Rake + +Note that the rake tasks don't use the fast rails_spec command - it uses the +standard spec. Also note that it is pre-configured to run any file that ends +in "_spec", so you'll have to follow that convention. + +Note that you can configure the options passed to RSpec by editing the spec/spec.opts file. + +All specs (excluding plugins) can be run with... + +
    +rake spec
+rake spec:app
+
    + +All specs including plugins can be run with... + +
    +rake spec:all
+
    + +You can also isolate Model, Controller, View, Helper or Plugin specs with... + +
    +rake spec:models
+rake spec:controllers
+rake spec:views
+rake spec:helpers
+rake spec:plugins
+
    + +To see all the RSpec related tasks, run + +
    +rake --tasks spec
+
    + diff --git a/website/src/documentation/rails/writing/controllers.page b/website/src/documentation/rails/writing/controllers.page new file mode 100644 index 00000000..0afc0905 --- /dev/null +++ b/website/src/documentation/rails/writing/controllers.page @@ -0,0 +1,162 @@ +--- +title: Controllers +order: 3 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +Controller Examples live in $RAILS_ROOT/spec/controllers/. + +In contrast to Test::Unit, where the controller is initialized in the setup method, +with Spec::Raiks you don't. Instead, pass the controller class to the describe method. +Spec::Rails automatically instantiates a controller for you, which you can access +from the examples (it blocks) using the controller method. + +h2. Isolation from views + +Spec::Rails has the ability to specify your controllers in complete +isolation from their related views. This allows you to spec your controllers +before the views even exist, and will keep the specs from failing when there +are errors in your views. + +h2. Optional integration with views + +If you prefer to integrate views (a la rails functional testing) you can by including +the keyword/commmand "integrate_views". + +<% coderay do -%> +describe ArticlesController do + integrate_views + ... +end +<% end -%> + +When you integrate views in the controller specs, you can use any of the +expectations that are specific to views as well. Read about "View Examples":views.html +to learn more. + +h2. Isolation from the database + +We strongly recommend that you use RSpec's "mocking/stubbing framework":../../mocks/index.html +to intercept class level calls like :find, :create and +even :new to introduce mock instances instead of real active_record instances. + +This allows you to focus your specs on the things that the controller does and not +worry about complex validations and relationships that should be described in +detail in the "Model Examples":models.html + +<% coderay do -%> +account = mock_model(Account) +Account.should_receive(:find).with("37").and_return(account) +<% end -%> + +or + +<% coderay do -%> +account = mock_model(Account) +Account.stub!(:find).and_return(account) +<% end -%> + +See "Mocks and Stubs":../../mocks/index.html for more information about the +built in mocking/stubbing framework. + +h2. Response Expectations + +These expectations will work whether in isolation or integration mode. See "Spec::Rails::Expectations":../../../rdoc-rails/index.html for details. + +h3. response.should be_success + +Passes if a status of 200 was returned. NOTE that in isolation mode, this will +always return true, so it's not that useful - but at least your specs won't break. + +<% coderay do -%> +response.should be_success +<% end -%> + +h3. response.should be_redirect + +Passes if a status of 300-399 was returned. + +<% coderay do -%> +response.should be_redirect +<% end -%> + +h3. response.should render_template + +<% coderay do -%> +get 'some_action' +response.should render_template("path/to/template/for/action") +<% end -%> + +h3. response.should have_text + +<% coderay do -%> +get 'some_action' +response.should have_text("expected text") +<% end -%> + +h3. response.should redirect_to + +<% coderay do -%> +get 'some_action' +response.should redirect_to(:action => 'other_action') +<% end -%> + +The following forms are supported: + +<% coderay do -%> +response.should redirect_to(:action => 'other_action') +response.should redirect_to('path/to/local/redirect') +response.should redirect_to('http://test.host/some_controller/some_action') +response.should redirect_to('http://some.other.domain.com') +<% end -%> + +h2. Rendering Expectations + +In addition to response.should render_template, described above, you can state more explicit rendering +expectations using controller.expect_render and controller.stub_render. If you have an action that +renders a partial, for example: + +<% coderay do -%> +controller.expect_render(:partial => 'person', :object => @person) #auto-verified +controller.stub_render(:partial => 'person', :object => @person) #not verified +<% end -%> + +%{color:red;font-weight:bold}WARNING%: expect_render and stub_render, while very useful, act +differently from standard Message Expectations (a.k.a. mock expectations), which would never pass calls +through to the real object. This can be very confusing when there are failures if you're not aware of this +fact, because some calls will be passed through while others will not. This is especially confusing when +you use stub_render because, as with all Method Stubs, you will get very little feedback +about what is going on. + +h3. assigns, flash and session + +Use these to access assigns, flash and session. + +<% coderay do -%> +assigns[:key] +flash[:key] +session[:key] +<% end -%> + +h2. Routing Expectations + +Specify the paths generated by custom routes. + +<% coderay do -%> +route_for(:controller => "hello", :action => "world").should == "/hello/world" +<% end -%> + +Specify the parameters generated from routes. + +<% coderay do -%> +params_from(:get, "/hello/world").should == {:controller => "hello", :action => "world"} +<% end -%> + + +h2. Sample Controller Example + +<% coderay do -%><%= IO.read "../example_rails_app/spec/controllers/people_controller_spec.rb" %><% end -%> diff --git a/website/src/documentation/rails/writing/helpers.page b/website/src/documentation/rails/writing/helpers.page new file mode 100644 index 00000000..214a424d --- /dev/null +++ b/website/src/documentation/rails/writing/helpers.page @@ -0,0 +1,33 @@ +--- +title: Helpers +order: 4 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +Helper Examples live in $RAILS_ROOT/spec/helpers/. + +Writing specs for your helpers is a snap. Just tell the Example Group the name of the +helper ... + +<% coderay do -%> +describe RegistrationHelper do + ... +end +<% end -%> + +... and the Example Group will expose an object that includes the helper. + +h2. Conveniences + +h3. assigns + +Use assigns[:key] to set instance variables to be used in the view that +includes the helper. See example below. + +h2. Example Helper Spec + +<% coderay do -%><%= IO.read "../example_rails_app/spec/helpers/people_helper_spec.rb" %><% end -%> diff --git a/website/src/documentation/rails/writing/index.page b/website/src/documentation/rails/writing/index.page new file mode 100644 index 00000000..0b52a017 --- /dev/null +++ b/website/src/documentation/rails/writing/index.page @@ -0,0 +1,42 @@ +--- +title: Writing +order: 2 +filter: + - erb + - textile +--- + +h2. Introduction to Writing Examples using Spec::Rails + +Spec::Rails supports 4 different types of Executable Examples: + +* "Model Examples":models.html +* "View Examples":views.html +* "Controller Examples":controllers.html +* "Helper Examples":helpers.html + +Each of these use specialized ExampleGroup subclasses to give you access to +the appropriate services and methods. The specific type of ExampleGroup is +determined implicitly by placing the examples in an appropriately named file +(*_spec.rb) within an appropriately named directory: + +
    +spec/controllers/**/*_spec.rb
+spec/helpers/**/*_spec.rb
+spec/models/**/*_spec.rb
+spec/views/**/*_spec.rb
+
    + +%{color:red;font-weight:bold}WARNING:% If you do not follow these conventions, +you will not get the correct ExampleGroup subclass. If you prefer to disregard +this convention, you can get the correct ExampleGroup subclass by passing a +hash to the describe method: + +<% coderay do -%> +describe "some model", :type => :model do + ... +end +<% end -%> + +This works with :model, :view, :controller and :helper. + diff --git a/website/src/documentation/rails/writing/models.page b/website/src/documentation/rails/writing/models.page new file mode 100644 index 00000000..05b5d043 --- /dev/null +++ b/website/src/documentation/rails/writing/models.page @@ -0,0 +1,38 @@ +--- +title: Models +order: 1 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +Model Examples live in $RAILS_ROOT/spec/models/ and provide access to fixtures. + +h2. Expectations + +Model Examples support the following custom expectations. +See "Spec::Rails::Expectations":../../../rdoc-rails/index.html for more detail. + +h3. Records + +<% coderay do -%> +Model.should have(:no).records +Model.should have(1).record +Model.should have(3).records +<% end -%> + +This is a shortcut for Model.find(:all).length.should == 3. + +h3. Errors + +<% coderay do -%> +model.should have(:no).errors_on(:attribute) +model.should have(1).error_on(:attribute) +model.should have(3).errors_on(:attribute) +<% end -%> + +h2. Sample Model Examples + +<% coderay do -%><%= IO.read "../example_rails_app/spec/models/person_spec.rb" %><% end -%> diff --git a/website/src/documentation/rails/writing/notes.txt b/website/src/documentation/rails/writing/notes.txt new file mode 100644 index 00000000..435f4999 --- /dev/null +++ b/website/src/documentation/rails/writing/notes.txt @@ -0,0 +1,21 @@ + +There +are two opposing forces that guide decisions about how to structure specs in relation +to the code being specified: + +* Rapid Fault Isolation. When we introduce a bug in the system, we want (ideally) only ONE +spec to fail. We certainly learn something when several fail, but it is often a sign +of coupling not only in the specs, but in the design as well. + +* Freedom to Refactor. When we want to change implementation without changing +behavior, we want to do so without changing specs. This is a core tenet of TDD +and an even more obvious part of our approach to BDD. Behaviour is its first name. + +The tension created between these two forces is that Rapid Fault Isolation +guides us to write specs that are as close to the implementation as possible, while +Freedom to Refactor guides us to write them as far from the implementation as +possible. + +BDD is all about balancing these two forces. There is no right answer as to how +to do this. The best advice we can give is to be aware of these two forces and +be aware of the effects of one pulling harder than the other. \ No newline at end of file diff --git a/website/src/documentation/rails/writing/stories.page b/website/src/documentation/rails/writing/stories.page new file mode 100644 index 00000000..71fe61eb --- /dev/null +++ b/website/src/documentation/rails/writing/stories.page @@ -0,0 +1,9 @@ +--- +title: User Stories and Scenarios +order: 5 +filter: + - erb + - textile +--- + +Docs coming soon ... diff --git a/website/src/documentation/rails/writing/views.page b/website/src/documentation/rails/writing/views.page new file mode 100644 index 00000000..b050d29b --- /dev/null +++ b/website/src/documentation/rails/writing/views.page @@ -0,0 +1,135 @@ +--- +title: Views +order: 2 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +View Examples live in $RAILS_ROOT/spec/views/. + +Spec::Rails supports the specification of views in complete isolation from their controllers. +This allows you to spec and write your views even before their controllers exist, +or before the related actions have been developed. It also means that bugs introduced +into controllers will not cause view specs to fail. + +As noted in the "introduction":index.html, these are great benefits +but they could hide bugs that exist in the interaction between a controller and its +view. We strongly recommend combining these isolated view specs with some sort of +high level integration testing, ideally using "RSpec stories":stories.html + +Here are some of the methods available to you, but see "Spec::Rails::Expectations":../../../rdoc-rails/index.html for more detail. + +h2. Conveniences + +h3. assigns + +Use assigns[:key] to set instance variables to be used in the view. We highly recommend that +you exploit the mock framework here rather than providing real model objects in order to +keep the view specs isolated from changes to your models. + +<% coderay do -%> +# example +article = mock_model(Article) +article.should_receive(:author).and_return("Joe") +article.should_receive(:text).and_return("this is the text of the article") +assigns[:article] = article +assigns[:articles] = [article] + +# template +<%% for article in @articles -%> + +<% end -%> + +h3. flash, params and session + +Use flash[:key], params[:key] and session[:key] to set values in the example that can +be accessed by the view. + +<% coderay do -%> +# example +flash[:notice] = "Message in flash" +params[:account_id] = "1234" +session[:user_id] = "5678" + +# template +<%%= flash[:notice] %> +<%%= params[:account_id] %> +<%%= session[:user_id] %> +<% end -%> + +h2. Expectations + +Spec::Rails' View Examples support the following custom expectations. + +h3. template.expect_render/stub_render + +This is a custom mock-like expectation that allows you to set expectations about partials and included +files that will be rendered, intercepting those calls to the #render method, while ignoring other calls +and passing them on to ActionView::Base. expect_render is verified at the end of the +example, while stub_render is not. + +%{color:red;font-weight:bold}WARNING%: expect_render and stub_render, while very useful, act +differently from standard Message Expectations (a.k.a. mock expectations), which would never pass calls +through to the real object. This can be very confusing when there are failures if you're not aware of this +fact, because some calls will be passed through while others will not. This is especially confusing when +you use stub_render because, as with all Method Stubs, you will get very little feedback +about what is going on. + +<% coderay do -%> +template.expect_render(:partial => 'person', :object => @person) #auto-verified +template.stub_render(:partial => 'person', :object => @person) #not verified +<% end -%> + + +h3. response.should have_tag + +This wraps assert_select and is available in both View Examples and Controller Examples run in integration mode. + +<% coderay do -%> +response.should have_tag('div') #passes if any div tags appear +response.should have_tag('div#interesting_div') +response.should have_tag('div', 'expected content') +response.should have_tag('div', /regexp matching expected content/) +response.should have_tag('form[action=?]', things_path) +response.should have_tag("input[type=?][checked=?]", 'checkbox', 'checked') +response.should have_tag('ul') do + with_tag('li', 'list item 1') + with_tag('li', 'list item 2') + with_tag('li', 'list item 3') +end +<% end -%> + +Note that any of the hash values can be either Strings or Regexps and will be +evaluated accordingly. + +h3. response[:capture].should have_tag + +This way you can access content that has been captured with content_for. + + +# example +response[:sidebar].should have_tag('div') + +# template +<% content_for :sidebar do %> +

    Sidebar content here

    +<% end %> +     + +h2. Mocking and stubbing helpers + +If you wish to mock or stub helper methods, this must be done on the template object: + +<% coderay do -%> +template.should_receive(:current_user).and_return(mock("user")) +<% end -%> + +%{color:red;font-weight:bold}WARNING:% Do NOT use mocks on the template object for expecting partials. +Instead, use expect_render or stub_render, described above. + +h2. Sample View Examples + +<% coderay do -%><%= IO.read "../example_rails_app/spec/views/people/list_view_spec.rb" %><% end -%> diff --git a/website/src/documentation/specs.page b/website/src/documentation/specs.page new file mode 100644 index 00000000..f60163be --- /dev/null +++ b/website/src/documentation/specs.page @@ -0,0 +1,9 @@ +--- +title: Specs +order: 3 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> \ No newline at end of file diff --git a/website/src/documentation/stories.page b/website/src/documentation/stories.page new file mode 100644 index 00000000..620d3e7e --- /dev/null +++ b/website/src/documentation/stories.page @@ -0,0 +1,18 @@ +--- +title: Stories +order: 5 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +Sorry folks but we just haven't had a chance to get any docs up on this. Here are some resources: + +"http://dannorth.net/whats-in-a-story":http://dannorth.net/whats-in-a-story
    +"http://evang.eli.st/blog/2007/10/8/story-runner-top-to-bottom-screencast":http://evang.eli.st/blog/2007/10/8/story-runner-top-to-bottom-screencast
    +"https://peepcode.com/products/rspec-user-stories":https://peepcode.com/products/rspec-user-stories
    +"http://blog.davidchelimsky.net/articles/tag/stories":http://blog.davidchelimsky.net/articles/tag/stories
    + +We'll have more soon. Stay tuned ... \ No newline at end of file diff --git a/website/src/documentation/test_unit.page b/website/src/documentation/test_unit.page new file mode 100644 index 00000000..6246f11a --- /dev/null +++ b/website/src/documentation/test_unit.page @@ -0,0 +1,81 @@ +--- +title: Test::Unit +order: 4 +filter: + - erb + - textile +--- + +h2. Coming from Test::Unit to RSpec + +RSpec's expectation API is a superset of Test::Unit's assertion API. Use this table to +find the RSpec equivalent of Test::Unit's asserts. + +| Test::Unit | RSpec | Comment | +| assert(object) | N/A | | +| assert_block {...} | lambda {...}.call.should be_true| | +| assert_equal(expected, actual) | actual.should == expected | Uses == | +| '' | actual.should eql(expected) | Uses Object.eql? | +| assert_in_delta(expected_float, actual_float, delta) | actual_float.should be_close(expected_float, delta) | | +| assert_instance_of(klass, object) | actual.should be_an_instance_of(klass) | | +| assert_match(pattern, string) | string.should match(regexp) | | +| '' | string.should =~ regexp | | +| assert_nil(object) | actual.should be_nil | | +| assert_no_match(regexp, string) | string.should_not match(regexp) | | +| assert_not_equal(expected, actual) | actual.should_not eql(expected) | Uses !Object.eql? | +| assert_not_nil(object) | actual.should_not be_nil | | +| assert_not_same(expected, actual) | actual.should_not equal(nil) | Uses Object.equal? | +| assert_nothing_raised(*args) {...} | lambda {...}.should_not raise_error(Exception=nil, message=nil) | +| assert_nothing_thrown {...} | lambda {...}.should_not throw_symbol(symbol=nil) | +| assert_operator(object1, operator, object2) | N/A | | +| assert_raise(*args) {...} | lambda {...}.should raise_error(Exception=nil, message=nil) | +| assert_raises(*args) {...} | lambda {...}.should raise_error(Exception=nil, message=nil) | +| assert_respond_to(object, method) | actual.should respond_to(method) | | +| assert_same(expected, actual) | actual.should equal(expected) | Uses !Object.equal? | +| assert_send(send_array) | N/A | | +| assert_throws(expected_symbol, &proc) | lambda {...}.should throw_symbol(symbol=nil) | | +| flunk(message="Flunked") | violated(message=nil) | | +| N/A | actual.should_be_something | Passes if object.something? is true | + +h2. Regarding Equality + +RSpec lets you express equality the same way Ruby does. This is different from +Test::Unit and other xUnit frameworks, and this may cause some confusion for those +of you who are making a switch. + +Consider this example: + +<% coderay do -%>words = "the words" +assert_equals("the words", words) #passes +assert_same("the words", words) #fails +<% end -%> + +xUnit frameworks traditionally use method names like #assert_equals to +imply object equivalence (objects with the same values) and method names like #assert_same to +imply object identity (actually the same object). For programmers who are used to this syntax, +it makes perfect sense to see this in a unit testing framework for Ruby. + +The problem that we found is that Ruby handles equality differently from other languages. In +java, for example, we override Object#equals(other) to describe object equivalence, +whereas we use == to describe object identity. In Ruby, we do just the opposite. +In fact, Ruby provides us with four ways to express equality: + +<% coderay do -%>a == b +a === b +a.equal?(b) +a.eql?(b) +<% end -%> + +Each of these has its own semantics, which can (and often do) vary from class to class. In +order to minimize the translation required to understand what an example might be expressing, +we chose to express these directly in RSpec. If you understand Ruby equality, then you +can understand what RSpec examples are describing: + +<% coderay do -%>a.should == b #passes if a == b +a.should === b #passes if a === b +a.should equal(b) #passes if a.equal?(b) +a.should eql(b) #passes if a.eql?(b) +<% end -%> + +See "http://www.ruby-doc.org/core/classes/Object.html#M001057":http://www.ruby-doc.org/core/classes/Object.html#M001057 for +more information about equality in Ruby. \ No newline at end of file diff --git a/website/src/documentation/tools/extensions/editors/index.page b/website/src/documentation/tools/extensions/editors/index.page new file mode 100644 index 00000000..02041188 --- /dev/null +++ b/website/src/documentation/tools/extensions/editors/index.page @@ -0,0 +1,56 @@ +--- +title: Editors +order: 1 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +RSpec's commandline API and pluggable formatters makes it very easy to integrate it with external tools +such as text editors (including IDEs). Below we describe the general steps you need to perform to write +an RSpec plugin for your editor. + +The RSpec team maintains a TextMate bundle which does exactly this. You may want to look at its source if +you're about to write a plugin for a new editor. + +We'd be happy to accept more editor plugins into RSpec. Please see "Contribute":../../../../community/contribute.html for +details. Or, if you're a developer of an editor, perhaps you want to bundle it with the editor. + +h3. Launch RSpec from the IDE + +Most advanced editors provide a mechanism to launch external processes by hitting a keystroke. +Depending on your editor, you may want to launch RSpec directly via the spec spec command +(which must be on your $PATH). Alternatively, if your editor makes it possible to run Ruby scripts +directly, you may execute RSpec via Spec::Runner::CommandLine.run (which has a similar API to +the spec command, except you can call it straight from Ruby without forking a new Ruby process). + +h3. Tell RSpec what spec(s) to run + +You may want to assign different keystrokes to run your specs. You could run All specs in your project, +the ones in the currently open file or just the one you have focussed in the editor. +RSpec's commandline API has a --line option which will make RSpec run the spec at the current +line (it also works if the line is inside the spec). +Most editors provide a way to query the current file and the line of the cursor when launching an external +process, and you can use this to feed the right argument to the --line option. + +h3. Make the backtrace work with your editor + +When a spec fails, the backtrace is displayed in the error message. The backtrace contains lines with +file paths and line numbers. Most editors have a mechanism that will open the file and put the +cursor on the right line when such a line is clicked - provided the line is on a format that the editor +understands. + +It is possible to customise the backtrace lines of RSpec's output to achieve this. All you need to do is +to implement your own Formatter class, typically by subclassing +"ProgressBarFormatter":../rdoc/classes/Spec/Runner/Formatter/ProgressBarFormatter.html or "HtmlFormatter":../rdoc/classes/Spec/Runner/Formatter/HtmlFormatter.html +(depending on what your editor understands). In your formatter class you +can override the backtrace_line method to make the output be something that works with your editor. +Example: + +<% coderay do -%><%= IO.read "../example_rails_app/vendor/plugins/rspec/examples/pure/custom_formatter.rb" %><% end -%> + +Then, when the editor plugin launches RSpec, just make sure it uses the --formatter +option to specify *your* custom formatter. Note that you will probably have to use --require +too, so that the code for your custom formatter is loaded. See spec --help for details. diff --git a/website/src/documentation/tools/extensions/editors/textmate.page b/website/src/documentation/tools/extensions/editors/textmate.page new file mode 100644 index 00000000..13da6027 --- /dev/null +++ b/website/src/documentation/tools/extensions/editors/textmate.page @@ -0,0 +1,62 @@ +--- +title: TextMate +order: 1 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +TextMate is a popular text editor for OS X. RSpec's TextMate bundle has a big number of snippets for +all of RSpec's expectations, contexts and specify's. You can even run specs from TextMate using +CMD-R - and you'll see a nice progress bar while the specs are running (except +usually they run so fast you won't be able to see it move). + +If you select one or more directories or files you can run those too with CMD-R (but you have to have +an arbitrary Ruby file open to make this work). + +h2. Installation + +There are several ways to install the RSpec bundle for TextMate. We'll start by the easiest. + +h3. Installing from RubyForge + +Just download the tgz file from RubyForge, unpack it and double-click the RSpec.tmbundle icon. +It is very important that your installed Ruby gem is a compatible version. + +h3. Installing from GitHub straight into your TextMate + +
    +cd ~/Library/Application\ Support/TextMate/Bundles/
+git clone git://github.com/dchelimsky/rspec-tmbundle.git RSpec.tmbundle
+
    + +h3. Symlinking an existing RSpec.tmbundle GitHuv clone to TextMate + +If you already have the RSpec.tmbundle checked out somewhere, you can make a symbolic link +from TextMate's bundle directory to your working copy of the bundle: + +
    +ln -s path/to/checked/out/RSpec.tmbundle ~/Library/Application\ Support/TextMate/Bundles/RSpec.tmbundle
+
    + +h2. Pointing to the right Ruby and RSpec. + +You may need to adjust the PATH in your ~/.MacOSX/environment.plist file to point to the directory +where your ruby and spec executables live. For example: + +
    +PATH
+/usr/local/bin:/usr/local/sbin:/usr/local/mysql/bin:/opt/local/bin:/usr/local/mysql/bin
+
    + +You may also have to set your TM_RUBY environment variable in TextMate's preferences to point to your ruby executable. + +You can also tell RSpec.tmbundle to use a particular RSpec (the library) at a particular location on your filesystem. +Just define the TM_RSPEC_HOME environment variable in TextMate's preferences. This should +point to the your working copy's rspec directory. + +h2. Setting RSpec command line options + +You can specify these in the TM_RSPEC_OPTS environment variable in TextMate's preferences. \ No newline at end of file diff --git a/website/src/documentation/tools/extensions/index.page b/website/src/documentation/tools/extensions/index.page new file mode 100644 index 00000000..204f17a0 --- /dev/null +++ b/website/src/documentation/tools/extensions/index.page @@ -0,0 +1,19 @@ +--- +title: Extensions +order: 5 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +RSpec extensions typically come in two different kinds: API extensions and runner extensions. + +h3. API Extensions + +API extensions are extensions to RSpec's core expectation API. + +h3. Runner Extensions + +Runner extensions can consist of plugins to other tools (such as editors and IDEs) as well as custom RSpec formatters. diff --git a/website/src/documentation/tools/heckle.page b/website/src/documentation/tools/heckle.page new file mode 100644 index 00000000..91815d40 --- /dev/null +++ b/website/src/documentation/tools/heckle.page @@ -0,0 +1,23 @@ +--- +title: Heckle +order: 4 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +RSpec has tight integration with "Heckle":https://rubyforge.org/projects/seattlerb/. Heckle is a tool inspired from +"Jester":http://jester.sourceforge.net/. + +RSpec's Heckle support will run your specs many times, each time with a tiny mutation to your code (the +application code, not the spec code). + +The idea is that if your specs still pass after the code has been mutated, then your specs are incomplete, +and RSpec will tell you. + +h3. Running specs with Heckle + +Just use the --heckle option and give it an argument, which should be the full name of a module +or a method. Run spec --help for further details. \ No newline at end of file diff --git a/website/src/documentation/tools/index.page b/website/src/documentation/tools/index.page new file mode 100644 index 00000000..a7d6cc56 --- /dev/null +++ b/website/src/documentation/tools/index.page @@ -0,0 +1,56 @@ +--- +title: Tools +order: 8 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +RSpec combines several tools in one package + +h3. 1) A language for expressing behavior + +RSpec provides programmers with a domain specific language for defining expected behavior of Ruby code. + +h3. 2) A runner for verifying behavior + +RSpec provides a command line utility for executing behavior specifications. + +h3. 3) Mock objects + +Mock objects frameworks usually come as separate add-ons to existing XUnit frameworks. In RSpec it's an integrated +part of the framework. + +h3. 4) Testdox-like reports + +Expressing behavior in real sentences improves communication between programmer, +analysts and testers. It also helps programmers keep a more critical mind about the code being developed. + +RSpec's built in support for generating "testdox-like":http://agiledox.sourceforge.net/ reports makes the code's behavior more transparent +to everybody (assuming you publish it to a webpage where everybody who needs to can see it). + +h3. 5) RCov Coverage tool integration + +While coverage tools cannot prove that you have verified everything there is to verify about your code, +they can prove when you have not verified everything there is to verify about your code. RCov is such a +coverage tool, and RSpec supports it out-of the box via its Rake task. + +h3. 6) Coverage threshold verification + +Except for the times when programmers agree to keep a close eye on coverage and keep it at, say 90%, it +will inevitably drop when they get other things to think about and start to write code in the wild. + +RSpec ships with a special Rake task that can verify that the coverage remains on a level defined by the +development team. Should the coverage drop, the build will fail, and developers are encouraged to address +it right away. + +h3. 7) Integrated diffing + +When you run specs with the --diff option, you'll see unified diffs when Strings don't match. +Very useful when your specs are comparing big strings! + +h3. 8) Mutation with Heckle + +The --heckle option will run your specs with mutations. \ No newline at end of file diff --git a/website/src/documentation/tools/rake.page b/website/src/documentation/tools/rake.page new file mode 100644 index 00000000..1ac77dab --- /dev/null +++ b/website/src/documentation/tools/rake.page @@ -0,0 +1,32 @@ +--- +title: Rake Tasks +order: 2 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +RSpec comes with a "Rake":http://rake.rubyforge.org/ task for executing specs. +See "Spec::Rake::SpecTask":../../rdoc/classes/Spec/Rake/SpecTask.html API for details. + +h3. Rake task example + +This is a snippet from RSpec's own Rakefile. It creates a task to run the examples. + +<% coderay do -%><%= IO.read "../example_rails_app/vendor/plugins/rspec/rake_tasks/examples.rake" %><% end -%> + +It can be invoked from the command line with: + +
    +rake examples
+
    + +Also see the "RCov":rcov.html page for info about how to generate a coverage report. + +h3. Generate HTML report + +<% coderay do -%><%= IO.read "../example_rails_app/vendor/plugins/rspec/rake_tasks/failing_examples_with_html.rake" %><% end -%> + +This will write a HTML file that looks like "this":failing_examples.html. diff --git a/website/src/documentation/tools/rcov.page b/website/src/documentation/tools/rcov.page new file mode 100644 index 00000000..5fa7bb05 --- /dev/null +++ b/website/src/documentation/tools/rcov.page @@ -0,0 +1,51 @@ +--- +title: RCov +order: 3 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +RSpec has tight integration with "RCov":http://eigenclass.org/hiki.rb?rcov, the excellent code coverage tool for Ruby. + +h3. Running specs with RCov + +The easiest way to use RCov with RSpec is from a rake script (Rakefile), using RSpec's +"Rake task":rake.html. The snippet below is from RSpec's own Rakefile. + +<% coderay do -%><%= IO.read "../example_rails_app/vendor/plugins/rspec/rake_tasks/examples_with_rcov.rake" %><% end -%> + +By adding rcov=true to the rake task, specs will be run with RCov +instead of the standard ruby interpreter, and a coverage report like +"this":../../coverage/index.html will be generated with the following command line: + +
    +rake examples_with_rcov
+
    + +Also, because you don't want your example files to be included in the coverage report (you just +want them to run), don't forget to add t.rcov_opts = ['--exclude', 'examples']. You +can use this to exclude any other files that must be required but should not be measured (just +use a comma separated list). + +h3. Coverage threshold + +You can guard your codebase's coverage from dropping below a certain threshold +by using RSpec's built-in task for verification of the total RCov coverage. +(This is not the same as RCov's --threshold option, which is a filtering mechanism). + +<% coderay do -%><%= IO.read "../example_rails_app/vendor/plugins/rspec/rake_tasks/verify_rcov.rake" %><% end -%> + +This will give you a :verify_rcov task that will fail your build if the +coverage drops below the threshold you define. +If it's too low you're encouraged to write more specs rather than "fix" +the threshold value (which should usually only be adjusted upwards). + +In fact, the task will also fail the build if the coverage raises above the threshold as well. +This might seem a bit counterintuitive, but this is when you should go and raise the +threshold in your Rakefile. This way you won't miss temporary coverage increases. Crank it up! +This is how we got to 100% coverage for RSpec. + +See "RCov::VerifyTask":../../rdoc/classes/RCov/VerifyTask.html for details. diff --git a/website/src/documentation/tools/spec.page b/website/src/documentation/tools/spec.page new file mode 100644 index 00000000..5043ef38 --- /dev/null +++ b/website/src/documentation/tools/spec.page @@ -0,0 +1,60 @@ +--- +title: Command Line +order: 1 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +h2. Executing examples directly + +Any file RSpec examples can be run directly from the command line: + +
    +$ ruby path/to/my_spec.rb [options]
+
    + +This will print the results to STDOUT. Use the --help option for more details. This is +practical when you only want to run one file. If you want to run more, use the spec +command or the Rake task. + +h2. The spec command + +After you install RSpec, you should have the spec command on your PATH. +This command can be used to process several files in one go. + +Any number of files, directories and shell globs can be provided, all ruby source files +that are found are loaded. To see this in action, cd to the RSpec install directory +(normally under /usr/local/lib/ruby/gems/1.8/gems/rspec-x.y.z/) and type spec examples: + +
    +$ spec examples
+
+<%= `ruby docspec.rb examples` %>
+
    + +Very simple and to the point. Passing examples are indicated by a '.', +failing ones by a 'F'. Note that failure indicates a violated expectation as +well as an unexpected exception being raised. Here are examples of both: + +
    +$ spec failing_examples/team_spec.rb
+
+<%= `ruby docspec.rb failing_examples/predicate_example.rb` %>
+
    + +h2. Command line options + +When you run spec with the --help option it prints a help message: + +
    +$ spec --help
+
+<%= `ruby docspec.rb --help` %>
+
    + +The command line options can be passed to customize the output and behaviour of RSpec. +The options apply whether specs are run in standalone mode (by executing the .rb files directly with ruby), +or using the spec command. diff --git a/website/src/download.page b/website/src/download.page new file mode 100644 index 00000000..70055dc5 --- /dev/null +++ b/website/src/download.page @@ -0,0 +1,26 @@ +--- +title: Download +order: 4 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +h3. Rubygems + +
    +gem install rspec
+
    + +or if you want an older version: + +
    +gem install rspec -v 1.0.8
+
    + +h3. From source (at "github":http://github.com) + +"http://github.com/dchelimsky/rspec/wikis/home":http://github.com/dchelimsky/rspec/wikis/home
    +"http://github.com/dchelimsky/rspec-rails/wikis/home":http://github.com/dchelimsky/rspec-rails/wikis/home diff --git a/website/src/examples.page b/website/src/examples.page new file mode 100644 index 00000000..5697f1de --- /dev/null +++ b/website/src/examples.page @@ -0,0 +1,24 @@ +--- +title: Examples +order: 2 +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +Here is an example of a spec for a Stack. We start with a group of shared examples. +These won't get run directly, but can be included by, and run in the context of +other example groups. + +<% coderay do -%><%= IO.read "../example_rails_app/vendor/plugins/rspec/examples/pure/shared_stack_examples.rb" %><% end -%> + +And here is the group that runs them. Note the nesting, which is a new feature in +RSpec 1.1. + +<% coderay do -%><%= IO.read "../example_rails_app/vendor/plugins/rspec/examples/pure/stack_spec_with_nested_example_groups.rb" %><% end -%> + +And here is what you see when you run these examples in TextMate: + + \ No newline at end of file diff --git a/website/src/images/David_and_Aslak.jpg b/website/src/images/David_and_Aslak.jpg new file mode 100644 index 00000000..c037c840 Binary files /dev/null and b/website/src/images/David_and_Aslak.jpg differ diff --git a/website/src/images/Whats_That_Dude.jpg b/website/src/images/Whats_That_Dude.jpg new file mode 100644 index 00000000..45faf258 Binary files /dev/null and b/website/src/images/Whats_That_Dude.jpg differ diff --git a/website/src/images/ali_westside.jpg b/website/src/images/ali_westside.jpg new file mode 100644 index 00000000..ae2d1bb1 Binary files /dev/null and b/website/src/images/ali_westside.jpg differ diff --git a/website/src/images/arrow.gif b/website/src/images/arrow.gif new file mode 100644 index 00000000..e355f3b9 Binary files /dev/null and b/website/src/images/arrow.gif differ diff --git a/website/src/images/ducks1.png b/website/src/images/ducks1.png new file mode 100644 index 00000000..4c4a76a8 Binary files /dev/null and b/website/src/images/ducks1.png differ diff --git a/website/src/images/eylogo.gif b/website/src/images/eylogo.gif new file mode 100644 index 00000000..e453f1c9 Binary files /dev/null and b/website/src/images/eylogo.gif differ diff --git a/website/src/images/pat_maddox.jpg b/website/src/images/pat_maddox.jpg new file mode 100644 index 00000000..4c50ea55 Binary files /dev/null and b/website/src/images/pat_maddox.jpg differ diff --git a/website/src/images/stack_example_tm_report.jpg b/website/src/images/stack_example_tm_report.jpg new file mode 100644 index 00000000..3938c5d2 Binary files /dev/null and b/website/src/images/stack_example_tm_report.jpg differ diff --git a/website/src/images/test_unit.graffle b/website/src/images/test_unit.graffle new file mode 100644 index 00000000..63a5721f --- /dev/null +++ b/website/src/images/test_unit.graffle @@ -0,0 +1,767 @@ + + + + + ActiveLayerIndex + 0 + AutoAdjust + + CanvasColor + + w + 1 + + CanvasOrigin + {0, 0} + CanvasScale + 1 + ColumnAlign + 1 + ColumnSpacing + 36 + CreationDate + 2007-09-17 13:15:30 +0200 + Creator + Aslak Hellesoy + DisplayScale + 1 in = 1 in + GraphDocumentVersion + 5 + GraphicsList + + + Bounds + {{572.625, 41}, {133.875, 196}} + Class + ShapedGraphic + FitText + Vertical + Flow + Resize + ID + 76 + Shape + Rectangle + Style + + fill + + Draws + NO + + shadow + + Draws + NO + + stroke + + Draws + NO + + + Text + + Align + 0 + Text + {\rtf1\mac\ansicpg10000\cocoartf824\cocoasubrtf420 +{\fonttbl\f0\fswiss\fcharset77 Helvetica;} +{\colortbl;\red255\green255\blue255;} +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural\pardirnatural + +\f0\fs24 \cf0 If Test::Unit is loaded (we can check if Test::Unit is defined?) the bridge gets loaded and the Test::Unit runner is used. It delegates work to RSpec's independent runner.\ +\ +Examples get TestCase as superclass\ +} + + + + Bounds + {{10.5, 63.6599}, {133.875, 112}} + Class + ShapedGraphic + FitText + Vertical + Flow + Resize + ID + 75 + Shape + Rectangle + Style + + fill + + Draws + NO + + shadow + + Draws + NO + + stroke + + Draws + NO + + + Text + + Align + 0 + Text + {\rtf1\mac\ansicpg10000\cocoartf824\cocoasubrtf420 +{\fonttbl\f0\fswiss\fcharset77 Helvetica;} +{\colortbl;\red255\green255\blue255;} +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural\pardirnatural + +\f0\fs24 \cf0 Classic specs (when Test::Unit is not required/loaded)\ +\ +Only RSpec's runner is used, Example does *not* have TestCase as superclass} + + + + Bounds + {{169.365, 11.4316}, {386.999, 371.661}} + Class + ShapedGraphic + ID + 74 + Rotation + 317 + Shape + Circle + Style + + fill + + Color + + b + 0.20978 + g + 1 + r + 0.986404 + + Draws + NO + + stroke + + Color + + b + 0.184314 + g + 0.623529 + r + 0.976471 + + Width + 2 + + + + + Bounds + {{10.457, 156.076}, {349.632, 199.579}} + Class + ShapedGraphic + ID + 2 + Rotation + 317 + Shape + Circle + Style + + fill + + Color + + b + 0.20978 + g + 1 + r + 0.986404 + + Draws + NO + + stroke + + Color + + b + 1 + g + 0.0321779 + r + 0 + + Width + 2 + + + + + Class + LineGraphic + Head + + ID + 13 + + ID + 72 + Points + + {408.47, 314.92} + {458, 297} + {481.839, 211.482} + + Style + + stroke + + HeadArrow + FilledArrow + LineType + 1 + TailArrow + 0 + + + Tail + + ID + 68 + + + + Class + LineGraphic + Head + + ID + 56 + + ID + 70 + Points + + {308.542, 311.093} + {265, 292} + {245.99, 211.487} + + Style + + stroke + + HeadArrow + FilledArrow + LineType + 1 + TailArrow + 0 + + + Tail + + ID + 68 + + + + Class + Group + Graphics + + + Bounds + {{309, 306}, {99, 54}} + Class + ShapedGraphic + ID + 68 + Shape + Rectangle + Text + + Text + {\rtf1\mac\ansicpg10000\cocoartf824\cocoasubrtf420 +{\fonttbl\f0\fswiss\fcharset77 Helvetica;} +{\colortbl;\red255\green255\blue255;} +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\qc + +\f0\fs24 \cf0 Intermingled tests and specs} + + + + Bounds + {{309, 297}, {29.1176, 9}} + Class + ShapedGraphic + ID + 69 + Shape + Rectangle + + + ID + 67 + + + Class + LineGraphic + Head + + ID + 56 + + ID + 66 + Points + + {169.458, 311.256} + {216, 291} + {233.463, 211.488} + + Style + + stroke + + HeadArrow + FilledArrow + LineType + 1 + TailArrow + 0 + + + Tail + + ID + 64 + + + + Class + Group + Graphics + + + Bounds + {{70, 306}, {99, 54}} + Class + ShapedGraphic + ID + 64 + Shape + Rectangle + Text + + Text + {\rtf1\mac\ansicpg10000\cocoartf824\cocoasubrtf420 +{\fonttbl\f0\fswiss\fcharset77 Helvetica;} +{\colortbl;\red255\green255\blue255;} +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\qc + +\f0\fs24 \cf0 Specs not using\ +Test::Unit} + + + + Bounds + {{70, 297}, {29.1176, 9}} + Class + ShapedGraphic + ID + 65 + Shape + Rectangle + + + ID + 63 + + + Class + LineGraphic + Head + + ID + 13 + + ID + 62 + Points + + {408.494, 90.6914} + {469, 100} + {482.792, 156.514} + + Style + + stroke + + HeadArrow + FilledArrow + LineType + 1 + TailArrow + 0 + + + Tail + + ID + 53 + + + + Class + LineGraphic + Head + + ID + 56 + + ID + 22 + Points + + {308.509, 92.358} + {257, 102} + {245.367, 156.511} + + Style + + stroke + + HeadArrow + FilledArrow + LineType + 1 + TailArrow + 0 + + + Tail + + ID + 53 + + + + Class + Group + Graphics + + + Bounds + {{190, 157}, {99, 54}} + Class + ShapedGraphic + ID + 56 + Shape + Rectangle + Text + + Text + {\rtf1\mac\ansicpg10000\cocoartf824\cocoasubrtf420 +{\fonttbl\f0\fswiss\fcharset77 Helvetica;} +{\colortbl;\red255\green255\blue255;} +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\qc + +\f0\fs24 \cf0 RSpec core} + + + + Bounds + {{190, 148}, {29.1176, 9}} + Class + ShapedGraphic + ID + 57 + Shape + Rectangle + + + ID + 55 + + + Class + Group + Graphics + + + Bounds + {{309, 56}, {99, 54}} + Class + ShapedGraphic + ID + 53 + Shape + Rectangle + Text + + Text + {\rtf1\mac\ansicpg10000\cocoartf824\cocoasubrtf420 +{\fonttbl\f0\fswiss\fcharset77 Helvetica;} +{\colortbl;\red255\green255\blue255;} +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\qc + +\f0\fs24 \cf0 RSpec\ +Test::Unit\ +bridge} + + + + Bounds + {{309, 47}, {29.1176, 9}} + Class + ShapedGraphic + ID + 54 + Shape + Rectangle + + + ID + 52 + + + Class + Group + Graphics + + + Bounds + {{440, 157}, {99, 54}} + Class + ShapedGraphic + ID + 13 + Shape + Rectangle + Text + + Text + {\rtf1\mac\ansicpg10000\cocoartf824\cocoasubrtf420 +{\fonttbl\f0\fswiss\fcharset77 Helvetica;} +{\colortbl;\red255\green255\blue255;} +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\qc + +\f0\fs24 \cf0 Test::Unit} + + + + Bounds + {{440, 148}, {29.1176, 9}} + Class + ShapedGraphic + ID + 14 + Shape + Rectangle + + + ID + 12 + + + GridInfo + + GuidesLocked + NO + GuidesVisible + YES + HPages + 1 + ImageCounter + 1 + IsPalette + NO + KeepToScale + + Layers + + + Lock + NO + Name + Layer 1 + Print + YES + View + YES + + + LayoutInfo + + LinksVisible + NO + MagnetsVisible + NO + MasterSheet + Master 1 + MasterSheets + + + ActiveLayerIndex + 0 + AutoAdjust + + CanvasColor + + w + 1 + + CanvasOrigin + {0, 0} + CanvasScale + 1 + ColumnAlign + 1 + ColumnSpacing + 36 + DisplayScale + 1 in = 1 in + GraphicsList + + GridInfo + + HPages + 1 + IsPalette + NO + KeepToScale + + Layers + + + Lock + NO + Name + Layer 1 + Print + YES + View + YES + + + LayoutInfo + + Orientation + 2 + OutlineStyle + Basic + RowAlign + 1 + RowSpacing + 36 + SheetTitle + Master 1 + UniqueID + 1 + VPages + 1 + + + ModificationDate + 2007-09-28 00:25:33 +0200 + Modifier + Aslak Hellesoy + NotesVisible + NO + Orientation + 2 + OriginVisible + NO + OutlineStyle + Basic + PageBreaks + YES + PrintInfo + + NSBottomMargin + + float + 0 + + NSLeftMargin + + float + 0 + + NSOrientation + + int + 1 + + NSPaperSize + + size + {792, 612} + + NSRightMargin + + float + 0 + + NSTopMargin + + float + 0 + + + ReadOnly + NO + RowAlign + 1 + RowSpacing + 36 + SheetTitle + Canvas 1 + SmartAlignmentGuidesActive + YES + SmartDistanceGuidesActive + YES + UniqueID + 1 + UseEntirePage + + VPages + 1 + WindowInfo + + CurrentSheet + 0 + DrawerOpen + + DrawerTab + Outline + DrawerWidth + 209 + FitInWindow + + Frame + {{137, 96}, {916, 584}} + ShowRuler + + ShowStatusBar + + VisibleRegion + {{-72, -57}, {901, 470}} + Zoom + 1 + + + diff --git a/website/src/images/test_unit.png b/website/src/images/test_unit.png new file mode 100644 index 00000000..a0330d44 Binary files /dev/null and b/website/src/images/test_unit.png differ diff --git a/website/src/index.page b/website/src/index.page new file mode 100644 index 00000000..14952513 --- /dev/null +++ b/website/src/index.page @@ -0,0 +1,149 @@ +--- +title: Overview +filter: + - erb + - textile +--- + +h2. <%= @page.title %> + +RSpec is a Behaviour Driven Development framework for Ruby. It provides two +frameworks for writing and executing examples of how your Ruby application should +behave: + + * a Story Framework for describing behaviour at the application level + * a Spec Framework for describing behaviour at the object level + +h2. Story Framework + +Start by writing a Story with one or more Scenarios in plain text, using the following +format. + +
    +Story: transfer from savings to checking account
+  As a savings account holder
+  I want to transfer money from my savings account to my checking account
+  So that I can get cash easily from an ATM
+
+  Scenario: savings account has sufficient funds
+    Given my savings account balance is $100
+    And my checking account balance is $10
+    When I transfer $20 from savings to checking
+    Then my savings account balance should be $80
+    And my checking account balance should be $30
+
+  Scenario: savings account has insufficient funds
+    Given my savings account balance is $50
+    And my checking account balance is $10
+    When I transfer $60 from savings to checking
+    Then my savings account balance should be $50
+    And my checking account balance should be $10
+
    + +Each Given, When and Then is a Step. The Ands are each the same kind as the previous Step. +Steps get defined in Ruby like this (detail left out for brevity): + +<% coderay(:lang => 'ruby') do -%> +steps_for(:accounts) do + Given("my $account_type account balance is $amount") do |account_type, amount| + create_account(account_type, amount) + end + When("I transfer $amount from $source_account to $target_account") do |amount, source_account, target_account| + get_account(source_account).transfer(amount).to(get_account(target_account)) + end + Then("my $account_type account balance should be $amount") do |account_type, amount| + get_account(account_type).should have_a_balance_of(amount) + end +end +<% end -%> + +Then run the Story like this: + +<% coderay(:lang => 'ruby') do -%> +with_steps_for :accounts do + run 'path/to/file/with/story' +end +<% end -%> + +h2. Spec Framework + + + + + + +
    +

    + Start with a very simple example that expresses + some basic desired behaviour. +

    + +<% coderay do -%> +# bowling_spec.rb +require 'bowling' + +describe Bowling do + before(:each) do + @bowling = Bowling.new + end + + it "should score 0 for gutter game" do + 20.times { @bowling.hit(0) } + @bowling.score.should == 0 + end +end +<% end -%> + +

    + Run the example and watch it fail. +

    +
    $ spec bowling_spec.rb 
+./bowling_spec.rb:4:
+  uninitialized constant Bowling
+
    +     		+

    + Now write + just enough code to make it pass. +

    + +<% coderay do -%> +# bowling.rb +class Bowling + def hit(pins) + end + + def score + 0 + end +end +<% end -%> +

    +Run the example and bask in the joy that is green. +

    + +
    $ spec bowling_spec.rb --format specdoc
+
+Bowling
+- should score 0 for gutter game
+
+Finished in 0.007534 seconds
+
+1 example, 0 failures
+
    +
    + +h2. Take very small steps + +Don't rush ahead with more code. Instead, add another +example and let it guide you to what you have +to do next. And don't forget to take time +to refactor your code before it gets messy. You should keep +your code clean at every step of the way. + +h2. Take the first step now! + +
    $ gem install rspec
    + +(See special installation instructions for "Spec::Rails":http://github.com/dchelimsky/rspec-rails/wikis/home) + diff --git a/website/src/javascripts/application.js b/website/src/javascripts/application.js new file mode 100644 index 00000000..fe457769 --- /dev/null +++ b/website/src/javascripts/application.js @@ -0,0 +1,2 @@ +// Place your application-specific JavaScript functions and classes here +// This file is automatically included by javascript_include_tag :defaults diff --git a/website/src/javascripts/controls.js b/website/src/javascripts/controls.js new file mode 100644 index 00000000..fbc4418b --- /dev/null +++ b/website/src/javascripts/controls.js @@ -0,0 +1,963 @@ +// Copyright (c) 2005-2007 Thomas Fuchs (http://script.aculo.us, http://mir.aculo.us) +// (c) 2005-2007 Ivan Krstic (http://blogs.law.harvard.edu/ivan) +// (c) 2005-2007 Jon Tirsen (http://www.tirsen.com) +// Contributors: +// Richard Livsey +// Rahul Bhargava +// Rob Wills +// +// script.aculo.us is freely distributable under the terms of an MIT-style license. +// For details, see the script.aculo.us web site: http://script.aculo.us/ + +// Autocompleter.Base handles all the autocompletion functionality +// that's independent of the data source for autocompletion. This +// includes drawing the autocompletion menu, observing keyboard +// and mouse events, and similar. +// +// Specific autocompleters need to provide, at the very least, +// a getUpdatedChoices function that will be invoked every time +// the text inside the monitored textbox changes. This method +// should get the text for which to provide autocompletion by +// invoking this.getToken(), NOT by directly accessing +// this.element.value. This is to allow incremental tokenized +// autocompletion. Specific auto-completion logic (AJAX, etc) +// belongs in getUpdatedChoices. +// +// Tokenized incremental autocompletion is enabled automatically +// when an autocompleter is instantiated with the 'tokens' option +// in the options parameter, e.g.: +// new Ajax.Autocompleter('id','upd', '/url/', { tokens: ',' }); +// will incrementally autocomplete with a comma as the token. +// Additionally, ',' in the above example can be replaced with +// a token array, e.g. { tokens: [',', '\n'] } which +// enables autocompletion on multiple tokens. This is most +// useful when one of the tokens is \n (a newline), as it +// allows smart autocompletion after linebreaks. + +if(typeof Effect == 'undefined') + throw("controls.js requires including script.aculo.us' effects.js library"); + +var Autocompleter = { } +Autocompleter.Base = Class.create({ + baseInitialize: function(element, update, options) { + element = $(element) + this.element = element; + this.update = $(update); + this.hasFocus = false; + this.changed = false; + this.active = false; + this.index = 0; + this.entryCount = 0; + this.oldElementValue = this.element.value; + + if(this.setOptions) + this.setOptions(options); + else + this.options = options || { }; + + this.options.paramName = this.options.paramName || this.element.name; + this.options.tokens = this.options.tokens || []; + this.options.frequency = this.options.frequency || 0.4; + this.options.minChars = this.options.minChars || 1; + this.options.onShow = this.options.onShow || + function(element, update){ + if(!update.style.position || update.style.position=='absolute') { + update.style.position = 'absolute'; + Position.clone(element, update, { + setHeight: false, + offsetTop: element.offsetHeight + }); + } + Effect.Appear(update,{duration:0.15}); + }; + this.options.onHide = this.options.onHide || + function(element, update){ new Effect.Fade(update,{duration:0.15}) }; + + if(typeof(this.options.tokens) == 'string') + this.options.tokens = new Array(this.options.tokens); + // Force carriage returns as token delimiters anyway + if (!this.options.tokens.include('\n')) + this.options.tokens.push('\n'); + + this.observer = null; + + this.element.setAttribute('autocomplete','off'); + + Element.hide(this.update); + + Event.observe(this.element, 'blur', this.onBlur.bindAsEventListener(this)); + Event.observe(this.element, 'keydown', this.onKeyPress.bindAsEventListener(this)); + }, + + show: function() { + if(Element.getStyle(this.update, 'display')=='none') this.options.onShow(this.element, this.update); + if(!this.iefix && + (Prototype.Browser.IE) && + (Element.getStyle(this.update, 'position')=='absolute')) { + new Insertion.After(this.update, + ''); + this.iefix = $(this.update.id+'_iefix'); + } + if(this.iefix) setTimeout(this.fixIEOverlapping.bind(this), 50); + }, + + fixIEOverlapping: function() { + Position.clone(this.update, this.iefix, {setTop:(!this.update.style.height)}); + this.iefix.style.zIndex = 1; + this.update.style.zIndex = 2; + Element.show(this.iefix); + }, + + hide: function() { + this.stopIndicator(); + if(Element.getStyle(this.update, 'display')!='none') this.options.onHide(this.element, this.update); + if(this.iefix) Element.hide(this.iefix); + }, + + startIndicator: function() { + if(this.options.indicator) Element.show(this.options.indicator); + }, + + stopIndicator: function() { + if(this.options.indicator) Element.hide(this.options.indicator); + }, + + onKeyPress: function(event) { + if(this.active) + switch(event.keyCode) { + case Event.KEY_TAB: + case Event.KEY_RETURN: + this.selectEntry(); + Event.stop(event); + case Event.KEY_ESC: + this.hide(); + this.active = false; + Event.stop(event); + return; + case Event.KEY_LEFT: + case Event.KEY_RIGHT: + return; + case Event.KEY_UP: + this.markPrevious(); + this.render(); + Event.stop(event); + return; + case Event.KEY_DOWN: + this.markNext(); + this.render(); + Event.stop(event); + return; + } + else + if(event.keyCode==Event.KEY_TAB || event.keyCode==Event.KEY_RETURN || + (Prototype.Browser.WebKit > 0 && event.keyCode == 0)) return; + + this.changed = true; + this.hasFocus = true; + + if(this.observer) clearTimeout(this.observer); + this.observer = + setTimeout(this.onObserverEvent.bind(this), this.options.frequency*1000); + }, + + activate: function() { + this.changed = false; + this.hasFocus = true; + this.getUpdatedChoices(); + }, + + onHover: function(event) { + var element = Event.findElement(event, 'LI'); + if(this.index != element.autocompleteIndex) + { + this.index = element.autocompleteIndex; + this.render(); + } + Event.stop(event); + }, + + onClick: function(event) { + var element = Event.findElement(event, 'LI'); + this.index = element.autocompleteIndex; + this.selectEntry(); + this.hide(); + }, + + onBlur: function(event) { + // needed to make click events working + setTimeout(this.hide.bind(this), 250); + this.hasFocus = false; + this.active = false; + }, + + render: function() { + if(this.entryCount > 0) { + for (var i = 0; i < this.entryCount; i++) + this.index==i ? + Element.addClassName(this.getEntry(i),"selected") : + Element.removeClassName(this.getEntry(i),"selected"); + if(this.hasFocus) { + this.show(); + this.active = true; + } + } else { + this.active = false; + this.hide(); + } + }, + + markPrevious: function() { + if(this.index > 0) this.index-- + else this.index = this.entryCount-1; + this.getEntry(this.index).scrollIntoView(true); + }, + + markNext: function() { + if(this.index < this.entryCount-1) this.index++ + else this.index = 0; + this.getEntry(this.index).scrollIntoView(false); + }, + + getEntry: function(index) { + return this.update.firstChild.childNodes[index]; + }, + + getCurrentEntry: function() { + return this.getEntry(this.index); + }, + + selectEntry: function() { + this.active = false; + this.updateElement(this.getCurrentEntry()); + }, + + updateElement: function(selectedElement) { + if (this.options.updateElement) { + this.options.updateElement(selectedElement); + return; + } + var value = ''; + if (this.options.select) { + var nodes = $(selectedElement).select('.' + this.options.select) || []; + if(nodes.length>0) value = Element.collectTextNodes(nodes[0], this.options.select); + } else + value = Element.collectTextNodesIgnoreClass(selectedElement, 'informal'); + + var bounds = this.getTokenBounds(); + if (bounds[0] != -1) { + var newValue = this.element.value.substr(0, bounds[0]); + var whitespace = this.element.value.substr(bounds[0]).match(/^\s+/); + if (whitespace) + newValue += whitespace[0]; + this.element.value = newValue + value + this.element.value.substr(bounds[1]); + } else { + this.element.value = value; + } + this.oldElementValue = this.element.value; + this.element.focus(); + + if (this.options.afterUpdateElement) + this.options.afterUpdateElement(this.element, selectedElement); + }, + + updateChoices: function(choices) { + if(!this.changed && this.hasFocus) { + this.update.innerHTML = choices; + Element.cleanWhitespace(this.update); + Element.cleanWhitespace(this.update.down()); + + if(this.update.firstChild && this.update.down().childNodes) { + this.entryCount = + this.update.down().childNodes.length; + for (var i = 0; i < this.entryCount; i++) { + var entry = this.getEntry(i); + entry.autocompleteIndex = i; + this.addObservers(entry); + } + } else { + this.entryCount = 0; + } + + this.stopIndicator(); + this.index = 0; + + if(this.entryCount==1 && this.options.autoSelect) { + this.selectEntry(); + this.hide(); + } else { + this.render(); + } + } + }, + + addObservers: function(element) { + Event.observe(element, "mouseover", this.onHover.bindAsEventListener(this)); + Event.observe(element, "click", this.onClick.bindAsEventListener(this)); + }, + + onObserverEvent: function() { + this.changed = false; + this.tokenBounds = null; + if(this.getToken().length>=this.options.minChars) { + this.getUpdatedChoices(); + } else { + this.active = false; + this.hide(); + } + this.oldElementValue = this.element.value; + }, + + getToken: function() { + var bounds = this.getTokenBounds(); + return this.element.value.substring(bounds[0], bounds[1]).strip(); + }, + + getTokenBounds: function() { + if (null != this.tokenBounds) return this.tokenBounds; + var value = this.element.value; + if (value.strip().empty()) return [-1, 0]; + var diff = arguments.callee.getFirstDifferencePos(value, this.oldElementValue); + var offset = (diff == this.oldElementValue.length ? 1 : 0); + var prevTokenPos = -1, nextTokenPos = value.length; + var tp; + for (var index = 0, l = this.options.tokens.length; index < l; ++index) { + tp = value.lastIndexOf(this.options.tokens[index], diff + offset - 1); + if (tp > prevTokenPos) prevTokenPos = tp; + tp = value.indexOf(this.options.tokens[index], diff + offset); + if (-1 != tp && tp < nextTokenPos) nextTokenPos = tp; + } + return (this.tokenBounds = [prevTokenPos + 1, nextTokenPos]); + } +}); + +Autocompleter.Base.prototype.getTokenBounds.getFirstDifferencePos = function(newS, oldS) { + var boundary = Math.min(newS.length, oldS.length); + for (var index = 0; index < boundary; ++index) + if (newS[index] != oldS[index]) + return index; + return boundary; +}; + +Ajax.Autocompleter = Class.create(Autocompleter.Base, { + initialize: function(element, update, url, options) { + this.baseInitialize(element, update, options); + this.options.asynchronous = true; + this.options.onComplete = this.onComplete.bind(this); + this.options.defaultParams = this.options.parameters || null; + this.url = url; + }, + + getUpdatedChoices: function() { + this.startIndicator(); + + var entry = encodeURIComponent(this.options.paramName) + '=' + + encodeURIComponent(this.getToken()); + + this.options.parameters = this.options.callback ? + this.options.callback(this.element, entry) : entry; + + if(this.options.defaultParams) + this.options.parameters += '&' + this.options.defaultParams; + + new Ajax.Request(this.url, this.options); + }, + + onComplete: function(request) { + this.updateChoices(request.responseText); + } +}); + +// The local array autocompleter. Used when you'd prefer to +// inject an array of autocompletion options into the page, rather +// than sending out Ajax queries, which can be quite slow sometimes. +// +// The constructor takes four parameters. The first two are, as usual, +// the id of the monitored textbox, and id of the autocompletion menu. +// The third is the array you want to autocomplete from, and the fourth +// is the options block. +// +// Extra local autocompletion options: +// - choices - How many autocompletion choices to offer +// +// - partialSearch - If false, the autocompleter will match entered +// text only at the beginning of strings in the +// autocomplete array. Defaults to true, which will +// match text at the beginning of any *word* in the +// strings in the autocomplete array. If you want to +// search anywhere in the string, additionally set +// the option fullSearch to true (default: off). +// +// - fullSsearch - Search anywhere in autocomplete array strings. +// +// - partialChars - How many characters to enter before triggering +// a partial match (unlike minChars, which defines +// how many characters are required to do any match +// at all). Defaults to 2. +// +// - ignoreCase - Whether to ignore case when autocompleting. +// Defaults to true. +// +// It's possible to pass in a custom function as the 'selector' +// option, if you prefer to write your own autocompletion logic. +// In that case, the other options above will not apply unless +// you support them. + +Autocompleter.Local = Class.create(Autocompleter.Base, { + initialize: function(element, update, array, options) { + this.baseInitialize(element, update, options); + this.options.array = array; + }, + + getUpdatedChoices: function() { + this.updateChoices(this.options.selector(this)); + }, + + setOptions: function(options) { + this.options = Object.extend({ + choices: 10, + partialSearch: true, + partialChars: 2, + ignoreCase: true, + fullSearch: false, + selector: function(instance) { + var ret = []; // Beginning matches + var partial = []; // Inside matches + var entry = instance.getToken(); + var count = 0; + + for (var i = 0; i < instance.options.array.length && + ret.length < instance.options.choices ; i++) { + + var elem = instance.options.array[i]; + var foundPos = instance.options.ignoreCase ? + elem.toLowerCase().indexOf(entry.toLowerCase()) : + elem.indexOf(entry); + + while (foundPos != -1) { + if (foundPos == 0 && elem.length != entry.length) { + ret.push("
  • " + elem.substr(0, entry.length) + "" + + elem.substr(entry.length) + "
    • "); + break; + } else if (entry.length >= instance.options.partialChars && + instance.options.partialSearch && foundPos != -1) { + if (instance.options.fullSearch || /\s/.test(elem.substr(foundPos-1,1))) { + partial.push("
  • " + elem.substr(0, foundPos) + "" + + elem.substr(foundPos, entry.length) + "" + elem.substr( + foundPos + entry.length) + "
    • "); + break; + } + } + + foundPos = instance.options.ignoreCase ? + elem.toLowerCase().indexOf(entry.toLowerCase(), foundPos + 1) : + elem.indexOf(entry, foundPos + 1); + + } + } + if (partial.length) + ret = ret.concat(partial.slice(0, instance.options.choices - ret.length)) + return "
      " + ret.join('') + "
    "; + } + }, options || { }); + } +}); + +// AJAX in-place editor and collection editor +// Full rewrite by Christophe Porteneuve (April 2007). + +// Use this if you notice weird scrolling problems on some browsers, +// the DOM might be a bit confused when this gets called so do this +// waits 1 ms (with setTimeout) until it does the activation +Field.scrollFreeActivate = function(field) { + setTimeout(function() { + Field.activate(field); + }, 1); +} + +Ajax.InPlaceEditor = Class.create({ + initialize: function(element, url, options) { + this.url = url; + this.element = element = $(element); + this.prepareOptions(); + this._controls = { }; + arguments.callee.dealWithDeprecatedOptions(options); // DEPRECATION LAYER!!! + Object.extend(this.options, options || { }); + if (!this.options.formId && this.element.id) { + this.options.formId = this.element.id + '-inplaceeditor'; + if ($(this.options.formId)) + this.options.formId = ''; + } + if (this.options.externalControl) + this.options.externalControl = $(this.options.externalControl); + if (!this.options.externalControl) + this.options.externalControlOnly = false; + this._originalBackground = this.element.getStyle('background-color') || 'transparent'; + this.element.title = this.options.clickToEditText; + this._boundCancelHandler = this.handleFormCancellation.bind(this); + this._boundComplete = (this.options.onComplete || Prototype.emptyFunction).bind(this); + this._boundFailureHandler = this.handleAJAXFailure.bind(this); + this._boundSubmitHandler = this.handleFormSubmission.bind(this); + this._boundWrapperHandler = this.wrapUp.bind(this); + this.registerListeners(); + }, + checkForEscapeOrReturn: function(e) { + if (!this._editing || e.ctrlKey || e.altKey || e.shiftKey) return; + if (Event.KEY_ESC == e.keyCode) + this.handleFormCancellation(e); + else if (Event.KEY_RETURN == e.keyCode) + this.handleFormSubmission(e); + }, + createControl: function(mode, handler, extraClasses) { + var control = this.options[mode + 'Control']; + var text = this.options[mode + 'Text']; + if ('button' == control) { + var btn = document.createElement('input'); + btn.type = 'submit'; + btn.value = text; + btn.className = 'editor_' + mode + '_button'; + if ('cancel' == mode) + btn.onclick = this._boundCancelHandler; + this._form.appendChild(btn); + this._controls[mode] = btn; + } else if ('link' == control) { + var link = document.createElement('a'); + link.href = '#'; + link.appendChild(document.createTextNode(text)); + link.onclick = 'cancel' == mode ? this._boundCancelHandler : this._boundSubmitHandler; + link.className = 'editor_' + mode + '_link'; + if (extraClasses) + link.className += ' ' + extraClasses; + this._form.appendChild(link); + this._controls[mode] = link; + } + }, + createEditField: function() { + var text = (this.options.loadTextURL ? this.options.loadingText : this.getText()); + var fld; + if (1 >= this.options.rows && !/\r|\n/.test(this.getText())) { + fld = document.createElement('input'); + fld.type = 'text'; + var size = this.options.size || this.options.cols || 0; + if (0 < size) fld.size = size; + } else { + fld = document.createElement('textarea'); + fld.rows = (1 >= this.options.rows ? this.options.autoRows : this.options.rows); + fld.cols = this.options.cols || 40; + } + fld.name = this.options.paramName; + fld.value = text; // No HTML breaks conversion anymore + fld.className = 'editor_field'; + if (this.options.submitOnBlur) + fld.onblur = this._boundSubmitHandler; + this._controls.editor = fld; + if (this.options.loadTextURL) + this.loadExternalText(); + this._form.appendChild(this._controls.editor); + }, + createForm: function() { + var ipe = this; + function addText(mode, condition) { + var text = ipe.options['text' + mode + 'Controls']; + if (!text || condition === false) return; + ipe._form.appendChild(document.createTextNode(text)); + }; + this._form = $(document.createElement('form')); + this._form.id = this.options.formId; + this._form.addClassName(this.options.formClassName); + this._form.onsubmit = this._boundSubmitHandler; + this.createEditField(); + if ('textarea' == this._controls.editor.tagName.toLowerCase()) + this._form.appendChild(document.createElement('br')); + if (this.options.onFormCustomization) + this.options.onFormCustomization(this, this._form); + addText('Before', this.options.okControl || this.options.cancelControl); + this.createControl('ok', this._boundSubmitHandler); + addText('Between', this.options.okControl && this.options.cancelControl); + this.createControl('cancel', this._boundCancelHandler, 'editor_cancel'); + addText('After', this.options.okControl || this.options.cancelControl); + }, + destroy: function() { + if (this._oldInnerHTML) + this.element.innerHTML = this._oldInnerHTML; + this.leaveEditMode(); + this.unregisterListeners(); + }, + enterEditMode: function(e) { + if (this._saving || this._editing) return; + this._editing = true; + this.triggerCallback('onEnterEditMode'); + if (this.options.externalControl) + this.options.externalControl.hide(); + this.element.hide(); + this.createForm(); + this.element.parentNode.insertBefore(this._form, this.element); + if (!this.options.loadTextURL) + this.postProcessEditField(); + if (e) Event.stop(e); + }, + enterHover: function(e) { + if (this.options.hoverClassName) + this.element.addClassName(this.options.hoverClassName); + if (this._saving) return; + this.triggerCallback('onEnterHover'); + }, + getText: function() { + return this.element.innerHTML; + }, + handleAJAXFailure: function(transport) { + this.triggerCallback('onFailure', transport); + if (this._oldInnerHTML) { + this.element.innerHTML = this._oldInnerHTML; + this._oldInnerHTML = null; + } + }, + handleFormCancellation: function(e) { + this.wrapUp(); + if (e) Event.stop(e); + }, + handleFormSubmission: function(e) { + var form = this._form; + var value = $F(this._controls.editor); + this.prepareSubmission(); + var params = this.options.callback(form, value) || ''; + if (Object.isString(params)) + params = params.toQueryParams(); + params.editorId = this.element.id; + if (this.options.htmlResponse) { + var options = Object.extend({ evalScripts: true }, this.options.ajaxOptions); + Object.extend(options, { + parameters: params, + onComplete: this._boundWrapperHandler, + onFailure: this._boundFailureHandler + }); + new Ajax.Updater({ success: this.element }, this.url, options); + } else { + var options = Object.extend({ method: 'get' }, this.options.ajaxOptions); + Object.extend(options, { + parameters: params, + onComplete: this._boundWrapperHandler, + onFailure: this._boundFailureHandler + }); + new Ajax.Request(this.url, options); + } + if (e) Event.stop(e); + }, + leaveEditMode: function() { + this.element.removeClassName(this.options.savingClassName); + this.removeForm(); + this.leaveHover(); + this.element.style.backgroundColor = this._originalBackground; + this.element.show(); + if (this.options.externalControl) + this.options.externalControl.show(); + this._saving = false; + this._editing = false; + this._oldInnerHTML = null; + this.triggerCallback('onLeaveEditMode'); + }, + leaveHover: function(e) { + if (this.options.hoverClassName) + this.element.removeClassName(this.options.hoverClassName); + if (this._saving) return; + this.triggerCallback('onLeaveHover'); + }, + loadExternalText: function() { + this._form.addClassName(this.options.loadingClassName); + this._controls.editor.disabled = true; + var options = Object.extend({ method: 'get' }, this.options.ajaxOptions); + Object.extend(options, { + parameters: 'editorId=' + encodeURIComponent(this.element.id), + onComplete: Prototype.emptyFunction, + onSuccess: function(transport) { + this._form.removeClassName(this.options.loadingClassName); + var text = transport.responseText; + if (this.options.stripLoadedTextTags) + text = text.stripTags(); + this._controls.editor.value = text; + this._controls.editor.disabled = false; + this.postProcessEditField(); + }.bind(this), + onFailure: this._boundFailureHandler + }); + new Ajax.Request(this.options.loadTextURL, options); + }, + postProcessEditField: function() { + var fpc = this.options.fieldPostCreation; + if (fpc) + $(this._controls.editor)['focus' == fpc ? 'focus' : 'activate'](); + }, + prepareOptions: function() { + this.options = Object.clone(Ajax.InPlaceEditor.DefaultOptions); + Object.extend(this.options, Ajax.InPlaceEditor.DefaultCallbacks); + [this._extraDefaultOptions].flatten().compact().each(function(defs) { + Object.extend(this.options, defs); + }.bind(this)); + }, + prepareSubmission: function() { + this._saving = true; + this.removeForm(); + this.leaveHover(); + this.showSaving(); + }, + registerListeners: function() { + this._listeners = { }; + var listener; + $H(Ajax.InPlaceEditor.Listeners).each(function(pair) { + listener = this[pair.value].bind(this); + this._listeners[pair.key] = listener; + if (!this.options.externalControlOnly) + this.element.observe(pair.key, listener); + if (this.options.externalControl) + this.options.externalControl.observe(pair.key, listener); + }.bind(this)); + }, + removeForm: function() { + if (!this._form) return; + this._form.remove(); + this._form = null; + this._controls = { }; + }, + showSaving: function() { + this._oldInnerHTML = this.element.innerHTML; + this.element.innerHTML = this.options.savingText; + this.element.addClassName(this.options.savingClassName); + this.element.style.backgroundColor = this._originalBackground; + this.element.show(); + }, + triggerCallback: function(cbName, arg) { + if ('function' == typeof this.options[cbName]) { + this.options[cbName](this, arg); + } + }, + unregisterListeners: function() { + $H(this._listeners).each(function(pair) { + if (!this.options.externalControlOnly) + this.element.stopObserving(pair.key, pair.value); + if (this.options.externalControl) + this.options.externalControl.stopObserving(pair.key, pair.value); + }.bind(this)); + }, + wrapUp: function(transport) { + this.leaveEditMode(); + // Can't use triggerCallback due to backward compatibility: requires + // binding + direct element + this._boundComplete(transport, this.element); + } +}); + +Object.extend(Ajax.InPlaceEditor.prototype, { + dispose: Ajax.InPlaceEditor.prototype.destroy +}); + +Ajax.InPlaceCollectionEditor = Class.create(Ajax.InPlaceEditor, { + initialize: function($super, element, url, options) { + this._extraDefaultOptions = Ajax.InPlaceCollectionEditor.DefaultOptions; + $super(element, url, options); + }, + + createEditField: function() { + var list = document.createElement('select'); + list.name = this.options.paramName; + list.size = 1; + this._controls.editor = list; + this._collection = this.options.collection || []; + if (this.options.loadCollectionURL) + this.loadCollection(); + else + this.checkForExternalText(); + this._form.appendChild(this._controls.editor); + }, + + loadCollection: function() { + this._form.addClassName(this.options.loadingClassName); + this.showLoadingText(this.options.loadingCollectionText); + var options = Object.extend({ method: 'get' }, this.options.ajaxOptions); + Object.extend(options, { + parameters: 'editorId=' + encodeURIComponent(this.element.id), + onComplete: Prototype.emptyFunction, + onSuccess: function(transport) { + var js = transport.responseText.strip(); + if (!/^\[.*\]$/.test(js)) // TODO: improve sanity check + throw 'Server returned an invalid collection representation.'; + this._collection = eval(js); + this.checkForExternalText(); + }.bind(this), + onFailure: this.onFailure + }); + new Ajax.Request(this.options.loadCollectionURL, options); + }, + + showLoadingText: function(text) { + this._controls.editor.disabled = true; + var tempOption = this._controls.editor.firstChild; + if (!tempOption) { + tempOption = document.createElement('option'); + tempOption.value = ''; + this._controls.editor.appendChild(tempOption); + tempOption.selected = true; + } + tempOption.update((text || '').stripScripts().stripTags()); + }, + + checkForExternalText: function() { + this._text = this.getText(); + if (this.options.loadTextURL) + this.loadExternalText(); + else + this.buildOptionList(); + }, + + loadExternalText: function() { + this.showLoadingText(this.options.loadingText); + var options = Object.extend({ method: 'get' }, this.options.ajaxOptions); + Object.extend(options, { + parameters: 'editorId=' + encodeURIComponent(this.element.id), + onComplete: Prototype.emptyFunction, + onSuccess: function(transport) { + this._text = transport.responseText.strip(); + this.buildOptionList(); + }.bind(this), + onFailure: this.onFailure + }); + new Ajax.Request(this.options.loadTextURL, options); + }, + + buildOptionList: function() { + this._form.removeClassName(this.options.loadingClassName); + this._collection = this._collection.map(function(entry) { + return 2 === entry.length ? entry : [entry, entry].flatten(); + }); + var marker = ('value' in this.options) ? this.options.value : this._text; + var textFound = this._collection.any(function(entry) { + return entry[0] == marker; + }.bind(this)); + this._controls.editor.update(''); + var option; + this._collection.each(function(entry, index) { + option = document.createElement('option'); + option.value = entry[0]; + option.selected = textFound ? entry[0] == marker : 0 == index; + option.appendChild(document.createTextNode(entry[1])); + this._controls.editor.appendChild(option); + }.bind(this)); + this._controls.editor.disabled = false; + Field.scrollFreeActivate(this._controls.editor); + } +}); + +//**** DEPRECATION LAYER FOR InPlace[Collection]Editor! **** +//**** This only exists for a while, in order to let **** +//**** users adapt to the new API. Read up on the new **** +//**** API and convert your code to it ASAP! **** + +Ajax.InPlaceEditor.prototype.initialize.dealWithDeprecatedOptions = function(options) { + if (!options) return; + function fallback(name, expr) { + if (name in options || expr === undefined) return; + options[name] = expr; + }; + fallback('cancelControl', (options.cancelLink ? 'link' : (options.cancelButton ? 'button' : + options.cancelLink == options.cancelButton == false ? false : undefined))); + fallback('okControl', (options.okLink ? 'link' : (options.okButton ? 'button' : + options.okLink == options.okButton == false ? false : undefined))); + fallback('highlightColor', options.highlightcolor); + fallback('highlightEndColor', options.highlightendcolor); +}; + +Object.extend(Ajax.InPlaceEditor, { + DefaultOptions: { + ajaxOptions: { }, + autoRows: 3, // Use when multi-line w/ rows == 1 + cancelControl: 'link', // 'link'|'button'|false + cancelText: 'cancel', + clickToEditText: 'Click to edit', + externalControl: null, // id|elt + externalControlOnly: false, + fieldPostCreation: 'activate', // 'activate'|'focus'|false + formClassName: 'inplaceeditor-form', + formId: null, // id|elt + highlightColor: '#ffff99', + highlightEndColor: '#ffffff', + hoverClassName: '', + htmlResponse: true, + loadingClassName: 'inplaceeditor-loading', + loadingText: 'Loading...', + okControl: 'button', // 'link'|'button'|false + okText: 'ok', + paramName: 'value', + rows: 1, // If 1 and multi-line, uses autoRows + savingClassName: 'inplaceeditor-saving', + savingText: 'Saving...', + size: 0, + stripLoadedTextTags: false, + submitOnBlur: false, + textAfterControls: '', + textBeforeControls: '', + textBetweenControls: '' + }, + DefaultCallbacks: { + callback: function(form) { + return Form.serialize(form); + }, + onComplete: function(transport, element) { + // For backward compatibility, this one is bound to the IPE, and passes + // the element directly. It was too often customized, so we don't break it. + new Effect.Highlight(element, { + startcolor: this.options.highlightColor, keepBackgroundImage: true }); + }, + onEnterEditMode: null, + onEnterHover: function(ipe) { + ipe.element.style.backgroundColor = ipe.options.highlightColor; + if (ipe._effect) + ipe._effect.cancel(); + }, + onFailure: function(transport, ipe) { + alert('Error communication with the server: ' + transport.responseText.stripTags()); + }, + onFormCustomization: null, // Takes the IPE and its generated form, after editor, before controls. + onLeaveEditMode: null, + onLeaveHover: function(ipe) { + ipe._effect = new Effect.Highlight(ipe.element, { + startcolor: ipe.options.highlightColor, endcolor: ipe.options.highlightEndColor, + restorecolor: ipe._originalBackground, keepBackgroundImage: true + }); + } + }, + Listeners: { + click: 'enterEditMode', + keydown: 'checkForEscapeOrReturn', + mouseover: 'enterHover', + mouseout: 'leaveHover' + } +}); + +Ajax.InPlaceCollectionEditor.DefaultOptions = { + loadingCollectionText: 'Loading options...' +}; + +// Delayed observer, like Form.Element.Observer, +// but waits for delay after last key input +// Ideal for live-search fields + +Form.Element.DelayedObserver = Class.create({ + initialize: function(element, delay, callback) { + this.delay = delay || 0.5; + this.element = $(element); + this.callback = callback; + this.timer = null; + this.lastValue = $F(this.element); + Event.observe(this.element,'keyup',this.delayedListener.bindAsEventListener(this)); + }, + delayedListener: function(event) { + if(this.lastValue == $F(this.element)) return; + if(this.timer) clearTimeout(this.timer); + this.timer = setTimeout(this.onTimerEvent.bind(this), this.delay * 1000); + this.lastValue = $F(this.element); + }, + onTimerEvent: function() { + this.timer = null; + this.callback(this.element, $F(this.element)); + } +}); diff --git a/website/src/javascripts/dragdrop.js b/website/src/javascripts/dragdrop.js new file mode 100644 index 00000000..ccf4a1e4 --- /dev/null +++ b/website/src/javascripts/dragdrop.js @@ -0,0 +1,972 @@ +// Copyright (c) 2005-2007 Thomas Fuchs (http://script.aculo.us, http://mir.aculo.us) +// (c) 2005-2007 Sammi Williams (http://www.oriontransfer.co.nz, sammi@oriontransfer.co.nz) +// +// script.aculo.us is freely distributable under the terms of an MIT-style license. +// For details, see the script.aculo.us web site: http://script.aculo.us/ + +if(Object.isUndefined(Effect)) + throw("dragdrop.js requires including script.aculo.us' effects.js library"); + +var Droppables = { + drops: [], + + remove: function(element) { + this.drops = this.drops.reject(function(d) { return d.element==$(element) }); + }, + + add: function(element) { + element = $(element); + var options = Object.extend({ + greedy: true, + hoverclass: null, + tree: false + }, arguments[1] || { }); + + // cache containers + if(options.containment) { + options._containers = []; + var containment = options.containment; + if(Object.isArray(containment)) { + containment.each( function(c) { options._containers.push($(c)) }); + } else { + options._containers.push($(containment)); + } + } + + if(options.accept) options.accept = [options.accept].flatten(); + + Element.makePositioned(element); // fix IE + options.element = element; + + this.drops.push(options); + }, + + findDeepestChild: function(drops) { + deepest = drops[0]; + + for (i = 1; i < drops.length; ++i) + if (Element.isParent(drops[i].element, deepest.element)) + deepest = drops[i]; + + return deepest; + }, + + isContained: function(element, drop) { + var containmentNode; + if(drop.tree) { + containmentNode = element.treeNode; + } else { + containmentNode = element.parentNode; + } + return drop._containers.detect(function(c) { return containmentNode == c }); + }, + + isAffected: function(point, element, drop) { + return ( + (drop.element!=element) && + ((!drop._containers) || + this.isContained(element, drop)) && + ((!drop.accept) || + (Element.classNames(element).detect( + function(v) { return drop.accept.include(v) } ) )) && + Position.within(drop.element, point[0], point[1]) ); + }, + + deactivate: function(drop) { + if(drop.hoverclass) + Element.removeClassName(drop.element, drop.hoverclass); + this.last_active = null; + }, + + activate: function(drop) { + if(drop.hoverclass) + Element.addClassName(drop.element, drop.hoverclass); + this.last_active = drop; + }, + + show: function(point, element) { + if(!this.drops.length) return; + var drop, affected = []; + + this.drops.each( function(drop) { + if(Droppables.isAffected(point, element, drop)) + affected.push(drop); + }); + + if(affected.length>0) + drop = Droppables.findDeepestChild(affected); + + if(this.last_active && this.last_active != drop) this.deactivate(this.last_active); + if (drop) { + Position.within(drop.element, point[0], point[1]); + if(drop.onHover) + drop.onHover(element, drop.element, Position.overlap(drop.overlap, drop.element)); + + if (drop != this.last_active) Droppables.activate(drop); + } + }, + + fire: function(event, element) { + if(!this.last_active) return; + Position.prepare(); + + if (this.isAffected([Event.pointerX(event), Event.pointerY(event)], element, this.last_active)) + if (this.last_active.onDrop) { + this.last_active.onDrop(element, this.last_active.element, event); + return true; + } + }, + + reset: function() { + if(this.last_active) + this.deactivate(this.last_active); + } +} + +var Draggables = { + drags: [], + observers: [], + + register: function(draggable) { + if(this.drags.length == 0) { + this.eventMouseUp = this.endDrag.bindAsEventListener(this); + this.eventMouseMove = this.updateDrag.bindAsEventListener(this); + this.eventKeypress = this.keyPress.bindAsEventListener(this); + + Event.observe(document, "mouseup", this.eventMouseUp); + Event.observe(document, "mousemove", this.eventMouseMove); + Event.observe(document, "keypress", this.eventKeypress); + } + this.drags.push(draggable); + }, + + unregister: function(draggable) { + this.drags = this.drags.reject(function(d) { return d==draggable }); + if(this.drags.length == 0) { + Event.stopObserving(document, "mouseup", this.eventMouseUp); + Event.stopObserving(document, "mousemove", this.eventMouseMove); + Event.stopObserving(document, "keypress", this.eventKeypress); + } + }, + + activate: function(draggable) { + if(draggable.options.delay) { + this._timeout = setTimeout(function() { + Draggables._timeout = null; + window.focus(); + Draggables.activeDraggable = draggable; + }.bind(this), draggable.options.delay); + } else { + window.focus(); // allows keypress events if window isn't currently focused, fails for Safari + this.activeDraggable = draggable; + } + }, + + deactivate: function() { + this.activeDraggable = null; + }, + + updateDrag: function(event) { + if(!this.activeDraggable) return; + var pointer = [Event.pointerX(event), Event.pointerY(event)]; + // Mozilla-based browsers fire successive mousemove events with + // the same coordinates, prevent needless redrawing (moz bug?) + if(this._lastPointer && (this._lastPointer.inspect() == pointer.inspect())) return; + this._lastPointer = pointer; + + this.activeDraggable.updateDrag(event, pointer); + }, + + endDrag: function(event) { + if(this._timeout) { + clearTimeout(this._timeout); + this._timeout = null; + } + if(!this.activeDraggable) return; + this._lastPointer = null; + this.activeDraggable.endDrag(event); + this.activeDraggable = null; + }, + + keyPress: function(event) { + if(this.activeDraggable) + this.activeDraggable.keyPress(event); + }, + + addObserver: function(observer) { + this.observers.push(observer); + this._cacheObserverCallbacks(); + }, + + removeObserver: function(element) { // element instead of observer fixes mem leaks + this.observers = this.observers.reject( function(o) { return o.element==element }); + this._cacheObserverCallbacks(); + }, + + notify: function(eventName, draggable, event) { // 'onStart', 'onEnd', 'onDrag' + if(this[eventName+'Count'] > 0) + this.observers.each( function(o) { + if(o[eventName]) o[eventName](eventName, draggable, event); + }); + if(draggable.options[eventName]) draggable.options[eventName](draggable, event); + }, + + _cacheObserverCallbacks: function() { + ['onStart','onEnd','onDrag'].each( function(eventName) { + Draggables[eventName+'Count'] = Draggables.observers.select( + function(o) { return o[eventName]; } + ).length; + }); + } +} + +/*--------------------------------------------------------------------------*/ + +var Draggable = Class.create({ + initialize: function(element) { + var defaults = { + handle: false, + reverteffect: function(element, top_offset, left_offset) { + var dur = Math.sqrt(Math.abs(top_offset^2)+Math.abs(left_offset^2))*0.02; + new Effect.Move(element, { x: -left_offset, y: -top_offset, duration: dur, + queue: {scope:'_draggable', position:'end'} + }); + }, + endeffect: function(element) { + var toOpacity = Object.isNumber(element._opacity) ? element._opacity : 1.0; + new Effect.Opacity(element, {duration:0.2, from:0.7, to:toOpacity, + queue: {scope:'_draggable', position:'end'}, + afterFinish: function(){ + Draggable._dragging[element] = false + } + }); + }, + zindex: 1000, + revert: false, + quiet: false, + scroll: false, + scrollSensitivity: 20, + scrollSpeed: 15, + snap: false, // false, or xy or [x,y] or function(x,y){ return [x,y] } + delay: 0 + }; + + if(!arguments[1] || Object.isUndefined(arguments[1].endeffect)) + Object.extend(defaults, { + starteffect: function(element) { + element._opacity = Element.getOpacity(element); + Draggable._dragging[element] = true; + new Effect.Opacity(element, {duration:0.2, from:element._opacity, to:0.7}); + } + }); + + var options = Object.extend(defaults, arguments[1] || { }); + + this.element = $(element); + + if(options.handle && Object.isString(options.handle)) + this.handle = this.element.down('.'+options.handle, 0); + + if(!this.handle) this.handle = $(options.handle); + if(!this.handle) this.handle = this.element; + + if(options.scroll && !options.scroll.scrollTo && !options.scroll.outerHTML) { + options.scroll = $(options.scroll); + this._isScrollChild = Element.childOf(this.element, options.scroll); + } + + Element.makePositioned(this.element); // fix IE + + this.options = options; + this.dragging = false; + + this.eventMouseDown = this.initDrag.bindAsEventListener(this); + Event.observe(this.handle, "mousedown", this.eventMouseDown); + + Draggables.register(this); + }, + + destroy: function() { + Event.stopObserving(this.handle, "mousedown", this.eventMouseDown); + Draggables.unregister(this); + }, + + currentDelta: function() { + return([ + parseInt(Element.getStyle(this.element,'left') || '0'), + parseInt(Element.getStyle(this.element,'top') || '0')]); + }, + + initDrag: function(event) { + if(!Object.isUndefined(Draggable._dragging[this.element]) && + Draggable._dragging[this.element]) return; + if(Event.isLeftClick(event)) { + // abort on form elements, fixes a Firefox issue + var src = Event.element(event); + if((tag_name = src.tagName.toUpperCase()) && ( + tag_name=='INPUT' || + tag_name=='SELECT' || + tag_name=='OPTION' || + tag_name=='BUTTON' || + tag_name=='TEXTAREA')) return; + + var pointer = [Event.pointerX(event), Event.pointerY(event)]; + var pos = Position.cumulativeOffset(this.element); + this.offset = [0,1].map( function(i) { return (pointer[i] - pos[i]) }); + + Draggables.activate(this); + Event.stop(event); + } + }, + + startDrag: function(event) { + this.dragging = true; + if(!this.delta) + this.delta = this.currentDelta(); + + if(this.options.zindex) { + this.originalZ = parseInt(Element.getStyle(this.element,'z-index') || 0); + this.element.style.zIndex = this.options.zindex; + } + + if(this.options.ghosting) { + this._clone = this.element.cloneNode(true); + this.element._originallyAbsolute = (this.element.getStyle('position') == 'absolute'); + if (!this.element._originallyAbsolute) + Position.absolutize(this.element); + this.element.parentNode.insertBefore(this._clone, this.element); + } + + if(this.options.scroll) { + if (this.options.scroll == window) { + var where = this._getWindowScroll(this.options.scroll); + this.originalScrollLeft = where.left; + this.originalScrollTop = where.top; + } else { + this.originalScrollLeft = this.options.scroll.scrollLeft; + this.originalScrollTop = this.options.scroll.scrollTop; + } + } + + Draggables.notify('onStart', this, event); + + if(this.options.starteffect) this.options.starteffect(this.element); + }, + + updateDrag: function(event, pointer) { + if(!this.dragging) this.startDrag(event); + + if(!this.options.quiet){ + Position.prepare(); + Droppables.show(pointer, this.element); + } + + Draggables.notify('onDrag', this, event); + + this.draw(pointer); + if(this.options.change) this.options.change(this); + + if(this.options.scroll) { + this.stopScrolling(); + + var p; + if (this.options.scroll == window) { + with(this._getWindowScroll(this.options.scroll)) { p = [ left, top, left+width, top+height ]; } + } else { + p = Position.page(this.options.scroll); + p[0] += this.options.scroll.scrollLeft + Position.deltaX; + p[1] += this.options.scroll.scrollTop + Position.deltaY; + p.push(p[0]+this.options.scroll.offsetWidth); + p.push(p[1]+this.options.scroll.offsetHeight); + } + var speed = [0,0]; + if(pointer[0] < (p[0]+this.options.scrollSensitivity)) speed[0] = pointer[0]-(p[0]+this.options.scrollSensitivity); + if(pointer[1] < (p[1]+this.options.scrollSensitivity)) speed[1] = pointer[1]-(p[1]+this.options.scrollSensitivity); + if(pointer[0] > (p[2]-this.options.scrollSensitivity)) speed[0] = pointer[0]-(p[2]-this.options.scrollSensitivity); + if(pointer[1] > (p[3]-this.options.scrollSensitivity)) speed[1] = pointer[1]-(p[3]-this.options.scrollSensitivity); + this.startScrolling(speed); + } + + // fix AppleWebKit rendering + if(Prototype.Browser.WebKit) window.scrollBy(0,0); + + Event.stop(event); + }, + + finishDrag: function(event, success) { + this.dragging = false; + + if(this.options.quiet){ + Position.prepare(); + var pointer = [Event.pointerX(event), Event.pointerY(event)]; + Droppables.show(pointer, this.element); + } + + if(this.options.ghosting) { + if (!this.element._originallyAbsolute) + Position.relativize(this.element); + delete this.element._originallyAbsolute; + Element.remove(this._clone); + this._clone = null; + } + + var dropped = false; + if(success) { + dropped = Droppables.fire(event, this.element); + if (!dropped) dropped = false; + } + if(dropped && this.options.onDropped) this.options.onDropped(this.element); + Draggables.notify('onEnd', this, event); + + var revert = this.options.revert; + if(revert && Object.isFunction(revert)) revert = revert(this.element); + + var d = this.currentDelta(); + if(revert && this.options.reverteffect) { + if (dropped == 0 || revert != 'failure') + this.options.reverteffect(this.element, + d[1]-this.delta[1], d[0]-this.delta[0]); + } else { + this.delta = d; + } + + if(this.options.zindex) + this.element.style.zIndex = this.originalZ; + + if(this.options.endeffect) + this.options.endeffect(this.element); + + Draggables.deactivate(this); + Droppables.reset(); + }, + + keyPress: function(event) { + if(event.keyCode!=Event.KEY_ESC) return; + this.finishDrag(event, false); + Event.stop(event); + }, + + endDrag: function(event) { + if(!this.dragging) return; + this.stopScrolling(); + this.finishDrag(event, true); + Event.stop(event); + }, + + draw: function(point) { + var pos = Position.cumulativeOffset(this.element); + if(this.options.ghosting) { + var r = Position.realOffset(this.element); + pos[0] += r[0] - Position.deltaX; pos[1] += r[1] - Position.deltaY; + } + + var d = this.currentDelta(); + pos[0] -= d[0]; pos[1] -= d[1]; + + if(this.options.scroll && (this.options.scroll != window && this._isScrollChild)) { + pos[0] -= this.options.scroll.scrollLeft-this.originalScrollLeft; + pos[1] -= this.options.scroll.scrollTop-this.originalScrollTop; + } + + var p = [0,1].map(function(i){ + return (point[i]-pos[i]-this.offset[i]) + }.bind(this)); + + if(this.options.snap) { + if(Object.isFunction(this.options.snap)) { + p = this.options.snap(p[0],p[1],this); + } else { + if(Object.isArray(this.options.snap)) { + p = p.map( function(v, i) { + return (v/this.options.snap[i]).round()*this.options.snap[i] }.bind(this)) + } else { + p = p.map( function(v) { + return (v/this.options.snap).round()*this.options.snap }.bind(this)) + } + }} + + var style = this.element.style; + if((!this.options.constraint) || (this.options.constraint=='horizontal')) + style.left = p[0] + "px"; + if((!this.options.constraint) || (this.options.constraint=='vertical')) + style.top = p[1] + "px"; + + if(style.visibility=="hidden") style.visibility = ""; // fix gecko rendering + }, + + stopScrolling: function() { + if(this.scrollInterval) { + clearInterval(this.scrollInterval); + this.scrollInterval = null; + Draggables._lastScrollPointer = null; + } + }, + + startScrolling: function(speed) { + if(!(speed[0] || speed[1])) return; + this.scrollSpeed = [speed[0]*this.options.scrollSpeed,speed[1]*this.options.scrollSpeed]; + this.lastScrolled = new Date(); + this.scrollInterval = setInterval(this.scroll.bind(this), 10); + }, + + scroll: function() { + var current = new Date(); + var delta = current - this.lastScrolled; + this.lastScrolled = current; + if(this.options.scroll == window) { + with (this._getWindowScroll(this.options.scroll)) { + if (this.scrollSpeed[0] || this.scrollSpeed[1]) { + var d = delta / 1000; + this.options.scroll.scrollTo( left + d*this.scrollSpeed[0], top + d*this.scrollSpeed[1] ); + } + } + } else { + this.options.scroll.scrollLeft += this.scrollSpeed[0] * delta / 1000; + this.options.scroll.scrollTop += this.scrollSpeed[1] * delta / 1000; + } + + Position.prepare(); + Droppables.show(Draggables._lastPointer, this.element); + Draggables.notify('onDrag', this); + if (this._isScrollChild) { + Draggables._lastScrollPointer = Draggables._lastScrollPointer || $A(Draggables._lastPointer); + Draggables._lastScrollPointer[0] += this.scrollSpeed[0] * delta / 1000; + Draggables._lastScrollPointer[1] += this.scrollSpeed[1] * delta / 1000; + if (Draggables._lastScrollPointer[0] < 0) + Draggables._lastScrollPointer[0] = 0; + if (Draggables._lastScrollPointer[1] < 0) + Draggables._lastScrollPointer[1] = 0; + this.draw(Draggables._lastScrollPointer); + } + + if(this.options.change) this.options.change(this); + }, + + _getWindowScroll: function(w) { + var T, L, W, H; + with (w.document) { + if (w.document.documentElement && documentElement.scrollTop) { + T = documentElement.scrollTop; + L = documentElement.scrollLeft; + } else if (w.document.body) { + T = body.scrollTop; + L = body.scrollLeft; + } + if (w.innerWidth) { + W = w.innerWidth; + H = w.innerHeight; + } else if (w.document.documentElement && documentElement.clientWidth) { + W = documentElement.clientWidth; + H = documentElement.clientHeight; + } else { + W = body.offsetWidth; + H = body.offsetHeight + } + } + return { top: T, left: L, width: W, height: H }; + } +}); + +Draggable._dragging = { }; + +/*--------------------------------------------------------------------------*/ + +var SortableObserver = Class.create({ + initialize: function(element, observer) { + this.element = $(element); + this.observer = observer; + this.lastValue = Sortable.serialize(this.element); + }, + + onStart: function() { + this.lastValue = Sortable.serialize(this.element); + }, + + onEnd: function() { + Sortable.unmark(); + if(this.lastValue != Sortable.serialize(this.element)) + this.observer(this.element) + } +}); + +var Sortable = { + SERIALIZE_RULE: /^[^_\-](?:[A-Za-z0-9\-\_]*)[_](.*)$/, + + sortables: { }, + + _findRootElement: function(element) { + while (element.tagName.toUpperCase() != "BODY") { + if(element.id && Sortable.sortables[element.id]) return element; + element = element.parentNode; + } + }, + + options: function(element) { + element = Sortable._findRootElement($(element)); + if(!element) return; + return Sortable.sortables[element.id]; + }, + + destroy: function(element){ + var s = Sortable.options(element); + + if(s) { + Draggables.removeObserver(s.element); + s.droppables.each(function(d){ Droppables.remove(d) }); + s.draggables.invoke('destroy'); + + delete Sortable.sortables[s.element.id]; + } + }, + + create: function(element) { + element = $(element); + var options = Object.extend({ + element: element, + tag: 'li', // assumes li children, override with tag: 'tagname' + dropOnEmpty: false, + tree: false, + treeTag: 'ul', + overlap: 'vertical', // one of 'vertical', 'horizontal' + constraint: 'vertical', // one of 'vertical', 'horizontal', false + containment: element, // also takes array of elements (or id's); or false + handle: false, // or a CSS class + only: false, + delay: 0, + hoverclass: null, + ghosting: false, + quiet: false, + scroll: false, + scrollSensitivity: 20, + scrollSpeed: 15, + format: this.SERIALIZE_RULE, + + // these take arrays of elements or ids and can be + // used for better initialization performance + elements: false, + handles: false, + + onChange: Prototype.emptyFunction, + onUpdate: Prototype.emptyFunction + }, arguments[1] || { }); + + // clear any old sortable with same element + this.destroy(element); + + // build options for the draggables + var options_for_draggable = { + revert: true, + quiet: options.quiet, + scroll: options.scroll, + scrollSpeed: options.scrollSpeed, + scrollSensitivity: options.scrollSensitivity, + delay: options.delay, + ghosting: options.ghosting, + constraint: options.constraint, + handle: options.handle }; + + if(options.starteffect) + options_for_draggable.starteffect = options.starteffect; + + if(options.reverteffect) + options_for_draggable.reverteffect = options.reverteffect; + else + if(options.ghosting) options_for_draggable.reverteffect = function(element) { + element.style.top = 0; + element.style.left = 0; + }; + + if(options.endeffect) + options_for_draggable.endeffect = options.endeffect; + + if(options.zindex) + options_for_draggable.zindex = options.zindex; + + // build options for the droppables + var options_for_droppable = { + overlap: options.overlap, + containment: options.containment, + tree: options.tree, + hoverclass: options.hoverclass, + onHover: Sortable.onHover + } + + var options_for_tree = { + onHover: Sortable.onEmptyHover, + overlap: options.overlap, + containment: options.containment, + hoverclass: options.hoverclass + } + + // fix for gecko engine + Element.cleanWhitespace(element); + + options.draggables = []; + options.droppables = []; + + // drop on empty handling + if(options.dropOnEmpty || options.tree) { + Droppables.add(element, options_for_tree); + options.droppables.push(element); + } + + (options.elements || this.findElements(element, options) || []).each( function(e,i) { + var handle = options.handles ? $(options.handles[i]) : + (options.handle ? $(e).select('.' + options.handle)[0] : e); + options.draggables.push( + new Draggable(e, Object.extend(options_for_draggable, { handle: handle }))); + Droppables.add(e, options_for_droppable); + if(options.tree) e.treeNode = element; + options.droppables.push(e); + }); + + if(options.tree) { + (Sortable.findTreeElements(element, options) || []).each( function(e) { + Droppables.add(e, options_for_tree); + e.treeNode = element; + options.droppables.push(e); + }); + } + + // keep reference + this.sortables[element.id] = options; + + // for onupdate + Draggables.addObserver(new SortableObserver(element, options.onUpdate)); + + }, + + // return all suitable-for-sortable elements in a guaranteed order + findElements: function(element, options) { + return Element.findChildren( + element, options.only, options.tree ? true : false, options.tag); + }, + + findTreeElements: function(element, options) { + return Element.findChildren( + element, options.only, options.tree ? true : false, options.treeTag); + }, + + onHover: function(element, dropon, overlap) { + if(Element.isParent(dropon, element)) return; + + if(overlap > .33 && overlap < .66 && Sortable.options(dropon).tree) { + return; + } else if(overlap>0.5) { + Sortable.mark(dropon, 'before'); + if(dropon.previousSibling != element) { + var oldParentNode = element.parentNode; + element.style.visibility = "hidden"; // fix gecko rendering + dropon.parentNode.insertBefore(element, dropon); + if(dropon.parentNode!=oldParentNode) + Sortable.options(oldParentNode).onChange(element); + Sortable.options(dropon.parentNode).onChange(element); + } + } else { + Sortable.mark(dropon, 'after'); + var nextElement = dropon.nextSibling || null; + if(nextElement != element) { + var oldParentNode = element.parentNode; + element.style.visibility = "hidden"; // fix gecko rendering + dropon.parentNode.insertBefore(element, nextElement); + if(dropon.parentNode!=oldParentNode) + Sortable.options(oldParentNode).onChange(element); + Sortable.options(dropon.parentNode).onChange(element); + } + } + }, + + onEmptyHover: function(element, dropon, overlap) { + var oldParentNode = element.parentNode; + var droponOptions = Sortable.options(dropon); + + if(!Element.isParent(dropon, element)) { + var index; + + var children = Sortable.findElements(dropon, {tag: droponOptions.tag, only: droponOptions.only}); + var child = null; + + if(children) { + var offset = Element.offsetSize(dropon, droponOptions.overlap) * (1.0 - overlap); + + for (index = 0; index < children.length; index += 1) { + if (offset - Element.offsetSize (children[index], droponOptions.overlap) >= 0) { + offset -= Element.offsetSize (children[index], droponOptions.overlap); + } else if (offset - (Element.offsetSize (children[index], droponOptions.overlap) / 2) >= 0) { + child = index + 1 < children.length ? children[index + 1] : null; + break; + } else { + child = children[index]; + break; + } + } + } + + dropon.insertBefore(element, child); + + Sortable.options(oldParentNode).onChange(element); + droponOptions.onChange(element); + } + }, + + unmark: function() { + if(Sortable._marker) Sortable._marker.hide(); + }, + + mark: function(dropon, position) { + // mark on ghosting only + var sortable = Sortable.options(dropon.parentNode); + if(sortable && !sortable.ghosting) return; + + if(!Sortable._marker) { + Sortable._marker = + ($('dropmarker') || Element.extend(document.createElement('DIV'))). + hide().addClassName('dropmarker').setStyle({position:'absolute'}); + document.getElementsByTagName("body").item(0).appendChild(Sortable._marker); + } + var offsets = Position.cumulativeOffset(dropon); + Sortable._marker.setStyle({left: offsets[0]+'px', top: offsets[1] + 'px'}); + + if(position=='after') + if(sortable.overlap == 'horizontal') + Sortable._marker.setStyle({left: (offsets[0]+dropon.clientWidth) + 'px'}); + else + Sortable._marker.setStyle({top: (offsets[1]+dropon.clientHeight) + 'px'}); + + Sortable._marker.show(); + }, + + _tree: function(element, options, parent) { + var children = Sortable.findElements(element, options) || []; + + for (var i = 0; i < children.length; ++i) { + var match = children[i].id.match(options.format); + + if (!match) continue; + + var child = { + id: encodeURIComponent(match ? match[1] : null), + element: element, + parent: parent, + children: [], + position: parent.children.length, + container: $(children[i]).down(options.treeTag) + } + + /* Get the element containing the children and recurse over it */ + if (child.container) + this._tree(child.container, options, child) + + parent.children.push (child); + } + + return parent; + }, + + tree: function(element) { + element = $(element); + var sortableOptions = this.options(element); + var options = Object.extend({ + tag: sortableOptions.tag, + treeTag: sortableOptions.treeTag, + only: sortableOptions.only, + name: element.id, + format: sortableOptions.format + }, arguments[1] || { }); + + var root = { + id: null, + parent: null, + children: [], + container: element, + position: 0 + } + + return Sortable._tree(element, options, root); + }, + + /* Construct a [i] index for a particular node */ + _constructIndex: function(node) { + var index = ''; + do { + if (node.id) index = '[' + node.position + ']' + index; + } while ((node = node.parent) != null); + return index; + }, + + sequence: function(element) { + element = $(element); + var options = Object.extend(this.options(element), arguments[1] || { }); + + return $(this.findElements(element, options) || []).map( function(item) { + return item.id.match(options.format) ? item.id.match(options.format)[1] : ''; + }); + }, + + setSequence: function(element, new_sequence) { + element = $(element); + var options = Object.extend(this.options(element), arguments[2] || { }); + + var nodeMap = { }; + this.findElements(element, options).each( function(n) { + if (n.id.match(options.format)) + nodeMap[n.id.match(options.format)[1]] = [n, n.parentNode]; + n.parentNode.removeChild(n); + }); + + new_sequence.each(function(ident) { + var n = nodeMap[ident]; + if (n) { + n[1].appendChild(n[0]); + delete nodeMap[ident]; + } + }); + }, + + serialize: function(element) { + element = $(element); + var options = Object.extend(Sortable.options(element), arguments[1] || { }); + var name = encodeURIComponent( + (arguments[1] && arguments[1].name) ? arguments[1].name : element.id); + + if (options.tree) { + return Sortable.tree(element, arguments[1]).children.map( function (item) { + return [name + Sortable._constructIndex(item) + "[id]=" + + encodeURIComponent(item.id)].concat(item.children.map(arguments.callee)); + }).flatten().join('&'); + } else { + return Sortable.sequence(element, arguments[1]).map( function(item) { + return name + "[]=" + encodeURIComponent(item); + }).join('&'); + } + } +} + +// Returns true if child is contained within element +Element.isParent = function(child, element) { + if (!child.parentNode || child == element) return false; + if (child.parentNode == element) return true; + return Element.isParent(child.parentNode, element); +} + +Element.findChildren = function(element, only, recursive, tagName) { + if(!element.hasChildNodes()) return null; + tagName = tagName.toUpperCase(); + if(only) only = [only].flatten(); + var elements = []; + $A(element.childNodes).each( function(e) { + if(e.tagName && e.tagName.toUpperCase()==tagName && + (!only || (Element.classNames(e).detect(function(v) { return only.include(v) })))) + elements.push(e); + if(recursive) { + var grandchildren = Element.findChildren(e, only, recursive, tagName); + if(grandchildren) elements.push(grandchildren); + } + }); + + return (elements.length>0 ? elements.flatten() : []); +} + +Element.offsetSize = function (element, type) { + return element['offset' + ((type=='vertical' || type=='height') ? 'Height' : 'Width')]; +} diff --git a/website/src/javascripts/effects.js b/website/src/javascripts/effects.js new file mode 100644 index 00000000..65aed239 --- /dev/null +++ b/website/src/javascripts/effects.js @@ -0,0 +1,1120 @@ +// Copyright (c) 2005-2007 Thomas Fuchs (http://script.aculo.us, http://mir.aculo.us) +// Contributors: +// Justin Palmer (http://encytemedia.com/) +// Mark Pilgrim (http://diveintomark.org/) +// Martin Bialasinki +// +// script.aculo.us is freely distributable under the terms of an MIT-style license. +// For details, see the script.aculo.us web site: http://script.aculo.us/ + +// converts rgb() and #xxx to #xxxxxx format, +// returns self (or first argument) if not convertable +String.prototype.parseColor = function() { + var color = '#'; + if (this.slice(0,4) == 'rgb(') { + var cols = this.slice(4,this.length-1).split(','); + var i=0; do { color += parseInt(cols[i]).toColorPart() } while (++i<3); + } else { + if (this.slice(0,1) == '#') { + if (this.length==4) for(var i=1;i<4;i++) color += (this.charAt(i) + this.charAt(i)).toLowerCase(); + if (this.length==7) color = this.toLowerCase(); + } + } + return (color.length==7 ? color : (arguments[0] || this)); +}; + +/*--------------------------------------------------------------------------*/ + +Element.collectTextNodes = function(element) { + return $A($(element).childNodes).collect( function(node) { + return (node.nodeType==3 ? node.nodeValue : + (node.hasChildNodes() ? Element.collectTextNodes(node) : '')); + }).flatten().join(''); +}; + +Element.collectTextNodesIgnoreClass = function(element, className) { + return $A($(element).childNodes).collect( function(node) { + return (node.nodeType==3 ? node.nodeValue : + ((node.hasChildNodes() && !Element.hasClassName(node,className)) ? + Element.collectTextNodesIgnoreClass(node, className) : '')); + }).flatten().join(''); +}; + +Element.setContentZoom = function(element, percent) { + element = $(element); + element.setStyle({fontSize: (percent/100) + 'em'}); + if (Prototype.Browser.WebKit) window.scrollBy(0,0); + return element; +}; + +Element.getInlineOpacity = function(element){ + return $(element).style.opacity || ''; +}; + +Element.forceRerendering = function(element) { + try { + element = $(element); + var n = document.createTextNode(' '); + element.appendChild(n); + element.removeChild(n); + } catch(e) { } +}; + +/*--------------------------------------------------------------------------*/ + +var Effect = { + _elementDoesNotExistError: { + name: 'ElementDoesNotExistError', + message: 'The specified DOM element does not exist, but is required for this effect to operate' + }, + Transitions: { + linear: Prototype.K, + sinoidal: function(pos) { + return (-Math.cos(pos*Math.PI)/2) + 0.5; + }, + reverse: function(pos) { + return 1-pos; + }, + flicker: function(pos) { + var pos = ((-Math.cos(pos*Math.PI)/4) + 0.75) + Math.random()/4; + return pos > 1 ? 1 : pos; + }, + wobble: function(pos) { + return (-Math.cos(pos*Math.PI*(9*pos))/2) + 0.5; + }, + pulse: function(pos, pulses) { + pulses = pulses || 5; + return ( + ((pos % (1/pulses)) * pulses).round() == 0 ? + ((pos * pulses * 2) - (pos * pulses * 2).floor()) : + 1 - ((pos * pulses * 2) - (pos * pulses * 2).floor()) + ); + }, + spring: function(pos) { + return 1 - (Math.cos(pos * 4.5 * Math.PI) * Math.exp(-pos * 6)); + }, + none: function(pos) { + return 0; + }, + full: function(pos) { + return 1; + } + }, + DefaultOptions: { + duration: 1.0, // seconds + fps: 100, // 100= assume 66fps max. + sync: false, // true for combining + from: 0.0, + to: 1.0, + delay: 0.0, + queue: 'parallel' + }, + tagifyText: function(element) { + var tagifyStyle = 'position:relative'; + if (Prototype.Browser.IE) tagifyStyle += ';zoom:1'; + + element = $(element); + $A(element.childNodes).each( function(child) { + if (child.nodeType==3) { + child.nodeValue.toArray().each( function(character) { + element.insertBefore( + new Element('span', {style: tagifyStyle}).update( + character == ' ' ? String.fromCharCode(160) : character), + child); + }); + Element.remove(child); + } + }); + }, + multiple: function(element, effect) { + var elements; + if (((typeof element == 'object') || + Object.isFunction(element)) && + (element.length)) + elements = element; + else + elements = $(element).childNodes; + + var options = Object.extend({ + speed: 0.1, + delay: 0.0 + }, arguments[2] || { }); + var masterDelay = options.delay; + + $A(elements).each( function(element, index) { + new effect(element, Object.extend(options, { delay: index * options.speed + masterDelay })); + }); + }, + PAIRS: { + 'slide': ['SlideDown','SlideUp'], + 'blind': ['BlindDown','BlindUp'], + 'appear': ['Appear','Fade'] + }, + toggle: function(element, effect) { + element = $(element); + effect = (effect || 'appear').toLowerCase(); + var options = Object.extend({ + queue: { position:'end', scope:(element.id || 'global'), limit: 1 } + }, arguments[2] || { }); + Effect[element.visible() ? + Effect.PAIRS[effect][1] : Effect.PAIRS[effect][0]](element, options); + } +}; + +Effect.DefaultOptions.transition = Effect.Transitions.sinoidal; + +/* ------------- core effects ------------- */ + +Effect.ScopedQueue = Class.create(Enumerable, { + initialize: function() { + this.effects = []; + this.interval = null; + }, + _each: function(iterator) { + this.effects._each(iterator); + }, + add: function(effect) { + var timestamp = new Date().getTime(); + + var position = Object.isString(effect.options.queue) ? + effect.options.queue : effect.options.queue.position; + + switch(position) { + case 'front': + // move unstarted effects after this effect + this.effects.findAll(function(e){ return e.state=='idle' }).each( function(e) { + e.startOn += effect.finishOn; + e.finishOn += effect.finishOn; + }); + break; + case 'with-last': + timestamp = this.effects.pluck('startOn').max() || timestamp; + break; + case 'end': + // start effect after last queued effect has finished + timestamp = this.effects.pluck('finishOn').max() || timestamp; + break; + } + + effect.startOn += timestamp; + effect.finishOn += timestamp; + + if (!effect.options.queue.limit || (this.effects.length < effect.options.queue.limit)) + this.effects.push(effect); + + if (!this.interval) + this.interval = setInterval(this.loop.bind(this), 15); + }, + remove: function(effect) { + this.effects = this.effects.reject(function(e) { return e==effect }); + if (this.effects.length == 0) { + clearInterval(this.interval); + this.interval = null; + } + }, + loop: function() { + var timePos = new Date().getTime(); + for(var i=0, len=this.effects.length;i= this.startOn) { + if (timePos >= this.finishOn) { + this.render(1.0); + this.cancel(); + this.event('beforeFinish'); + if (this.finish) this.finish(); + this.event('afterFinish'); + return; + } + var pos = (timePos - this.startOn) / this.totalTime, + frame = (pos * this.totalFrames).round(); + if (frame > this.currentFrame) { + this.render(pos); + this.currentFrame = frame; + } + } + }, + cancel: function() { + if (!this.options.sync) + Effect.Queues.get(Object.isString(this.options.queue) ? + 'global' : this.options.queue.scope).remove(this); + this.state = 'finished'; + }, + event: function(eventName) { + if (this.options[eventName + 'Internal']) this.options[eventName + 'Internal'](this); + if (this.options[eventName]) this.options[eventName](this); + }, + inspect: function() { + var data = $H(); + for(property in this) + if (!Object.isFunction(this[property])) data.set(property, this[property]); + return '#'; + } +}); + +Effect.Parallel = Class.create(Effect.Base, { + initialize: function(effects) { + this.effects = effects || []; + this.start(arguments[1]); + }, + update: function(position) { + this.effects.invoke('render', position); + }, + finish: function(position) { + this.effects.each( function(effect) { + effect.render(1.0); + effect.cancel(); + effect.event('beforeFinish'); + if (effect.finish) effect.finish(position); + effect.event('afterFinish'); + }); + } +}); + +Effect.Tween = Class.create(Effect.Base, { + initialize: function(object, from, to) { + object = Object.isString(object) ? $(object) : object; + var args = $A(arguments), method = args.last(), + options = args.length == 5 ? args[3] : null; + this.method = Object.isFunction(method) ? method.bind(object) : + Object.isFunction(object[method]) ? object[method].bind(object) : + function(value) { object[method] = value }; + this.start(Object.extend({ from: from, to: to }, options || { })); + }, + update: function(position) { + this.method(position); + } +}); + +Effect.Event = Class.create(Effect.Base, { + initialize: function() { + this.start(Object.extend({ duration: 0 }, arguments[0] || { })); + }, + update: Prototype.emptyFunction +}); + +Effect.Opacity = Class.create(Effect.Base, { + initialize: function(element) { + this.element = $(element); + if (!this.element) throw(Effect._elementDoesNotExistError); + // make this work on IE on elements without 'layout' + if (Prototype.Browser.IE && (!this.element.currentStyle.hasLayout)) + this.element.setStyle({zoom: 1}); + var options = Object.extend({ + from: this.element.getOpacity() || 0.0, + to: 1.0 + }, arguments[1] || { }); + this.start(options); + }, + update: function(position) { + this.element.setOpacity(position); + } +}); + +Effect.Move = Class.create(Effect.Base, { + initialize: function(element) { + this.element = $(element); + if (!this.element) throw(Effect._elementDoesNotExistError); + var options = Object.extend({ + x: 0, + y: 0, + mode: 'relative' + }, arguments[1] || { }); + this.start(options); + }, + setup: function() { + this.element.makePositioned(); + this.originalLeft = parseFloat(this.element.getStyle('left') || '0'); + this.originalTop = parseFloat(this.element.getStyle('top') || '0'); + if (this.options.mode == 'absolute') { + this.options.x = this.options.x - this.originalLeft; + this.options.y = this.options.y - this.originalTop; + } + }, + update: function(position) { + this.element.setStyle({ + left: (this.options.x * position + this.originalLeft).round() + 'px', + top: (this.options.y * position + this.originalTop).round() + 'px' + }); + } +}); + +// for backwards compatibility +Effect.MoveBy = function(element, toTop, toLeft) { + return new Effect.Move(element, + Object.extend({ x: toLeft, y: toTop }, arguments[3] || { })); +}; + +Effect.Scale = Class.create(Effect.Base, { + initialize: function(element, percent) { + this.element = $(element); + if (!this.element) throw(Effect._elementDoesNotExistError); + var options = Object.extend({ + scaleX: true, + scaleY: true, + scaleContent: true, + scaleFromCenter: false, + scaleMode: 'box', // 'box' or 'contents' or { } with provided values + scaleFrom: 100.0, + scaleTo: percent + }, arguments[2] || { }); + this.start(options); + }, + setup: function() { + this.restoreAfterFinish = this.options.restoreAfterFinish || false; + this.elementPositioning = this.element.getStyle('position'); + + this.originalStyle = { }; + ['top','left','width','height','fontSize'].each( function(k) { + this.originalStyle[k] = this.element.style[k]; + }.bind(this)); + + this.originalTop = this.element.offsetTop; + this.originalLeft = this.element.offsetLeft; + + var fontSize = this.element.getStyle('font-size') || '100%'; + ['em','px','%','pt'].each( function(fontSizeType) { + if (fontSize.indexOf(fontSizeType)>0) { + this.fontSize = parseFloat(fontSize); + this.fontSizeType = fontSizeType; + } + }.bind(this)); + + this.factor = (this.options.scaleTo - this.options.scaleFrom)/100; + + this.dims = null; + if (this.options.scaleMode=='box') + this.dims = [this.element.offsetHeight, this.element.offsetWidth]; + if (/^content/.test(this.options.scaleMode)) + this.dims = [this.element.scrollHeight, this.element.scrollWidth]; + if (!this.dims) + this.dims = [this.options.scaleMode.originalHeight, + this.options.scaleMode.originalWidth]; + }, + update: function(position) { + var currentScale = (this.options.scaleFrom/100.0) + (this.factor * position); + if (this.options.scaleContent && this.fontSize) + this.element.setStyle({fontSize: this.fontSize * currentScale + this.fontSizeType }); + this.setDimensions(this.dims[0] * currentScale, this.dims[1] * currentScale); + }, + finish: function(position) { + if (this.restoreAfterFinish) this.element.setStyle(this.originalStyle); + }, + setDimensions: function(height, width) { + var d = { }; + if (this.options.scaleX) d.width = width.round() + 'px'; + if (this.options.scaleY) d.height = height.round() + 'px'; + if (this.options.scaleFromCenter) { + var topd = (height - this.dims[0])/2; + var leftd = (width - this.dims[1])/2; + if (this.elementPositioning == 'absolute') { + if (this.options.scaleY) d.top = this.originalTop-topd + 'px'; + if (this.options.scaleX) d.left = this.originalLeft-leftd + 'px'; + } else { + if (this.options.scaleY) d.top = -topd + 'px'; + if (this.options.scaleX) d.left = -leftd + 'px'; + } + } + this.element.setStyle(d); + } +}); + +Effect.Highlight = Class.create(Effect.Base, { + initialize: function(element) { + this.element = $(element); + if (!this.element) throw(Effect._elementDoesNotExistError); + var options = Object.extend({ startcolor: '#ffff99' }, arguments[1] || { }); + this.start(options); + }, + setup: function() { + // Prevent executing on elements not in the layout flow + if (this.element.getStyle('display')=='none') { this.cancel(); return; } + // Disable background image during the effect + this.oldStyle = { }; + if (!this.options.keepBackgroundImage) { + this.oldStyle.backgroundImage = this.element.getStyle('background-image'); + this.element.setStyle({backgroundImage: 'none'}); + } + if (!this.options.endcolor) + this.options.endcolor = this.element.getStyle('background-color').parseColor('#ffffff'); + if (!this.options.restorecolor) + this.options.restorecolor = this.element.getStyle('background-color'); + // init color calculations + this._base = $R(0,2).map(function(i){ return parseInt(this.options.startcolor.slice(i*2+1,i*2+3),16) }.bind(this)); + this._delta = $R(0,2).map(function(i){ return parseInt(this.options.endcolor.slice(i*2+1,i*2+3),16)-this._base[i] }.bind(this)); + }, + update: function(position) { + this.element.setStyle({backgroundColor: $R(0,2).inject('#',function(m,v,i){ + return m+((this._base[i]+(this._delta[i]*position)).round().toColorPart()); }.bind(this)) }); + }, + finish: function() { + this.element.setStyle(Object.extend(this.oldStyle, { + backgroundColor: this.options.restorecolor + })); + } +}); + +Effect.ScrollTo = function(element) { + var options = arguments[1] || { }, + scrollOffsets = document.viewport.getScrollOffsets(), + elementOffsets = $(element).cumulativeOffset(), + max = (window.height || document.body.scrollHeight) - document.viewport.getHeight(); + + if (options.offset) elementOffsets[1] += options.offset; + + return new Effect.Tween(null, + scrollOffsets.top, + elementOffsets[1] > max ? max : elementOffsets[1], + options, + function(p){ scrollTo(scrollOffsets.left, p.round()) } + ); +}; + +/* ------------- combination effects ------------- */ + +Effect.Fade = function(element) { + element = $(element); + var oldOpacity = element.getInlineOpacity(); + var options = Object.extend({ + from: element.getOpacity() || 1.0, + to: 0.0, + afterFinishInternal: function(effect) { + if (effect.options.to!=0) return; + effect.element.hide().setStyle({opacity: oldOpacity}); + } + }, arguments[1] || { }); + return new Effect.Opacity(element,options); +}; + +Effect.Appear = function(element) { + element = $(element); + var options = Object.extend({ + from: (element.getStyle('display') == 'none' ? 0.0 : element.getOpacity() || 0.0), + to: 1.0, + // force Safari to render floated elements properly + afterFinishInternal: function(effect) { + effect.element.forceRerendering(); + }, + beforeSetup: function(effect) { + effect.element.setOpacity(effect.options.from).show(); + }}, arguments[1] || { }); + return new Effect.Opacity(element,options); +}; + +Effect.Puff = function(element) { + element = $(element); + var oldStyle = { + opacity: element.getInlineOpacity(), + position: element.getStyle('position'), + top: element.style.top, + left: element.style.left, + width: element.style.width, + height: element.style.height + }; + return new Effect.Parallel( + [ new Effect.Scale(element, 200, + { sync: true, scaleFromCenter: true, scaleContent: true, restoreAfterFinish: true }), + new Effect.Opacity(element, { sync: true, to: 0.0 } ) ], + Object.extend({ duration: 1.0, + beforeSetupInternal: function(effect) { + Position.absolutize(effect.effects[0].element) + }, + afterFinishInternal: function(effect) { + effect.effects[0].element.hide().setStyle(oldStyle); } + }, arguments[1] || { }) + ); +}; + +Effect.BlindUp = function(element) { + element = $(element); + element.makeClipping(); + return new Effect.Scale(element, 0, + Object.extend({ scaleContent: false, + scaleX: false, + restoreAfterFinish: true, + afterFinishInternal: function(effect) { + effect.element.hide().undoClipping(); + } + }, arguments[1] || { }) + ); +}; + +Effect.BlindDown = function(element) { + element = $(element); + var elementDimensions = element.getDimensions(); + return new Effect.Scale(element, 100, Object.extend({ + scaleContent: false, + scaleX: false, + scaleFrom: 0, + scaleMode: {originalHeight: elementDimensions.height, originalWidth: elementDimensions.width}, + restoreAfterFinish: true, + afterSetup: function(effect) { + effect.element.makeClipping().setStyle({height: '0px'}).show(); + }, + afterFinishInternal: function(effect) { + effect.element.undoClipping(); + } + }, arguments[1] || { })); +}; + +Effect.SwitchOff = function(element) { + element = $(element); + var oldOpacity = element.getInlineOpacity(); + return new Effect.Appear(element, Object.extend({ + duration: 0.4, + from: 0, + transition: Effect.Transitions.flicker, + afterFinishInternal: function(effect) { + new Effect.Scale(effect.element, 1, { + duration: 0.3, scaleFromCenter: true, + scaleX: false, scaleContent: false, restoreAfterFinish: true, + beforeSetup: function(effect) { + effect.element.makePositioned().makeClipping(); + }, + afterFinishInternal: function(effect) { + effect.element.hide().undoClipping().undoPositioned().setStyle({opacity: oldOpacity}); + } + }) + } + }, arguments[1] || { })); +}; + +Effect.DropOut = function(element) { + element = $(element); + var oldStyle = { + top: element.getStyle('top'), + left: element.getStyle('left'), + opacity: element.getInlineOpacity() }; + return new Effect.Parallel( + [ new Effect.Move(element, {x: 0, y: 100, sync: true }), + new Effect.Opacity(element, { sync: true, to: 0.0 }) ], + Object.extend( + { duration: 0.5, + beforeSetup: function(effect) { + effect.effects[0].element.makePositioned(); + }, + afterFinishInternal: function(effect) { + effect.effects[0].element.hide().undoPositioned().setStyle(oldStyle); + } + }, arguments[1] || { })); +}; + +Effect.Shake = function(element) { + element = $(element); + var options = Object.extend({ + distance: 20, + duration: 0.5 + }, arguments[1] || {}); + var distance = parseFloat(options.distance); + var split = parseFloat(options.duration) / 10.0; + var oldStyle = { + top: element.getStyle('top'), + left: element.getStyle('left') }; + return new Effect.Move(element, + { x: distance, y: 0, duration: split, afterFinishInternal: function(effect) { + new Effect.Move(effect.element, + { x: -distance*2, y: 0, duration: split*2, afterFinishInternal: function(effect) { + new Effect.Move(effect.element, + { x: distance*2, y: 0, duration: split*2, afterFinishInternal: function(effect) { + new Effect.Move(effect.element, + { x: -distance*2, y: 0, duration: split*2, afterFinishInternal: function(effect) { + new Effect.Move(effect.element, + { x: distance*2, y: 0, duration: split*2, afterFinishInternal: function(effect) { + new Effect.Move(effect.element, + { x: -distance, y: 0, duration: split, afterFinishInternal: function(effect) { + effect.element.undoPositioned().setStyle(oldStyle); + }}) }}) }}) }}) }}) }}); +}; + +Effect.SlideDown = function(element) { + element = $(element).cleanWhitespace(); + // SlideDown need to have the content of the element wrapped in a container element with fixed height! + var oldInnerBottom = element.down().getStyle('bottom'); + var elementDimensions = element.getDimensions(); + return new Effect.Scale(element, 100, Object.extend({ + scaleContent: false, + scaleX: false, + scaleFrom: window.opera ? 0 : 1, + scaleMode: {originalHeight: elementDimensions.height, originalWidth: elementDimensions.width}, + restoreAfterFinish: true, + afterSetup: function(effect) { + effect.element.makePositioned(); + effect.element.down().makePositioned(); + if (window.opera) effect.element.setStyle({top: ''}); + effect.element.makeClipping().setStyle({height: '0px'}).show(); + }, + afterUpdateInternal: function(effect) { + effect.element.down().setStyle({bottom: + (effect.dims[0] - effect.element.clientHeight) + 'px' }); + }, + afterFinishInternal: function(effect) { + effect.element.undoClipping().undoPositioned(); + effect.element.down().undoPositioned().setStyle({bottom: oldInnerBottom}); } + }, arguments[1] || { }) + ); +}; + +Effect.SlideUp = function(element) { + element = $(element).cleanWhitespace(); + var oldInnerBottom = element.down().getStyle('bottom'); + var elementDimensions = element.getDimensions(); + return new Effect.Scale(element, window.opera ? 0 : 1, + Object.extend({ scaleContent: false, + scaleX: false, + scaleMode: 'box', + scaleFrom: 100, + scaleMode: {originalHeight: elementDimensions.height, originalWidth: elementDimensions.width}, + restoreAfterFinish: true, + afterSetup: function(effect) { + effect.element.makePositioned(); + effect.element.down().makePositioned(); + if (window.opera) effect.element.setStyle({top: ''}); + effect.element.makeClipping().show(); + }, + afterUpdateInternal: function(effect) { + effect.element.down().setStyle({bottom: + (effect.dims[0] - effect.element.clientHeight) + 'px' }); + }, + afterFinishInternal: function(effect) { + effect.element.hide().undoClipping().undoPositioned(); + effect.element.down().undoPositioned().setStyle({bottom: oldInnerBottom}); + } + }, arguments[1] || { }) + ); +}; + +// Bug in opera makes the TD containing this element expand for a instance after finish +Effect.Squish = function(element) { + return new Effect.Scale(element, window.opera ? 1 : 0, { + restoreAfterFinish: true, + beforeSetup: function(effect) { + effect.element.makeClipping(); + }, + afterFinishInternal: function(effect) { + effect.element.hide().undoClipping(); + } + }); +}; + +Effect.Grow = function(element) { + element = $(element); + var options = Object.extend({ + direction: 'center', + moveTransition: Effect.Transitions.sinoidal, + scaleTransition: Effect.Transitions.sinoidal, + opacityTransition: Effect.Transitions.full + }, arguments[1] || { }); + var oldStyle = { + top: element.style.top, + left: element.style.left, + height: element.style.height, + width: element.style.width, + opacity: element.getInlineOpacity() }; + + var dims = element.getDimensions(); + var initialMoveX, initialMoveY; + var moveX, moveY; + + switch (options.direction) { + case 'top-left': + initialMoveX = initialMoveY = moveX = moveY = 0; + break; + case 'top-right': + initialMoveX = dims.width; + initialMoveY = moveY = 0; + moveX = -dims.width; + break; + case 'bottom-left': + initialMoveX = moveX = 0; + initialMoveY = dims.height; + moveY = -dims.height; + break; + case 'bottom-right': + initialMoveX = dims.width; + initialMoveY = dims.height; + moveX = -dims.width; + moveY = -dims.height; + break; + case 'center': + initialMoveX = dims.width / 2; + initialMoveY = dims.height / 2; + moveX = -dims.width / 2; + moveY = -dims.height / 2; + break; + } + + return new Effect.Move(element, { + x: initialMoveX, + y: initialMoveY, + duration: 0.01, + beforeSetup: function(effect) { + effect.element.hide().makeClipping().makePositioned(); + }, + afterFinishInternal: function(effect) { + new Effect.Parallel( + [ new Effect.Opacity(effect.element, { sync: true, to: 1.0, from: 0.0, transition: options.opacityTransition }), + new Effect.Move(effect.element, { x: moveX, y: moveY, sync: true, transition: options.moveTransition }), + new Effect.Scale(effect.element, 100, { + scaleMode: { originalHeight: dims.height, originalWidth: dims.width }, + sync: true, scaleFrom: window.opera ? 1 : 0, transition: options.scaleTransition, restoreAfterFinish: true}) + ], Object.extend({ + beforeSetup: function(effect) { + effect.effects[0].element.setStyle({height: '0px'}).show(); + }, + afterFinishInternal: function(effect) { + effect.effects[0].element.undoClipping().undoPositioned().setStyle(oldStyle); + } + }, options) + ) + } + }); +}; + +Effect.Shrink = function(element) { + element = $(element); + var options = Object.extend({ + direction: 'center', + moveTransition: Effect.Transitions.sinoidal, + scaleTransition: Effect.Transitions.sinoidal, + opacityTransition: Effect.Transitions.none + }, arguments[1] || { }); + var oldStyle = { + top: element.style.top, + left: element.style.left, + height: element.style.height, + width: element.style.width, + opacity: element.getInlineOpacity() }; + + var dims = element.getDimensions(); + var moveX, moveY; + + switch (options.direction) { + case 'top-left': + moveX = moveY = 0; + break; + case 'top-right': + moveX = dims.width; + moveY = 0; + break; + case 'bottom-left': + moveX = 0; + moveY = dims.height; + break; + case 'bottom-right': + moveX = dims.width; + moveY = dims.height; + break; + case 'center': + moveX = dims.width / 2; + moveY = dims.height / 2; + break; + } + + return new Effect.Parallel( + [ new Effect.Opacity(element, { sync: true, to: 0.0, from: 1.0, transition: options.opacityTransition }), + new Effect.Scale(element, window.opera ? 1 : 0, { sync: true, transition: options.scaleTransition, restoreAfterFinish: true}), + new Effect.Move(element, { x: moveX, y: moveY, sync: true, transition: options.moveTransition }) + ], Object.extend({ + beforeStartInternal: function(effect) { + effect.effects[0].element.makePositioned().makeClipping(); + }, + afterFinishInternal: function(effect) { + effect.effects[0].element.hide().undoClipping().undoPositioned().setStyle(oldStyle); } + }, options) + ); +}; + +Effect.Pulsate = function(element) { + element = $(element); + var options = arguments[1] || { }; + var oldOpacity = element.getInlineOpacity(); + var transition = options.transition || Effect.Transitions.sinoidal; + var reverser = function(pos){ return transition(1-Effect.Transitions.pulse(pos, options.pulses)) }; + reverser.bind(transition); + return new Effect.Opacity(element, + Object.extend(Object.extend({ duration: 2.0, from: 0, + afterFinishInternal: function(effect) { effect.element.setStyle({opacity: oldOpacity}); } + }, options), {transition: reverser})); +}; + +Effect.Fold = function(element) { + element = $(element); + var oldStyle = { + top: element.style.top, + left: element.style.left, + width: element.style.width, + height: element.style.height }; + element.makeClipping(); + return new Effect.Scale(element, 5, Object.extend({ + scaleContent: false, + scaleX: false, + afterFinishInternal: function(effect) { + new Effect.Scale(element, 1, { + scaleContent: false, + scaleY: false, + afterFinishInternal: function(effect) { + effect.element.hide().undoClipping().setStyle(oldStyle); + } }); + }}, arguments[1] || { })); +}; + +Effect.Morph = Class.create(Effect.Base, { + initialize: function(element) { + this.element = $(element); + if (!this.element) throw(Effect._elementDoesNotExistError); + var options = Object.extend({ + style: { } + }, arguments[1] || { }); + + if (!Object.isString(options.style)) this.style = $H(options.style); + else { + if (options.style.include(':')) + this.style = options.style.parseStyle(); + else { + this.element.addClassName(options.style); + this.style = $H(this.element.getStyles()); + this.element.removeClassName(options.style); + var css = this.element.getStyles(); + this.style = this.style.reject(function(style) { + return style.value == css[style.key]; + }); + options.afterFinishInternal = function(effect) { + effect.element.addClassName(effect.options.style); + effect.transforms.each(function(transform) { + effect.element.style[transform.style] = ''; + }); + } + } + } + this.start(options); + }, + + setup: function(){ + function parseColor(color){ + if (!color || ['rgba(0, 0, 0, 0)','transparent'].include(color)) color = '#ffffff'; + color = color.parseColor(); + return $R(0,2).map(function(i){ + return parseInt( color.slice(i*2+1,i*2+3), 16 ) + }); + } + this.transforms = this.style.map(function(pair){ + var property = pair[0], value = pair[1], unit = null; + + if (value.parseColor('#zzzzzz') != '#zzzzzz') { + value = value.parseColor(); + unit = 'color'; + } else if (property == 'opacity') { + value = parseFloat(value); + if (Prototype.Browser.IE && (!this.element.currentStyle.hasLayout)) + this.element.setStyle({zoom: 1}); + } else if (Element.CSS_LENGTH.test(value)) { + var components = value.match(/^([\+\-]?[0-9\.]+)(.*)$/); + value = parseFloat(components[1]); + unit = (components.length == 3) ? components[2] : null; + } + + var originalValue = this.element.getStyle(property); + return { + style: property.camelize(), + originalValue: unit=='color' ? parseColor(originalValue) : parseFloat(originalValue || 0), + targetValue: unit=='color' ? parseColor(value) : value, + unit: unit + }; + }.bind(this)).reject(function(transform){ + return ( + (transform.originalValue == transform.targetValue) || + ( + transform.unit != 'color' && + (isNaN(transform.originalValue) || isNaN(transform.targetValue)) + ) + ) + }); + }, + update: function(position) { + var style = { }, transform, i = this.transforms.length; + while(i--) + style[(transform = this.transforms[i]).style] = + transform.unit=='color' ? '#'+ + (Math.round(transform.originalValue[0]+ + (transform.targetValue[0]-transform.originalValue[0])*position)).toColorPart() + + (Math.round(transform.originalValue[1]+ + (transform.targetValue[1]-transform.originalValue[1])*position)).toColorPart() + + (Math.round(transform.originalValue[2]+ + (transform.targetValue[2]-transform.originalValue[2])*position)).toColorPart() : + (transform.originalValue + + (transform.targetValue - transform.originalValue) * position).toFixed(3) + + (transform.unit === null ? '' : transform.unit); + this.element.setStyle(style, true); + } +}); + +Effect.Transform = Class.create({ + initialize: function(tracks){ + this.tracks = []; + this.options = arguments[1] || { }; + this.addTracks(tracks); + }, + addTracks: function(tracks){ + tracks.each(function(track){ + track = $H(track); + var data = track.values().first(); + this.tracks.push($H({ + ids: track.keys().first(), + effect: Effect.Morph, + options: { style: data } + })); + }.bind(this)); + return this; + }, + play: function(){ + return new Effect.Parallel( + this.tracks.map(function(track){ + var ids = track.get('ids'), effect = track.get('effect'), options = track.get('options'); + var elements = [$(ids) || $$(ids)].flatten(); + return elements.map(function(e){ return new effect(e, Object.extend({ sync:true }, options)) }); + }).flatten(), + this.options + ); + } +}); + +Element.CSS_PROPERTIES = $w( + 'backgroundColor backgroundPosition borderBottomColor borderBottomStyle ' + + 'borderBottomWidth borderLeftColor borderLeftStyle borderLeftWidth ' + + 'borderRightColor borderRightStyle borderRightWidth borderSpacing ' + + 'borderTopColor borderTopStyle borderTopWidth bottom clip color ' + + 'fontSize fontWeight height left letterSpacing lineHeight ' + + 'marginBottom marginLeft marginRight marginTop markerOffset maxHeight '+ + 'maxWidth minHeight minWidth opacity outlineColor outlineOffset ' + + 'outlineWidth paddingBottom paddingLeft paddingRight paddingTop ' + + 'right textIndent top width wordSpacing zIndex'); + +Element.CSS_LENGTH = /^(([\+\-]?[0-9\.]+)(em|ex|px|in|cm|mm|pt|pc|\%))|0$/; + +String.__parseStyleElement = document.createElement('div'); +String.prototype.parseStyle = function(){ + var style, styleRules = $H(); + if (Prototype.Browser.WebKit) + style = new Element('div',{style:this}).style; + else { + String.__parseStyleElement.innerHTML = '
    '; + style = String.__parseStyleElement.childNodes[0].style; + } + + Element.CSS_PROPERTIES.each(function(property){ + if (style[property]) styleRules.set(property, style[property]); + }); + + if (Prototype.Browser.IE && this.include('opacity')) + styleRules.set('opacity', this.match(/opacity:\s*((?:0|1)?(?:\.\d*)?)/)[1]); + + return styleRules; +}; + +if (document.defaultView && document.defaultView.getComputedStyle) { + Element.getStyles = function(element) { + var css = document.defaultView.getComputedStyle($(element), null); + return Element.CSS_PROPERTIES.inject({ }, function(styles, property) { + styles[property] = css[property]; + return styles; + }); + }; +} else { + Element.getStyles = function(element) { + element = $(element); + var css = element.currentStyle, styles; + styles = Element.CSS_PROPERTIES.inject({ }, function(hash, property) { + hash.set(property, css[property]); + return hash; + }); + if (!styles.opacity) styles.set('opacity', element.getOpacity()); + return styles; + }; +}; + +Effect.Methods = { + morph: function(element, style) { + element = $(element); + new Effect.Morph(element, Object.extend({ style: style }, arguments[2] || { })); + return element; + }, + visualEffect: function(element, effect, options) { + element = $(element) + var s = effect.dasherize().camelize(), klass = s.charAt(0).toUpperCase() + s.substring(1); + new Effect[klass](element, options); + return element; + }, + highlight: function(element, options) { + element = $(element); + new Effect.Highlight(element, options); + return element; + } +}; + +$w('fade appear grow shrink fold blindUp blindDown slideUp slideDown '+ + 'pulsate shake puff squish switchOff dropOut').each( + function(effect) { + Effect.Methods[effect] = function(element, options){ + element = $(element); + Effect[effect.charAt(0).toUpperCase() + effect.substring(1)](element, options); + return element; + } + } +); + +$w('getInlineOpacity forceRerendering setContentZoom collectTextNodes collectTextNodesIgnoreClass getStyles').each( + function(f) { Effect.Methods[f] = Element[f]; } +); + +Element.addMethods(Effect.Methods); diff --git a/website/src/javascripts/prototype.js b/website/src/javascripts/prototype.js new file mode 100644 index 00000000..546f9fe4 --- /dev/null +++ b/website/src/javascripts/prototype.js @@ -0,0 +1,4225 @@ +/* Prototype JavaScript framework, version 1.6.0.1 + * (c) 2005-2007 Sam Stephenson + * + * Prototype is freely distributable under the terms of an MIT-style license. + * For details, see the Prototype web site: http://www.prototypejs.org/ + * + *--------------------------------------------------------------------------*/ + +var Prototype = { + Version: '1.6.0.1', + + Browser: { + IE: !!(window.attachEvent && !window.opera), + Opera: !!window.opera, + WebKit: navigator.userAgent.indexOf('AppleWebKit/') > -1, + Gecko: navigator.userAgent.indexOf('Gecko') > -1 && navigator.userAgent.indexOf('KHTML') == -1, + MobileSafari: !!navigator.userAgent.match(/Apple.*Mobile.*Safari/) + }, + + BrowserFeatures: { + XPath: !!document.evaluate, + ElementExtensions: !!window.HTMLElement, + SpecificElementExtensions: + document.createElement('div').__proto__ && + document.createElement('div').__proto__ !== + document.createElement('form').__proto__ + }, + + ScriptFragment: ']*>([\\S\\s]*?)<\/script>', + JSONFilter: /^\/\*-secure-([\s\S]*)\*\/\s*$/, + + emptyFunction: function() { }, + K: function(x) { return x } +}; + +if (Prototype.Browser.MobileSafari) + Prototype.BrowserFeatures.SpecificElementExtensions = false; + + +/* Based on Alex Arnell's inheritance implementation. */ +var Class = { + create: function() { + var parent = null, properties = $A(arguments); + if (Object.isFunction(properties[0])) + parent = properties.shift(); + + function klass() { + this.initialize.apply(this, arguments); + } + + Object.extend(klass, Class.Methods); + klass.superclass = parent; + klass.subclasses = []; + + if (parent) { + var subclass = function() { }; + subclass.prototype = parent.prototype; + klass.prototype = new subclass; + parent.subclasses.push(klass); + } + + for (var i = 0; i < properties.length; i++) + klass.addMethods(properties[i]); + + if (!klass.prototype.initialize) + klass.prototype.initialize = Prototype.emptyFunction; + + klass.prototype.constructor = klass; + + return klass; + } +}; + +Class.Methods = { + addMethods: function(source) { + var ancestor = this.superclass && this.superclass.prototype; + var properties = Object.keys(source); + + if (!Object.keys({ toString: true }).length) + properties.push("toString", "valueOf"); + + for (var i = 0, length = properties.length; i < length; i++) { + var property = properties[i], value = source[property]; + if (ancestor && Object.isFunction(value) && + value.argumentNames().first() == "$super") { + var method = value, value = Object.extend((function(m) { + return function() { return ancestor[m].apply(this, arguments) }; + })(property).wrap(method), { + valueOf: function() { return method }, + toString: function() { return method.toString() } + }); + } + this.prototype[property] = value; + } + + return this; + } +}; + +var Abstract = { }; + +Object.extend = function(destination, source) { + for (var property in source) + destination[property] = source[property]; + return destination; +}; + +Object.extend(Object, { + inspect: function(object) { + try { + if (Object.isUndefined(object)) return 'undefined'; + if (object === null) return 'null'; + return object.inspect ? object.inspect() : object.toString(); + } catch (e) { + if (e instanceof RangeError) return '...'; + throw e; + } + }, + + toJSON: function(object) { + var type = typeof object; + switch (type) { + case 'undefined': + case 'function': + case 'unknown': return; + case 'boolean': return object.toString(); + } + + if (object === null) return 'null'; + if (object.toJSON) return object.toJSON(); + if (Object.isElement(object)) return; + + var results = []; + for (var property in object) { + var value = Object.toJSON(object[property]); + if (!Object.isUndefined(value)) + results.push(property.toJSON() + ': ' + value); + } + + return '{' + results.join(', ') + '}'; + }, + + toQueryString: function(object) { + return $H(object).toQueryString(); + }, + + toHTML: function(object) { + return object && object.toHTML ? object.toHTML() : String.interpret(object); + }, + + keys: function(object) { + var keys = []; + for (var property in object) + keys.push(property); + return keys; + }, + + values: function(object) { + var values = []; + for (var property in object) + values.push(object[property]); + return values; + }, + + clone: function(object) { + return Object.extend({ }, object); + }, + + isElement: function(object) { + return object && object.nodeType == 1; + }, + + isArray: function(object) { + return object && object.constructor === Array; + }, + + isHash: function(object) { + return object instanceof Hash; + }, + + isFunction: function(object) { + return typeof object == "function"; + }, + + isString: function(object) { + return typeof object == "string"; + }, + + isNumber: function(object) { + return typeof object == "number"; + }, + + isUndefined: function(object) { + return typeof object == "undefined"; + } +}); + +Object.extend(Function.prototype, { + argumentNames: function() { + var names = this.toString().match(/^[\s\(]*function[^(]*\((.*?)\)/)[1].split(",").invoke("strip"); + return names.length == 1 && !names[0] ? [] : names; + }, + + bind: function() { + if (arguments.length < 2 && Object.isUndefined(arguments[0])) return this; + var __method = this, args = $A(arguments), object = args.shift(); + return function() { + return __method.apply(object, args.concat($A(arguments))); + } + }, + + bindAsEventListener: function() { + var __method = this, args = $A(arguments), object = args.shift(); + return function(event) { + return __method.apply(object, [event || window.event].concat(args)); + } + }, + + curry: function() { + if (!arguments.length) return this; + var __method = this, args = $A(arguments); + return function() { + return __method.apply(this, args.concat($A(arguments))); + } + }, + + delay: function() { + var __method = this, args = $A(arguments), timeout = args.shift() * 1000; + return window.setTimeout(function() { + return __method.apply(__method, args); + }, timeout); + }, + + wrap: function(wrapper) { + var __method = this; + return function() { + return wrapper.apply(this, [__method.bind(this)].concat($A(arguments))); + } + }, + + methodize: function() { + if (this._methodized) return this._methodized; + var __method = this; + return this._methodized = function() { + return __method.apply(null, [this].concat($A(arguments))); + }; + } +}); + +Function.prototype.defer = Function.prototype.delay.curry(0.01); + +Date.prototype.toJSON = function() { + return '"' + this.getUTCFullYear() + '-' + + (this.getUTCMonth() + 1).toPaddedString(2) + '-' + + this.getUTCDate().toPaddedString(2) + 'T' + + this.getUTCHours().toPaddedString(2) + ':' + + this.getUTCMinutes().toPaddedString(2) + ':' + + this.getUTCSeconds().toPaddedString(2) + 'Z"'; +}; + +var Try = { + these: function() { + var returnValue; + + for (var i = 0, length = arguments.length; i < length; i++) { + var lambda = arguments[i]; + try { + returnValue = lambda(); + break; + } catch (e) { } + } + + return returnValue; + } +}; + +RegExp.prototype.match = RegExp.prototype.test; + +RegExp.escape = function(str) { + return String(str).replace(/([.*+?^=!:${}()|[\]\/\\])/g, '\\$1'); +}; + +/*--------------------------------------------------------------------------*/ + +var PeriodicalExecuter = Class.create({ + initialize: function(callback, frequency) { + this.callback = callback; + this.frequency = frequency; + this.currentlyExecuting = false; + + this.registerCallback(); + }, + + registerCallback: function() { + this.timer = setInterval(this.onTimerEvent.bind(this), this.frequency * 1000); + }, + + execute: function() { + this.callback(this); + }, + + stop: function() { + if (!this.timer) return; + clearInterval(this.timer); + this.timer = null; + }, + + onTimerEvent: function() { + if (!this.currentlyExecuting) { + try { + this.currentlyExecuting = true; + this.execute(); + } finally { + this.currentlyExecuting = false; + } + } + } +}); +Object.extend(String, { + interpret: function(value) { + return value == null ? '' : String(value); + }, + specialChar: { + '\b': '\\b', + '\t': '\\t', + '\n': '\\n', + '\f': '\\f', + '\r': '\\r', + '\\': '\\\\' + } +}); + +Object.extend(String.prototype, { + gsub: function(pattern, replacement) { + var result = '', source = this, match; + replacement = arguments.callee.prepareReplacement(replacement); + + while (source.length > 0) { + if (match = source.match(pattern)) { + result += source.slice(0, match.index); + result += String.interpret(replacement(match)); + source = source.slice(match.index + match[0].length); + } else { + result += source, source = ''; + } + } + return result; + }, + + sub: function(pattern, replacement, count) { + replacement = this.gsub.prepareReplacement(replacement); + count = Object.isUndefined(count) ? 1 : count; + + return this.gsub(pattern, function(match) { + if (--count < 0) return match[0]; + return replacement(match); + }); + }, + + scan: function(pattern, iterator) { + this.gsub(pattern, iterator); + return String(this); + }, + + truncate: function(length, truncation) { + length = length || 30; + truncation = Object.isUndefined(truncation) ? '...' : truncation; + return this.length > length ? + this.slice(0, length - truncation.length) + truncation : String(this); + }, + + strip: function() { + return this.replace(/^\s+/, '').replace(/\s+$/, ''); + }, + + stripTags: function() { + return this.replace(/<\/?[^>]+>/gi, ''); + }, + + stripScripts: function() { + return this.replace(new RegExp(Prototype.ScriptFragment, 'img'), ''); + }, + + extractScripts: function() { + var matchAll = new RegExp(Prototype.ScriptFragment, 'img'); + var matchOne = new RegExp(Prototype.ScriptFragment, 'im'); + return (this.match(matchAll) || []).map(function(scriptTag) { + return (scriptTag.match(matchOne) || ['', ''])[1]; + }); + }, + + evalScripts: function() { + return this.extractScripts().map(function(script) { return eval(script) }); + }, + + escapeHTML: function() { + var self = arguments.callee; + self.text.data = this; + return self.div.innerHTML; + }, + + unescapeHTML: function() { + var div = new Element('div'); + div.innerHTML = this.stripTags(); + return div.childNodes[0] ? (div.childNodes.length > 1 ? + $A(div.childNodes).inject('', function(memo, node) { return memo+node.nodeValue }) : + div.childNodes[0].nodeValue) : ''; + }, + + toQueryParams: function(separator) { + var match = this.strip().match(/([^?#]*)(#.*)?$/); + if (!match) return { }; + + return match[1].split(separator || '&').inject({ }, function(hash, pair) { + if ((pair = pair.split('='))[0]) { + var key = decodeURIComponent(pair.shift()); + var value = pair.length > 1 ? pair.join('=') : pair[0]; + if (value != undefined) value = decodeURIComponent(value); + + if (key in hash) { + if (!Object.isArray(hash[key])) hash[key] = [hash[key]]; + hash[key].push(value); + } + else hash[key] = value; + } + return hash; + }); + }, + + toArray: function() { + return this.split(''); + }, + + succ: function() { + return this.slice(0, this.length - 1) + + String.fromCharCode(this.charCodeAt(this.length - 1) + 1); + }, + + times: function(count) { + return count < 1 ? '' : new Array(count + 1).join(this); + }, + + camelize: function() { + var parts = this.split('-'), len = parts.length; + if (len == 1) return parts[0]; + + var camelized = this.charAt(0) == '-' + ? parts[0].charAt(0).toUpperCase() + parts[0].substring(1) + : parts[0]; + + for (var i = 1; i < len; i++) + camelized += parts[i].charAt(0).toUpperCase() + parts[i].substring(1); + + return camelized; + }, + + capitalize: function() { + return this.charAt(0).toUpperCase() + this.substring(1).toLowerCase(); + }, + + underscore: function() { + return this.gsub(/::/, '/').gsub(/([A-Z]+)([A-Z][a-z])/,'#{1}_#{2}').gsub(/([a-z\d])([A-Z])/,'#{1}_#{2}').gsub(/-/,'_').toLowerCase(); + }, + + dasherize: function() { + return this.gsub(/_/,'-'); + }, + + inspect: function(useDoubleQuotes) { + var escapedString = this.gsub(/[\x00-\x1f\\]/, function(match) { + var character = String.specialChar[match[0]]; + return character ? character : '\\u00' + match[0].charCodeAt().toPaddedString(2, 16); + }); + if (useDoubleQuotes) return '"' + escapedString.replace(/"/g, '\\"') + '"'; + return "'" + escapedString.replace(/'/g, '\\\'') + "'"; + }, + + toJSON: function() { + return this.inspect(true); + }, + + unfilterJSON: function(filter) { + return this.sub(filter || Prototype.JSONFilter, '#{1}'); + }, + + isJSON: function() { + var str = this; + if (str.blank()) return false; + str = this.replace(/\\./g, '@').replace(/"[^"\\\n\r]*"/g, ''); + return (/^[,:{}\[\]0-9.\-+Eaeflnr-u \n\r\t]*$/).test(str); + }, + + evalJSON: function(sanitize) { + var json = this.unfilterJSON(); + try { + if (!sanitize || json.isJSON()) return eval('(' + json + ')'); + } catch (e) { } + throw new SyntaxError('Badly formed JSON string: ' + this.inspect()); + }, + + include: function(pattern) { + return this.indexOf(pattern) > -1; + }, + + startsWith: function(pattern) { + return this.indexOf(pattern) === 0; + }, + + endsWith: function(pattern) { + var d = this.length - pattern.length; + return d >= 0 && this.lastIndexOf(pattern) === d; + }, + + empty: function() { + return this == ''; + }, + + blank: function() { + return /^\s*$/.test(this); + }, + + interpolate: function(object, pattern) { + return new Template(this, pattern).evaluate(object); + } +}); + +if (Prototype.Browser.WebKit || Prototype.Browser.IE) Object.extend(String.prototype, { + escapeHTML: function() { + return this.replace(/&/g,'&').replace(//g,'>'); + }, + unescapeHTML: function() { + return this.replace(/&/g,'&').replace(/</g,'<').replace(/>/g,'>'); + } +}); + +String.prototype.gsub.prepareReplacement = function(replacement) { + if (Object.isFunction(replacement)) return replacement; + var template = new Template(replacement); + return function(match) { return template.evaluate(match) }; +}; + +String.prototype.parseQuery = String.prototype.toQueryParams; + +Object.extend(String.prototype.escapeHTML, { + div: document.createElement('div'), + text: document.createTextNode('') +}); + +with (String.prototype.escapeHTML) div.appendChild(text); + +var Template = Class.create({ + initialize: function(template, pattern) { + this.template = template.toString(); + this.pattern = pattern || Template.Pattern; + }, + + evaluate: function(object) { + if (Object.isFunction(object.toTemplateReplacements)) + object = object.toTemplateReplacements(); + + return this.template.gsub(this.pattern, function(match) { + if (object == null) return ''; + + var before = match[1] || ''; + if (before == '\\') return match[2]; + + var ctx = object, expr = match[3]; + var pattern = /^([^.[]+|\[((?:.*?[^\\])?)\])(\.|\[|$)/; + match = pattern.exec(expr); + if (match == null) return before; + + while (match != null) { + var comp = match[1].startsWith('[') ? match[2].gsub('\\\\]', ']') : match[1]; + ctx = ctx[comp]; + if (null == ctx || '' == match[3]) break; + expr = expr.substring('[' == match[3] ? match[1].length : match[0].length); + match = pattern.exec(expr); + } + + return before + String.interpret(ctx); + }.bind(this)); + } +}); +Template.Pattern = /(^|.|\r|\n)(#\{(.*?)\})/; + +var $break = { }; + +var Enumerable = { + each: function(iterator, context) { + var index = 0; + iterator = iterator.bind(context); + try { + this._each(function(value) { + iterator(value, index++); + }); + } catch (e) { + if (e != $break) throw e; + } + return this; + }, + + eachSlice: function(number, iterator, context) { + iterator = iterator ? iterator.bind(context) : Prototype.K; + var index = -number, slices = [], array = this.toArray(); + while ((index += number) < array.length) + slices.push(array.slice(index, index+number)); + return slices.collect(iterator, context); + }, + + all: function(iterator, context) { + iterator = iterator ? iterator.bind(context) : Prototype.K; + var result = true; + this.each(function(value, index) { + result = result && !!iterator(value, index); + if (!result) throw $break; + }); + return result; + }, + + any: function(iterator, context) { + iterator = iterator ? iterator.bind(context) : Prototype.K; + var result = false; + this.each(function(value, index) { + if (result = !!iterator(value, index)) + throw $break; + }); + return result; + }, + + collect: function(iterator, context) { + iterator = iterator ? iterator.bind(context) : Prototype.K; + var results = []; + this.each(function(value, index) { + results.push(iterator(value, index)); + }); + return results; + }, + + detect: function(iterator, context) { + iterator = iterator.bind(context); + var result; + this.each(function(value, index) { + if (iterator(value, index)) { + result = value; + throw $break; + } + }); + return result; + }, + + findAll: function(iterator, context) { + iterator = iterator.bind(context); + var results = []; + this.each(function(value, index) { + if (iterator(value, index)) + results.push(value); + }); + return results; + }, + + grep: function(filter, iterator, context) { + iterator = iterator ? iterator.bind(context) : Prototype.K; + var results = []; + + if (Object.isString(filter)) + filter = new RegExp(filter); + + this.each(function(value, index) { + if (filter.match(value)) + results.push(iterator(value, index)); + }); + return results; + }, + + include: function(object) { + if (Object.isFunction(this.indexOf)) + if (this.indexOf(object) != -1) return true; + + var found = false; + this.each(function(value) { + if (value == object) { + found = true; + throw $break; + } + }); + return found; + }, + + inGroupsOf: function(number, fillWith) { + fillWith = Object.isUndefined(fillWith) ? null : fillWith; + return this.eachSlice(number, function(slice) { + while(slice.length < number) slice.push(fillWith); + return slice; + }); + }, + + inject: function(memo, iterator, context) { + iterator = iterator.bind(context); + this.each(function(value, index) { + memo = iterator(memo, value, index); + }); + return memo; + }, + + invoke: function(method) { + var args = $A(arguments).slice(1); + return this.map(function(value) { + return value[method].apply(value, args); + }); + }, + + max: function(iterator, context) { + iterator = iterator ? iterator.bind(context) : Prototype.K; + var result; + this.each(function(value, index) { + value = iterator(value, index); + if (result == null || value >= result) + result = value; + }); + return result; + }, + + min: function(iterator, context) { + iterator = iterator ? iterator.bind(context) : Prototype.K; + var result; + this.each(function(value, index) { + value = iterator(value, index); + if (result == null || value < result) + result = value; + }); + return result; + }, + + partition: function(iterator, context) { + iterator = iterator ? iterator.bind(context) : Prototype.K; + var trues = [], falses = []; + this.each(function(value, index) { + (iterator(value, index) ? + trues : falses).push(value); + }); + return [trues, falses]; + }, + + pluck: function(property) { + var results = []; + this.each(function(value) { + results.push(value[property]); + }); + return results; + }, + + reject: function(iterator, context) { + iterator = iterator.bind(context); + var results = []; + this.each(function(value, index) { + if (!iterator(value, index)) + results.push(value); + }); + return results; + }, + + sortBy: function(iterator, context) { + iterator = iterator.bind(context); + return this.map(function(value, index) { + return {value: value, criteria: iterator(value, index)}; + }).sort(function(left, right) { + var a = left.criteria, b = right.criteria; + return a < b ? -1 : a > b ? 1 : 0; + }).pluck('value'); + }, + + toArray: function() { + return this.map(); + }, + + zip: function() { + var iterator = Prototype.K, args = $A(arguments); + if (Object.isFunction(args.last())) + iterator = args.pop(); + + var collections = [this].concat(args).map($A); + return this.map(function(value, index) { + return iterator(collections.pluck(index)); + }); + }, + + size: function() { + return this.toArray().length; + }, + + inspect: function() { + return '#'; + } +}; + +Object.extend(Enumerable, { + map: Enumerable.collect, + find: Enumerable.detect, + select: Enumerable.findAll, + filter: Enumerable.findAll, + member: Enumerable.include, + entries: Enumerable.toArray, + every: Enumerable.all, + some: Enumerable.any +}); +function $A(iterable) { + if (!iterable) return []; + if (iterable.toArray) return iterable.toArray(); + var length = iterable.length, results = new Array(length); + while (length--) results[length] = iterable[length]; + return results; +} + +if (Prototype.Browser.WebKit) { + function $A(iterable) { + if (!iterable) return []; + if (!(Object.isFunction(iterable) && iterable == '[object NodeList]') && + iterable.toArray) return iterable.toArray(); + var length = iterable.length, results = new Array(length); + while (length--) results[length] = iterable[length]; + return results; + } +} + +Array.from = $A; + +Object.extend(Array.prototype, Enumerable); + +if (!Array.prototype._reverse) Array.prototype._reverse = Array.prototype.reverse; + +Object.extend(Array.prototype, { + _each: function(iterator) { + for (var i = 0, length = this.length; i < length; i++) + iterator(this[i]); + }, + + clear: function() { + this.length = 0; + return this; + }, + + first: function() { + return this[0]; + }, + + last: function() { + return this[this.length - 1]; + }, + + compact: function() { + return this.select(function(value) { + return value != null; + }); + }, + + flatten: function() { + return this.inject([], function(array, value) { + return array.concat(Object.isArray(value) ? + value.flatten() : [value]); + }); + }, + + without: function() { + var values = $A(arguments); + return this.select(function(value) { + return !values.include(value); + }); + }, + + reverse: function(inline) { + return (inline !== false ? this : this.toArray())._reverse(); + }, + + reduce: function() { + return this.length > 1 ? this : this[0]; + }, + + uniq: function(sorted) { + return this.inject([], function(array, value, index) { + if (0 == index || (sorted ? array.last() != value : !array.include(value))) + array.push(value); + return array; + }); + }, + + intersect: function(array) { + return this.uniq().findAll(function(item) { + return array.detect(function(value) { return item === value }); + }); + }, + + clone: function() { + return [].concat(this); + }, + + size: function() { + return this.length; + }, + + inspect: function() { + return '[' + this.map(Object.inspect).join(', ') + ']'; + }, + + toJSON: function() { + var results = []; + this.each(function(object) { + var value = Object.toJSON(object); + if (!Object.isUndefined(value)) results.push(value); + }); + return '[' + results.join(', ') + ']'; + } +}); + +// use native browser JS 1.6 implementation if available +if (Object.isFunction(Array.prototype.forEach)) + Array.prototype._each = Array.prototype.forEach; + +if (!Array.prototype.indexOf) Array.prototype.indexOf = function(item, i) { + i || (i = 0); + var length = this.length; + if (i < 0) i = length + i; + for (; i < length; i++) + if (this[i] === item) return i; + return -1; +}; + +if (!Array.prototype.lastIndexOf) Array.prototype.lastIndexOf = function(item, i) { + i = isNaN(i) ? this.length : (i < 0 ? this.length + i : i) + 1; + var n = this.slice(0, i).reverse().indexOf(item); + return (n < 0) ? n : i - n - 1; +}; + +Array.prototype.toArray = Array.prototype.clone; + +function $w(string) { + if (!Object.isString(string)) return []; + string = string.strip(); + return string ? string.split(/\s+/) : []; +} + +if (Prototype.Browser.Opera){ + Array.prototype.concat = function() { + var array = []; + for (var i = 0, length = this.length; i < length; i++) array.push(this[i]); + for (var i = 0, length = arguments.length; i < length; i++) { + if (Object.isArray(arguments[i])) { + for (var j = 0, arrayLength = arguments[i].length; j < arrayLength; j++) + array.push(arguments[i][j]); + } else { + array.push(arguments[i]); + } + } + return array; + }; +} +Object.extend(Number.prototype, { + toColorPart: function() { + return this.toPaddedString(2, 16); + }, + + succ: function() { + return this + 1; + }, + + times: function(iterator) { + $R(0, this, true).each(iterator); + return this; + }, + + toPaddedString: function(length, radix) { + var string = this.toString(radix || 10); + return '0'.times(length - string.length) + string; + }, + + toJSON: function() { + return isFinite(this) ? this.toString() : 'null'; + } +}); + +$w('abs round ceil floor').each(function(method){ + Number.prototype[method] = Math[method].methodize(); +}); +function $H(object) { + return new Hash(object); +}; + +var Hash = Class.create(Enumerable, (function() { + + function toQueryPair(key, value) { + if (Object.isUndefined(value)) return key; + return key + '=' + encodeURIComponent(String.interpret(value)); + } + + return { + initialize: function(object) { + this._object = Object.isHash(object) ? object.toObject() : Object.clone(object); + }, + + _each: function(iterator) { + for (var key in this._object) { + var value = this._object[key], pair = [key, value]; + pair.key = key; + pair.value = value; + iterator(pair); + } + }, + + set: function(key, value) { + return this._object[key] = value; + }, + + get: function(key) { + return this._object[key]; + }, + + unset: function(key) { + var value = this._object[key]; + delete this._object[key]; + return value; + }, + + toObject: function() { + return Object.clone(this._object); + }, + + keys: function() { + return this.pluck('key'); + }, + + values: function() { + return this.pluck('value'); + }, + + index: function(value) { + var match = this.detect(function(pair) { + return pair.value === value; + }); + return match && match.key; + }, + + merge: function(object) { + return this.clone().update(object); + }, + + update: function(object) { + return new Hash(object).inject(this, function(result, pair) { + result.set(pair.key, pair.value); + return result; + }); + }, + + toQueryString: function() { + return this.map(function(pair) { + var key = encodeURIComponent(pair.key), values = pair.value; + + if (values && typeof values == 'object') { + if (Object.isArray(values)) + return values.map(toQueryPair.curry(key)).join('&'); + } + return toQueryPair(key, values); + }).join('&'); + }, + + inspect: function() { + return '#'; + }, + + toJSON: function() { + return Object.toJSON(this.toObject()); + }, + + clone: function() { + return new Hash(this); + } + } +})()); + +Hash.prototype.toTemplateReplacements = Hash.prototype.toObject; +Hash.from = $H; +var ObjectRange = Class.create(Enumerable, { + initialize: function(start, end, exclusive) { + this.start = start; + this.end = end; + this.exclusive = exclusive; + }, + + _each: function(iterator) { + var value = this.start; + while (this.include(value)) { + iterator(value); + value = value.succ(); + } + }, + + include: function(value) { + if (value < this.start) + return false; + if (this.exclusive) + return value < this.end; + return value <= this.end; + } +}); + +var $R = function(start, end, exclusive) { + return new ObjectRange(start, end, exclusive); +}; + +var Ajax = { + getTransport: function() { + return Try.these( + function() {return new XMLHttpRequest()}, + function() {return new ActiveXObject('Msxml2.XMLHTTP')}, + function() {return new ActiveXObject('Microsoft.XMLHTTP')} + ) || false; + }, + + activeRequestCount: 0 +}; + +Ajax.Responders = { + responders: [], + + _each: function(iterator) { + this.responders._each(iterator); + }, + + register: function(responder) { + if (!this.include(responder)) + this.responders.push(responder); + }, + + unregister: function(responder) { + this.responders = this.responders.without(responder); + }, + + dispatch: function(callback, request, transport, json) { + this.each(function(responder) { + if (Object.isFunction(responder[callback])) { + try { + responder[callback].apply(responder, [request, transport, json]); + } catch (e) { } + } + }); + } +}; + +Object.extend(Ajax.Responders, Enumerable); + +Ajax.Responders.register({ + onCreate: function() { Ajax.activeRequestCount++ }, + onComplete: function() { Ajax.activeRequestCount-- } +}); + +Ajax.Base = Class.create({ + initialize: function(options) { + this.options = { + method: 'post', + asynchronous: true, + contentType: 'application/x-www-form-urlencoded', + encoding: 'UTF-8', + parameters: '', + evalJSON: true, + evalJS: true + }; + Object.extend(this.options, options || { }); + + this.options.method = this.options.method.toLowerCase(); + + if (Object.isString(this.options.parameters)) + this.options.parameters = this.options.parameters.toQueryParams(); + else if (Object.isHash(this.options.parameters)) + this.options.parameters = this.options.parameters.toObject(); + } +}); + +Ajax.Request = Class.create(Ajax.Base, { + _complete: false, + + initialize: function($super, url, options) { + $super(options); + this.transport = Ajax.getTransport(); + this.request(url); + }, + + request: function(url) { + this.url = url; + this.method = this.options.method; + var params = Object.clone(this.options.parameters); + + if (!['get', 'post'].include(this.method)) { + // simulate other verbs over post + params['_method'] = this.method; + this.method = 'post'; + } + + this.parameters = params; + + if (params = Object.toQueryString(params)) { + // when GET, append parameters to URL + if (this.method == 'get') + this.url += (this.url.include('?') ? '&' : '?') + params; + else if (/Konqueror|Safari|KHTML/.test(navigator.userAgent)) + params += '&_='; + } + + try { + var response = new Ajax.Response(this); + if (this.options.onCreate) this.options.onCreate(response); + Ajax.Responders.dispatch('onCreate', this, response); + + this.transport.open(this.method.toUpperCase(), this.url, + this.options.asynchronous); + + if (this.options.asynchronous) this.respondToReadyState.bind(this).defer(1); + + this.transport.onreadystatechange = this.onStateChange.bind(this); + this.setRequestHeaders(); + + this.body = this.method == 'post' ? (this.options.postBody || params) : null; + this.transport.send(this.body); + + /* Force Firefox to handle ready state 4 for synchronous requests */ + if (!this.options.asynchronous && this.transport.overrideMimeType) + this.onStateChange(); + + } + catch (e) { + this.dispatchException(e); + } + }, + + onStateChange: function() { + var readyState = this.transport.readyState; + if (readyState > 1 && !((readyState == 4) && this._complete)) + this.respondToReadyState(this.transport.readyState); + }, + + setRequestHeaders: function() { + var headers = { + 'X-Requested-With': 'XMLHttpRequest', + 'X-Prototype-Version': Prototype.Version, + 'Accept': 'text/javascript, text/html, application/xml, text/xml, */*' + }; + + if (this.method == 'post') { + headers['Content-type'] = this.options.contentType + + (this.options.encoding ? '; charset=' + this.options.encoding : ''); + + /* Force "Connection: close" for older Mozilla browsers to work + * around a bug where XMLHttpRequest sends an incorrect + * Content-length header. See Mozilla Bugzilla #246651. + */ + if (this.transport.overrideMimeType && + (navigator.userAgent.match(/Gecko\/(\d{4})/) || [0,2005])[1] < 2005) + headers['Connection'] = 'close'; + } + + // user-defined headers + if (typeof this.options.requestHeaders == 'object') { + var extras = this.options.requestHeaders; + + if (Object.isFunction(extras.push)) + for (var i = 0, length = extras.length; i < length; i += 2) + headers[extras[i]] = extras[i+1]; + else + $H(extras).each(function(pair) { headers[pair.key] = pair.value }); + } + + for (var name in headers) + this.transport.setRequestHeader(name, headers[name]); + }, + + success: function() { + var status = this.getStatus(); + return !status || (status >= 200 && status < 300); + }, + + getStatus: function() { + try { + return this.transport.status || 0; + } catch (e) { return 0 } + }, + + respondToReadyState: function(readyState) { + var state = Ajax.Request.Events[readyState], response = new Ajax.Response(this); + + if (state == 'Complete') { + try { + this._complete = true; + (this.options['on' + response.status] + || this.options['on' + (this.success() ? 'Success' : 'Failure')] + || Prototype.emptyFunction)(response, response.headerJSON); + } catch (e) { + this.dispatchException(e); + } + + var contentType = response.getHeader('Content-type'); + if (this.options.evalJS == 'force' + || (this.options.evalJS && contentType + && contentType.match(/^\s*(text|application)\/(x-)?(java|ecma)script(;.*)?\s*$/i))) + this.evalResponse(); + } + + try { + (this.options['on' + state] || Prototype.emptyFunction)(response, response.headerJSON); + Ajax.Responders.dispatch('on' + state, this, response, response.headerJSON); + } catch (e) { + this.dispatchException(e); + } + + if (state == 'Complete') { + // avoid memory leak in MSIE: clean up + this.transport.onreadystatechange = Prototype.emptyFunction; + } + }, + + getHeader: function(name) { + try { + return this.transport.getResponseHeader(name); + } catch (e) { return null } + }, + + evalResponse: function() { + try { + return eval((this.transport.responseText || '').unfilterJSON()); + } catch (e) { + this.dispatchException(e); + } + }, + + dispatchException: function(exception) { + (this.options.onException || Prototype.emptyFunction)(this, exception); + Ajax.Responders.dispatch('onException', this, exception); + } +}); + +Ajax.Request.Events = + ['Uninitialized', 'Loading', 'Loaded', 'Interactive', 'Complete']; + +Ajax.Response = Class.create({ + initialize: function(request){ + this.request = request; + var transport = this.transport = request.transport, + readyState = this.readyState = transport.readyState; + + if((readyState > 2 && !Prototype.Browser.IE) || readyState == 4) { + this.status = this.getStatus(); + this.statusText = this.getStatusText(); + this.responseText = String.interpret(transport.responseText); + this.headerJSON = this._getHeaderJSON(); + } + + if(readyState == 4) { + var xml = transport.responseXML; + this.responseXML = Object.isUndefined(xml) ? null : xml; + this.responseJSON = this._getResponseJSON(); + } + }, + + status: 0, + statusText: '', + + getStatus: Ajax.Request.prototype.getStatus, + + getStatusText: function() { + try { + return this.transport.statusText || ''; + } catch (e) { return '' } + }, + + getHeader: Ajax.Request.prototype.getHeader, + + getAllHeaders: function() { + try { + return this.getAllResponseHeaders(); + } catch (e) { return null } + }, + + getResponseHeader: function(name) { + return this.transport.getResponseHeader(name); + }, + + getAllResponseHeaders: function() { + return this.transport.getAllResponseHeaders(); + }, + + _getHeaderJSON: function() { + var json = this.getHeader('X-JSON'); + if (!json) return null; + json = decodeURIComponent(escape(json)); + try { + return json.evalJSON(this.request.options.sanitizeJSON); + } catch (e) { + this.request.dispatchException(e); + } + }, + + _getResponseJSON: function() { + var options = this.request.options; + if (!options.evalJSON || (options.evalJSON != 'force' && + !(this.getHeader('Content-type') || '').include('application/json')) || + this.responseText.blank()) + return null; + try { + return this.responseText.evalJSON(options.sanitizeJSON); + } catch (e) { + this.request.dispatchException(e); + } + } +}); + +Ajax.Updater = Class.create(Ajax.Request, { + initialize: function($super, container, url, options) { + this.container = { + success: (container.success || container), + failure: (container.failure || (container.success ? null : container)) + }; + + options = Object.clone(options); + var onComplete = options.onComplete; + options.onComplete = (function(response, json) { + this.updateContent(response.responseText); + if (Object.isFunction(onComplete)) onComplete(response, json); + }).bind(this); + + $super(url, options); + }, + + updateContent: function(responseText) { + var receiver = this.container[this.success() ? 'success' : 'failure'], + options = this.options; + + if (!options.evalScripts) responseText = responseText.stripScripts(); + + if (receiver = $(receiver)) { + if (options.insertion) { + if (Object.isString(options.insertion)) { + var insertion = { }; insertion[options.insertion] = responseText; + receiver.insert(insertion); + } + else options.insertion(receiver, responseText); + } + else receiver.update(responseText); + } + } +}); + +Ajax.PeriodicalUpdater = Class.create(Ajax.Base, { + initialize: function($super, container, url, options) { + $super(options); + this.onComplete = this.options.onComplete; + + this.frequency = (this.options.frequency || 2); + this.decay = (this.options.decay || 1); + + this.updater = { }; + this.container = container; + this.url = url; + + this.start(); + }, + + start: function() { + this.options.onComplete = this.updateComplete.bind(this); + this.onTimerEvent(); + }, + + stop: function() { + this.updater.options.onComplete = undefined; + clearTimeout(this.timer); + (this.onComplete || Prototype.emptyFunction).apply(this, arguments); + }, + + updateComplete: function(response) { + if (this.options.decay) { + this.decay = (response.responseText == this.lastText ? + this.decay * this.options.decay : 1); + + this.lastText = response.responseText; + } + this.timer = this.onTimerEvent.bind(this).delay(this.decay * this.frequency); + }, + + onTimerEvent: function() { + this.updater = new Ajax.Updater(this.container, this.url, this.options); + } +}); +function $(element) { + if (arguments.length > 1) { + for (var i = 0, elements = [], length = arguments.length; i < length; i++) + elements.push($(arguments[i])); + return elements; + } + if (Object.isString(element)) + element = document.getElementById(element); + return Element.extend(element); +} + +if (Prototype.BrowserFeatures.XPath) { + document._getElementsByXPath = function(expression, parentElement) { + var results = []; + var query = document.evaluate(expression, $(parentElement) || document, + null, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null); + for (var i = 0, length = query.snapshotLength; i < length; i++) + results.push(Element.extend(query.snapshotItem(i))); + return results; + }; +} + +/*--------------------------------------------------------------------------*/ + +if (!window.Node) var Node = { }; + +if (!Node.ELEMENT_NODE) { + // DOM level 2 ECMAScript Language Binding + Object.extend(Node, { + ELEMENT_NODE: 1, + ATTRIBUTE_NODE: 2, + TEXT_NODE: 3, + CDATA_SECTION_NODE: 4, + ENTITY_REFERENCE_NODE: 5, + ENTITY_NODE: 6, + PROCESSING_INSTRUCTION_NODE: 7, + COMMENT_NODE: 8, + DOCUMENT_NODE: 9, + DOCUMENT_TYPE_NODE: 10, + DOCUMENT_FRAGMENT_NODE: 11, + NOTATION_NODE: 12 + }); +} + +(function() { + var element = this.Element; + this.Element = function(tagName, attributes) { + attributes = attributes || { }; + tagName = tagName.toLowerCase(); + var cache = Element.cache; + if (Prototype.Browser.IE && attributes.name) { + tagName = '<' + tagName + ' name="' + attributes.name + '">'; + delete attributes.name; + return Element.writeAttribute(document.createElement(tagName), attributes); + } + if (!cache[tagName]) cache[tagName] = Element.extend(document.createElement(tagName)); + return Element.writeAttribute(cache[tagName].cloneNode(false), attributes); + }; + Object.extend(this.Element, element || { }); +}).call(window); + +Element.cache = { }; + +Element.Methods = { + visible: function(element) { + return $(element).style.display != 'none'; + }, + + toggle: function(element) { + element = $(element); + Element[Element.visible(element) ? 'hide' : 'show'](element); + return element; + }, + + hide: function(element) { + $(element).style.display = 'none'; + return element; + }, + + show: function(element) { + $(element).style.display = ''; + return element; + }, + + remove: function(element) { + element = $(element); + element.parentNode.removeChild(element); + return element; + }, + + update: function(element, content) { + element = $(element); + if (content && content.toElement) content = content.toElement(); + if (Object.isElement(content)) return element.update().insert(content); + content = Object.toHTML(content); + element.innerHTML = content.stripScripts(); + content.evalScripts.bind(content).defer(); + return element; + }, + + replace: function(element, content) { + element = $(element); + if (content && content.toElement) content = content.toElement(); + else if (!Object.isElement(content)) { + content = Object.toHTML(content); + var range = element.ownerDocument.createRange(); + range.selectNode(element); + content.evalScripts.bind(content).defer(); + content = range.createContextualFragment(content.stripScripts()); + } + element.parentNode.replaceChild(content, element); + return element; + }, + + insert: function(element, insertions) { + element = $(element); + + if (Object.isString(insertions) || Object.isNumber(insertions) || + Object.isElement(insertions) || (insertions && (insertions.toElement || insertions.toHTML))) + insertions = {bottom:insertions}; + + var content, t, range; + + for (position in insertions) { + content = insertions[position]; + position = position.toLowerCase(); + t = Element._insertionTranslations[position]; + + if (content && content.toElement) content = content.toElement(); + if (Object.isElement(content)) { + t.insert(element, content); + continue; + } + + content = Object.toHTML(content); + + range = element.ownerDocument.createRange(); + t.initializeRange(element, range); + t.insert(element, range.createContextualFragment(content.stripScripts())); + + content.evalScripts.bind(content).defer(); + } + + return element; + }, + + wrap: function(element, wrapper, attributes) { + element = $(element); + if (Object.isElement(wrapper)) + $(wrapper).writeAttribute(attributes || { }); + else if (Object.isString(wrapper)) wrapper = new Element(wrapper, attributes); + else wrapper = new Element('div', wrapper); + if (element.parentNode) + element.parentNode.replaceChild(wrapper, element); + wrapper.appendChild(element); + return wrapper; + }, + + inspect: function(element) { + element = $(element); + var result = '<' + element.tagName.toLowerCase(); + $H({'id': 'id', 'className': 'class'}).each(function(pair) { + var property = pair.first(), attribute = pair.last(); + var value = (element[property] || '').toString(); + if (value) result += ' ' + attribute + '=' + value.inspect(true); + }); + return result + '>'; + }, + + recursivelyCollect: function(element, property) { + element = $(element); + var elements = []; + while (element = element[property]) + if (element.nodeType == 1) + elements.push(Element.extend(element)); + return elements; + }, + + ancestors: function(element) { + return $(element).recursivelyCollect('parentNode'); + }, + + descendants: function(element) { + return $(element).getElementsBySelector("*"); + }, + + firstDescendant: function(element) { + element = $(element).firstChild; + while (element && element.nodeType != 1) element = element.nextSibling; + return $(element); + }, + + immediateDescendants: function(element) { + if (!(element = $(element).firstChild)) return []; + while (element && element.nodeType != 1) element = element.nextSibling; + if (element) return [element].concat($(element).nextSiblings()); + return []; + }, + + previousSiblings: function(element) { + return $(element).recursivelyCollect('previousSibling'); + }, + + nextSiblings: function(element) { + return $(element).recursivelyCollect('nextSibling'); + }, + + siblings: function(element) { + element = $(element); + return element.previousSiblings().reverse().concat(element.nextSiblings()); + }, + + match: function(element, selector) { + if (Object.isString(selector)) + selector = new Selector(selector); + return selector.match($(element)); + }, + + up: function(element, expression, index) { + element = $(element); + if (arguments.length == 1) return $(element.parentNode); + var ancestors = element.ancestors(); + return expression ? Selector.findElement(ancestors, expression, index) : + ancestors[index || 0]; + }, + + down: function(element, expression, index) { + element = $(element); + if (arguments.length == 1) return element.firstDescendant(); + var descendants = element.descendants(); + return expression ? Selector.findElement(descendants, expression, index) : + descendants[index || 0]; + }, + + previous: function(element, expression, index) { + element = $(element); + if (arguments.length == 1) return $(Selector.handlers.previousElementSibling(element)); + var previousSiblings = element.previousSiblings(); + return expression ? Selector.findElement(previousSiblings, expression, index) : + previousSiblings[index || 0]; + }, + + next: function(element, expression, index) { + element = $(element); + if (arguments.length == 1) return $(Selector.handlers.nextElementSibling(element)); + var nextSiblings = element.nextSiblings(); + return expression ? Selector.findElement(nextSiblings, expression, index) : + nextSiblings[index || 0]; + }, + + select: function() { + var args = $A(arguments), element = $(args.shift()); + return Selector.findChildElements(element, args); + }, + + adjacent: function() { + var args = $A(arguments), element = $(args.shift()); + return Selector.findChildElements(element.parentNode, args).without(element); + }, + + identify: function(element) { + element = $(element); + var id = element.readAttribute('id'), self = arguments.callee; + if (id) return id; + do { id = 'anonymous_element_' + self.counter++ } while ($(id)); + element.writeAttribute('id', id); + return id; + }, + + readAttribute: function(element, name) { + element = $(element); + if (Prototype.Browser.IE) { + var t = Element._attributeTranslations.read; + if (t.values[name]) return t.values[name](element, name); + if (t.names[name]) name = t.names[name]; + if (name.include(':')) { + return (!element.attributes || !element.attributes[name]) ? null : + element.attributes[name].value; + } + } + return element.getAttribute(name); + }, + + writeAttribute: function(element, name, value) { + element = $(element); + var attributes = { }, t = Element._attributeTranslations.write; + + if (typeof name == 'object') attributes = name; + else attributes[name] = Object.isUndefined(value) ? true : value; + + for (var attr in attributes) { + name = t.names[attr] || attr; + value = attributes[attr]; + if (t.values[attr]) name = t.values[attr](element, value); + if (value === false || value === null) + element.removeAttribute(name); + else if (value === true) + element.setAttribute(name, name); + else element.setAttribute(name, value); + } + return element; + }, + + getHeight: function(element) { + return $(element).getDimensions().height; + }, + + getWidth: function(element) { + return $(element).getDimensions().width; + }, + + classNames: function(element) { + return new Element.ClassNames(element); + }, + + hasClassName: function(element, className) { + if (!(element = $(element))) return; + var elementClassName = element.className; + return (elementClassName.length > 0 && (elementClassName == className || + new RegExp("(^|\\s)" + className + "(\\s|$)").test(elementClassName))); + }, + + addClassName: function(element, className) { + if (!(element = $(element))) return; + if (!element.hasClassName(className)) + element.className += (element.className ? ' ' : '') + className; + return element; + }, + + removeClassName: function(element, className) { + if (!(element = $(element))) return; + element.className = element.className.replace( + new RegExp("(^|\\s+)" + className + "(\\s+|$)"), ' ').strip(); + return element; + }, + + toggleClassName: function(element, className) { + if (!(element = $(element))) return; + return element[element.hasClassName(className) ? + 'removeClassName' : 'addClassName'](className); + }, + + // removes whitespace-only text node children + cleanWhitespace: function(element) { + element = $(element); + var node = element.firstChild; + while (node) { + var nextNode = node.nextSibling; + if (node.nodeType == 3 && !/\S/.test(node.nodeValue)) + element.removeChild(node); + node = nextNode; + } + return element; + }, + + empty: function(element) { + return $(element).innerHTML.blank(); + }, + + descendantOf: function(element, ancestor) { + element = $(element), ancestor = $(ancestor); + var originalAncestor = ancestor; + + if (element.compareDocumentPosition) + return (element.compareDocumentPosition(ancestor) & 8) === 8; + + if (element.sourceIndex && !Prototype.Browser.Opera) { + var e = element.sourceIndex, a = ancestor.sourceIndex, + nextAncestor = ancestor.nextSibling; + if (!nextAncestor) { + do { ancestor = ancestor.parentNode; } + while (!(nextAncestor = ancestor.nextSibling) && ancestor.parentNode); + } + if (nextAncestor) return (e > a && e < nextAncestor.sourceIndex); + } + + while (element = element.parentNode) + if (element == originalAncestor) return true; + return false; + }, + + scrollTo: function(element) { + element = $(element); + var pos = element.cumulativeOffset(); + window.scrollTo(pos[0], pos[1]); + return element; + }, + + getStyle: function(element, style) { + element = $(element); + style = style == 'float' ? 'cssFloat' : style.camelize(); + var value = element.style[style]; + if (!value) { + var css = document.defaultView.getComputedStyle(element, null); + value = css ? css[style] : null; + } + if (style == 'opacity') return value ? parseFloat(value) : 1.0; + return value == 'auto' ? null : value; + }, + + getOpacity: function(element) { + return $(element).getStyle('opacity'); + }, + + setStyle: function(element, styles) { + element = $(element); + var elementStyle = element.style, match; + if (Object.isString(styles)) { + element.style.cssText += ';' + styles; + return styles.include('opacity') ? + element.setOpacity(styles.match(/opacity:\s*(\d?\.?\d*)/)[1]) : element; + } + for (var property in styles) + if (property == 'opacity') element.setOpacity(styles[property]); + else + elementStyle[(property == 'float' || property == 'cssFloat') ? + (Object.isUndefined(elementStyle.styleFloat) ? 'cssFloat' : 'styleFloat') : + property] = styles[property]; + + return element; + }, + + setOpacity: function(element, value) { + element = $(element); + element.style.opacity = (value == 1 || value === '') ? '' : + (value < 0.00001) ? 0 : value; + return element; + }, + + getDimensions: function(element) { + element = $(element); + var display = $(element).getStyle('display'); + if (display != 'none' && display != null) // Safari bug + return {width: element.offsetWidth, height: element.offsetHeight}; + + // All *Width and *Height properties give 0 on elements with display none, + // so enable the element temporarily + var els = element.style; + var originalVisibility = els.visibility; + var originalPosition = els.position; + var originalDisplay = els.display; + els.visibility = 'hidden'; + els.position = 'absolute'; + els.display = 'block'; + var originalWidth = element.clientWidth; + var originalHeight = element.clientHeight; + els.display = originalDisplay; + els.position = originalPosition; + els.visibility = originalVisibility; + return {width: originalWidth, height: originalHeight}; + }, + + makePositioned: function(element) { + element = $(element); + var pos = Element.getStyle(element, 'position'); + if (pos == 'static' || !pos) { + element._madePositioned = true; + element.style.position = 'relative'; + // Opera returns the offset relative to the positioning context, when an + // element is position relative but top and left have not been defined + if (window.opera) { + element.style.top = 0; + element.style.left = 0; + } + } + return element; + }, + + undoPositioned: function(element) { + element = $(element); + if (element._madePositioned) { + element._madePositioned = undefined; + element.style.position = + element.style.top = + element.style.left = + element.style.bottom = + element.style.right = ''; + } + return element; + }, + + makeClipping: function(element) { + element = $(element); + if (element._overflow) return element; + element._overflow = Element.getStyle(element, 'overflow') || 'auto'; + if (element._overflow !== 'hidden') + element.style.overflow = 'hidden'; + return element; + }, + + undoClipping: function(element) { + element = $(element); + if (!element._overflow) return element; + element.style.overflow = element._overflow == 'auto' ? '' : element._overflow; + element._overflow = null; + return element; + }, + + cumulativeOffset: function(element) { + var valueT = 0, valueL = 0; + do { + valueT += element.offsetTop || 0; + valueL += element.offsetLeft || 0; + element = element.offsetParent; + } while (element); + return Element._returnOffset(valueL, valueT); + }, + + positionedOffset: function(element) { + var valueT = 0, valueL = 0; + do { + valueT += element.offsetTop || 0; + valueL += element.offsetLeft || 0; + element = element.offsetParent; + if (element) { + if (element.tagName == 'BODY') break; + var p = Element.getStyle(element, 'position'); + if (p == 'relative' || p == 'absolute') break; + } + } while (element); + return Element._returnOffset(valueL, valueT); + }, + + absolutize: function(element) { + element = $(element); + if (element.getStyle('position') == 'absolute') return; + // Position.prepare(); // To be done manually by Scripty when it needs it. + + var offsets = element.positionedOffset(); + var top = offsets[1]; + var left = offsets[0]; + var width = element.clientWidth; + var height = element.clientHeight; + + element._originalLeft = left - parseFloat(element.style.left || 0); + element._originalTop = top - parseFloat(element.style.top || 0); + element._originalWidth = element.style.width; + element._originalHeight = element.style.height; + + element.style.position = 'absolute'; + element.style.top = top + 'px'; + element.style.left = left + 'px'; + element.style.width = width + 'px'; + element.style.height = height + 'px'; + return element; + }, + + relativize: function(element) { + element = $(element); + if (element.getStyle('position') == 'relative') return; + // Position.prepare(); // To be done manually by Scripty when it needs it. + + element.style.position = 'relative'; + var top = parseFloat(element.style.top || 0) - (element._originalTop || 0); + var left = parseFloat(element.style.left || 0) - (element._originalLeft || 0); + + element.style.top = top + 'px'; + element.style.left = left + 'px'; + element.style.height = element._originalHeight; + element.style.width = element._originalWidth; + return element; + }, + + cumulativeScrollOffset: function(element) { + var valueT = 0, valueL = 0; + do { + valueT += element.scrollTop || 0; + valueL += element.scrollLeft || 0; + element = element.parentNode; + } while (element); + return Element._returnOffset(valueL, valueT); + }, + + getOffsetParent: function(element) { + if (element.offsetParent) return $(element.offsetParent); + if (element == document.body) return $(element); + + while ((element = element.parentNode) && element != document.body) + if (Element.getStyle(element, 'position') != 'static') + return $(element); + + return $(document.body); + }, + + viewportOffset: function(forElement) { + var valueT = 0, valueL = 0; + + var element = forElement; + do { + valueT += element.offsetTop || 0; + valueL += element.offsetLeft || 0; + + // Safari fix + if (element.offsetParent == document.body && + Element.getStyle(element, 'position') == 'absolute') break; + + } while (element = element.offsetParent); + + element = forElement; + do { + if (!Prototype.Browser.Opera || element.tagName == 'BODY') { + valueT -= element.scrollTop || 0; + valueL -= element.scrollLeft || 0; + } + } while (element = element.parentNode); + + return Element._returnOffset(valueL, valueT); + }, + + clonePosition: function(element, source) { + var options = Object.extend({ + setLeft: true, + setTop: true, + setWidth: true, + setHeight: true, + offsetTop: 0, + offsetLeft: 0 + }, arguments[2] || { }); + + // find page position of source + source = $(source); + var p = source.viewportOffset(); + + // find coordinate system to use + element = $(element); + var delta = [0, 0]; + var parent = null; + // delta [0,0] will do fine with position: fixed elements, + // position:absolute needs offsetParent deltas + if (Element.getStyle(element, 'position') == 'absolute') { + parent = element.getOffsetParent(); + delta = parent.viewportOffset(); + } + + // correct by body offsets (fixes Safari) + if (parent == document.body) { + delta[0] -= document.body.offsetLeft; + delta[1] -= document.body.offsetTop; + } + + // set position + if (options.setLeft) element.style.left = (p[0] - delta[0] + options.offsetLeft) + 'px'; + if (options.setTop) element.style.top = (p[1] - delta[1] + options.offsetTop) + 'px'; + if (options.setWidth) element.style.width = source.offsetWidth + 'px'; + if (options.setHeight) element.style.height = source.offsetHeight + 'px'; + return element; + } +}; + +Element.Methods.identify.counter = 1; + +Object.extend(Element.Methods, { + getElementsBySelector: Element.Methods.select, + childElements: Element.Methods.immediateDescendants +}); + +Element._attributeTranslations = { + write: { + names: { + className: 'class', + htmlFor: 'for' + }, + values: { } + } +}; + + +if (!document.createRange || Prototype.Browser.Opera) { + Element.Methods.insert = function(element, insertions) { + element = $(element); + + if (Object.isString(insertions) || Object.isNumber(insertions) || + Object.isElement(insertions) || (insertions && (insertions.toElement || insertions.toHTML))) + insertions = { bottom: insertions }; + + var t = Element._insertionTranslations, content, position, pos, tagName; + + for (position in insertions) { + content = insertions[position]; + position = position.toLowerCase(); + pos = t[position]; + + if (content && content.toElement) content = content.toElement(); + if (Object.isElement(content)) { + pos.insert(element, content); + continue; + } + + content = Object.toHTML(content); + tagName = ((position == 'before' || position == 'after') + ? element.parentNode : element).tagName.toUpperCase(); + + if (t.tags[tagName]) { + var fragments = Element._getContentFromAnonymousElement(tagName, content.stripScripts()); + if (position == 'top' || position == 'after') fragments.reverse(); + fragments.each(pos.insert.curry(element)); + } + else element.insertAdjacentHTML(pos.adjacency, content.stripScripts()); + + content.evalScripts.bind(content).defer(); + } + + return element; + }; +} + +if (Prototype.Browser.Opera) { + Element.Methods.getStyle = Element.Methods.getStyle.wrap( + function(proceed, element, style) { + switch (style) { + case 'left': case 'top': case 'right': case 'bottom': + if (proceed(element, 'position') === 'static') return null; + case 'height': case 'width': + // returns '0px' for hidden elements; we want it to return null + if (!Element.visible(element)) return null; + + // returns the border-box dimensions rather than the content-box + // dimensions, so we subtract padding and borders from the value + var dim = parseInt(proceed(element, style), 10); + + if (dim !== element['offset' + style.capitalize()]) + return dim + 'px'; + + var properties; + if (style === 'height') { + properties = ['border-top-width', 'padding-top', + 'padding-bottom', 'border-bottom-width']; + } + else { + properties = ['border-left-width', 'padding-left', + 'padding-right', 'border-right-width']; + } + return properties.inject(dim, function(memo, property) { + var val = proceed(element, property); + return val === null ? memo : memo - parseInt(val, 10); + }) + 'px'; + default: return proceed(element, style); + } + } + ); + + Element.Methods.readAttribute = Element.Methods.readAttribute.wrap( + function(proceed, element, attribute) { + if (attribute === 'title') return element.title; + return proceed(element, attribute); + } + ); +} + +else if (Prototype.Browser.IE) { + $w('positionedOffset getOffsetParent viewportOffset').each(function(method) { + Element.Methods[method] = Element.Methods[method].wrap( + function(proceed, element) { + element = $(element); + var position = element.getStyle('position'); + if (position != 'static') return proceed(element); + element.setStyle({ position: 'relative' }); + var value = proceed(element); + element.setStyle({ position: position }); + return value; + } + ); + }); + + Element.Methods.getStyle = function(element, style) { + element = $(element); + style = (style == 'float' || style == 'cssFloat') ? 'styleFloat' : style.camelize(); + var value = element.style[style]; + if (!value && element.currentStyle) value = element.currentStyle[style]; + + if (style == 'opacity') { + if (value = (element.getStyle('filter') || '').match(/alpha\(opacity=(.*)\)/)) + if (value[1]) return parseFloat(value[1]) / 100; + return 1.0; + } + + if (value == 'auto') { + if ((style == 'width' || style == 'height') && (element.getStyle('display') != 'none')) + return element['offset' + style.capitalize()] + 'px'; + return null; + } + return value; + }; + + Element.Methods.setOpacity = function(element, value) { + function stripAlpha(filter){ + return filter.replace(/alpha\([^\)]*\)/gi,''); + } + element = $(element); + var currentStyle = element.currentStyle; + if ((currentStyle && !currentStyle.hasLayout) || + (!currentStyle && element.style.zoom == 'normal')) + element.style.zoom = 1; + + var filter = element.getStyle('filter'), style = element.style; + if (value == 1 || value === '') { + (filter = stripAlpha(filter)) ? + style.filter = filter : style.removeAttribute('filter'); + return element; + } else if (value < 0.00001) value = 0; + style.filter = stripAlpha(filter) + + 'alpha(opacity=' + (value * 100) + ')'; + return element; + }; + + Element._attributeTranslations = { + read: { + names: { + 'class': 'className', + 'for': 'htmlFor' + }, + values: { + _getAttr: function(element, attribute) { + return element.getAttribute(attribute, 2); + }, + _getAttrNode: function(element, attribute) { + var node = element.getAttributeNode(attribute); + return node ? node.value : ""; + }, + _getEv: function(element, attribute) { + attribute = element.getAttribute(attribute); + return attribute ? attribute.toString().slice(23, -2) : null; + }, + _flag: function(element, attribute) { + return $(element).hasAttribute(attribute) ? attribute : null; + }, + style: function(element) { + return element.style.cssText.toLowerCase(); + }, + title: function(element) { + return element.title; + } + } + } + }; + + Element._attributeTranslations.write = { + names: Object.clone(Element._attributeTranslations.read.names), + values: { + checked: function(element, value) { + element.checked = !!value; + }, + + style: function(element, value) { + element.style.cssText = value ? value : ''; + } + } + }; + + Element._attributeTranslations.has = {}; + + $w('colSpan rowSpan vAlign dateTime accessKey tabIndex ' + + 'encType maxLength readOnly longDesc').each(function(attr) { + Element._attributeTranslations.write.names[attr.toLowerCase()] = attr; + Element._attributeTranslations.has[attr.toLowerCase()] = attr; + }); + + (function(v) { + Object.extend(v, { + href: v._getAttr, + src: v._getAttr, + type: v._getAttr, + action: v._getAttrNode, + disabled: v._flag, + checked: v._flag, + readonly: v._flag, + multiple: v._flag, + onload: v._getEv, + onunload: v._getEv, + onclick: v._getEv, + ondblclick: v._getEv, + onmousedown: v._getEv, + onmouseup: v._getEv, + onmouseover: v._getEv, + onmousemove: v._getEv, + onmouseout: v._getEv, + onfocus: v._getEv, + onblur: v._getEv, + onkeypress: v._getEv, + onkeydown: v._getEv, + onkeyup: v._getEv, + onsubmit: v._getEv, + onreset: v._getEv, + onselect: v._getEv, + onchange: v._getEv + }); + })(Element._attributeTranslations.read.values); +} + +else if (Prototype.Browser.Gecko && /rv:1\.8\.0/.test(navigator.userAgent)) { + Element.Methods.setOpacity = function(element, value) { + element = $(element); + element.style.opacity = (value == 1) ? 0.999999 : + (value === '') ? '' : (value < 0.00001) ? 0 : value; + return element; + }; +} + +else if (Prototype.Browser.WebKit) { + Element.Methods.setOpacity = function(element, value) { + element = $(element); + element.style.opacity = (value == 1 || value === '') ? '' : + (value < 0.00001) ? 0 : value; + + if (value == 1) + if(element.tagName == 'IMG' && element.width) { + element.width++; element.width--; + } else try { + var n = document.createTextNode(' '); + element.appendChild(n); + element.removeChild(n); + } catch (e) { } + + return element; + }; + + // Safari returns margins on body which is incorrect if the child is absolutely + // positioned. For performance reasons, redefine Element#cumulativeOffset for + // KHTML/WebKit only. + Element.Methods.cumulativeOffset = function(element) { + var valueT = 0, valueL = 0; + do { + valueT += element.offsetTop || 0; + valueL += element.offsetLeft || 0; + if (element.offsetParent == document.body) + if (Element.getStyle(element, 'position') == 'absolute') break; + + element = element.offsetParent; + } while (element); + + return Element._returnOffset(valueL, valueT); + }; +} + +if (Prototype.Browser.IE || Prototype.Browser.Opera) { + // IE and Opera are missing .innerHTML support for TABLE-related and SELECT elements + Element.Methods.update = function(element, content) { + element = $(element); + + if (content && content.toElement) content = content.toElement(); + if (Object.isElement(content)) return element.update().insert(content); + + content = Object.toHTML(content); + var tagName = element.tagName.toUpperCase(); + + if (tagName in Element._insertionTranslations.tags) { + $A(element.childNodes).each(function(node) { element.removeChild(node) }); + Element._getContentFromAnonymousElement(tagName, content.stripScripts()) + .each(function(node) { element.appendChild(node) }); + } + else element.innerHTML = content.stripScripts(); + + content.evalScripts.bind(content).defer(); + return element; + }; +} + +if (document.createElement('div').outerHTML) { + Element.Methods.replace = function(element, content) { + element = $(element); + + if (content && content.toElement) content = content.toElement(); + if (Object.isElement(content)) { + element.parentNode.replaceChild(content, element); + return element; + } + + content = Object.toHTML(content); + var parent = element.parentNode, tagName = parent.tagName.toUpperCase(); + + if (Element._insertionTranslations.tags[tagName]) { + var nextSibling = element.next(); + var fragments = Element._getContentFromAnonymousElement(tagName, content.stripScripts()); + parent.removeChild(element); + if (nextSibling) + fragments.each(function(node) { parent.insertBefore(node, nextSibling) }); + else + fragments.each(function(node) { parent.appendChild(node) }); + } + else element.outerHTML = content.stripScripts(); + + content.evalScripts.bind(content).defer(); + return element; + }; +} + +Element._returnOffset = function(l, t) { + var result = [l, t]; + result.left = l; + result.top = t; + return result; +}; + +Element._getContentFromAnonymousElement = function(tagName, html) { + var div = new Element('div'), t = Element._insertionTranslations.tags[tagName]; + div.innerHTML = t[0] + html + t[1]; + t[2].times(function() { div = div.firstChild }); + return $A(div.childNodes); +}; + +Element._insertionTranslations = { + before: { + adjacency: 'beforeBegin', + insert: function(element, node) { + element.parentNode.insertBefore(node, element); + }, + initializeRange: function(element, range) { + range.setStartBefore(element); + } + }, + top: { + adjacency: 'afterBegin', + insert: function(element, node) { + element.insertBefore(node, element.firstChild); + }, + initializeRange: function(element, range) { + range.selectNodeContents(element); + range.collapse(true); + } + }, + bottom: { + adjacency: 'beforeEnd', + insert: function(element, node) { + element.appendChild(node); + } + }, + after: { + adjacency: 'afterEnd', + insert: function(element, node) { + element.parentNode.insertBefore(node, element.nextSibling); + }, + initializeRange: function(element, range) { + range.setStartAfter(element); + } + }, + tags: { + TABLE: ['', '
    ', 1], + TBODY: ['', '
    ', 2], + TR: ['', '
    ', 3], + TD: ['
    ', '
    ', 4], + SELECT: ['', 1] + } +}; + +(function() { + this.bottom.initializeRange = this.top.initializeRange; + Object.extend(this.tags, { + THEAD: this.tags.TBODY, + TFOOT: this.tags.TBODY, + TH: this.tags.TD + }); +}).call(Element._insertionTranslations); + +Element.Methods.Simulated = { + hasAttribute: function(element, attribute) { + attribute = Element._attributeTranslations.has[attribute] || attribute; + var node = $(element).getAttributeNode(attribute); + return node && node.specified; + } +}; + +Element.Methods.ByTag = { }; + +Object.extend(Element, Element.Methods); + +if (!Prototype.BrowserFeatures.ElementExtensions && + document.createElement('div').__proto__) { + window.HTMLElement = { }; + window.HTMLElement.prototype = document.createElement('div').__proto__; + Prototype.BrowserFeatures.ElementExtensions = true; +} + +Element.extend = (function() { + if (Prototype.BrowserFeatures.SpecificElementExtensions) + return Prototype.K; + + var Methods = { }, ByTag = Element.Methods.ByTag; + + var extend = Object.extend(function(element) { + if (!element || element._extendedByPrototype || + element.nodeType != 1 || element == window) return element; + + var methods = Object.clone(Methods), + tagName = element.tagName, property, value; + + // extend methods for specific tags + if (ByTag[tagName]) Object.extend(methods, ByTag[tagName]); + + for (property in methods) { + value = methods[property]; + if (Object.isFunction(value) && !(property in element)) + element[property] = value.methodize(); + } + + element._extendedByPrototype = Prototype.emptyFunction; + return element; + + }, { + refresh: function() { + // extend methods for all tags (Safari doesn't need this) + if (!Prototype.BrowserFeatures.ElementExtensions) { + Object.extend(Methods, Element.Methods); + Object.extend(Methods, Element.Methods.Simulated); + } + } + }); + + extend.refresh(); + return extend; +})(); + +Element.hasAttribute = function(element, attribute) { + if (element.hasAttribute) return element.hasAttribute(attribute); + return Element.Methods.Simulated.hasAttribute(element, attribute); +}; + +Element.addMethods = function(methods) { + var F = Prototype.BrowserFeatures, T = Element.Methods.ByTag; + + if (!methods) { + Object.extend(Form, Form.Methods); + Object.extend(Form.Element, Form.Element.Methods); + Object.extend(Element.Methods.ByTag, { + "FORM": Object.clone(Form.Methods), + "INPUT": Object.clone(Form.Element.Methods), + "SELECT": Object.clone(Form.Element.Methods), + "TEXTAREA": Object.clone(Form.Element.Methods) + }); + } + + if (arguments.length == 2) { + var tagName = methods; + methods = arguments[1]; + } + + if (!tagName) Object.extend(Element.Methods, methods || { }); + else { + if (Object.isArray(tagName)) tagName.each(extend); + else extend(tagName); + } + + function extend(tagName) { + tagName = tagName.toUpperCase(); + if (!Element.Methods.ByTag[tagName]) + Element.Methods.ByTag[tagName] = { }; + Object.extend(Element.Methods.ByTag[tagName], methods); + } + + function copy(methods, destination, onlyIfAbsent) { + onlyIfAbsent = onlyIfAbsent || false; + for (var property in methods) { + var value = methods[property]; + if (!Object.isFunction(value)) continue; + if (!onlyIfAbsent || !(property in destination)) + destination[property] = value.methodize(); + } + } + + function findDOMClass(tagName) { + var klass; + var trans = { + "OPTGROUP": "OptGroup", "TEXTAREA": "TextArea", "P": "Paragraph", + "FIELDSET": "FieldSet", "UL": "UList", "OL": "OList", "DL": "DList", + "DIR": "Directory", "H1": "Heading", "H2": "Heading", "H3": "Heading", + "H4": "Heading", "H5": "Heading", "H6": "Heading", "Q": "Quote", + "INS": "Mod", "DEL": "Mod", "A": "Anchor", "IMG": "Image", "CAPTION": + "TableCaption", "COL": "TableCol", "COLGROUP": "TableCol", "THEAD": + "TableSection", "TFOOT": "TableSection", "TBODY": "TableSection", "TR": + "TableRow", "TH": "TableCell", "TD": "TableCell", "FRAMESET": + "FrameSet", "IFRAME": "IFrame" + }; + if (trans[tagName]) klass = 'HTML' + trans[tagName] + 'Element'; + if (window[klass]) return window[klass]; + klass = 'HTML' + tagName + 'Element'; + if (window[klass]) return window[klass]; + klass = 'HTML' + tagName.capitalize() + 'Element'; + if (window[klass]) return window[klass]; + + window[klass] = { }; + window[klass].prototype = document.createElement(tagName).__proto__; + return window[klass]; + } + + if (F.ElementExtensions) { + copy(Element.Methods, HTMLElement.prototype); + copy(Element.Methods.Simulated, HTMLElement.prototype, true); + } + + if (F.SpecificElementExtensions) { + for (var tag in Element.Methods.ByTag) { + var klass = findDOMClass(tag); + if (Object.isUndefined(klass)) continue; + copy(T[tag], klass.prototype); + } + } + + Object.extend(Element, Element.Methods); + delete Element.ByTag; + + if (Element.extend.refresh) Element.extend.refresh(); + Element.cache = { }; +}; + +document.viewport = { + getDimensions: function() { + var dimensions = { }; + var B = Prototype.Browser; + $w('width height').each(function(d) { + var D = d.capitalize(); + dimensions[d] = (B.WebKit && !document.evaluate) ? self['inner' + D] : + (B.Opera) ? document.body['client' + D] : document.documentElement['client' + D]; + }); + return dimensions; + }, + + getWidth: function() { + return this.getDimensions().width; + }, + + getHeight: function() { + return this.getDimensions().height; + }, + + getScrollOffsets: function() { + return Element._returnOffset( + window.pageXOffset || document.documentElement.scrollLeft || document.body.scrollLeft, + window.pageYOffset || document.documentElement.scrollTop || document.body.scrollTop); + } +}; +/* Portions of the Selector class are derived from Jack Slocum’s DomQuery, + * part of YUI-Ext version 0.40, distributed under the terms of an MIT-style + * license. Please see http://www.yui-ext.com/ for more information. */ + +var Selector = Class.create({ + initialize: function(expression) { + this.expression = expression.strip(); + this.compileMatcher(); + }, + + shouldUseXPath: function() { + if (!Prototype.BrowserFeatures.XPath) return false; + + var e = this.expression; + + // Safari 3 chokes on :*-of-type and :empty + if (Prototype.Browser.WebKit && + (e.include("-of-type") || e.include(":empty"))) + return false; + + // XPath can't do namespaced attributes, nor can it read + // the "checked" property from DOM nodes + if ((/(\[[\w-]*?:|:checked)/).test(this.expression)) + return false; + + return true; + }, + + compileMatcher: function() { + if (this.shouldUseXPath()) + return this.compileXPathMatcher(); + + var e = this.expression, ps = Selector.patterns, h = Selector.handlers, + c = Selector.criteria, le, p, m; + + if (Selector._cache[e]) { + this.matcher = Selector._cache[e]; + return; + } + + this.matcher = ["this.matcher = function(root) {", + "var r = root, h = Selector.handlers, c = false, n;"]; + + while (e && le != e && (/\S/).test(e)) { + le = e; + for (var i in ps) { + p = ps[i]; + if (m = e.match(p)) { + this.matcher.push(Object.isFunction(c[i]) ? c[i](m) : + new Template(c[i]).evaluate(m)); + e = e.replace(m[0], ''); + break; + } + } + } + + this.matcher.push("return h.unique(n);\n}"); + eval(this.matcher.join('\n')); + Selector._cache[this.expression] = this.matcher; + }, + + compileXPathMatcher: function() { + var e = this.expression, ps = Selector.patterns, + x = Selector.xpath, le, m; + + if (Selector._cache[e]) { + this.xpath = Selector._cache[e]; return; + } + + this.matcher = ['.//*']; + while (e && le != e && (/\S/).test(e)) { + le = e; + for (var i in ps) { + if (m = e.match(ps[i])) { + this.matcher.push(Object.isFunction(x[i]) ? x[i](m) : + new Template(x[i]).evaluate(m)); + e = e.replace(m[0], ''); + break; + } + } + } + + this.xpath = this.matcher.join(''); + Selector._cache[this.expression] = this.xpath; + }, + + findElements: function(root) { + root = root || document; + if (this.xpath) return document._getElementsByXPath(this.xpath, root); + return this.matcher(root); + }, + + match: function(element) { + this.tokens = []; + + var e = this.expression, ps = Selector.patterns, as = Selector.assertions; + var le, p, m; + + while (e && le !== e && (/\S/).test(e)) { + le = e; + for (var i in ps) { + p = ps[i]; + if (m = e.match(p)) { + // use the Selector.assertions methods unless the selector + // is too complex. + if (as[i]) { + this.tokens.push([i, Object.clone(m)]); + e = e.replace(m[0], ''); + } else { + // reluctantly do a document-wide search + // and look for a match in the array + return this.findElements(document).include(element); + } + } + } + } + + var match = true, name, matches; + for (var i = 0, token; token = this.tokens[i]; i++) { + name = token[0], matches = token[1]; + if (!Selector.assertions[name](element, matches)) { + match = false; break; + } + } + + return match; + }, + + toString: function() { + return this.expression; + }, + + inspect: function() { + return "#"; + } +}); + +Object.extend(Selector, { + _cache: { }, + + xpath: { + descendant: "//*", + child: "/*", + adjacent: "/following-sibling::*[1]", + laterSibling: '/following-sibling::*', + tagName: function(m) { + if (m[1] == '*') return ''; + return "[local-name()='" + m[1].toLowerCase() + + "' or local-name()='" + m[1].toUpperCase() + "']"; + }, + className: "[contains(concat(' ', @class, ' '), ' #{1} ')]", + id: "[@id='#{1}']", + attrPresence: function(m) { + m[1] = m[1].toLowerCase(); + return new Template("[@#{1}]").evaluate(m); + }, + attr: function(m) { + m[1] = m[1].toLowerCase(); + m[3] = m[5] || m[6]; + return new Template(Selector.xpath.operators[m[2]]).evaluate(m); + }, + pseudo: function(m) { + var h = Selector.xpath.pseudos[m[1]]; + if (!h) return ''; + if (Object.isFunction(h)) return h(m); + return new Template(Selector.xpath.pseudos[m[1]]).evaluate(m); + }, + operators: { + '=': "[@#{1}='#{3}']", + '!=': "[@#{1}!='#{3}']", + '^=': "[starts-with(@#{1}, '#{3}')]", + '$=': "[substring(@#{1}, (string-length(@#{1}) - string-length('#{3}') + 1))='#{3}']", + '*=': "[contains(@#{1}, '#{3}')]", + '~=': "[contains(concat(' ', @#{1}, ' '), ' #{3} ')]", + '|=': "[contains(concat('-', @#{1}, '-'), '-#{3}-')]" + }, + pseudos: { + 'first-child': '[not(preceding-sibling::*)]', + 'last-child': '[not(following-sibling::*)]', + 'only-child': '[not(preceding-sibling::* or following-sibling::*)]', + 'empty': "[count(*) = 0 and (count(text()) = 0 or translate(text(), ' \t\r\n', '') = '')]", + 'checked': "[@checked]", + 'disabled': "[@disabled]", + 'enabled': "[not(@disabled)]", + 'not': function(m) { + var e = m[6], p = Selector.patterns, + x = Selector.xpath, le, v; + + var exclusion = []; + while (e && le != e && (/\S/).test(e)) { + le = e; + for (var i in p) { + if (m = e.match(p[i])) { + v = Object.isFunction(x[i]) ? x[i](m) : new Template(x[i]).evaluate(m); + exclusion.push("(" + v.substring(1, v.length - 1) + ")"); + e = e.replace(m[0], ''); + break; + } + } + } + return "[not(" + exclusion.join(" and ") + ")]"; + }, + 'nth-child': function(m) { + return Selector.xpath.pseudos.nth("(count(./preceding-sibling::*) + 1) ", m); + }, + 'nth-last-child': function(m) { + return Selector.xpath.pseudos.nth("(count(./following-sibling::*) + 1) ", m); + }, + 'nth-of-type': function(m) { + return Selector.xpath.pseudos.nth("position() ", m); + }, + 'nth-last-of-type': function(m) { + return Selector.xpath.pseudos.nth("(last() + 1 - position()) ", m); + }, + 'first-of-type': function(m) { + m[6] = "1"; return Selector.xpath.pseudos['nth-of-type'](m); + }, + 'last-of-type': function(m) { + m[6] = "1"; return Selector.xpath.pseudos['nth-last-of-type'](m); + }, + 'only-of-type': function(m) { + var p = Selector.xpath.pseudos; return p['first-of-type'](m) + p['last-of-type'](m); + }, + nth: function(fragment, m) { + var mm, formula = m[6], predicate; + if (formula == 'even') formula = '2n+0'; + if (formula == 'odd') formula = '2n+1'; + if (mm = formula.match(/^(\d+)$/)) // digit only + return '[' + fragment + "= " + mm[1] + ']'; + if (mm = formula.match(/^(-?\d*)?n(([+-])(\d+))?/)) { // an+b + if (mm[1] == "-") mm[1] = -1; + var a = mm[1] ? Number(mm[1]) : 1; + var b = mm[2] ? Number(mm[2]) : 0; + predicate = "[((#{fragment} - #{b}) mod #{a} = 0) and " + + "((#{fragment} - #{b}) div #{a} >= 0)]"; + return new Template(predicate).evaluate({ + fragment: fragment, a: a, b: b }); + } + } + } + }, + + criteria: { + tagName: 'n = h.tagName(n, r, "#{1}", c); c = false;', + className: 'n = h.className(n, r, "#{1}", c); c = false;', + id: 'n = h.id(n, r, "#{1}", c); c = false;', + attrPresence: 'n = h.attrPresence(n, r, "#{1}"); c = false;', + attr: function(m) { + m[3] = (m[5] || m[6]); + return new Template('n = h.attr(n, r, "#{1}", "#{3}", "#{2}"); c = false;').evaluate(m); + }, + pseudo: function(m) { + if (m[6]) m[6] = m[6].replace(/"/g, '\\"'); + return new Template('n = h.pseudo(n, "#{1}", "#{6}", r, c); c = false;').evaluate(m); + }, + descendant: 'c = "descendant";', + child: 'c = "child";', + adjacent: 'c = "adjacent";', + laterSibling: 'c = "laterSibling";' + }, + + patterns: { + // combinators must be listed first + // (and descendant needs to be last combinator) + laterSibling: /^\s*~\s*/, + child: /^\s*>\s*/, + adjacent: /^\s*\+\s*/, + descendant: /^\s/, + + // selectors follow + tagName: /^\s*(\*|[\w\-]+)(\b|$)?/, + id: /^#([\w\-\*]+)(\b|$)/, + className: /^\.([\w\-\*]+)(\b|$)/, + pseudo: /^:((first|last|nth|nth-last|only)(-child|-of-type)|empty|checked|(en|dis)abled|not)(\((.*?)\))?(\b|$|(?=\s)|(?=:))/, + attrPresence: /^\[([\w]+)\]/, + attr: /\[((?:[\w-]*:)?[\w-]+)\s*(?:([!^$*~|]?=)\s*((['"])([^\4]*?)\4|([^'"][^\]]*?)))?\]/ + }, + + // for Selector.match and Element#match + assertions: { + tagName: function(element, matches) { + return matches[1].toUpperCase() == element.tagName.toUpperCase(); + }, + + className: function(element, matches) { + return Element.hasClassName(element, matches[1]); + }, + + id: function(element, matches) { + return element.id === matches[1]; + }, + + attrPresence: function(element, matches) { + return Element.hasAttribute(element, matches[1]); + }, + + attr: function(element, matches) { + var nodeValue = Element.readAttribute(element, matches[1]); + return Selector.operators[matches[2]](nodeValue, matches[3]); + } + }, + + handlers: { + // UTILITY FUNCTIONS + // joins two collections + concat: function(a, b) { + for (var i = 0, node; node = b[i]; i++) + a.push(node); + return a; + }, + + // marks an array of nodes for counting + mark: function(nodes) { + for (var i = 0, node; node = nodes[i]; i++) + node._counted = true; + return nodes; + }, + + unmark: function(nodes) { + for (var i = 0, node; node = nodes[i]; i++) + node._counted = undefined; + return nodes; + }, + + // mark each child node with its position (for nth calls) + // "ofType" flag indicates whether we're indexing for nth-of-type + // rather than nth-child + index: function(parentNode, reverse, ofType) { + parentNode._counted = true; + if (reverse) { + for (var nodes = parentNode.childNodes, i = nodes.length - 1, j = 1; i >= 0; i--) { + var node = nodes[i]; + if (node.nodeType == 1 && (!ofType || node._counted)) node.nodeIndex = j++; + } + } else { + for (var i = 0, j = 1, nodes = parentNode.childNodes; node = nodes[i]; i++) + if (node.nodeType == 1 && (!ofType || node._counted)) node.nodeIndex = j++; + } + }, + + // filters out duplicates and extends all nodes + unique: function(nodes) { + if (nodes.length == 0) return nodes; + var results = [], n; + for (var i = 0, l = nodes.length; i < l; i++) + if (!(n = nodes[i])._counted) { + n._counted = true; + results.push(Element.extend(n)); + } + return Selector.handlers.unmark(results); + }, + + // COMBINATOR FUNCTIONS + descendant: function(nodes) { + var h = Selector.handlers; + for (var i = 0, results = [], node; node = nodes[i]; i++) + h.concat(results, node.getElementsByTagName('*')); + return results; + }, + + child: function(nodes) { + var h = Selector.handlers; + for (var i = 0, results = [], node; node = nodes[i]; i++) { + for (var j = 0, child; child = node.childNodes[j]; j++) + if (child.nodeType == 1 && child.tagName != '!') results.push(child); + } + return results; + }, + + adjacent: function(nodes) { + for (var i = 0, results = [], node; node = nodes[i]; i++) { + var next = this.nextElementSibling(node); + if (next) results.push(next); + } + return results; + }, + + laterSibling: function(nodes) { + var h = Selector.handlers; + for (var i = 0, results = [], node; node = nodes[i]; i++) + h.concat(results, Element.nextSiblings(node)); + return results; + }, + + nextElementSibling: function(node) { + while (node = node.nextSibling) + if (node.nodeType == 1) return node; + return null; + }, + + previousElementSibling: function(node) { + while (node = node.previousSibling) + if (node.nodeType == 1) return node; + return null; + }, + + // TOKEN FUNCTIONS + tagName: function(nodes, root, tagName, combinator) { + tagName = tagName.toUpperCase(); + var results = [], h = Selector.handlers; + if (nodes) { + if (combinator) { + // fastlane for ordinary descendant combinators + if (combinator == "descendant") { + for (var i = 0, node; node = nodes[i]; i++) + h.concat(results, node.getElementsByTagName(tagName)); + return results; + } else nodes = this[combinator](nodes); + if (tagName == "*") return nodes; + } + for (var i = 0, node; node = nodes[i]; i++) + if (node.tagName.toUpperCase() == tagName) results.push(node); + return results; + } else return root.getElementsByTagName(tagName); + }, + + id: function(nodes, root, id, combinator) { + var targetNode = $(id), h = Selector.handlers; + if (!targetNode) return []; + if (!nodes && root == document) return [targetNode]; + if (nodes) { + if (combinator) { + if (combinator == 'child') { + for (var i = 0, node; node = nodes[i]; i++) + if (targetNode.parentNode == node) return [targetNode]; + } else if (combinator == 'descendant') { + for (var i = 0, node; node = nodes[i]; i++) + if (Element.descendantOf(targetNode, node)) return [targetNode]; + } else if (combinator == 'adjacent') { + for (var i = 0, node; node = nodes[i]; i++) + if (Selector.handlers.previousElementSibling(targetNode) == node) + return [targetNode]; + } else nodes = h[combinator](nodes); + } + for (var i = 0, node; node = nodes[i]; i++) + if (node == targetNode) return [targetNode]; + return []; + } + return (targetNode && Element.descendantOf(targetNode, root)) ? [targetNode] : []; + }, + + className: function(nodes, root, className, combinator) { + if (nodes && combinator) nodes = this[combinator](nodes); + return Selector.handlers.byClassName(nodes, root, className); + }, + + byClassName: function(nodes, root, className) { + if (!nodes) nodes = Selector.handlers.descendant([root]); + var needle = ' ' + className + ' '; + for (var i = 0, results = [], node, nodeClassName; node = nodes[i]; i++) { + nodeClassName = node.className; + if (nodeClassName.length == 0) continue; + if (nodeClassName == className || (' ' + nodeClassName + ' ').include(needle)) + results.push(node); + } + return results; + }, + + attrPresence: function(nodes, root, attr) { + if (!nodes) nodes = root.getElementsByTagName("*"); + var results = []; + for (var i = 0, node; node = nodes[i]; i++) + if (Element.hasAttribute(node, attr)) results.push(node); + return results; + }, + + attr: function(nodes, root, attr, value, operator) { + if (!nodes) nodes = root.getElementsByTagName("*"); + var handler = Selector.operators[operator], results = []; + for (var i = 0, node; node = nodes[i]; i++) { + var nodeValue = Element.readAttribute(node, attr); + if (nodeValue === null) continue; + if (handler(nodeValue, value)) results.push(node); + } + return results; + }, + + pseudo: function(nodes, name, value, root, combinator) { + if (nodes && combinator) nodes = this[combinator](nodes); + if (!nodes) nodes = root.getElementsByTagName("*"); + return Selector.pseudos[name](nodes, value, root); + } + }, + + pseudos: { + 'first-child': function(nodes, value, root) { + for (var i = 0, results = [], node; node = nodes[i]; i++) { + if (Selector.handlers.previousElementSibling(node)) continue; + results.push(node); + } + return results; + }, + 'last-child': function(nodes, value, root) { + for (var i = 0, results = [], node; node = nodes[i]; i++) { + if (Selector.handlers.nextElementSibling(node)) continue; + results.push(node); + } + return results; + }, + 'only-child': function(nodes, value, root) { + var h = Selector.handlers; + for (var i = 0, results = [], node; node = nodes[i]; i++) + if (!h.previousElementSibling(node) && !h.nextElementSibling(node)) + results.push(node); + return results; + }, + 'nth-child': function(nodes, formula, root) { + return Selector.pseudos.nth(nodes, formula, root); + }, + 'nth-last-child': function(nodes, formula, root) { + return Selector.pseudos.nth(nodes, formula, root, true); + }, + 'nth-of-type': function(nodes, formula, root) { + return Selector.pseudos.nth(nodes, formula, root, false, true); + }, + 'nth-last-of-type': function(nodes, formula, root) { + return Selector.pseudos.nth(nodes, formula, root, true, true); + }, + 'first-of-type': function(nodes, formula, root) { + return Selector.pseudos.nth(nodes, "1", root, false, true); + }, + 'last-of-type': function(nodes, formula, root) { + return Selector.pseudos.nth(nodes, "1", root, true, true); + }, + 'only-of-type': function(nodes, formula, root) { + var p = Selector.pseudos; + return p['last-of-type'](p['first-of-type'](nodes, formula, root), formula, root); + }, + + // handles the an+b logic + getIndices: function(a, b, total) { + if (a == 0) return b > 0 ? [b] : []; + return $R(1, total).inject([], function(memo, i) { + if (0 == (i - b) % a && (i - b) / a >= 0) memo.push(i); + return memo; + }); + }, + + // handles nth(-last)-child, nth(-last)-of-type, and (first|last)-of-type + nth: function(nodes, formula, root, reverse, ofType) { + if (nodes.length == 0) return []; + if (formula == 'even') formula = '2n+0'; + if (formula == 'odd') formula = '2n+1'; + var h = Selector.handlers, results = [], indexed = [], m; + h.mark(nodes); + for (var i = 0, node; node = nodes[i]; i++) { + if (!node.parentNode._counted) { + h.index(node.parentNode, reverse, ofType); + indexed.push(node.parentNode); + } + } + if (formula.match(/^\d+$/)) { // just a number + formula = Number(formula); + for (var i = 0, node; node = nodes[i]; i++) + if (node.nodeIndex == formula) results.push(node); + } else if (m = formula.match(/^(-?\d*)?n(([+-])(\d+))?/)) { // an+b + if (m[1] == "-") m[1] = -1; + var a = m[1] ? Number(m[1]) : 1; + var b = m[2] ? Number(m[2]) : 0; + var indices = Selector.pseudos.getIndices(a, b, nodes.length); + for (var i = 0, node, l = indices.length; node = nodes[i]; i++) { + for (var j = 0; j < l; j++) + if (node.nodeIndex == indices[j]) results.push(node); + } + } + h.unmark(nodes); + h.unmark(indexed); + return results; + }, + + 'empty': function(nodes, value, root) { + for (var i = 0, results = [], node; node = nodes[i]; i++) { + // IE treats comments as element nodes + if (node.tagName == '!' || (node.firstChild && !node.innerHTML.match(/^\s*$/))) continue; + results.push(node); + } + return results; + }, + + 'not': function(nodes, selector, root) { + var h = Selector.handlers, selectorType, m; + var exclusions = new Selector(selector).findElements(root); + h.mark(exclusions); + for (var i = 0, results = [], node; node = nodes[i]; i++) + if (!node._counted) results.push(node); + h.unmark(exclusions); + return results; + }, + + 'enabled': function(nodes, value, root) { + for (var i = 0, results = [], node; node = nodes[i]; i++) + if (!node.disabled) results.push(node); + return results; + }, + + 'disabled': function(nodes, value, root) { + for (var i = 0, results = [], node; node = nodes[i]; i++) + if (node.disabled) results.push(node); + return results; + }, + + 'checked': function(nodes, value, root) { + for (var i = 0, results = [], node; node = nodes[i]; i++) + if (node.checked) results.push(node); + return results; + } + }, + + operators: { + '=': function(nv, v) { return nv == v; }, + '!=': function(nv, v) { return nv != v; }, + '^=': function(nv, v) { return nv.startsWith(v); }, + '$=': function(nv, v) { return nv.endsWith(v); }, + '*=': function(nv, v) { return nv.include(v); }, + '~=': function(nv, v) { return (' ' + nv + ' ').include(' ' + v + ' '); }, + '|=': function(nv, v) { return ('-' + nv.toUpperCase() + '-').include('-' + v.toUpperCase() + '-'); } + }, + + matchElements: function(elements, expression) { + var matches = new Selector(expression).findElements(), h = Selector.handlers; + h.mark(matches); + for (var i = 0, results = [], element; element = elements[i]; i++) + if (element._counted) results.push(element); + h.unmark(matches); + return results; + }, + + findElement: function(elements, expression, index) { + if (Object.isNumber(expression)) { + index = expression; expression = false; + } + return Selector.matchElements(elements, expression || '*')[index || 0]; + }, + + findChildElements: function(element, expressions) { + var exprs = expressions.join(','); + expressions = []; + exprs.scan(/(([\w#:.~>+()\s-]+|\*|\[.*?\])+)\s*(,|$)/, function(m) { + expressions.push(m[1].strip()); + }); + var results = [], h = Selector.handlers; + for (var i = 0, l = expressions.length, selector; i < l; i++) { + selector = new Selector(expressions[i].strip()); + h.concat(results, selector.findElements(element)); + } + return (l > 1) ? h.unique(results) : results; + } +}); + +if (Prototype.Browser.IE) { + // IE returns comment nodes on getElementsByTagName("*"). + // Filter them out. + Selector.handlers.concat = function(a, b) { + for (var i = 0, node; node = b[i]; i++) + if (node.tagName !== "!") a.push(node); + return a; + }; +} + +function $$() { + return Selector.findChildElements(document, $A(arguments)); +} +var Form = { + reset: function(form) { + $(form).reset(); + return form; + }, + + serializeElements: function(elements, options) { + if (typeof options != 'object') options = { hash: !!options }; + else if (Object.isUndefined(options.hash)) options.hash = true; + var key, value, submitted = false, submit = options.submit; + + var data = elements.inject({ }, function(result, element) { + if (!element.disabled && element.name) { + key = element.name; value = $(element).getValue(); + if (value != null && (element.type != 'submit' || (!submitted && + submit !== false && (!submit || key == submit) && (submitted = true)))) { + if (key in result) { + // a key is already present; construct an array of values + if (!Object.isArray(result[key])) result[key] = [result[key]]; + result[key].push(value); + } + else result[key] = value; + } + } + return result; + }); + + return options.hash ? data : Object.toQueryString(data); + } +}; + +Form.Methods = { + serialize: function(form, options) { + return Form.serializeElements(Form.getElements(form), options); + }, + + getElements: function(form) { + return $A($(form).getElementsByTagName('*')).inject([], + function(elements, child) { + if (Form.Element.Serializers[child.tagName.toLowerCase()]) + elements.push(Element.extend(child)); + return elements; + } + ); + }, + + getInputs: function(form, typeName, name) { + form = $(form); + var inputs = form.getElementsByTagName('input'); + + if (!typeName && !name) return $A(inputs).map(Element.extend); + + for (var i = 0, matchingInputs = [], length = inputs.length; i < length; i++) { + var input = inputs[i]; + if ((typeName && input.type != typeName) || (name && input.name != name)) + continue; + matchingInputs.push(Element.extend(input)); + } + + return matchingInputs; + }, + + disable: function(form) { + form = $(form); + Form.getElements(form).invoke('disable'); + return form; + }, + + enable: function(form) { + form = $(form); + Form.getElements(form).invoke('enable'); + return form; + }, + + findFirstElement: function(form) { + var elements = $(form).getElements().findAll(function(element) { + return 'hidden' != element.type && !element.disabled; + }); + var firstByIndex = elements.findAll(function(element) { + return element.hasAttribute('tabIndex') && element.tabIndex >= 0; + }).sortBy(function(element) { return element.tabIndex }).first(); + + return firstByIndex ? firstByIndex : elements.find(function(element) { + return ['input', 'select', 'textarea'].include(element.tagName.toLowerCase()); + }); + }, + + focusFirstElement: function(form) { + form = $(form); + form.findFirstElement().activate(); + return form; + }, + + request: function(form, options) { + form = $(form), options = Object.clone(options || { }); + + var params = options.parameters, action = form.readAttribute('action') || ''; + if (action.blank()) action = window.location.href; + options.parameters = form.serialize(true); + + if (params) { + if (Object.isString(params)) params = params.toQueryParams(); + Object.extend(options.parameters, params); + } + + if (form.hasAttribute('method') && !options.method) + options.method = form.method; + + return new Ajax.Request(action, options); + } +}; + +/*--------------------------------------------------------------------------*/ + +Form.Element = { + focus: function(element) { + $(element).focus(); + return element; + }, + + select: function(element) { + $(element).select(); + return element; + } +}; + +Form.Element.Methods = { + serialize: function(element) { + element = $(element); + if (!element.disabled && element.name) { + var value = element.getValue(); + if (value != undefined) { + var pair = { }; + pair[element.name] = value; + return Object.toQueryString(pair); + } + } + return ''; + }, + + getValue: function(element) { + element = $(element); + var method = element.tagName.toLowerCase(); + return Form.Element.Serializers[method](element); + }, + + setValue: function(element, value) { + element = $(element); + var method = element.tagName.toLowerCase(); + Form.Element.Serializers[method](element, value); + return element; + }, + + clear: function(element) { + $(element).value = ''; + return element; + }, + + present: function(element) { + return $(element).value != ''; + }, + + activate: function(element) { + element = $(element); + try { + element.focus(); + if (element.select && (element.tagName.toLowerCase() != 'input' || + !['button', 'reset', 'submit'].include(element.type))) + element.select(); + } catch (e) { } + return element; + }, + + disable: function(element) { + element = $(element); + element.blur(); + element.disabled = true; + return element; + }, + + enable: function(element) { + element = $(element); + element.disabled = false; + return element; + } +}; + +/*--------------------------------------------------------------------------*/ + +var Field = Form.Element; +var $F = Form.Element.Methods.getValue; + +/*--------------------------------------------------------------------------*/ + +Form.Element.Serializers = { + input: function(element, value) { + switch (element.type.toLowerCase()) { + case 'checkbox': + case 'radio': + return Form.Element.Serializers.inputSelector(element, value); + default: + return Form.Element.Serializers.textarea(element, value); + } + }, + + inputSelector: function(element, value) { + if (Object.isUndefined(value)) return element.checked ? element.value : null; + else element.checked = !!value; + }, + + textarea: function(element, value) { + if (Object.isUndefined(value)) return element.value; + else element.value = value; + }, + + select: function(element, index) { + if (Object.isUndefined(index)) + return this[element.type == 'select-one' ? + 'selectOne' : 'selectMany'](element); + else { + var opt, value, single = !Object.isArray(index); + for (var i = 0, length = element.length; i < length; i++) { + opt = element.options[i]; + value = this.optionValue(opt); + if (single) { + if (value == index) { + opt.selected = true; + return; + } + } + else opt.selected = index.include(value); + } + } + }, + + selectOne: function(element) { + var index = element.selectedIndex; + return index >= 0 ? this.optionValue(element.options[index]) : null; + }, + + selectMany: function(element) { + var values, length = element.length; + if (!length) return null; + + for (var i = 0, values = []; i < length; i++) { + var opt = element.options[i]; + if (opt.selected) values.push(this.optionValue(opt)); + } + return values; + }, + + optionValue: function(opt) { + // extend element because hasAttribute may not be native + return Element.extend(opt).hasAttribute('value') ? opt.value : opt.text; + } +}; + +/*--------------------------------------------------------------------------*/ + +Abstract.TimedObserver = Class.create(PeriodicalExecuter, { + initialize: function($super, element, frequency, callback) { + $super(callback, frequency); + this.element = $(element); + this.lastValue = this.getValue(); + }, + + execute: function() { + var value = this.getValue(); + if (Object.isString(this.lastValue) && Object.isString(value) ? + this.lastValue != value : String(this.lastValue) != String(value)) { + this.callback(this.element, value); + this.lastValue = value; + } + } +}); + +Form.Element.Observer = Class.create(Abstract.TimedObserver, { + getValue: function() { + return Form.Element.getValue(this.element); + } +}); + +Form.Observer = Class.create(Abstract.TimedObserver, { + getValue: function() { + return Form.serialize(this.element); + } +}); + +/*--------------------------------------------------------------------------*/ + +Abstract.EventObserver = Class.create({ + initialize: function(element, callback) { + this.element = $(element); + this.callback = callback; + + this.lastValue = this.getValue(); + if (this.element.tagName.toLowerCase() == 'form') + this.registerFormCallbacks(); + else + this.registerCallback(this.element); + }, + + onElementEvent: function() { + var value = this.getValue(); + if (this.lastValue != value) { + this.callback(this.element, value); + this.lastValue = value; + } + }, + + registerFormCallbacks: function() { + Form.getElements(this.element).each(this.registerCallback, this); + }, + + registerCallback: function(element) { + if (element.type) { + switch (element.type.toLowerCase()) { + case 'checkbox': + case 'radio': + Event.observe(element, 'click', this.onElementEvent.bind(this)); + break; + default: + Event.observe(element, 'change', this.onElementEvent.bind(this)); + break; + } + } + } +}); + +Form.Element.EventObserver = Class.create(Abstract.EventObserver, { + getValue: function() { + return Form.Element.getValue(this.element); + } +}); + +Form.EventObserver = Class.create(Abstract.EventObserver, { + getValue: function() { + return Form.serialize(this.element); + } +}); +if (!window.Event) var Event = { }; + +Object.extend(Event, { + KEY_BACKSPACE: 8, + KEY_TAB: 9, + KEY_RETURN: 13, + KEY_ESC: 27, + KEY_LEFT: 37, + KEY_UP: 38, + KEY_RIGHT: 39, + KEY_DOWN: 40, + KEY_DELETE: 46, + KEY_HOME: 36, + KEY_END: 35, + KEY_PAGEUP: 33, + KEY_PAGEDOWN: 34, + KEY_INSERT: 45, + + cache: { }, + + relatedTarget: function(event) { + var element; + switch(event.type) { + case 'mouseover': element = event.fromElement; break; + case 'mouseout': element = event.toElement; break; + default: return null; + } + return Element.extend(element); + } +}); + +Event.Methods = (function() { + var isButton; + + if (Prototype.Browser.IE) { + var buttonMap = { 0: 1, 1: 4, 2: 2 }; + isButton = function(event, code) { + return event.button == buttonMap[code]; + }; + + } else if (Prototype.Browser.WebKit) { + isButton = function(event, code) { + switch (code) { + case 0: return event.which == 1 && !event.metaKey; + case 1: return event.which == 1 && event.metaKey; + default: return false; + } + }; + + } else { + isButton = function(event, code) { + return event.which ? (event.which === code + 1) : (event.button === code); + }; + } + + return { + isLeftClick: function(event) { return isButton(event, 0) }, + isMiddleClick: function(event) { return isButton(event, 1) }, + isRightClick: function(event) { return isButton(event, 2) }, + + element: function(event) { + var node = Event.extend(event).target; + return Element.extend(node.nodeType == Node.TEXT_NODE ? node.parentNode : node); + }, + + findElement: function(event, expression) { + var element = Event.element(event); + if (!expression) return element; + var elements = [element].concat(element.ancestors()); + return Selector.findElement(elements, expression, 0); + }, + + pointer: function(event) { + return { + x: event.pageX || (event.clientX + + (document.documentElement.scrollLeft || document.body.scrollLeft)), + y: event.pageY || (event.clientY + + (document.documentElement.scrollTop || document.body.scrollTop)) + }; + }, + + pointerX: function(event) { return Event.pointer(event).x }, + pointerY: function(event) { return Event.pointer(event).y }, + + stop: function(event) { + Event.extend(event); + event.preventDefault(); + event.stopPropagation(); + event.stopped = true; + } + }; +})(); + +Event.extend = (function() { + var methods = Object.keys(Event.Methods).inject({ }, function(m, name) { + m[name] = Event.Methods[name].methodize(); + return m; + }); + + if (Prototype.Browser.IE) { + Object.extend(methods, { + stopPropagation: function() { this.cancelBubble = true }, + preventDefault: function() { this.returnValue = false }, + inspect: function() { return "[object Event]" } + }); + + return function(event) { + if (!event) return false; + if (event._extendedByPrototype) return event; + + event._extendedByPrototype = Prototype.emptyFunction; + var pointer = Event.pointer(event); + Object.extend(event, { + target: event.srcElement, + relatedTarget: Event.relatedTarget(event), + pageX: pointer.x, + pageY: pointer.y + }); + return Object.extend(event, methods); + }; + + } else { + Event.prototype = Event.prototype || document.createEvent("HTMLEvents").__proto__; + Object.extend(Event.prototype, methods); + return Prototype.K; + } +})(); + +Object.extend(Event, (function() { + var cache = Event.cache; + + function getEventID(element) { + if (element._eventID) return element._eventID; + arguments.callee.id = arguments.callee.id || 1; + return element._eventID = ++arguments.callee.id; + } + + function getDOMEventName(eventName) { + if (eventName && eventName.include(':')) return "dataavailable"; + return eventName; + } + + function getCacheForID(id) { + return cache[id] = cache[id] || { }; + } + + function getWrappersForEventName(id, eventName) { + var c = getCacheForID(id); + return c[eventName] = c[eventName] || []; + } + + function createWrapper(element, eventName, handler) { + var id = getEventID(element); + var c = getWrappersForEventName(id, eventName); + if (c.pluck("handler").include(handler)) return false; + + var wrapper = function(event) { + if (!Event || !Event.extend || + (event.eventName && event.eventName != eventName)) + return false; + + Event.extend(event); + handler.call(element, event) + }; + + wrapper.handler = handler; + c.push(wrapper); + return wrapper; + } + + function findWrapper(id, eventName, handler) { + var c = getWrappersForEventName(id, eventName); + return c.find(function(wrapper) { return wrapper.handler == handler }); + } + + function destroyWrapper(id, eventName, handler) { + var c = getCacheForID(id); + if (!c[eventName]) return false; + c[eventName] = c[eventName].without(findWrapper(id, eventName, handler)); + } + + function destroyCache() { + for (var id in cache) + for (var eventName in cache[id]) + cache[id][eventName] = null; + } + + if (window.attachEvent) { + window.attachEvent("onunload", destroyCache); + } + + return { + observe: function(element, eventName, handler) { + element = $(element); + var name = getDOMEventName(eventName); + + var wrapper = createWrapper(element, eventName, handler); + if (!wrapper) return element; + + if (element.addEventListener) { + element.addEventListener(name, wrapper, false); + } else { + element.attachEvent("on" + name, wrapper); + } + + return element; + }, + + stopObserving: function(element, eventName, handler) { + element = $(element); + var id = getEventID(element), name = getDOMEventName(eventName); + + if (!handler && eventName) { + getWrappersForEventName(id, eventName).each(function(wrapper) { + element.stopObserving(eventName, wrapper.handler); + }); + return element; + + } else if (!eventName) { + Object.keys(getCacheForID(id)).each(function(eventName) { + element.stopObserving(eventName); + }); + return element; + } + + var wrapper = findWrapper(id, eventName, handler); + if (!wrapper) return element; + + if (element.removeEventListener) { + element.removeEventListener(name, wrapper, false); + } else { + element.detachEvent("on" + name, wrapper); + } + + destroyWrapper(id, eventName, handler); + + return element; + }, + + fire: function(element, eventName, memo) { + element = $(element); + if (element == document && document.createEvent && !element.dispatchEvent) + element = document.documentElement; + + if (document.createEvent) { + var event = document.createEvent("HTMLEvents"); + event.initEvent("dataavailable", true, true); + } else { + var event = document.createEventObject(); + event.eventType = "ondataavailable"; + } + + event.eventName = eventName; + event.memo = memo || { }; + + if (document.createEvent) { + element.dispatchEvent(event); + } else { + element.fireEvent(event.eventType, event); + } + + return Event.extend(event); + } + }; +})()); + +Object.extend(Event, Event.Methods); + +Element.addMethods({ + fire: Event.fire, + observe: Event.observe, + stopObserving: Event.stopObserving +}); + +Object.extend(document, { + fire: Element.Methods.fire.methodize(), + observe: Element.Methods.observe.methodize(), + stopObserving: Element.Methods.stopObserving.methodize() +}); + +(function() { + /* Support for the DOMContentLoaded event is based on work by Dan Webb, + Matthias Miller, Dean Edwards and John Resig. */ + + var timer, fired = false; + + function fireContentLoadedEvent() { + if (fired) return; + if (timer) window.clearInterval(timer); + document.fire("dom:loaded"); + fired = true; + } + + if (document.addEventListener) { + if (Prototype.Browser.WebKit) { + timer = window.setInterval(function() { + if (/loaded|complete/.test(document.readyState)) + fireContentLoadedEvent(); + }, 0); + + Event.observe(window, "load", fireContentLoadedEvent); + + } else { + document.addEventListener("DOMContentLoaded", + fireContentLoadedEvent, false); + } + + } else { + document.write("