果冻表单控件

Jenkins源代码中的大多数jelly文件都有嵌入式文档必威国际有限公司IDE配置详细了解如何进行此设置,以便您可以在IDE中单击它。

例如,你可以看到< >形式标记

你也可以看看参考资料ui-samples-plugin,该存储库包含用户界面元素的可执行示例,包括表单。

验证按钮

此标记创建一个用于执行服务器端验证的右对齐按钮。它适用于验证依赖于多个输入字段的值的情况,例如同时使用用户名和密码的凭据检查。

标题${%Access密钥ID}>访问ID/>> < / f:条目标题${%秘密访问密钥}>< f:密码secretKey/>> < / f:条目< f: validateButton标题${%测试连接}进步${%Testing…}方法testConnectionsecretKey, accessId/>

标题属性用于确定写在按钮上的文本进步属性确定在进行服务器端验证时显示的消息。的方法属性指定此按钮调用的服务器端方法;这遵循订书机名称损坏约定,例如方法= " testConnection "将调用doTestConnection方法。此方法需要位于拥有此表单片段的描述符类上。

属性指定发送到服务器进行验证的输入字段。它们与属性或的名字其他输入控件的属性。的上方最接近的输入字段的值< f: validateButton / >发送到服务器,因此这意味着按钮必须出现在输入字段之后。可以使用','指定多个字段。

在服务器端,这个标签像这样调用标准的“do”样式的方法:

@POST公众的FormValidation点连接(@查询参数访问ID最后字符串访问ID,@查询参数secretKey最后字符串secretKey,@AncestorInPath工作工作)投掷IOException,ServletException{尝试如果(工作= =无效的) {J必威国际有限公司enkins.get () .checkPermission (Jenkins.ADMINISTER);}其他的{job.checkPermission(Item.CONFIGURE);}…执行一些测试…返回FormValidation.ok(成功);}(EC2Exception e) {返回FormValidation.error (客户端错误:+ e.getMessage ());}}

doTestConnection方法包含验证逻辑。最后,这个方法必须调用其中一个好的.warning,或。error方法。根据您使用的方法,将在客户端呈现适当的HTML以向用户指示状态。

先进的

默认情况下显示“高级…”按钮的可展开部分。单击该按钮后,部分将展开。

标题高级项目选项>页面configure-advanced.jelly/>< / f:先进的>> < / f:部分

光学块

选中菜单项时,可折叠块展开。

< f:块><表>< f: optionalBlock的名字动态标题使用现有的动态视图>标题视图驱动器>的名字开车价值${it.drive}/>> < / f:条目< / f: optionalBlock >< / f:块>

未勾选将不显示文本框勾选将显示文本框

选择(下拉菜单)

使用一个标记来包围正常的选择标记。

的名字目标类型标题选择目标类型目标类型><选择的名字目标类型><选项价值buildGoal>建立目标> < /选项<选项价值spotBugsGoal>SpotBugs目标> < /选项> < / f:条目

选择(下拉菜单)模型填充值

基本上与上面相同。您需要在可描述实例的描述符中定义以下方法:

公众的ListBoxModel doFillGoalTypeItems() {ListBoxModel items =新的ListBoxModel ();items.add (建立目标buildGoal);项目。添加(SpotBugs目标spotBugsGoal);返回项目;}

然后,使用一个标记来包围正常的选择标记。

目标类型标题选择目标类型>< f:选择/>> < / f:条目

嵌入式帮助

向表单元素添加内联帮助

大多数表单元素都允许通过添加一个小HTML文件并遵循一些约定来生成内联帮助。

例如标签使用属性。

给定src/main/resources/myForm.jelly中包含以下内容的文件:

标题的名字的名字>/>> < / f:条目

添加一个src /主/资源/ help-name.html:

这是我的内容,以帮助最终用户了解如何使用该字段。< / div >

将自动显示带有< div >…< / div >内容。

关于内联帮助的附加说明

  • 大多数控件都支持help.html作为整体的帮助可描写的

  • 的帮助信息可以在果冻中重写帮助属性,但请尽可能使用约定'help-fieldName.html'。

标题这是一个很好的标题帮助/插件/ my-plugin /帮助/ custom-file.html>

工具书类