JavaFX CSS @font-face 错误全面分析 loadStylesheetUnPrivileged / reportException

JavaFx 支持样式表,并且支持 @font-face 加载指定字体。官方提供的示例代码如下:

css 复制代码
@font-face {
    font-family: 'sample';
    font-style: normal;
    font-weight: normal;
    src: local('sample'), url('http://font.samples/resources/sample.ttf';) format('truetype');
}

但是这段代码极具误导性,而且很容易出现如下错误:

css 复制代码
// 错误1
com.sun.javafx.css.StyleManager loadStylesheetUnPrivileged
INFO:Could not load @font-face font [file:/D:/JOYZL%20SCADA/scada/trunk/brace/target/classes/com/joyzl/brace/window/HUATENS.ttf]

// 错误2
javafx.css.CssParser reportException
警告: Please report java.lang.NullPointerException at:

其次的错误是字体加载成功了,但是却没有生效。

原因为:

  1. StyleManager 使用 Font.loadFont() 这个方法不会对URL编码的百分号字符执行解码,那么如果路径中存在空格,会导致加载失败。由于CSS中的路径URL是样式解析器通过 getResource 获得的,因此我们没有可用的干预手段,折中的方案是,JavaFx 程序启动时通过代码加载字体,我们需要将 %20 替换为 空格。

  2. src:url("/sample.ttf") 的URL不能出现 '/' 开头的根目录表示形式,字体文件定位相对于CSS文件的位置,不应使用绝对路径,请改为相对路径。如果路径解析失败将收到 reportException 异常。

  3. 字体加载成功(未提示异常),但是字体依然没有生效,是为字体名称匹配失败,这会由三个原因导致:

A. @font-face 中指定的 font-family 是无效的,JavaFx 不会使用这个指令,@font-face 中除了 src:url 之外的指令都被忽略,包括 url 后面的 format,只能使用字体默认名称。

B. 字体默认名称,在不同的操作系统可能不一样,以"阿里巴巴普惠体"字体测试,在简体中文 Windows 11 中字体名称为 '阿里巴巴普惠体 3.0 45 Light' 而在 Debian 12 中字体名称为 'Alibaba PuHuiTi 3.0 45 Light',并且 -fx-fongt-family 指令不支持多个字体名称,是不是要疯了。

C. 样式表中的字体名称必须有引号包围,否则依然会匹配失败。

css 复制代码
-fx-font-family: Monserrat; /*无效*/
-fx-font-family: 'Monserrat';

JavaFX CSS Reference Guide

Introduction to FXML | JavaFX 24

相关推荐
R cddddd1 小时前
Java实习面试记录
java·spring cloud·java-rocketmq
代码的余温1 小时前
Java试题-选择题(2)
java·开发语言
lemon_sjdk1 小时前
java笔记——ConcurrentLinkedQueue
java·开发语言·笔记
天天摸鱼的java工程师1 小时前
QPS 10 万,任务接口耗时 100ms,线程池如何优化?
java·后端·面试
天天摸鱼的java工程师1 小时前
掘金图片上传被拒:一次由CheckAuthenticationError引发的密钥‘失踪’迷案
java·后端
bug菌1 小时前
学生信息管理系统,真的是码农的必修课吗?
java·后端·java ee
李长渊哦1 小时前
SpringBoot中ResponseEntity的使用详解
java·spring boot·后端
超浪的晨2 小时前
Maven 与单元测试:JavaWeb 项目质量保障的基石
java·开发语言·学习·单元测试·maven·个人开发
不会理财的程序员不是好老板2 小时前
Java Spring Boot项目中集成Swagger完整步骤
java·开发语言·spring boot
不太厉害的程序员2 小时前
eclipse更改jdk环境和生成webservice客户端代码
java·ide·后端·eclipse·webservice