2.2. 对主题的更改


2.2.1. 对 Welcome theme 的更改

"welcome"主题已更新为使用新布局,现在使用 PatternFly 5 而不是 PatternFly 3。如果您要扩展主题或自行提供,您可能需要按如下方式进行更新:

2.2.1.1. 从 PatternFly 3 迁移到 PatternFly 5

欢迎主题是红帽构建的 Keycloak 中的过期主题之一。它最初基于 PatternFly 3,但现已更新为使用 PatternFly 5,跳过过程中的主要版本。如果您的自定义主题扩展了内置主题,您需要对其进行更新以使用 PatternFly 5 语法。有关详细信息,请参阅 PatternFly 5 文档

如果您仍然在您自己的自定义主题中使用 PatternFly 3 (没有扩展内置主题),您可以继续使用它,但 PatternFly 3 支持将在以后的版本中删除,因此您应该尽快迁移到 PatternFly 5。

2.2.1.2. 自动重定向到管理控制台

如果启用了 Admin 控制台,则欢迎页面将自动重定向到它(如果管理用户已存在)。通过在 主题.properties 文件中设置 redirectToAdmin 来修改此行为。默认情况下,属性设为 false,除非您扩展内置主题,在这种情况下,属性设为 true

2.2.1.4. 现在,资产已从 'common' 资源加载

背景、徽标和 favicon 等镜像现在从 'common' 资源加载,而不是从主题资源加载。此更改意味着,如果您要扩展内置主题,并且覆盖这些镜像,则需要将它们移到主题的"通用"资源,并更新您的 主题.properties 文件使其包含新路径:

# This defaults to 'common/keycloak' if not set.
import=common/your-theme-name
Copy to Clipboard Toggle word wrap

2.2.2. 对帐户控制台主题自定义的更改

如果您之前扩展帐户控制台主题的已弃用版本 2,则需要更新您的主题以使用帐户控制台主题的新版本 3。新版本的帐户控制台主题会做一些关于它自定义方式的更改。要开始清理,您可以遵循新的自定义 快速入门

要移动您的自定义主题,首先将 父项 改为新的主题:

# Before
parent=keycloak.v2

# After
parent=keycloak.v3
Copy to Clipboard Toggle word wrap

如果您有任何自定义 React 组件,您将直接导入 React,而不是使用相对路径:

// Before
import * as React from "../../../../common/keycloak/web_modules/react.js";

// After
import React from "react";
Copy to Clipboard Toggle word wrap

如果您使用 content.json 自定义主题,则对文件结构有一些更改,特别是:

  • content 属性已重命名为 children
  • idiconcomponentName 属性已被删除,因为 modulePath 提供了相同的功能。

2.2.3. 用于它们的默认语言文件到 UTF-8 编码

此发行版本现在遵循 Java 及之后的版本的标准机制,它假定要在 UTF-8 中编码资源捆绑包文件。

之前的 Keycloak 版本支持在第一行中指定编码,它带有类似 # encoding: UTF-8 的注释,该注释不再被支持并会被忽略。

现在,sees 的消息属性文件在 UTF-8 编码中读取,自动回退到 ISO-8859-1 编码。如果您使用不同的编码,请将文件转换为 UTF-8。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat