目录

PrimeFaces 15.0.15 现已发布 :rocket: 🔵 TL;DR（摘要）

• 快速概览：为什么 PrimeFaces 15.0.15 重要，以及它带来了哪些改进。 🔵 PrimeFaces 15.0.15 带来了什么 🔵 1. Schedule 工具提示转义
• PrimeFaces 现在可以更好地控制 p:schedule 中工具提示内容的转义方式。
• 说明： 🔵 2. 带有受信任 HTML 的 Schedule 工具提示
• 当内容受信任且受控时，仍然可以渲染 HTML 工具提示。
• 说明：
• 适用场景： 🔵 3. SelectOneMenu 无障碍性
• SelectOneMenu 改进了 ARIA 行为，以提供更好的无障碍支持。
• 说明：
• 重要性： 🔵 4. Panel 折叠标题行为
• 当使用可折叠标题时，Panel 标题现在表现出更准确的无障碍行为。
• 说明：
• 重要性： 🔵 5. 显示前的确认回调
• 确认对话框可以更好地遵循在显示对话框之前执行的逻辑。
• 说明：
• 适用场景： 🔵 6. InputNumber 和 AutoNumeric 更新
• 数值输入在格式化、精度和用户交互方面得到了改进。
• 说明：
• 为何开发者关心： 🔵 7. TextEditor 粘贴清理
• 粘贴到编辑器中的文本处理得更干净，特别是在处理不可见的间距问题时。
• 说明：
• 重要性： 🔵 8. PanelMenu 状态保持
• 嵌套菜单项在导航后能更好地记住其展开或折叠的状态。
• 说明：
• 重要性： 🔵 9. Ajax 错误处理
• 改进了局部页面更新期间重定向和错误情况下的 Ajax 行为。
• 说明：
• 这意味着小的 Ajax 错误可能会产生奇怪的 UI 效果： 🔵 10. BlockUI 清理
• 在 Ajax 更新和组件生命周期更改后，被阻塞的 UI 区域清理得更可靠。
• 说明：
• 重要性： 🔵 11. AutoComplete MoreText 修复
• AutoComplete 现在能更一致地处理“更多结果”消息。
• 说明：
• 适用场景： 🔵 12. Slider 精度
• Slider 数值的显示精度现在能更好地匹配配置的步长。
• 说明：
• 示例： 🔵 总结
• 小的维护性修复会对安全性、无障碍性和日常用户体验产生重大影响。

PrimeFaces 15.0.15 现已发布 🚀

这不是“Java 版的 React”。

PrimeFaces 是一个用于 JSF / Jakarta Faces 的组件库。

其目标很简单：

构建富 UI 组件的服务器端 Java Web 应用，而无需手动编写所有的 HTML、CSS 和 JavaScript。

此次发布主要侧重于完善： ▪️ 安全加固 ▪️ 无障碍性修复 ▪️ 更好的组件行为 ▪️ 减少 UI 边缘情况 ▪️ 更顺畅的开发体验

让我们看看有哪些变化，并结合小代码示例了解最常见的 PrimeFaces 概念。👇

https://github.com/primefaces/primefaces/releases/tag/v15.0.15

🔵 TL;DR

快速概览：为什么 PrimeFaces 15.0.15 重要，以及它带来了哪些改进。

▪️ PrimeFaces 15.0.15 是一个维护版本，而非“大型功能”版本。 ▪️ 最明显的变化是 p:schedule 工具提示的新转义行为。 ▪️ 对 ARIA 属性的无障碍支持持续改进。 ▪️ 多个组件收到了小而实用的修复：SelectOneMenu、Panel、ConfirmDialog、TextEditor、BlockUI、AutoComplete、Slider。 ▪️ PrimeFaces 仍然是强 Java/服务器端导向应用程序的绝佳选择。

🔵 PrimeFaces 15.0.15 带来了什么

🔵 1. Schedule 工具提示转义

PrimeFaces 现在可以更好地控制 p:schedule 中工具提示内容的转义方式。

<p:schedule value="#{calendarBean.eventModel}"
            tooltip="true"
            escape="true" />

escape 属性控制是否转义日程工具提示描述中的 HTML 内容。

说明：

▪️ escape="true" 是安全默认值。 ▪️ HTML 将被作为纯文本渲染。 ▪️ 这有助于避免工具提示中出现不必要的 HTML 注入。 ▪️ 如果您明确需要受信任的 HTML，可以小心地选择关闭它。

给新手的话：不要仅仅因为“看起来更好看”就将 escape 设置为 false。只有在您完全控制并清理了内容时才这样做。🔐

🔵 2. 带有受信任 HTML 的 Schedule 工具提示

当内容受信任且受控时，仍然可以渲染 HTML 工具提示。

<p:schedule value="#{calendarBean.eventModel}"
            tooltip="true"
            escape="false" />

说明：

当事件描述包含 HTML 时，这允许更丰富的工具提示渲染。

适用场景：

▪️ 内部仪表板 ▪️ 受信任的管理员内容 ▪️ 格式化的日历事件

但这伴随着责任。如果内容来自用户、数据库、导入或外部系统，则应保持转义开启。

安全不是美学上的选项。😉

🔵 3. SelectOneMenu 无障碍性

SelectOneMenu 改进了 ARIA 行为，以提供更好的无障碍支持。

<p:outputLabel for="country" value="Country" />

<p:selectOneMenu id="country"
                 value="#{userBean.country}"
                 required="true"
                 ariaLabel="Country">
    <f:selectItem itemLabel="Select one" itemValue="" />
    <f:selectItems value="#{userBean.countries}" />
</p:selectOneMenu>

说明：

PrimeFaces 15.0.15 恢复了 SelectOneMenu 上的一些 ARIA 属性。

重要性：

▪️ 屏幕阅读器能更好地理解组件。 ▪️ 无效/必填状态更清晰。 ▪️ 表单更具无障碍性。 ▪️ 企业应用对每个人都更易用 ♿

无障碍性不是装饰，它是组件契约的一部分。

🔵 4. Panel 折叠标题行为

当使用可折叠标题时，Panel 标题现在表现出更准确的无障碍行为。

<p:panel header="Advanced filters"
         toggleable="true"
         toggleableHeader="true">

    <p:inputText value="#{searchBean.keyword}" />
</p:panel>

说明：

Panel 的修复使 ARIA 行为更加精确。只有在标题确实可折叠时，它才应表现得像一个按钮。

重要性：

▪️ 更好的语义。 ▪️ 减少令人困惑的屏幕阅读器输出。 ▪️ 更清晰的键盘导航。 ▪️ 更可预测的 UI 行为。

小修复，真实的 UX 影响。

🔵 5. 显示前的确认回调

确认对话框可以更好地遵循在显示对话框之前执行的逻辑。

<script>
function canShowDeleteConfirm() {
    return confirm('Do you really want to open the confirmation dialog?');
}
</script>

<p:commandButton value="Delete"
                 action="#{userBean.delete}">
    <p:confirm header="Confirmation"
               message="Delete this user?"
               icon="pi pi-exclamation-triangle"
               beforeShow="return canShowDeleteConfirm();" />
</p:commandButton>

<p:confirmDialog global="true" />

说明：

beforeShow 回调现在得到了正确遵循。这意味着您可以在确认弹窗打开之前做出决定。

适用场景：

▪️ 业务预检查。 ▪️ 客户端条件判断。 ▪️ 避免不必要的对话框。 ▪️ 自定义 UX 流程。

这是一个小修复，但它使确认流程更可靠。

🔵 6. InputNumber 和 AutoNumeric 更新

数值输入在格式化、精度和用户交互方面得到了改进。

<p:inputNumber value="#{invoiceBean.amount}"
               symbol="€"
               decimalPlaces="2"
               thousandSeparator=" "
               decimalSeparator="," />

说明：

PrimeFaces 15.0.15 更新/修复了 p:inputNumber 背后的 JavaScript 库 AutoNumeric 的相关行为。

为何开发者关心：

▪️ 数值输入很棘手。 ▪️ 货币很棘手。 ▪️ 小数分隔符很棘手。 ▪️ 撤销/重做、退格、格式化和解析必须保持一致。

这就是用户可能永远不会注意到的一种修复……因为组件只是表现得正确了。✅

🔵 7. TextEditor 粘贴清理

粘贴到编辑器中的文本处理得更干净，特别是在处理不可见的间距问题时。

<p:textEditor value="#{articleBean.content}"
              height="300" />

说明：

TextEditor 的修复处理了粘贴操作期间的不换行空格。

重要性：

▪️ 从 Word、网站或富文本编辑器复制粘贴可能会引入不可见字符。 ▪️ 不可见字符会导致格式错误。 ▪️ 文本存储和渲染变得更整洁。 ▪️ 内容编辑感觉更稳定。

富文本编辑器从来不仅仅是“纯文本”。此修复有助于减少那些恼人的内容编辑边缘情况之一。

🔵 8. PanelMenu 状态保持

嵌套菜单项在导航后能更好地记住其展开或折叠的状态。

<p:panelMenu stateful="true">
    <p:submenu label="Administration">
        <p:submenu label="Users">
            <p:menuitem value="Search users"
                        outcome="/admin/users" />
        </p:submenu>
    </p:submenu>
</p:panelMenu>

说明：

此版本改进了嵌套菜单项的状态保持功能（子菜单能更好地在导航之间记住展开/折叠状态）。

重要性：

▪️ 更好地保留了菜单展开状态。 ▪️ 嵌套导航不再那么令人沮丧。 ▪️ 后台管理面板感觉更稳定。 ▪️ 用户不会丢失导航上下文。

在后台应用程序中，导航稳定性非常重要。

🔵 9. Ajax 错误处理

改进了局部页面更新期间重定向和错误情况下的 Ajax 行为。

<p:commandButton value="Save"
                 action="#{profileBean.save}"
                 process="@form"
                 update="messages profilePanel" />

<p:messages id="messages" />

说明：

PrimeFaces 15.0.15 改进了围绕重定向/错误边缘情况的 Ajax 处理。PrimeFaces 应用程序非常依赖局部页面更新。

这意味着小的 Ajax 错误可能会产生奇怪的 UI 效果：

▪️ 组件阻塞。 ▪️ 刷新不完整。 ▪️ 重定向行为中断。 ▪️ 令人困惑的用户反馈。

此修复大多是隐形的，但对健壮性很重要。

🔵 10. BlockUI 清理

在 Ajax 更新和组件生命周期更改后，被阻塞的 UI 区域清理得更可靠。

<p:blockUI block="formPanel"
           trigger="saveButton" />

<p:panel id="formPanel">
    <p:commandButton id="saveButton"
                     value="Save"
                     action="#{profileBean.save}"
                     update="formPanel" />
</p:panel>

说明：

BlockUI 用于防止 Ajax 请求运行期间的用户交互。此修复确保在组件清理期间目标元素被正确解锁。

重要性：

▪️ 减少“UI 卡死”情况。 ▪️ 局部更新后表现更好。 ▪️ 更整洁的 Ajax 生命周期。 ▪️ 减少用户的挫败感。

保存按钮点击后屏幕被阻塞是失去用户信任的最快方式之一。

🔵 11. AutoComplete MoreText 修复

AutoComplete 现在能更一致地处理“更多结果”消息。

<p:autoComplete value="#{cityBean.selectedCity}"
                completeMethod="#{cityBean.completeCity}"
                var="city"
                itemLabel="#{city.name}"
                itemValue="#{city}"
                moreText="More results available..." />

说明：

当存在的建议多于当前显示的数量时，会使用 moreText 区域。此修复改进了该文本的渲染和展现方式。

适用场景：

▪️ 建议数量有限时。 ▪️ 搜索结果较大时。 ▪️ 用户需要反馈时。 ▪️ 无障碍性很重要时。

自动补全不仅是为了搜索，更是为了引导用户。

🔵 12. Slider 精度

Slider 数值的显示精度现在能更好地匹配配置的步长。

<p:slider for="txt"
          step="0.5" />

说明：

Slider 组件现在根据配置的 step 值来显示精度。

示例：

如果 step="0.5"，则显示 1.0、1.5、2.0，而不是奇怪的浮点数。

🔵 总结

小的维护性修复会对安全性、无障碍性和日常用户体验产生重大影响。## 🔵 12. 滑块精度 (SLIDER PRECISION)

滑块数值的显示精度现在能更好地匹配所配置的步长 (step)。

<p:inputText id="discount" value="#{pricingBean.discount}" />

<p:slider for="discount"
          minValue="0"
          maxValue="1"
          step="0.05"
          display="discountOutput"
          displayTemplate="{value}" />

<h:outputText id="discountOutput" />

说明：

滑块的显示现在使用与配置步长相同的精度。

示例：

• 步长 (step) = 0.05
• 显示效果将与该精度保持一致
• 不会出现奇怪的舍入偏差
• 为百分比、评分、阈值和数值过滤器提供更好的显示效果

微小的细节。在用户处理数字时却有巨大的差异。

🔵 总结 (TAKEAWAYS)

小规模的维护修复也能对安全性、可访问性和日常用户体验产生重大影响。

• 当您希望进行服务器端 Java UI 开发时，PrimeFaces 依然具有相关性
• 它特别适用于企业级 CRUD、管理面板、内部工具和数据密集型应用程序
• PrimeFaces 15.0.15 版本的核心在于质量，而非炒作
• 安全性和可访问性修复与炫酷的组件同样重要
• 新开发者在评价 PrimeFaces 之前，应先理解 JSF 生命周期
• 其真正的强大之处不在于“拖拽式 UI”，而在于 Java Bean、组件、Ajax 更新和丰富的小部件的有机结合

PrimeFaces 并不是前端领域里的“潮流宠儿”。但在许多 Java 企业级应用中，它依然在发挥着核心作用。☕🎨

Java #JakartaEE #JSF #PrimeFaces #JakartaFaces #企业级Java #Web开发 #Java开发者 #软件工程 #可访问性 #Web安全 #后端开发 #Java全栈

进一步了解 Java 认证：

Java👇

https://bit.ly/javaOCP

Spring👇

https://bit.ly/2v7222

SpringBook👇

https://bit.ly/springtify

JavaBook👇

https://bit.ly/jroadmap

✌️😎

文章 💪😤 THE 12 LABOURS OF PRIMEFACES 15.0.15 #release 最早发布于 foojay。