14. 如何在XPages中插入HTML

在经典的Notes Web开发中，我们经常需要在表单中插入HTML，即Pass-Through HTML，因为Domino Web引擎将表单上的设计元素转换成HTML时既原始丑陋又没有给开发人员太多控制调整的机会。在XPages里，大部分情况下，我们只需要添加控件，设置属性，XPages引擎就能产生出令人满意的HTML。但是，在某些情况下，还会需要手工添加和编写HTML，因为目前的控件还不够全面。而这样做恰恰也比在经典的Notes开发中更直观和方便。

打开任何一个XPage，转到源代码视图，直接在控件标签之间添加HTML代码。就这么简单。XPages引擎在解析页面时，会处理给定了命名空间的元素，比如在按钮xp:button就是在xmlns:xp=http://www.ibm.com/xsp/core定义的命名空间之下；对没有命名空间的HTML标签则直接传递（pass-through）到返回浏览器的流中（在底层的JSF视图的组件树中，这些HTML标签每个都被包装在一个com.ibm.xsp.component.UIPassThroughTag组件里。例如xp:br和直接用br都能输出一个换行符，前者由一个组件com.ibm.xsp.component.xp.XspLineBreak代表，后者则包装在一个com.ibm.xsp.component.UIPassThroughTag里）。同时在设计视图下，还会解析显示（render）这些HTML！赶紧试试吧。

这样做的大用处，在之后建立大纲/导航/菜单时就会显示出来。