Skip to main content

Per-Display Field Rendering Config

makes your components more usable, by ensuring that each field only appears where itโ€™s truly relevant โ€” and always in the most effective layout

What It Does

Joomla Component Builder (JCB) gives you fine-grained control over how each field behaves depending on where itโ€™s rendered:

  • List View (e.g., admin list of items)
  • Edit View (e.g., form used to create/edit an item)

Every field in JCB has separate configurations that let you control:

  • Whether it should appear in the list or form (or both)
  • Custom column title for list view
  • Column width, alignment, and ordering
  • Field label, tooltip, and description
  • Default values for new records
  • Conditional rendering or JavaScript visibility rules

Where to Configure It

Inside the Field entity GUI, youโ€™ll find:

  • โœ” Show in List
  • โœ” Show in Form
  • Field Label
  • Field Description
  • List Column Width
  • List Column Class (for styling)
  • Placeholder text (form only)
  • Tab/Accordion grouping options (form only)

Use Cases

  • Show a "status" field in the list view as a colored badge, but disable editing in the form.
  • Hide internal or computed fields from the form but show them in the list as read-only.
  • Reformat dates, prices, or booleans differently in list vs form using custom render layouts or field templates.
  • Group fields visually into tabs or sections in the edit form while maintaining a clean list view.

Benefits

  • โœ… Decouples list layout from form layout
  • โœ… Reduces form clutter for complex records
  • โœ… Makes admin list views cleaner and more informative
  • โœ… Allows read-only fields in lists without enabling editing
  • โœ… Enables logic-based display using JavaScript callbacks

Conclusion

Per-display rendering configuration makes your components more usable, by ensuring that each field only appears where itโ€™s truly relevant โ€” and always in the most effective layout. JCB empowers you to shape the admin experience with intention, clarity, and precision.