[jira] Commented: (TAP5-737) Parameter "translate" of TextField is specified as required, but it's realy not required

["Robert Zeigler (JIRA)" <ji...@apache.org>]

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

Robert Zeigler commented on TAP5-737:
-------------------------------------

Translate absolutely is required.  But like many parameters, tapestry can often determine an appropriate value to fill in if the user doesn't provide one.
But if it can't figure out a suitable default, you'll get an exception (because it's required).

The value parameter is likewise required, but if you have a page/component property with the same name as the component id, you don't have to supply the value because tapestry will auto-bind to that property (the one with the same name as the component id).

What /would/ be nice is for the documentation to somehow flag those properties which are required, but tapestry will attempt to provide a default value should the user not supply one. Examples include the "model" parameter of BeanEditor & BeanDisplay, the value parameter of form fields, and the translate parameter of form fields.

> 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: 5.1.0.5
>            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.