1HTML::FormHandler::ResuUlste(r3)Contributed Perl DocumenHtTaMtLi:o:nFormHandler::Result(3)
2
3
4
6 HTML::FormHandler::Result - form result object
7
9 version 0.40068
10
12 This is the Result object that maps to the Form.
13
14 my $result = $self->form->run( $params );
15 my $result2 = $self->form->run( $other_params );
16
17 my $value = $result->field('title')->value;
18 my $fif = $result->fif;
19 my $field_fid = $result->field('title')->fif;
20
21 DESCRIPTION
22 Although not experimental, the 'results' have not been exercised as
23 much as the other parts of the code. If there is missing functionality
24 or things that don't work, please ask or report bugs.
25
26 The original FormHandler 'process' method, when used with persistent
27 forms, leaves behind state data for a particular execution of
28 'process'. This is not optimal or clean from an architectural point of
29 view. The intention with the 'result' object is to separate dynamic
30 data from static. The 'form' object is treated as a kind of result
31 factory, which will spit out results and leave the form in a consistent
32 state.
33
34 In the current state of implementation, the result object can be used
35 to render a form:
36
37 $result->render;
38
39 However there are still open questions about how much of the form/field
40 should be forwarded to the result. At this point, the number of
41 forwarded methods is minimal. Mechanisms to make this more customizable
42 are being considered.
43
44 Dynamic select lists are not supported yet. Static select lists (that
45 are the same for every form execution) should work fine, but lists that
46 are different depending on some field value will not.
47
48 Most of this object is implemented in HTML::FormHandler::Result::Role,
49 because it is shared with HTML::FormHandler::Field::Result.
50
52 FormHandler Contributors - see HTML::FormHandler
53
55 This software is copyright (c) 2017 by Gerda Shank.
56
57 This is free software; you can redistribute it and/or modify it under
58 the same terms as the Perl 5 programming language system itself.
59
60
61
62perl v5.36.0 2022-07-22 HTML::FormHandler::Result(3)