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

相关推荐
前端呆猿1 小时前
深入解析HTML5中的object-fit属性
前端·css·html5
YuTaoShao2 小时前
【LeetCode 热题 100】139. 单词拆分——(解法一)记忆化搜索
java·算法·leetcode·职场和发展
Best_Liu~3 小时前
策略模式 vs 适配器模式
java·spring boot·适配器模式·策略模式
direction__3 小时前
Java Main无法初始化主类的原因与解决方法(VsCode工具)
java·vscode
帧栈3 小时前
开发避坑指南(29):微信昵称特殊字符存储异常修复方案
java·mysql
每天的每一天3 小时前
面试可能问到的问题思考-Redis
java
路灯下的光3 小时前
用scss设计一下系统主题有什么方案吗
前端·css·scss
青云交4 小时前
Java 大视界 -- Java 大数据在智能安防人脸识别系统中的活体检测与防伪技术应用
java·大数据·生成对抗网络·人脸识别·智能安防·防伪技术·活体测试
一只小风华~4 小时前
CSS @media 媒体查询
前端·css·媒体
学习至死qaq4 小时前
信创产品TongLinkQ安装及springboot2整合使用
java·东方通·tonglinkq