The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Template-Caribou-1.2.2
River stage one • 3 direct dependents • 3 total dependents
1 ++
/ Template::Caribou::Tags::HTML::Extended

NAME

Template::Caribou::Tags::HTML::Extended - custom HTML tags optimized for DWIMery

VERSION

version 1.2.2

SYNOPSIS

    package MyTemplate;

    use Moose;

    use Template::Caribou::Tags::HTML;
    use Template::Caribou::Tags::HTML::Extended;

    with 'Template::Caribou';

    template 'page' => sub {
        html {
            head { 
                css q{
                    color: magenta;
                };
            };
            body {
                markdown q{Ain't Markdown **grand**?};
                
                anchor "http://foo.com" => sub {
                    image 'http://foo.com/bar.jpg', alt => 'Foo logo';
                };
            }

        }
    };

DESCRIPTION

Whereas Template::Caribou::Tags::HTML offers straight function equivalents to their HTML tags, this module provides a more DWIM interface, and shortcut for often used patterns.

doctype $type

    doctype 'html5';
    # <!DOCTYPE html>

Prints the doctype declaration for the given type.

For the moment, only html 5 (or html5) is supported as a type.

favicon $url

Generates a favicon link tag.

    favicon 'my_icon.png';
    # <link rel="shortcut icon" href="my_icon.png" />

submit $value, %attr

    submit 'foo';
    # <input type="submit" value="foo" />

Shortcut for

    input { attr type => submit, value => $value, %attr; }

less $script

Compiles the LESS script into CSS. Requires CSS::LESSp.

javascript $script

    javascript q{ console.log( "Hello there!" ) };
    # <script type="text/javascript">console.log( "Hello there!" )</script>

Shortcut for

    <script type="text/javascript>$script</script>

javascript_include $url

Shortcut for

    <script type="text/javascript" src="http://..."> </script>

css_include $url, %args

    css_include 'public/bootstrap/css/bootstrap.min.css', media => 'screen';
    # <link href="public/bootstrap/css/bootstrap.min.css" rel="stylesheet"
    #       media="screen" />

css $text

Wraps the $text in a style element.

    <style type="text/css">$text</style>

anchor $url, $inner

Shortcut for <a>. $inner can be either a string, or a subref.

    anchor 'http://foo.com' => 'linkie';

is equivalent to

    a {
        attr href => 'http://foo.com';
        'linkie';
    }

image $src, %attr

    image 'kitten.jpg';
    # <img src="kitten.jpg" />

Shortcut for <img>.

markdown $text

Converts the markdown $text into its html equivalent.

Uses Text::MultiMarkdown.

AUTHOR

Yanick Champoux <yanick@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2023 by Yanick Champoux.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.