SL/Presenter/Part.pm

   1 package SL::Presenter::Part;
   2
   3 use strict;
   4
   5 use SL::DB::Part;
   6
   7 use Exporter qw(import);
   8 our @EXPORT = qw(part_picker);
   9
  10 sub part_picker {
  11   my ($self, $name, $value, %params) = @_;
  12   my $name_e    = $self->escape($name);
  13
  14   $value = SL::DB::Manager::Part->find_by(id => $value) if !ref $value;
  15
  16   my $ret =
  17     $self->input_tag($name, (ref $value && $value->can('id') ? $value->id : ''), class => 'part_autocomplete', type => 'hidden') .
  18     $self->input_tag("", delete $params{type}, id => $self->name_to_id("$name_e\_type"), type => 'hidden') .
  19     $self->input_tag("", (ref $value && $value->can('description')) ? $value->description : '', id => $self->name_to_id("$name_e\_name"), %params) .
  20     $self->input_tag("", delete $params{column}, id => $self->name_to_id("$name_e\_column"), type => 'hidden');
  21
  22   $self->html_tag('span', $ret, class => 'part_picker');
  23 }
  24
  25 1;
  26
  27 __END__
  28
  29 =encoding utf-8
  30
  31 =head1 NAME
  32
  33 SL::Presenter::Part - Part lelated presenter stuff
  34
  35 =head1 SYNOPSIS
  36
  37 see L<SL::Presenter>
  38
  39 =head1 DESCRIPTION
  40
  41 see L<SL::Presenter>
  42
  43 =head1 FUNCTIONS
  44
  45 =over 4
  46
  47 =item C<part_picker NAME, VALUE, PARAMS>
  48
  49 All-in-one picker widget for parts. The name will be both id and name of the
  50 resulting hidden C<id> input field. An additional dummy input will be generated
  51 which is used to find parts. For a detailed description of it's behaviour, see
  52 section C<PART PICKER SPECIFICATION>.
  53
  54 C<VALUE> can be an id or C<Rose::DB:Object> instance.
  55
  56 If C<PARAMS> contains C<type> only parts of this type will be used for
  57 autocompletion. You may comma separate multiple types as in C<part,assembly>.
  58
  59 Obsolete parts will by default not displayed for selection. However they are
  60 accepted as default values and can persist during updates. As with other
  61 selectors though, they are not selectable once overridden.
  62
  63 Currently you must include C<js/autocomplete_part.js> in your controller, the
  64 presenter can not do this from the template.
  65
  66 =back
  67
  68 =head1 BUGS
  69
  70 =over 4
  71
  72 =item *
  73
  74 Picker icons aren't displayed with css menu, because the spritemap is not loaded.
  75
  76 =back
  77
  78 =head1 AUTHOR
  79
  80 Sven Schöling E<lt>s.schoeling@linet-services.deE<gt>
  81
  82 =cut