Customizable Components (HTML) Library - Panel Customizable (HTML) Component

Use to enable run-time customizations like move, and maximize or restore on components.

The Panel Customizable (HTML) component provides a container in which you can lay out the child components vertically or horizontally. At run time, you can move child components within the Panel Customizable (HTML) component, and maximize or restore child components.

Using the attributes of the Panel Customizable (HTML) component at design time, you can choose to lay out child components horizontally or vertically on the page, change the style of the content region, enable persistence of run-time customizations, and so on.

Note that this Panel Customizable (HTML) component is different from the Panel Customizable available in the Composer tag library in that the latter, when included inside a Page Customizable component, can also be used as a container to drag and drop components. Panel Customizable (HTML) does not provide this capability.

Example

<custh:panelCustomizable id="pc1"/>

Common Attributes

Element Description

id

Specifies the unique identifier for the component on the page. This attribute is populated with a unique value by default when you add the component.
  • The identifier must follow a subset of the syntax allowed in HTML:

  • Must not be a zero-length String.

  • First character must be an ASCII letter (A-Za-z) or an underscore ('_').

  • Subsequent characters must be an ASCII letter or digit (A-Za-z0-9), an underscore ('_'), or a dash ('-')

rendered

Specifies whether the component is rendered. When set to false, no output will be delivered for this component (the component will not in any way be rendered, and cannot be made visible on the client). The default value is true.

layout

Specifies whether child components must be laid out vertically or horizontally. The default layout is vertical.

If you select vertical, then the child components are displayed one below the other and can be moved either up or down within the layout.

If you select horizontal, then the child components are displayed adjacent to each other and can be moved either to the left or right within the layout.


Style Attributes

Element Description

styleClass

Specifies the CSS style class to be used for this component.

inlineStyle

Specifies the CSS style to apply to the whole Panel Customizable (HTML). Manually enter any style in compliance with CSS version 2.0 or later, or use the Text, Background, Box, and Classification tabs to specify style elements.

Advanced Attributes

Element Description

binding

Specifies an EL reference that will store the component instance on a bean. This can be used to give programmatic access to a component from a backing bean, or to move creation of the component to a backing bean.

Customization Attributes

Element Description

customizationAllowed

Specifies whether customizations are allowed on this component. Available values are true and false. The default value is true.

customizationAllowedBy

Specifies the roles for which customization is enabled.

The Expression Builder option available when setting these attributes allows you to bind a Panel Customizable (HTML) instance to a managed bean property.


Other Attributes

Element Description

customizationId

This attribute is deprecated. It will be removed in the next release. Use the id attribute.