Mojolicious::Plugin::TUserlContributed PerlMojolicious::Plugin::TagHelpers(3p)



NAME
       Mojolicious::Plugin::TagHelpers - Tag Helpers Plugin

SYNOPSIS
         # Mojolicious
         $self->plugin('tag_helpers');

         # Mojolicious::Lite
         plugin 'tag_helpers';

DESCRIPTION
       Mojolicious::Plugin::TagHelpers is a collection of HTML5 tag helpers
       for Mojolicious.  This is a core plugin, that means it is always
       enabled and its code a good example for learning to build new plugins.

       Most form helpers can automatically pick up previous input values and
       will show them as default.  You can also use "param" to set them
       manually and let necessary attributes always be generated
       automatically.

         <% param country => 'germany' unless param 'country' %>
         <%= radio_button 'country', value => 'germany' %> Germany
         <%= radio_button 'country', value => 'france'  %> France
         <%= radio_button 'country', value => 'uk'      %> UK

HELPERS
   "base_tag"
         <%= base_tag %>

       Generate "base" tag refering to the current base URL.

         <base href="http://localhost/cgi-bin/myapp.pl" />

   "check_box"
         <%= check_box employed => 1 %>
         <%= check_box employed => 1, id => 'foo' %>

       Generate checkbox input element.  Previous input values will
       automatically get picked up and shown as default.

         <input name="employed" type="checkbox" value="1" />
         <input id="foo" name="employed" type="checkbox" value="1" />

   "file_field"
         <%= file_field 'avatar' %>
         <%= file_field 'avatar', id => 'foo' %>

       Generate file input element.

         <input name="avatar" type="file" />
         <input id="foo" name="avatar" type="file" />

   "form_for"
         <%= form_for login => (method => 'post') => begin %>
           <%= text_field 'first_name' %>
           <%= submit_button %>
         <% end %>
         <%= form_for login => {foo => 'bar'} => (method => 'post') => begin %>
           <%= text_field 'first_name' %>
           <%= submit_button %>
         <% end %>
         <%= form_for '/login' => (method => 'post') => begin %>
           <%= text_field 'first_name' %>
           <%= submit_button %>
         <% end %>
         <%= form_for 'http://kraih.com/login' => (method => 'post') => begin %>
           <%= text_field 'first_name' %>
           <%= submit_button %>
         <% end %>

       Generate form for route, path or URL.

         <form action="/path/to/login" method="post">
           <input name="first_name" />
           <input value="Ok" type="submit" />
         </form>
         <form action="/path/to/login/bar" method="post">
           <input name="first_name" />
           <input value="Ok" type="submit" />
         </form>
         <form action="/login" method="post">
           <input name="first_name" />
           <input value="Ok" type="submit" />
         </form>
         <form action="http://kraih.com/login" method="post">
           <input name="first_name" />
           <input value="Ok" type="submit" />
         </form>

   "hidden_field"
         <%= hidden_field foo => 'bar' %>
         <%= hidden_field foo => 'bar', id => 'bar' %>

       Generate hidden input element.

         <input name="foo" type="hidden" value="bar" />
         <input id="bar" name="foo" type="hidden" value="bar" />

   "image"
         <%= image '/images/foo.png' %>
         <%= image '/images/foo.png', alt => 'Foo' %>

       Generate image tag.

         <img src="/images/foo.png" />
         <img alt="Foo" src="/images/foo.png" />

   "input_tag"
         <%= input_tag 'first_name' %>
         <%= input_tag first_name => 'Default name' %>
         <%= input_tag 'employed', type => 'checkbox' %>
         <%= input_tag 'country', type => 'radio', value => 'germany' %>

       Generate form input element.  Previous input values will automatically
       get picked up and shown as default.

         <input name="first_name" />
         <input name="first_name" value="Default name" />
         <input name="employed" type="checkbox" />
         <input name="country" type="radio" value="germany" />

   "javascript"
         <%= javascript '/script.js' %>
         <%= javascript begin %>
           var a = 'b';
         <% end %>

       Generate script tag for "Javascript" asset.

         <script src="/script.js" type="text/javascript" />
         <script type="text/javascript"><![CDATA[
           var a = 'b';
         ]]></script>

   "link_to"
         <%= link_to Home => 'index' %>
         <%= link_to index => begin %>Home<% end %>
         <%= link_to index => {foo => 'bar'} => (class => 'links') => begin %>
           Home
         <% end %>
         <%= link_to '/path/to/file' => begin %>File<% end %>
         <%= link_to 'http://mojolicio.us' => begin %>Mojolicious<% end %>
         <%= link_to url_for->query(foo => $foo) => begin %>Retry<% end %>

       Generate link to route, path or URL, by default the capitalized link
       target will be used as content.

         <a href="/path/to/index">Home</a>
         <a href="/path/to/index">Home</a>
         <a class="links" href="/path/to/index/bar">Home</a>
         <a href="/path/to/file">File</a>
         <a href="http://mojolicio.us">Mojolicious</a>
         <a href="/current/path?foo=something">Retry</a>

   "password_field"
         <%= password_field 'pass' %>
         <%= password_field 'pass', id => 'foo' %>

       Generate password input element.

         <input name="pass" type="password" />
         <input id="foo" name="pass" type="password" />

   "radio_button"
         <%= radio_button country => 'germany' %>
         <%= radio_button country => 'germany', id => 'foo' %>

       Generate radio input element.  Previous input values will automatically
       get picked up and shown as default.

         <input name="country" type="radio" value="germany" />
         <input id="foo" name="country" type="radio" value="germany" />

   "select_field"
         <%= select_field language => [qw/de en/] %>
         <%= select_field language => [qw/de en/], id => 'lang' %>
         <%= select_field country => [[Germany => 'de'], 'en'] %>
         <%= select_field country => [{Europe => [[Germany => 'de'], 'en']}] %>
         <%= select_field country => [[Germany => 'de', class => 'europe'], 'en'] %>

       Generate select, option and optgroup elements.  Previous input values
       will automatically get picked up and shown as default.

         <select name="language">
           <option value="de">de</option>
           <option value="en">en</option>
         </select>
         <select id="lang" name="language">
           <option value="de">de</option>
           <option value="en">en</option>
         </select>
         <select name="country">
           <option value="de">Germany</option>
           <option value="en">en</option>
         </select>
         <select id="lang" name="language">
           <optgroup label="Europe">
             <option value="de">Germany</option>
             <option value="en">en</option>
           </optgroup>
         </select>
         <select name="country">
           <option class="europe" value="de">Germany</option>
           <option value="en">en</option>
         </select>

   "stylesheet"
         <%= stylesheet '/foo.css' %>
         <%= stylesheet begin %>
           body {color: #000}
         <% end %>

       Generate style or link tag for "CSS" asset.

         <link href="/foo.css" media="screen" rel="stylesheet" type="text/css" />
         <style type="text/css"><![CDATA[
           body {color: #000}
         ]]></style>

   "submit_button"
         <%= submit_button %>
         <%= submit_button 'Ok!', id => 'foo' %>

       Generate submit input element.

         <input type="submit" value="Ok" />
         <input id="foo" type="submit" value="Ok!" />

   "tag"
         <%= tag 'div' %>
         <%= tag 'div', id => 'foo' %>
         <%= tag div => begin %>Content<% end %>

       HTML5 tag generator.

         <div />
         <div id="foo" />
         <div>Content</div>

   "text_field"
         <%= text_field 'first_name' %>
         <%= text_field first_name => 'Default name' %>
         <%= text_field first_name => 'Default name', class => 'user' %>

       Generate text input element.  Previous input values will automatically
       get picked up and shown as default.

         <input name="first_name" />
         <input name="first_name" value="Default name" />
         <input class="user" name="first_name" value="Default name" />

   "text_area"
         <%= text_area 'foo' %>
         <%= text_area foo => begin %>
           Default!
         <% end %>

       Generate textarea element.  Previous input values will automatically
       get picked up and shown as default.

         <textarea name="foo"></textarea>
         <textarea name="foo">
           Default!
         </textarea>

METHODS
       Mojolicious::Plugin::TagHelpers inherits all methods from
       Mojolicious::Plugin and implements the following new ones.

   "register"
         $plugin->register;

       Register helpers in Mojolicious application.

SEE ALSO
       Mojolicious, Mojolicious::Guides, <http://mojolicio.us>.



perl v5.12.2                      2011-03-1Mojolicious::Plugin::TagHelpers(3p)
