NAME

DSL::HTML::STL - Standard Template Library for DSL::HTML.

DESCRIPTION

Templates. See DSL::HTML.

WORK IN PROGRESS

This library is still under development, currently it is minimal at best.

SYNOPSYS

    use DSL::HTML;
    use DSL::HTML::STL qw/ul .../;

    # Create a short HTML doc
    my $html = build_template ul => qw(foo bar baz);

    # Define a template that uses the ul template
    template mydoc {
        my @items = @_;
        ...
        tag h1 { "the list:" }
        include ul => @items;
        ...
    }

    # Create an HTML doc using the 'mydoc' template
    my $html = build_template mydoc => qw(foo bar baz);

TEMPLATES

LISTS

All of these create lists of the specified type. All can take 4 types of arguments, the first of any given type is the only one used, the rest are ignored.

If a scalar is provided, it is treated as the class attribute.

If an arrayref is provided it is treated as the items to be listed (or to be used in the <dt> of the <dl>).

If a hashref is provided it is used to find the values for the <dd> in the <dl>. If no arrayref is provided then the keys of the hashref will be used as the list items. In 'ul' and 'dl' the values of the hash are ignored.

If a coderef is provided it is used via sort() to sort the list items by name.

ul
    include ul => [qw/a b c d/];
ol
    include ol => [qw/a b c d/];
dl

All arguments are optional, but without a hashref you have no <dd> values. If you have no hashref and no arrayref then you get an empty list.

    include dl => (
        # Our <dd> values
        { foo => 'a foo', bar => 'a bar', ... },

        # Our <dt> values (other keys in the hashref are ignored)
        [ 'foo', 'bar' ],

        # our 'class' attribute
        'my_class other_class ...'

        # How to sort the values
        sub($$) { $_[0] cmp $_[1] },
    );

AUTHORS

Chad Granum exodist7@gmail.com

COPYRIGHT

Copyright (C) 2013 Chad Granum

DSL-HTML is free software; Standard perl license (GPL and Artistic).

DSL-HTML is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the license for more details.