File: README

package info (click to toggle)
libtemplate-plugin-cycle-perl 1.06-1
  • links: PTS
  • area: main
  • in suites: buster, jessie, jessie-kfreebsd, sid, stretch, wheezy
  • size: 156 kB
  • ctags: 96
  • sloc: perl: 1,103; makefile: 2
file content (179 lines) | stat: -rw-r--r-- 5,645 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
NAME
    Template::Plugin::Cycle - Cyclically insert into a Template from a
    sequence of values

SYNOPSIS
      [% USE cycle('row', 'altrow') %]
  
      <table border="1">
        <tr class="[% class %]">
          <td>First row</td>
        </tr>
        <tr class="[% class %]">
          <td>Second row</td>
        </tr>
        <tr class="[% class %]">
          <td>Third row</td>
        </tr>
      </table>
  
      ###################################################################
      # Alternatively, you might want to make it available to all templates
      # throughout an entire application.
  
      use Template::Plugin::Cycle;
  
      # Create a Cycle object and set some values
      my $Cycle = Template::Plugin::Cycle->new;
      $Cycle->init('normalrow', 'alternaterow');
  
      # Bind the Cycle object into the Template
      $Template->process( 'tablepage.html', class => $Cycle );
  
      #######################################################
      # Later that night in a Template
  
      <table border="1">
        <tr class="[% class %]">
          <td>First row</td>
        </tr>
        <tr class="[% class %]">
          <td>Second row</td>
        </tr>
        <tr class="[% class %]">
          <td>Third row</td>
        </tr>
      </table>
  
      [% class.reset %]
      <table border="1">
        <tr class="[% class %]">
          <td>Another first row</td>
        </tr>
      </table>
  
      #######################################################
      # Which of course produces
  
      <table border="1">
        <tr class="normalrow">
          <td>First row</td>
        </tr>
        <tr class="alternaterow">
          <td>Second row</td>
        </tr>
        <tr class="normalrow">
          <td>Third row</td>
        </tr>
      </table>
  
      <table border="1">
        <tr class="normalrow">
          <td>Another first row</td>
        </tr>
      </table>

DESCRIPTION
    Sometimes, apparently almost exclusively when doing alternating table
    row backgrounds, you need to print an alternating, cycling, set of
    values into a template.

    Template::Plugin::Cycle is a small, simple, and hopefully DWIM solution
    to these sorts of tasks.

    It can be used either as a normal Template::Plugin, or can be created
    directly and passed in as a template argument, so that you can set up
    situations where it is implicitly available in every page.

METHODS
  new [ $Context ] [, @list ]
    The "new" constructor creates and returns a new
    "Template::Plugin::Cycle" object. It can be optionally passed an initial
    set of values to cycle through.

    When called from within a Template, the new constructor will be passed
    the current Template::Context as the first argument. This will be
    ignored.

    By doing this, you can use it both directly, AND from inside a Template.

  init @list
    If you need to set the values for a new empty object, of change the
    values to cycle through for an existing object, they can be passed to
    the "init" method.

    The method always returns the '' null string, to avoid inserting
    anything into the template.

  elements
    The "elements" method returns the number of items currently set for the
    "Template::Plugin::Cycle" object.

  list
    The "list" method returns the current list of values for the
    "Template::Plugin::Cycle" object.

    This is also the prefered method for getting access to a value at a
    particular position within the list of items being cycled to.

      [%# Access a variety of things from the list %]
      The first item in the Cycle object is [% cycle.list.first %].
      The second item in the Cycle object is [% cycle.list.[1] %].
      The last item in the Cycle object is [% cycle.list.last %].

  next
    The "next" method returns the next value from the Cycle. If the end of
    the list of valuese is reached, it will "cycle" back the first object
    again.

    This method is also the one called when the object is stringified. That
    is, when it appears on its own in a template. Thus, you can do something
    like the following.

      <!-- An example of alternate row classes in a table-->
      <table border="1">
        <!-- Explicitly access the next class in the cycle -->
        <tr class="[% rowclass.next %]">
          <td>First row</td>
        </tr>
        <!-- This has the same effect -->
        <tr class="[% rowclass %]">
          <td>Second row</td>
        </tr>
      </table>

  value
    The "value" method is an analogy for the "next" method.

  reset
    If a single "Template::Plugin::Cycle" object is to be used it multiple
    places within a template, and it is important that the same value be
    first every time, then the "reset" method can be used.

    The "reset" method resets the Cycle, so that the next value returned
    will be the first value in the Cycle object.

SUPPORT
    Bugs should be submitted via the CPAN bug tracker, located at

    <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Template-Plugin-Cycle>

    For other issues, or commercial enhancement or support, contact the
    author..

AUTHOR
    Adam Kennedy <adamk@cpan.org>

    Thank you to Phase N Australia (<http://phase-n.com/>) for permitting
    the open sourcing and release of this distribution as a spin-off from a
    commercial project.

COPYRIGHT
    Copyright 2004 - 2008 Adam Kennedy.

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

    The full text of the license can be found in the LICENSE file included
    with this module.