Upgrade to 4.2.8
[usit-rt.git] / share / html / Widgets / Form / String
1 %# BEGIN BPS TAGGED BLOCK {{{
2 %#
3 %# COPYRIGHT:
4 %#
5 %# This software is Copyright (c) 1996-2014 Best Practical Solutions, LLC
6 %#                                          <sales@bestpractical.com>
7 %#
8 %# (Except where explicitly superseded by other copyright notices)
9 %#
10 %#
11 %# LICENSE:
12 %#
13 %# This work is made available to you under the terms of Version 2 of
14 %# the GNU General Public License. A copy of that license should have
15 %# been provided with this software, but in any event can be snarfed
16 %# from www.gnu.org.
17 %#
18 %# This work is distributed in the hope that it will be useful, but
19 %# WITHOUT ANY WARRANTY; without even the implied warranty of
20 %# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
21 %# General Public License for more details.
22 %#
23 %# You should have received a copy of the GNU General Public License
24 %# along with this program; if not, write to the Free Software
25 %# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
26 %# 02110-1301 or visit their web page on the internet at
27 %# http://www.gnu.org/licenses/old-licenses/gpl-2.0.html.
28 %#
29 %#
30 %# CONTRIBUTION SUBMISSION POLICY:
31 %#
32 %# (The following paragraph is not intended to limit the rights granted
33 %# to you to modify and distribute this software under the terms of
34 %# the GNU General Public License and is only of importance to you if
35 %# you choose to contribute your changes and enhancements to the
36 %# community by submitting them to Best Practical Solutions, LLC.)
37 %#
38 %# By intentionally submitting any modifications, corrections or
39 %# derivatives to this work, or any other work intended for use with
40 %# Request Tracker, to Best Practical Solutions, LLC, you confirm that
41 %# you are the copyright holder for those contributions and you grant
42 %# Best Practical Solutions,  LLC a nonexclusive, worldwide, irrevocable,
43 %# royalty-free, perpetual, license to use, copy, create derivative
44 %# works based on those contributions, and sublicense and distribute
45 %# those contributions and any derivatives thereof.
46 %#
47 %# END BPS TAGGED BLOCK }}}
48 <%DOC>
49 see docs/extending/using_forms_widgets.pod
50 </%DOC>
51 <div id="form-box-<% lc $Name %>" class="widget">
52 <span class="description label"><% $Description %></span>
53 <span class="value"><& SELF:InputOnly, %ARGS &></span>
54 % if ( $Default ) {
55 <span class="comment"><% $DefaultLabel %></span>
56 % }
57 <span class="hints"><% $Hints %></span>
58 </div>
59 <%ARGS>
60 $Name
61
62 $Description  => undef,
63 $Hints        => ''
64
65 $CurrentValue => '',
66
67 $Default        => 0,
68 $DefaultValue   => '',
69 $DefaultLabel   => loc( 'Default: [_1]', $DefaultValue ),
70 </%ARGS>
71
72 <%METHOD InputOnly>
73 <input type="<% $Type %>" name="<% $Name %>" value="<% $CurrentValue || '' %>" />\
74 <%ARGS>
75 $Name
76 $CurrentValue => '',
77 $Type => 'text'
78 </%ARGS>
79 </%METHOD>
80
81 <%METHOD Process>
82 <%ARGS>
83 $Name
84
85 $Arguments    => {},
86
87 $Default      => 0,
88 $DefaultValue => '',
89 </%ARGS>
90 <%INIT>
91 my $value = $Arguments->{ $Name };
92 $value = '' unless defined $value;
93
94 # canonicalize: delete leading and trailing spaces, replaces newlines
95 # with one space and then replace all continuouse spaces with one ' '
96 # (including tabs and other fancy things)
97 $value =~ s/^\s+//;
98 $value =~ s/\s+$//;
99 $value =~ s/\r*\n/ /g;
100 $value =~ s/\s+$/ /g;
101
102 if ( $value eq '' ) {
103     return $DefaultValue unless $Default;
104     return undef;
105 }
106 return $value;
107 </%INIT>
108 </%METHOD>