OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

wsrp-comment message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Public Comment


Comment from: kramirez@thejavathinktank.org

I'm in the middle of writing a book on Portlets and Portals for Addison Wesley and would like to cover the CSS class styles and am having some issues with some of the classes and I would like to see if you could please provide me with some feedback.

Perhaps it would be better if I gave you my understanding of where these classes would be used and let you know which ones don't make sense to me. Let's go through them one at a time:

1. Links (Anchors) - since no class is provided for this, I'm assuming that portlet-font or portlet-font-dim could be used here. If the developer or designer wishes to provide mouse over, both font classes could be used. One for mouse-out and one for mouse-over. However, the question on most developers minds will be "which one should I used for what".

2. Font - The description for these two classes states that "The font style definitions affect the font attributes only". However, it is difficult to define the other classes using some kind of inheritance on this class. In other words, say we define a class named portlet-font, how would we define portlet-msg-status to use the font specified in portlet-font? The only way that I can think of, would be to have nested div tags. The outer tag uses a class of portlet-font and the inner uses whatever else it needs (like portlet-msg-status). Would this work?

Is this how it was meant to be used?

Can you provide me with two realistic examples where it would make sense to use portlet-font and portlet-font-dim?

3. Messages - I can't think of a real-world example when I would just throw a message (such as the ones used in the spec example) on the current page being viewed by the user. The only thing I can come up with is perhaps providing some kind of message under each input control as the user enters the focus of the control (perhaps explaining what is expected in the input control, e.g. telephone number and format). Another example is when you popup a new window to let the user know what is happening, e.g. "Please wait while those flights are checked...".

Can you provide some realistic examples for:

portlet-msg-status
portlet-msg-info
portlet-msg-error
portlet-msg-alert
portlet-msg-success

4. Sections - This one threw me bit because it seems to be so close to Tables. The only thing I could imagine that you guys meant for their use is the classic example of a news story. A news story has a Headline, a possible subheader, body, and possibly a footer (containing the author's information and background). However, I can't see what purpose the alternate class would serve and I can't see the use for portlet-section-text (this one sounds like it should be the same as portlet-section-body). As for the portlet-section-selected, I could see this being used on a page that offers input selection for copy and paste operations (like a CMS input page). Am I right about my assumptions?

What other purposes would these classes serve?

5. Tables - the only one that wouldn't make sense to me is portlet-table-text. All of the rest make sense. Can you provide me with an explanation for portlet-table-text?

Where would you use it?

6. Forms - This one I want to make sure that I get right. So here's the classes and my thoughts or questions on them:

A. portlet-form-label - this is used for the Text that appears above or to the side of the form, which is used to introduce the form or perhaps name the form, e.g. "Customer Information".

B. portlet-form-input-field - this one is pretty obvious. The is the style for the input field.

C. portlet-form-button - again, pretty obvious. This could be used for the "Submit" or "Clear" buttons.

D. portlet-icon-label - "Text that appears beside a context dependent action icon." This makes no sense to me. Can you explain it in more detail please?

E. portlet-dlg-icon-label - "Text that appears beside a 'standard' icon". There is no such thing as a "standard" icon. Please explain.

F. portlet-form-field-label - I understand that this one is used for the text that appears next to a field. So, if you have an input box to collect someone's last name, the text "Last Name:" would use this class. Is this correct? What is mean by "Text for a separator of fields"? What is a separator of fields?

G. portlet-form-field - Not sure about this one. Is this used for the text that appears next to a radio button or check box? What about the text inside of listboxes or combo boxes? What class style do they use?

7. Menus - again, let's go through each one:

A. portlet-menu - General menu settings. Again, how would you inherit these general settings for use in the other class styles? Would you use nested div or spans (as described above)?

B. portlet-menu-item - this is the text that all non-selected items in the menu appear as by default (except for the caption, which uses menu caption class).

C. portlet-menu-item-selected - currently highlighted menu item (unless the mouse is over the highlight item, in which case the hover--selected is used).

D. portlet-menu-item-hover - this is used in the case of the mouse being inside of the item, but it is not selected? I'm not sure what the difference is when it is selected or hover or hover-selected, since most menus use them interchangeably.

E. portlet-menu-item-hover-selected - mouse is inside the area of the item and it is selected. However, wouldn't the menu disappear once you select something? Is this meant to be used when you select an item pressing the mouse button down but haven't released the button back up yet?

F. portlet-menu-cascade-item - this is used for the item that has a cascading submenu. Do you simply have to hover over the item to show this class or do non-selected or hovered items with submenus automatically appear with this class?

G. portlet-menu-cascade-item-selected - this is used to represent the selected item that has a submenu once you have physically selected and shown that item's submenu.

H. portlet-menu-description -  this could be used on the text in a pop-up bubble that would appear next to the item or on the window below the menu item.

I. portlet-menu-caption - this is used for the caption of the menu. What about the selected caption?  There doesn't appear to be a style class for that.

Thanks for all of your help...

Ken 


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]