Revision 81e4602d
Von Sven Schöling vor etwa 11 Jahren hinzugefügt
| SL/Presenter/Part.pm | ||
|---|---|---|
| 45 | 45 |
All-in-one picker widget for parts. The name will be both id and name of the |
| 46 | 46 |
resulting hidden C<id> input field. An additional dummy input will be generated |
| 47 | 47 |
which is used to find parts. For a detailed description of it's behaviour, see |
| 48 |
section C<PART PICKER SPECIFICATION>.
|
|
| 48 |
section L</PART PICKER SPECIFICATION>.
|
|
| 49 | 49 |
|
| 50 | 50 |
C<VALUE> can be an id or C<Rose::DB:Object> instance. |
| 51 | 51 |
|
| ... | ... | |
| 61 | 61 |
|
| 62 | 62 |
=back |
| 63 | 63 |
|
| 64 |
=head1 PART PICKER SPECIFICATION |
|
| 65 |
|
|
| 66 |
The following list of design goals were applied: |
|
| 67 |
|
|
| 68 |
=over 4 |
|
| 69 |
|
|
| 70 |
=item * |
|
| 71 |
|
|
| 72 |
Parts should not be perceived by the user as distinct inputs of partnumber and |
|
| 73 |
description but as a single object |
|
| 74 |
|
|
| 75 |
=item * |
|
| 76 |
|
|
| 77 |
Easy to use without documentation for novice users |
|
| 78 |
|
|
| 79 |
=item * |
|
| 80 |
|
|
| 81 |
Fast to use with keyboard for experienced users |
|
| 82 |
|
|
| 83 |
=item * |
|
| 84 |
|
|
| 85 |
Possible to use without any keyboard interaction for mouse (or touchscreen) |
|
| 86 |
users |
|
| 87 |
|
|
| 88 |
=item * |
|
| 89 |
|
|
| 90 |
Must not leave the current page in event of ambiguity (cf. current select_item |
|
| 91 |
mechanism) |
|
| 92 |
|
|
| 93 |
=item * |
|
| 94 |
|
|
| 95 |
Should be useable with hand scanners or similar alternative keyboard devices |
|
| 96 |
|
|
| 97 |
=item * |
|
| 98 |
|
|
| 99 |
Should not require a feedback/check loop in the common case |
|
| 100 |
|
|
| 101 |
=item * |
|
| 102 |
|
|
| 103 |
Should not be constraint to exact matches |
|
| 104 |
|
|
| 105 |
=back |
|
| 106 |
|
|
| 107 |
The implementation consists of the following parts which will be referenced later: |
|
| 108 |
|
|
| 109 |
=over 4 |
|
| 110 |
|
|
| 111 |
=item 1 |
|
| 112 |
|
|
| 113 |
A hidden input (id input), used to hold the id of the selected part. The only |
|
| 114 |
input that gets submitted |
|
| 115 |
|
|
| 116 |
=item 2 |
|
| 117 |
|
|
| 118 |
An input (dummy input) containing a description of the currently selected part, |
|
| 119 |
also used by the user to search for parts |
|
| 120 |
|
|
| 121 |
=item 3 |
|
| 122 |
|
|
| 123 |
A jquery.autocomplete mechanism attached to the dummy field |
|
| 124 |
|
|
| 125 |
=item 4 |
|
| 126 |
|
|
| 127 |
A popup layer for both feedback and input of additional data in case of |
|
| 128 |
ambiguity. |
|
| 129 |
|
|
| 130 |
=item 5 |
|
| 131 |
|
|
| 132 |
An internal status of the part picker, indicating wether id input and dummy |
|
| 133 |
input are consistent. After leaving the dummy input the part picker must |
|
| 134 |
place itself in a consistent status. |
|
| 135 |
|
|
| 136 |
=item 6 |
|
| 137 |
|
|
| 138 |
A clickable icon (popup trigger) attached to the dummy input, which triggers the popup layer. |
|
| 139 |
|
|
| 140 |
=back |
|
| 141 |
|
|
| 64 | 142 |
=head1 BUGS |
| 65 | 143 |
|
| 66 | 144 |
=over 4 |
| 67 | 145 |
|
| 68 | 146 |
=item * |
| 69 | 147 |
|
| 70 |
Picker icons aren't displayed with css menu, because the spritemap is not loaded.
|
|
| 148 |
Popup triggers are not displayed with css menu, because the spritemap is not loaded.
|
|
| 71 | 149 |
|
| 72 | 150 |
=back |
| 73 | 151 |
|
Auch abrufbar als: Unified diff
part picker doku