tapestry-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Robert Zeigler (JIRA)" <j...@apache.org>
Subject [jira] Commented: (TAP5-737) Parameter "translate" of TextField is specified as required, but it's realy not required
Date Thu, 04 Jun 2009 14:21:07 GMT

    [ https://issues.apache.org/jira/browse/TAP5-737?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12716290#action_12716290

Robert Zeigler commented on TAP5-737:

Documentation for translate parameter:

"The object which will perform translation between server-side and client-side representations.
If not specified, a value will usually be generated based on the type of the value parameter."

Note: the "providing a default" behavior is already documented.

Documentation for the value parameter of form fields:

"The value to be read and updated. This is not necessarily a string, a translator may be provided
to convert between client side and server side representations. If not bound, a default binding
is made to a property of the container matching the component's id. If no such property exists,
then you will see a runtime exception due to the unbound value parameter. "

Note: the "providing a default" behavior is already documented.

Checking BeanDisplay, the "providing a default" behavior is documented for "object" (which
is required) and "model" (which isn't required).

Likewise for BeanEditor and BeanEditForm.

So, the documentation is already clear about required parameters for which defaults are provided,
and what those defaults are.

> Parameter "translate" of TextField is specified as required, but it's realy not required
> ----------------------------------------------------------------------------------------
>                 Key: TAP5-737
>                 URL: https://issues.apache.org/jira/browse/TAP5-737
>             Project: Tapestry 5
>          Issue Type: Bug
>          Components: tapestry-core
>    Affects Versions:
>            Reporter: Lukasz Jazgar
>            Priority: Minor
> Components TextField, TextArea and PasswordField have parameter "translate", which is
specified by annotation and in documentation as required.
> This parameter should not be required and it isn't really. 
> Even in examples of using TextField parameter "translate" is not used (http://tapestry.apache.org/tapestry5.1/tapestry-core/ref/org/apache/tapestry5/corelib/components/TextField.html).
> Specification in documentation, specification in annotations,  examples and real behaviour
should be consistent.

This message is automatically generated by JIRA.
You can reply to this email to add a comment to the issue online.

View raw message