[Fwd: [Html-widget] formfu - big changes!]

[Mario Minati]

Am Montag 12 März 2007 12:39 schrieben Sie:
> -------- Original-Nachricht --------
> Betreff: 	[Html-widget] formfu - big changes!
> Datum: 	Tue, 6 Mar 2007 18:34:55 +0000
> Von: 	Carl Franks <fireartist at gmail.com>
> Antwort an: 	html-widget at lists.rawmode.org
> An: 	html-widget list <html-widget at lists.rawmode.org>
>
>
>
> In this mail, I'll just address the past week's changes which will
> require code changes for anyone experimenting with formfu.
>
> Originally, HTML::Widget had a form/element stage, and a result stage(),
> with the html generation muddled within both stages.
> With my first pass at HTML::FormFu, I split it out to 3 stages: a form
> form/element stage, a result stage, and a render stage.
> I've now simplified this, so that there is now only a form/element
> stage and a render stage.
> All "logic", such as generating "for" label attributes, generating
> IDs, etc has been moved from the result to the form/element stage.
> The render stage only massages data structures into html.
> For anyone who wishes to use just [% form %] in their templates, they
> can ignore the render stage completely, as render() is automatically
> called when a form or element is stringified.

I'm one of them ;-)

> This means there is no more $result object.
> You can now just print the $form, rather than having to print
> $form->result.
>
> If there's input, you need to either set the query, then call process():
>    $form->query( $q );
>    $form->process();
>
> or pass process() a query object or hash-ref of input values:
>    $form->process( $q );

Pretty cool, i like that

> The methods which were previously on the $result object, such as
> submitted(), has_errors(), params(), param(), add_error() and add_valid()
> should now be called from the $form object.
>
>    if ( $form->submitted && !$form->has_errors ) {
>        my $input = $form->params
>    }
>
> The only real use for having seperate form and result object that I'm
> aware of, was being able to create multiple result objects from the
> same form.
> To replicate this, you can instead copy the form with $form->clone(),
> which doesn't copy the internal $query object.

Ok. 
I'll keep the id of cloning complete forms in my mind. Let's what it will be 
good for.

> Another big change, is that the syntax for creating elements,
> constraints, etc has been changed to optimise forms defined in a
> config file, over those created in perl code.

Once you start defining forms with yaml you get adicted to it, right?

> The arguments varients for element() are:
>    elements( 'type' );
>    # or
>    elements( \%options );
>    # or
>    elements( \@arrayref_of_the_above );
>
> An example in yaml is:
>
> ---
> elements:
>  - type: text
>    name: search
>  - type: submit
>    name: submit
>    label: Google Search
>  - type: submit
>    name: lucky
>    label: I'm Feeling Lucky

That is much easier to write now. Thank you.

> You might notice in the above, it was 'text' and not 'Text'.
> I've lowercased all the element filenames.
> My reasoning is, that it was giving too high a visual cue to the
> element type, which isn't really the most important thing - generally
> the name is.
> I think in the yaml example above, the leading dash for each list item
> provides enough of a cue/divider between each element.
> Now, I'm not a 100% on this change, so I'm open to discussion, but I
> think it's generally for the best.

Why don't you put in a 'lc' or 'ucfirst' so everyone can decide himself howto 
write the elements?

> The syntax for creating constraints, filters, etc has also changed. It is
> now: constraints( 'type' );
>    # or
>    constraints( \%options );
>    # or
>    constraints( @arrayref_of_the_above );
>
> To expand the above yaml with some constraints and filters, might look
> something like this:
>
> ---
> elements:
>  - type: text
>    name: search
>    constraints:
>      - Required
>      - ASCII
>      - type: Length
>        max: 100
>    filters: [TrimEdges]
>  - type: submit
>    name: submit
>    label: Google Search
>  - type: submit
>    name: lucky
>    label: I'm Feeling Lucky

Yeah, I'm feeling realy lucky ;-)

> The modules Catalyst::Controller::HTML::FormFu, DBIx::Class::FormFu
> and HTML::FormFu::Dojo have been updated to take all these changes
> into account.

I'll incorporate the current version in my project tomorrow.

Greets,
Mario