module Padrino::Helpers::AssetTagHelpers

Helpers related to producing assets (images, stylesheets, js, etc) within templates.

Constants

ABSOLUTE_URL_PATTERN
APPEND_ASSET_EXTENSIONS
ASSET_FOLDERS

Public Instance Methods

asset_path(kind, source = nil) click to toggle source

Returns the path to the specified asset (css or javascript).

@param [String] kind

The kind of asset (i.e :images, :js, :css).

@param [String] source

The path to the asset (relative or absolute).

@return [String] Path for the asset given the kind and source.

@example

# Generates: /javascripts/application.js?1269008689
asset_path :js, :application

# Generates: /stylesheets/application.css?1269008689
asset_path :css, :application

# Generates: /images/example.jpg?1269008689
asset_path :images, 'example.jpg'

# Generates: /uploads/file.ext?1269008689
asset_path 'uploads/file.ext'
# File lib/padrino-helpers/asset_tag_helpers.rb, line 316
def asset_path(kind, source = nil)
  kind, source = source, kind if source.nil?
  source = asset_normalize_extension(kind, escape_link(source.to_s))
  return source if source =~ ABSOLUTE_URL_PATTERN || source =~ /^\//
  source = File.join(asset_folder_name(kind), source)
  timestamp = asset_timestamp(source)
  result_path = uri_root_path(source)
  "#{result_path}#{timestamp}"
end
favicon_tag(source, options={}) click to toggle source

Generates a favicon link. Looks inside images folder

@param [String] source

The source image path for the favicon link tag.

@param [Hash] options

The html options for the favicon link tag.

@return [String] The favicon link html tag with specified options.

@example

favicon_tag 'favicon.png'
favicon_tag 'icons/favicon.png'
# or override some options
favicon_tag 'favicon.png', :type => 'image/ico'
# File lib/padrino-helpers/asset_tag_helpers.rb, line 191
def favicon_tag(source, options={})
  type = File.extname(source).sub('.','')
  options = { :href => image_path(source), :rel => 'icon', :type => "image/#{type}" }.update(options)
  tag(:link, options)
end
feed_tag(mime, url, options={}) click to toggle source

Creates a link tag that browsers and news readers can use to auto-detect an RSS or ATOM feed.

@param [Symbol] mime

The mime type of the feed (i.e :atom or :rss).

@param [String] url

The url for the feed tag to reference.

@param options

The options for the feed tag.

@option options [String] :rel (“alternate”)

Specify the relation of this link.

@option options [String] :type

Override the auto-generated mime type.

@option options [String] :title

Specify the title of the link, defaults to the type.

@return [String] Feed link html tag with specified options.

@example

feed_tag :atom, url(:blog, :posts, :format => :atom), :title => "ATOM"
# Generates: <link type="application/atom+xml" rel="alternate" href="/blog/posts.atom" title="ATOM" />
feed_tag :rss, url(:blog, :posts, :format => :rss)
# Generates: <link type="application/rss+xml" rel="alternate" href="/blog/posts.rss" title="rss" />
# File lib/padrino-helpers/asset_tag_helpers.rb, line 117
def feed_tag(mime, url, options={})
  full_mime = (mime == :atom) ? 'application/atom+xml' : 'application/rss+xml'
  tag(:link, { :rel => 'alternate', :type => full_mime, :title => mime, :href => url }.update(options))
end
flash_tag(*args) click to toggle source

Creates a div to display the flash of given type if it exists.

@param [Symbol] kind

The type of flash to display in the tag.

@param [Hash] options

The html options for this section.
use :bootstrap => true to support Twitter's bootstrap dismiss alert button.

@return [String] Flash tag html with specified options.

@example

flash_tag(:notice, :id => 'flash-notice')
# Generates: <div class="notice" id="flash-notice">flash-notice</div>
flash_tag(:error, :success)
# Generates: <div class="error">flash-error</div>
# <div class="success">flash-success</div>
# File lib/padrino-helpers/asset_tag_helpers.rb, line 32
def flash_tag(*args)
  options = args.last.is_a?(Hash) ? args.pop : {}
  bootstrap = options.delete(:bootstrap) if options[:bootstrap]
  args.inject(SafeBuffer.new) do |html,kind|
    next html unless flash[kind]
    flash_text = SafeBuffer.new << flash[kind]
    flash_text << content_tag(:button, '&times;'.html_safe, {:type => :button, :class => :close, :'data-dismiss' => :alert}) if bootstrap
    html << content_tag(:div, flash_text, { :class => kind }.update(options))
  end
end
image_alt(src) click to toggle source

Returns a string suitable for an alt attribute of img element.

@param [String] src

The source path for the image tag.

@return [String] The alt attribute value.

# File lib/padrino-helpers/asset_tag_helpers.rb, line 223
def image_alt(src)
  File.basename(src, '.*').sub(/-[[:xdigit:]]{32,64}\z/, '').tr('-_', ' ').capitalize
end
image_path(src) click to toggle source

Returns the path to the image, either relative or absolute. We search it in your appname.public_folder like app/public/images for inclusion. You can provide also a full path.

@param [String] src

The path to the image file (relative or absolute).

@return [String] Path to an image given the kind and source.

@example

# Generates: /images/foo.jpg?1269008689
image_path("foo.jpg")

@api public

# File lib/padrino-helpers/asset_tag_helpers.rb, line 289
def image_path(src)
  asset_path(:images, src)
end
image_tag(url, options={}) click to toggle source

Creates an image element with given url and options.

@param [String] url

The source path for the image tag.

@param [Hash] options

The html options for the image tag.

@return [String] Image html tag with url and specified options.

@example

image_tag('icons/avatar.png')
# File lib/padrino-helpers/asset_tag_helpers.rb, line 210
def image_tag(url, options={})
  options = { :src => image_path(url) }.update(options)
  options[:alt] ||= image_alt(url) unless url.to_s =~ /\A(?:cid|data):|\A\Z/
  tag(:img, options)
end
javascript_include_tag(*sources) click to toggle source

Returns a html script tag for each of the sources provided. You can pass in the filename without extension or a symbol and we search it in your appname.public_folder like app/public/javascript for inclusion. You can provide also a full path.

@overload #javascript_include_tag(*sources, options={})

@param [Array<String>] sources   Splat of js source paths
@param [Hash]          options   The html options for the script tag

@return [String] Script tag for sources with specified options.

@example

javascript_include_tag 'application', :extjs
# File lib/padrino-helpers/asset_tag_helpers.rb, line 266
def javascript_include_tag(*sources)
  options = {
    :type => 'text/javascript'
  }.update(sources.last.is_a?(Hash) ? Utils.symbolize_keys(sources.pop) : {})
  sources.flatten.inject(SafeBuffer.new) do |all,source|
    all << content_tag(:script, nil, { :src => asset_path(:js, source) }.update(options))
  end
end
mail_to(email, caption=nil, mail_options={}) click to toggle source

Creates a mail link element with given name and caption.

@param [String] email

The email address for the link.

@param [String] caption

The caption for the link.

@param [Hash] mail_options

The options for the mail link. Accepts html options.

@option mail_options [String] cc The cc recipients. @option mail_options [String] bcc The bcc recipients. @option mail_options [String] subject The subject line. @option mail_options [String] body The email body.

@return [String] Mail link html tag with specified options.

@example

mail_to "me@demo.com"
# Generates: <a href="mailto:me@demo.com">me@demo.com</a>

mail_to "me@demo.com", "My Email"
# Generates: <a href="mailto:me@demo.com">My Email</a>
# File lib/padrino-helpers/asset_tag_helpers.rb, line 145
def mail_to(email, caption=nil, mail_options={})
  mail_options, html_options = mail_options.partition{ |key,_| [:cc, :bcc, :subject, :body].include?(key) }
  mail_query = Rack::Utils.build_query(Hash[mail_options]).gsub(/\+/, '%20').gsub('%40', '@')
  mail_href = "mailto:#{email}"
  mail_href << "?#{mail_query}" unless mail_query.empty?
  link_to((caption || email), mail_href, Hash[html_options])
end
meta_tag(content, options={}) click to toggle source

Creates a meta element with the content and given options.

@param [String] content

The content for the meta tag.

@param [Hash] options

The html options for the meta tag.

@return [String] Meta html tag with specified options.

@example

meta_tag "weblog,news", :name => "keywords"
# Generates: <meta name="keywords" content="weblog,news" />

meta_tag "text/html; charset=UTF-8", 'http-equiv' => "Content-Type"
# Generates: <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
# File lib/padrino-helpers/asset_tag_helpers.rb, line 170
def meta_tag(content, options={})
  options = { "content" => content }.update(options)
  tag(:meta, options)
end