[Portal参考手册]6.Portlet布局框架

Portlet布局组件类似java中的awt/swing组件。原因有二：

1) 象awt/swing一样，提供了相近的增删组件的API

2) 基于Composite设计模式，用户可以自己开发组件。

Portlet布局组件：

一个portlet布局,在用户看来就是一个PortletPage。一个PortletPage包含多个portlet组件。通常portlet布局组件继承于PortletContainer类，有width,height,CSS属性等。

PortletContent

允许使用include属性包含外部内容。

PortletTableLayout

表格布局。

PortletRowLayout

行布局。

PortletColumnLayout

列布局。

PortletTabbedPane

Tab面板布局。

PortletTab

一个tab定义了一个标题和一个 portlet组件，当tab被选择的时候这个组件将被显示。

PortletFrame

一 个portlet frame 显示一个portlet。它包含标题边框和要显示的portlet的类名。如果transparent属性不被设为 true, 标题栏不会被显示。required-role元素可以被指定为"GUEST", "USER", "ADMIN" 或 "SUPER"。

设计一个布局：

一个外部的web应用可以指定一种布局，通过年纪WEB-INF/layout.xml文件。布局描述文件定义了在一个double-tabbed 面板中的portlet的组织。下面时一个例子。

<portlet-tabbed-pane> 1

<portlet-tab>

<title lang="en">Examples</title> 2

<portlet-tabbed-pane style="sub-menu"> 3

<portlet-tab>

<title lang="en">Simple Examples</title>

<table-layout> 4

<row-layout> 5

<column-layout width="50%> 6

<portlet-frame> 7

<portlet-class>org.myorg.portlets.examples.simpleone.1</portlet-class>

</portlet-frame>

</column-layout width="50%>

<column-layout width="50%>

<portlet-frame label="simpletwo"> 8

<portlet-class>org.myorg.portlets.examples.simpletwo.1</portlet-class>

</portlet-frame>

</column-layout>

</row-layout>

</table-layout>

</portlet-tab>

<portlet-tab>

<title lang="en">Demos</title>

<table-layout>

<row-layout>

<column-layout>

<portlet-frame>

<name>DemoPortlet</name>

<portlet-class>com.kuaff.spirit.portlets.examples.DemoPortlet.1</portlet-class>

</portlet-frame>

</column-layout>

</row-layout>

</table-layout>

</portlet-tab>

</portlet-tabbed-pane>

</portlet-tab>

</portlet-tabbed-pane>

1

每一个描述文件都必须以portlet-tabbed-pane 开始

2

Tab标题可以本地化。

3

不是必须的。

4

Table布局。

5

Row布局。

6

Table布局。

7

portlet frame。

8

指定一个标签。意味着它可以被连接。

了解更多的信息，可以查看layout-mapping.xml文件，它定义了portlet组件类和描述符之间的关系。