package WebGUI::Form::TimeField; =head1 LEGAL ------------------------------------------------------------------- WebGUI is Copyright 2001-2009 Plain Black Corporation. ------------------------------------------------------------------- Please read the legal notices (docs/legal.txt) and the license (docs/license.txt) that came with this distribution before using this software. ------------------------------------------------------------------- http://www.plainblack.com info@plainblack.com ------------------------------------------------------------------- =cut use strict; use base 'WebGUI::Form::Text'; use WebGUI::Form::Button; use WebGUI::Form::Hidden; use WebGUI::International; =head1 NAME Package WebGUI::Form::TimeField =head1 DESCRIPTION Creates a time form field. If the default value is a MySQL time, the value returned by this form element will be a MySQL time. Note: Will not be adjusted for the user's time zone. Otherwise, the value returned by this form element will be a number of seconds, adjusted for the user's time zone.. =head1 SEE ALSO This is a subclass of WebGUI::Form::Text. =head1 METHODS The following methods are specifically available from this class. Check the superclass for additional methods. =cut #------------------------------------------------------------------- =head2 definition ( [ additionalTerms ] ) See the superclass for additional details. =head3 additionalTerms The following additional parameters have been added via this sub class. =head4 defaultValue Either a number of seconds or a MySQL time. =head4 maxlength Defaults to 8. Determines the maximum number of characters allowed in this field. =head4 size Default to 8. Determines how many characters wide the field wlll be. =cut sub definition { my $class = shift; my $session = shift; my $definition = shift || []; push(@{$definition}, { maxlength=>{ defaultValue=>8 }, size=>{ defaultValue=>8 }, format => { defaultValue => undef, }, }); return $class->SUPER::definition($session, $definition); } #------------------------------------------------------------------- =head2 getDatabaseFieldType ( ) Returns "BIGINT". =cut sub getDatabaseFieldType { return "BIGINT"; } #------------------------------------------------------------------- =head2 getName ( session ) Returns the human readable name of this control. =cut sub getName { my ($self, $session) = @_; return WebGUI::International->new($session, 'WebGUI')->get('971'); } #------------------------------------------------------------------- =head2 getValue ( [ value ] ) If the defaultValue is a MySQL time, or the format property = 'mysql', the value returned by this form element will be a MySQL time. Note: Will not be adjusted for the user's time zone. Otherwise, the value returned by this form element will be a number of seconds. =head3 value An optional value to process, instead of POST input. This should be in the form of an integer of seconds, 'HH:MM', or 'HH:MM:SS'. =cut my $mysqlFormattedDate = qr/^\d{2}\D\d{2}(?:\D\d{2})?$/; sub getValue { my $self = shift; my $value = $self->SUPER::getValue(@_); my $mysqlMode = $self->get('format') eq 'mysql' || $self->getDefaultValue =~ $mysqlFormattedDate; my $mysqlDate = ($value =~ $mysqlFormattedDate); my $digits = ($value =~ /^\d+/); ##Format is fine if ( ( $mysqlMode && $mysqlDate) ||(!$mysqlMode && !$mysqlDate) && $digits) { return $value; } ##Convert to mysql format elsif ($mysqlMode && $digits) { return $self->session->datetime->secondsToTime($value); } ##Convert to seconds. elsif ($mysqlDate) { return $self->session->datetime->timeToSeconds($value); } else { ##Bad stuff, maynard return undef; } } #------------------------------------------------------------------- =head2 getValueAsHtml ( ) Return the Form's value as a formatted time. =cut sub getValueAsHtml { my $self = shift; my $value = $self->getOriginalValue(); my $mysqlTime = ($value =~ $mysqlFormattedDate); my $digits = ($value =~ /^\d+$/); ##Format is fine if ( $mysqlTime ) { return $value; } ##Convert to mysql format elsif ($digits) { return $self->session->datetime->secondsToTime($value); } else { ##Bad stuff, maynard return undef; } } #------------------------------------------------------------------- =head2 headTags ( ) Set the head tags for this form plugin =cut sub headTags { my $self = shift; my $style = $self->session->style; my $url = $self->session->url; $style->setScript($url->extras('inputCheck.js'), { type => 'text/javascript' }); $style->setScript($url->extras('yui/build/connection/connection-min.js'), { type => 'text/javascript'}); $style->setScript($url->extras('yui/build/event/event-min.js'), { type => 'text/javascript' }); $style->setScript($url->extras('yui/build/json/json-min.js'), { type => 'text/javascript' }); $style->setScript($url->extras('yui-webgui/build/i18n/i18n.js' ), { type => 'text/javascript' }); $style->setScript($url->extras('form/timefield.js'), { type => 'text/javascript' }); } #------------------------------------------------------------------- =head2 isDynamicCompatible ( ) A class method that returns a boolean indicating whether this control is compatible with the DynamicField control. =cut sub isDynamicCompatible { return 1; } #------------------------------------------------------------------- =head2 toHtml ( ) Renders a time field. =cut sub toHtml { my $self = shift; ##JS expects formatted time $self->set('value', $self->getValueAsHtml); #my $i18n = WebGUI::International->new($self->session); $self->set("extras", $self->get('extras') . ' onblur="WebGUI.TimeField.munge(document.getElementById(\''.$self->get("id").'\'))" onkeyup="WebGUI.TimeField.check(document.getElementById(\''.$self->get("id").'\'));"'); return $self->SUPER::toHtml; } #------------------------------------------------------------------- =head2 toHtmlAsHidden ( ) Renders the field as a hidden field. =cut sub toHtmlAsHidden { my $self = shift; my $value = $self->getOriginalValue; return WebGUI::Form::Hidden->new($self->session, name=>$self->get("name"), value=>$value )->toHtmlAsHidden; } 1;