[Zope3-dev] Re: title/description vs. label/hint

[Garrett Smith]

I see that ZCML support for widgets in forms is implemented (thanks 
Stephan!) making this issue a bit more important to reconcile. I propose 
renaming IWidget 'title' to 'label' and 'description' to 'hint' per the 
proposal -- this would make the ZCML more readable:

E.g.

   <widget
     label="Foo"
     hint="Specify the value for 'foo'."
     ... />

is better than:

   <widget
     title="Foo"
     description="Specify the value for 'foo'."
     ... />


Garrett Smith wrote:
> The proposal
> 
>   http://dev.zope.org/Zope3/CleanupOfSchemaAndWidgets
> 
> calls for 'label' and 'hint' to be added to IWidget as attributes. 
> However, IWidget already uses 'title' and 'description' for these. (The 
> proposal's/my claim that widgets display the field title and description 
> is wrong -- they use the field info by default if not overridden.)
> 
> I prefer the terms 'label' and 'hint' because they more clearly describe 
> the attributes' use. But there's also no point to change them if people 
> are happy.
> 
> Any opinions?
> 
>  -- Garrett
> 
> 
> 
> _______________________________________________
> Zope3-dev mailing list
> Zope3-dev at zope.org
> Unsub: 
> http://mail.zope.org/mailman/options/zope3-dev/zope-zope3-dev%40m.gmane.org
> 
>