# Copyright (c) 1999-2010 bivio Software, Inc.  All rights reserved.
#
# Visit http://www.bivio.biz for more info.
# 
# This library is free software; you can redistribute it and/or modify
# it under the terms of the GNU Lesser General Public License as
# published by the Free Software Foundation; either version 2.1 of the
# License, or (at your option) any later version.
# 
# This library 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 GNU
# Lesser General Public License for more details.
# 
# You should have received a copy of the GNU Lesser General Public
# License along with this library;  If not, you may get a copy from:
# http://www.opensource.org/licenses/lgpl-license.html
# 
# $Id: Format.pm,v 2.3 2010/09/08 21:50:43 nagler Exp $
package Bivio::UI::HTML::Format;
use strict;
use Bivio::Base 'UI.WidgetValueSource';

# C<Bivio::UI::HTML::Format> is the superclass of HTML widget value formatters.
# Typically, this class sits first the the L<get_widget_value|"get_widget_value">
# parameter list, e.g.
#
#     value => [HTMLFormat.DateTime => request => 'start_time'];
#
# Formatters transform widget values into something "renderable".  This may
# involve querying user preferences to determine how the user likes to
# see things, e.g. date/time format.

our($VERSION) = sprintf('%d.%02d', q$Revision: 2.3 $ =~ /\d+/g);

sub get_instance {
    my($proto, $class) = @_;
    $class = b_use('HTMLFormat', $class)
	unless ref($class);
    b_die($class, ': not a ', $proto->package_name)
	unless $proto->is_subclass($class);
    return $class;
}

sub result_is_html {
    return 0;
}

1;