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