The Content Row component in Oracle APEX is a key layout element used to organize regions and components horizontally across a page. It acts as a container that groups one or more columns or regions side-by-side, allowing developers to create structured, responsive designs. Content Rows work in conjunction with Columns and Content Blocks to build flexible and modern page layouts that adapt well to different screen sizes.
How to Use the Content Row Component in Oracle APEX
Using the Content Row component involves arranging regions inside rows and columns to create a grid-based layout. Here’s a detailed explanation of how to implement and configure Content Rows:
-
Add a Content Row Region
-
In Oracle APEX App Builder, open the page where you want to organize content.
-
Click + Add Region.
-
Select Content Row from the list of region types.
-
Give the row a descriptive name to identify its purpose.
-
-
Add Columns Within the Content Row
-
Once the Content Row is created, add Content Column regions inside it.
-
Columns can be configured with specific widths (for example, 1/3, 1/2, 2/3) depending on the grid system.
-
Columns hold the actual content regions like reports, charts, or text.
-
-
Place Regions Inside Columns
-
Within each column, add your content regions such as Reports, Forms, or Content Blocks.
-
These regions will display horizontally side-by-side in the row.
-
You can nest rows and columns for complex layouts.
-
-
Configure Responsive Behavior
-
Content Rows and Columns use APEX’s built-in responsive grid.
-
Set breakpoints or use default behavior to ensure columns stack vertically on smaller screens.
-
You can adjust padding, margins, and alignment for rows and columns.
-
-
Customize Appearance
-
Apply CSS classes or inline styles for spacing, background color, or borders.
-
Use the Template Options to control the look and feel of rows and columns.
-
Use the Page Designer’s Layout tab to drag and drop regions and rearrange the layout visually.
-
Examples
Example 1: Two-Column Layout
-
Content Row with two columns each occupying 50% width.
-
Left column contains a Classic Report.
-
Right column contains a Chart Region.
Example 2: Three-Column Feature Section
-
Content Row with three equal-width columns.
-
Each column displays a Content Block describing a product feature.
Example 3: Nested Rows for Complex Layout
-
A Content Row with two columns.
-
The right column contains another nested Content Row with two columns, showing multiple charts.
Best Practices
-
Plan your page layout in advance, considering the flow and importance of content.
-
Use Content Rows and Columns consistently for better maintenance.
-
Test layouts on multiple screen sizes to ensure responsive behavior.
-
Avoid overcrowding rows with too many columns; keep it simple for readability.
-
Use Template Options to maintain visual consistency.
-
Leverage APEX’s drag-and-drop features in Page Designer to quickly build and modify layouts.
Content Row is a theme component that is suitable for displaying most types of content. This component features a column for an icon, title and description, miscellaneous attributes, and actions.
Example:
SQL Query:
select t.ID,
t.PROJECT,
t.PARENT_TASK,
t.TASK_NAME,
t.START_DATE,
t.END_DATE,
t.STATUS,
t.ASSIGNED_TO,
p.project as proj_name,
case t.status
when 'Open' then 'fa-exclamation-circle-o'
when 'Closed' then 'fa-check-circle u-success-text'
when 'On-Hold' then 'fa-minus-circle u-danger-text'
when 'Pending' then 'fa-exclamation-triangle u-warning-text'
end icon_class
from EBA_UT_CHART_TASKS t,
EBA_UT_CHART_PROJECTS p
where t.project = p.id
order by p.created
Attributes:
Oracle APEX Documentation
For detailed information on Content Rows and responsive layouts, refer to the official Oracle APEX documentation:
https://docs.oracle.com/en/database/oracle/apex/
Search for “Content Row” and “Grid Layout” for examples and best practices.
Conclusion
The Content Row component is essential for building clean, structured, and responsive layouts in Oracle APEX. By grouping regions horizontally into rows and columns, you can design pages that organize content logically and look great on any device. Using Content Rows effectively enhances both the usability and visual appeal of your applications, making them easier to navigate and more professional in appearance.