组件参考

Tapestry包含65个以上的内置组件和mixin。此外,还有数百个Tapestry组件可从其他人那里免费获得。当然,Tapestry做到了非常简单创建您自己的自定义组件,所以如果您没有看到需要什么,只需自己开发它们即可。

相关文章

目录

磁带提供的组件

Tapestry提供的大多数组件都位于org.apache.tapestry5.corelib.components网站包装。其他组件包含在单独的org.apache.tapestry5.kaptcha.组件org.apache.tapestry5.upload.components网站包装。

AJAX特定组件

主要文章:Ajax和区域

AjaxForm循环

Loop组件的一种特殊形式,添加了Ajax支持,以处理动态添加新行和删除现有行。

添加行链接,删除行链接

在AjaxFormLoop组件内部使用,以刺激行的添加或删除。

渐进式显示

用于实施逐步增强的网页设计策略;组件使用简化的初始内容呈现自己(即“加载…”),然后Ajax请求提供组件的真实主体。

区域

标记为通过Ajax或其他客户端效果进行动态更新的页面区域。

Bean显示和编辑

主要文章:BeanEditForm指南

Bean显示

使用基础BeanModel将bean的属性显示为带有dt/dd对的dl元素。

BeanEditForm(BeanEdit表单)

创建一个完整的表单来编辑特定bean的属性

BeanEditor(BeanEditor)

BeanEditForm的核心组件,它生成用于编辑bean属性的用户界面

属性显示

输出单个特性值。单个属性的覆盖来自名称与属性id匹配的块参数。此组件由BeanDisplay组件使用。

属性编辑器

用于编辑bean的单个属性。这主要由BeanEditForm使用。

条件和循环组件

如果

有条件地渲染其主体。可以呈现其标记和任何非正式参数

案例

不是真正的组件,而是使用委托模拟“case”语句的技术

循环

循环多个项(由其源参数提供),为每个项呈现其主体]

除非

如果条件为false,If组件的反转将渲染其主体。

代表

不进行任何自己的渲染,但将委托给其他可以进行渲染的对象

表单组件

复选框

呈现标准<input type=“checkbox”>元素

检查表

呈现元素的垂直列表

日期字段

使用客户端JavaScript日历从用户处收集提供的日期

表格

HTML表单,它将包含其他组件以呈现各种类型的字段。

表单碎片

可选择性显示的窗体的一部分

隐藏

用于将页面属性作为值记录到表单中

标签

为特定字段生成标签元素

卡普查油田

基于Captcha的认证方案的一部分;KaptchaField与KaptchaImage配对,以确保用户提供了正确的值

Kaptcha图像

基于Captcha的认证方案的一部分;KaptchaImage在渲染时会生成一个新的文本图像,并可以随后提供以前渲染的文本(它会永久存储在会话中)

调色板

多重选择组件。生成由两个配置为多选的选择元素组成的UI;左边的是“可用”元素列表,右边的是“选中”元素列表。

密码字段

TextField的一个版本,但呈现为<input type=“password”>元素。

收音机

单选按钮(即<input type=“radio”>)。单选按钮必须在RadioContainer(通常是RadioGroup组件)中操作。

单选

将一组影响相同属性的无线电组件组合在一起

选择

呈现用于从值列表中选择项的<select>元素

SubmitNotifier(提交通知程序)

一个非可视组件,用于在表单提交期间向其容器提供通知

文本域

呈现用于编辑多行文本的<textarea>元素

文本字段

呈现<input type=“text”>元素以编辑单行文本

上传

基于Apache Commons FileUpload的文件上传组件(即<input type=“file”>)

网格、表格和树

网格

通过在列表或数组上迭代,在<table>元素中显示表格数据

网格单元格

网格的一部分,在单个数据单元内呈现标记

网格列

网格的一部分,呈现网格的列标题,包括用于控制列排序的链接(如果合适)

网格寻呼机

生成一系列链接,用于跳转到总体数据集中的特定页面索引

网格行

呈现表中的一系列行

用于呈现递归树结构的组件,具有可扩展/可折叠/可选择的节点。

链接和按钮

ActionLink(操作链接)

通过后续的整页刷新触发服务器上的操作

事件链接

与ActionLink类似,只是它触发的事件是显式控制的,而不是始终“action”,并且事件是在其容器中触发的

链接提交

生成提交封闭表单的客户端超链接

提交

对应于<input type=“submit”>或<input type=“image”>,这是可以强制封闭表单提交的客户端元素

页面链接

生成指向应用程序中其他页面的呈现请求链接

输出和消息

警报

呈现一个空的<div>元素,并提供JavaScript初始化,使该元素成为警报的容器。

动态

通过使用外部模板文件,允许组件在不同的时间以不同的方式渲染自身。

错误

显示单个字段的验证错误。必须用Form组件括起来

错误

标准验证错误演示者。必须用Form组件括起来。如果出现错误,则在横幅消息和未编号的错误消息列表周围呈现div元素

异常显示

默认ExceptionReport页面的组成部分,用于分解和显示异常的属性

字体AwesomeIcon

呈现<i>用CSS类标记以选择字体Awesome 4.7.0偶像。

输出

用于格式化输出的组件。如果在模板中使用元素表示组件,那么元素(加上任何非正式参数)将围绕格式化值输出。

输出原始

将原始标记输出到客户端。与扩展不同,OutputRaw的输出未经过滤,任何特殊字符或实体都保持原样。

文本输出

输出面向段落的文本,通常通过TextArea组件收集。TextArea被拆分为多行,每一行都输出到自己的p元素中。

其他

任何

呈现包含非正式参数的任意元素

开发工具在开发时呈现有用选项的下拉菜单,例如重新加载当前页面或使当前HttpSession无效。

文件类型

覆盖所呈现文档的DOCTYPE(通过document.dtd(String,String,字符串)),当呈现到同一文档的不同组件模板对正确的DOCTYPE不一致时,该选项非常有用。

渲染对象

使用ObjectRenderer服务呈现对象。主要用于ExceptionReport页面

触发

在呈现期间触发任意事件。这对于将JavaScript添加到页面或组件(通过调用JavaScriptSupport环境)通常很有用。

挂毯混搭

主要文章:成分混合物

混合允许您向现有组件添加行为。核心混合物位于org.apache.tapestry5.corelib.mixins网站包装。

Tapestry包括以下现成的mixin。

自动完成

修改文本字段,以便在用户键入时使用从服务器检索的值自动完成文本。请参阅说明.

确认附加到窗体或链接组件后,运行modal-dialog以强制用户确认行为。Tapestry 5.4的新增功能。

丢弃车身

丢弃组件的主体。从BeforeRenderBody阶段返回false,这会阻止主体的渲染。

表单字段焦点

插入外部窗体,焦点应在其上激活。替换为Tapestry 5.4中开始的OverrideFieldFocus。

窗体组附加到字段以呈现封闭的<div>元素和标签,以正确引导文本字段、选择和文本区域的标记

非空

附加到呈现元素的任何组件。在渲染结束时,如果元素为空,则会向元素中注入一个非中断空格(&nbsp;)。

覆盖FieldFocus

当附加到表单字段时,会使该字段获得焦点。从Tapestry 5.4开始,它将取代FormFieldFocus。

渲染客户端Id

通过确保调用“getClientId”,强制客户端元素呈现其客户端id。

渲染已禁用

如果包含的组件被禁用,则呈现“disabled”属性

呈现信息

在BeginRender阶段结束时渲染所有非正式参数。此mixin可以与在BeginRender阶段内渲染单个标记的组件一起使用。

呈现通知

当附加组件进入BeginRender和AfterRender渲染阶段时,将触发组件事件通知。

触发器片段

当应用于复选框或Radio组件时,链接输入字段和FormFragment,使该字段控制FormFragment的客户端可见性

分区刷新

通过使用ajax请求触发服务器上的事件,定期刷新区域。

挂毯页面

Tapestry提供了几个提供状态信息的特殊页面。其中大多数位于org.apache.tapestry5.corelib.pages网站包装。

例外报告

负责报告运行时异常。此页面非常冗长,通常在生产应用程序中被覆盖。

页面目录

列出当前加载的页面以及一些统计信息。

属性显示块

包含用于显示基本属性类型的块;这些块被贡献给BeanBlockSource服务。

PropertyEditBlocks(属性编辑块)

包含用于编辑不同类型属性的块的页面。此页面上的块被贡献到BeanBlockSource服务配置中。

服务状态

用于查看注册表定义的所有服务状态的页面。

基本组件

基本组件,位于org.apache.tapestry5.corelib.base网站包,旨在由其他组件扩展,而不是直接在模板中使用。

抽象组件事件链接

基于组件事件请求的链接生成组件的基类。此类事件具有事件上下文,也可能更新区域。

抽象条件

If和Excelf的基类。将从else参数渲染其主体或块。如果它渲染任何东西,并且它有一个元素名称,那么它就会渲染元素及其非正式参数。

抽象字段

提供clientId和elementName属性的初始化。此外,添加了RenderInformals、RenderDisabled和DiscardBody混合。

抽象链接

为生成可单击链接的类提供基本实用程序。

抽象属性输出

使用PropertyModel输出属性值的组件的基类

抽象文本字段

用于呈现文本字段的某些变体的各种组件的抽象类。大多数用于用户输入验证的钩子都在这个类中

基本消息

输出消息的组件的基类

其他组件库

请参见模块