At 20:04 02/16/01, Raphaël Luta wrote:
>>I updated the java docs in the proposals directory so that everybody can 
>>have a look at them. They are more detailed, but I hope that this mail 
>>did also make the idea clear.
>>I still owe you a proposal that defines which rules document fragments 
>>will have to comply to in order to by a "well-defined fragments". Didn't 
>>get to it yet, but it'll follow.
>
>I'm mostly interested in the WML fragments you'd like to propose because 
>it's a really tough
>issue...

Ok, here is a try:

* Use standard WML.  The official WML specification is available on the 
www.wapforum.org.

* Watch out for unterminated and extraneous tags.  The behavior of pages 
with improperly terminated tags is undefined.

* Use only elements that can be included into a card (probably together 
with other portlets/elements). Do not create separate cards.

* Make no assumptions on whether the portlet will be displayed alone or 
together with other other portlets.

* Do not use templates.

* Do not try to set the card title.

* Avoid lengthy, complex WML.  The buffer length can be restricted by the 
user agent Portlets may share a page with others.

* Avoid using images too often. When using images, define a meaningful alt 
name ( this is necessary for the devices that don't support images or if 
the image can't be fetched). Define localsrc if possible.

* Do not use intrinsic events. These events (oneventforward, 
oneventbackward, etc.) should be only added by the aggregation level.

* Avoid using timers.

* Use user-tiggered events only if necessary. For user-triggered events 
always define label and name parameters explicitely. Prefix the name with 
the portlet unique id, otherwise conflict between diffent portlets on one 
page is possible. Use meaningful names for labels.

* Do not create fixed-width WML tables or images in portlets.

* Avoid long, unbroken lines of unwrap text. This helps avoiding 
unnecessary scrolling.




--
--------------------------------------------------------------
To subscribe:        [EMAIL PROTECTED]
To unsubscribe:      [EMAIL PROTECTED]
Search: <http://www.mail-archive.com/[email protected]/>
List Help?:          [EMAIL PROTECTED]

Reply via email to