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

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

<!--[if !supportLists]-->1) <!--[endif]-->象awt/swing一样，提供了相近的增删组件的API

<!--[if !supportLists]-->2) <!--[endif]-->基于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> <!--[if !vml]--><!--[endif]-->

<portlet-tab>

<title lang="en">Examples</title> <!--[if !vml]--><!--[endif]-->

<portlet-tabbed-pane style="sub-menu"> <!--[if !vml]--><!--[endif]-->

<portlet-tab>

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

<table-layout> <!--[if !vml]--><!--[endif]-->

<row-layout> <!--[if !vml]--><!--[endif]-->

<column-layout width="50%> <!--[if !vml]--><!--[endif]-->

<portlet-frame> <!--[if !vml]--><!--[endif]-->

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

</portlet-frame>

</column-layout width="50%>

<column-layout width="50%>

<portlet-frame label="simpletwo"> <!--[if !vml]--><!--[endif]-->

<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>



<!--[if !vml]--><!--[endif]-->
每一个描述文件都必须以portlet-tabbed-pane 开始

<!--[if !vml]--><!--[endif]-->
Tab标题可以本地化。

<!--[if !vml]--><!--[endif]-->
不是必须的。

<!--[if !vml]--><!--[endif]-->
Table布局。

<!--[if !vml]--><!--[endif]-->
Row布局。

<!--[if !vml]--><!--[endif]-->
Table布局。

<!--[if !vml]--><!--[endif]-->
portlet frame。

<!--[if !vml]--><!--[endif]-->
指定一个标签。意味着它可以被连接。