NAME
Catalyst::Controller::AutoAssets::Handler::ImageSet - ImageSet type handler
SYNOPSIS
In your controller:
package MyApp::Controller::Assets::MyImages;
use parent 'Catalyst::Controller::AutoAssets';
1;
Then, in your .conf:
<Controller::Assets::MyImages>
include root/images/
type ImageSet
flatten_paths 1
include_regex '\.(png|jpg|gif)$'
</Controller::Assets::MyImages>
And in your .tt files:
[% c.controller('Assets::MyImages').img_tag('foo.png') %]
<img src="[% c.controller('Assets::MyImages').asset_path('apple.jpg') %]">
Or, in static HTML:
<img src="/assets/myimages/current/apple.jpg">
DESCRIPTION
Like the 'Directory' asset type but with some extra options, defaults and functionality specific to images.
This class extends Catalyst::Controller::AutoAssets::Handler::Directory. Only differences are shown below.
CONFIG PARAMS
include_regex
Optional regex ($string) to require files to match to be included.
Defaults to '\.(png|jpg|jpeg|gif|bmp|tif|tiff|svg)$'
regex_ignore_case
Whether or not to use case-insensitive regex (qr/$regex/i
vs qr/$regex/
) when evaluating include_regex/exclude_regex.
Defaults to true (1).
flatten_paths
Whether or not to convert paths to filenames (i.e. 'path/to/apple.jpg'
becomes 'apple.jpg'
) for shorter and easier names. Duplicate filenames ignored (only the first will be used) with a warning in the log.
Defaults to false (0).
METHODS
img_tag
Convenience method to return an HTML img tag for the supplied image/path.
img_tag_title
Convenience method to return an HTML img tag for the supplied image/path with the 'title' attribute (i.e. for mouse-over) set to the path.
dump_all_img_tags
Dumps img tags for every image in the asset
SEE ALSO
- Catalyst::Controller::AutoAssets
- Catalyst::Controller::AutoAssets::Handler
- Catalyst::Controller::AutoAssets::Handler::Directory
- Catalyst::Controller::AutoAssets::Handler::IconSet
AUTHOR
Henry Van Styn <vanstyn@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2013 by IntelliTree Solutions llc.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.