domino xpages 开发 Repeat显示富域值.doc

在 Domino XPages 开发中，`<xp:repeat>` 是一个关键组件，用于迭代和显示数据集合中的元素。在这个特定的文档示例中，开发者正在使用 `<xp:repeat>` 来展示视图（view）中的多条记录，并通过富文本域（Rich Text Field）来显示每个记录的详细内容。下面我们将深入探讨 `<xp:repeat>` 组件以及如何与富文本域结合使用。 1. **<xp:repeat> 组件**： `<xp:repeat>` 是一个循环组件，它允许开发者遍历一个集合并为集合中的每个元素创建一个或多个子组件。在这个例子中，`rows="30"` 设置了显示的最大行数，而 `value="#{view1}"` 指定了要迭代的数据源，即视图 `view1`。`var="row"` 定义了一个变量 `row`，在循环体内代表当前迭代到的视图项。 2. **<xp:dominoDocument>**： 在 `<xp:repeat>` 内部，使用 `<xp:dominoDocument>` 来打开指定文档。`documentId="#{javascript:row.getNoteID()}"` 使用 JavaScript 脚本获取当前行的文档 ID，以便打开相应的 Lotus Domino 文档。`ignoreRequestParams="true"` 表示忽略请求参数，确保不会受到任何外部参数的影响。 3. **<xp:inputRichText>**： `<xp:inputRichText>` 是一个用于显示和编辑富文本的组件。在这个例子中，它的 `value="#{doc.ArticleContent}"` 属性绑定了 `doc` 变量（由 `<xp:dominoDocument>` 创建）上的 `ArticleContent` 字段，这样就能显示文档的富文本内容。`readonly="true"` 设置表示这个富文本域是只读的，用户不能编辑。 4. **显示富文本内容**： 在 `<xp:repeat>` 结构中，`<xp:inputRichText>` 用于显示每个文档的 `ArticleContent` 字段，这通常包含格式化后的文本，如段落、字体样式、图片等。`<xp:inputRichText>` 会保持原始的格式，使得用户可以查看格式化的文本，但无法修改。 5. **<xp:viewPanel> 和 <xp:viewColumn>**： 示例中还提到了 `<xp:viewPanel>` 和 `<xp:viewColumn>`，它们用于构建数据视图。`<xp:viewPanel>` 是一个表格视图，它以列的形式展示数据，而 `<xp:viewColumn>` 定义了视图中的每一列。在这里，`value=”#{rowData.getNoteID()}”` 获取视图行的 ID，用于打开对应的文档。类似地，`<xp:inputRichText>` 用于显示 `summary` 字段的富文本内容。 总结起来，这个文档示例展示了如何使用 Domino XPages 的 `<xp:repeat>` 组件来迭代视图数据，通过 `<xp:dominoDocument>` 打开每个文档，并用 `<xp:inputRichText>` 显示富文本字段的值。同时，也介绍了 `<xp:viewPanel>` 和 `<xp:viewColumn>` 如何构建数据视图并展示富文本信息。在实际开发中，这些组件和属性的组合使用有助于创建动态、交互式的用户界面，以便用户能够浏览和处理 Lotus Domino 数据库中的复杂文档内容。