method

link_to_function

rails latest stable - Class: ActionView::Helpers::JavaScriptHelper

link_to_function(name, function, html_options={})

public

Returns a link whose onclick handler triggers the passed JavaScript.

The helper receives a name, JavaScript code, and an optional hash of HTML options. The name is used as the link text and the JavaScript code goes into the onclick attribute. If html_options has an :onclick, that one is put before function. Once all the JavaScript is set, the helper appends “; return false;”.

The href attribute of the tag is set to “#” unless html_options has one.

link_to_function "Greeting", "alert('Hello world!')", class: "nav_link"
# => <a class="nav_link" href="#" onclick="alert('Hello world!'); return false;">Greeting</a>

# File actionpack/lib/action_view/helpers/javascript_helper.rb, line 105
      def link_to_function(name, function, html_options={})
        message = "link_to_function is deprecated and will be removed from Rails 4.1. We recommend using Unobtrusive JavaScript instead. " +
          "See http://guides.rubyonrails.org/working_with_javascript_in_rails.html#unobtrusive-javascript"
        ActiveSupport::Deprecation.warn message

        onclick = "#{"#{html_options[:onclick]}; " if html_options[:onclick]}#{function}; return false;"
        href = html_options[:href] || '#'

        content_tag(:a, name, html_options.merge(:href => href, :onclick => onclick))
      end

2Notes

error in block code example

freegenie · Jul 2, 20087 thanks

I guess there's an error in this part of the code:

link_to_function("Show me more", nil, :id => "more_link") do |page| page[:details].visual_effect :toggle_blind page[:more_link].replace_html "Show me less" end

It doesn't work. It should be:

link_to_function("Show me more", nil, :id => "more_link") do |page| page[:details].toggle "Blind" page[:more_link].replace_html "Show me less" end

Using Rails 2.1.0

Another solution for visual_effect in code block example in link_to_remote

dovadi · Jul 23, 2008

Update: Code block example in link_to_function not link_to_remote (can't edit subject annymore :( )

This doesn't work:

====

page[:details].visual_effect :toggle_blind

My solution:

====

page.visual_effect :toggle_blind, 'details'

link_to_function

Method deprecated or moved

2Notes

error in block code example

Another solution for visual_effect in code block example in link_to_remote

Related methods