rt/share/html/Widgets/Form/String

   1 %# BEGIN BPS TAGGED BLOCK {{{
   2 %#
   3 %# COPYRIGHT:
   4 %#
   5 %# This software is Copyright (c) 1996-2015 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>