You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

Showcase App alterations

There is a requirement to add information about the fields etc. that are available in the showcase app:

  1. The information should be succinct, descriptive but not contain any coding information or any detail beyond a description for each item.
  2. For further information the user needs to look to official documentation. For this reason there needs to be a link to official documentation from within Magnolia CMS 5.

Currently there are three tabs in the showcase app:

  1. Form fields - Magnolia specific fields. 
  2. Vaadin fields - Vaadin fields that can be used with Magnolia.
  3. Unsupported fields by Maganolia  - Not clear why we specify what Vaadin fields NOT to use. Suggest adding information on what is wrong with each field (i.e. - why it should not be used). That or simply removing this tab.

All three tabs require changes.

Form fields tab -

After discussions with Andreas and Philip, I would suggest making a few alterations to the Showcase App: Form fields tab:

  1. Increase real estate for the fields (i.e make the grey area bigger - stretch it to the left and right)
  2. Left align all fields
  3. Add headings:
    1. Field name
    2. Appearance
    3. Function (or Description)
  4. Consider adding visible columns for headings
  5. Add a short description per field. Say, max 140 characters. (Use this for... Can also be used for... etc.) Where, why, how. (Use on x pages to describe....Try not to use more than x times per page.)
  6. Add link to official documentation, where users can find detailed information on using fields. The link could be by the line "Showcase apps......."

 

FieldDescription
Static text 
Commit button in a form 
Reset button in a form 
Link 
Text field 
Text area 
Password fields 
Checkbox 
Radio button group 
Checkbox group 
Select 
Date field 


Vaadin fields and descriptions

 

FieldDescription
Static text 
Commit button in a form 
Reset button in a form 
Link 
Text field 
Text area 
Password fields 
Checkbox 
Radio button group 
Checkbox group 
Select 
Date field 


 


 

 

 

 


 

 

 

 

 

  • No labels