如何快速美化JavaFX应用：Atlantafx主题库的完整使用指南

如何快速美化JavaFX应用：Atlantafx主题库的完整使用指南 🎨

【免费下载链接】atlantafx Modern JavaFX CSS theme collection with additional controls. 项目地址: https://gitcode.com/gh_mirrors/at/atlantafx

Atlantafx是一个强大的JavaFX CSS主题集合，提供了丰富的预定义样式和额外控件，帮助开发者轻松打造现代化、高颜值的桌面应用界面。无需复杂配置，即可快速替换默认JavaFX样式，支持明暗主题切换和个性化定制。

🚀 一键安装：3种简单上手方式

Maven依赖集成（推荐）

最便捷的方式是通过Maven引入依赖，自动管理主题更新：

<dependency>
    <groupId>io.github.mkpaz</groupId>
    <artifactId>atlantafx-base</artifactId>
    <version>2.0.0</version>
</dependency>

官方配置文档：docs/docs/getting-started.md

本地CSS文件导入

无需额外依赖，直接下载编译好的CSS文件：

1. 从项目发布页获取主题包
2. 将CSS文件放入项目classpath
3. 通过代码设置样式表：

Application.setUserAgentStylesheet("path/to/atlantafx-theme.css");

Git仓库克隆

获取完整源码和示例：

git clone https://gitcode.com/gh_mirrors/at/atlantafx

🎨 内置主题展示：8种风格任你选

Atlantafx提供多种精心设计的主题，满足不同场景需求：

图：Atlantafx主题切换效果演示

主流主题预览

• Primer系列：primer-light.scss、primer-dark.scss（GitHub风格）
• Nord系列：nord-light.scss、nord-dark.scss（简约蓝调）
• Cupertino系列：cupertino-light.scss、cupertino-dark.scss（macOS风格）
• Dracula：dracula.scss（深色主题经典）

图：Cupertino Light主题效果（Alt文本：Atlantafx Cupertino Light JavaFX主题界面）

⚙️ 3步快速使用主题

第1步：设置主题样式表

在Application启动类中配置：

@Override
public void start(Stage stage) {
    // 选择主题（二选一）
    Application.setUserAgentStylesheet(new PrimerLight().getUserAgentStylesheet());
    Application.setUserAgentStylesheet(new PrimerDark().getUserAgentStylesheet());
    
    // 其余初始化代码...
}

第2步：使用额外控件

引入扩展控件库：

<dependency>
    <groupId>io.github.mkpaz</groupId>
    <artifactId>atlantafx-controls</artifactId>
    <version>2.0.0</version>
</dependency>

控件源码目录：base/src/main/java/atlantafx

第3步：运行效果

启动应用即可看到全新界面样式，所有标准JavaFX控件会自动应用主题样式。

🛠️ 高级定制：打造专属主题

颜色变量覆盖

通过CSS变量自定义主题色调：

.root:custom-theme {
    -color-bg-default: #f5f5f5; /* 背景色 */
    -color-text-default: #333333; /* 文本色 */
    /* 更多变量... */
}

颜色配置文件：styles/settings/color-vars.scss

SASS源码编译

1. 克隆主题模板仓库：

git clone https://github.com/mkpaz/atlantafx-sample-theme

2. 修改SASS变量后编译：

cd atlantafx-sample-theme
mvn compile -Pwatch  # 实时监控变化

图：Atlantafx颜色对比度检查工具（Alt文本：JavaFX主题颜色对比度检查器）

📚 资源与文档

• 官方文档：docs/docs
• 主题开发指南：docs/docs/theming.md
• 控件参考：docs/docs/reference/controls.md
• 示例项目：sampler/src/main/java/atlantafx/sampler

Atlantafx让JavaFX界面设计变得简单而优雅，无论是快速原型开发还是商业应用美化，都能满足你的需求。立即尝试，让你的Java桌面应用焕发新生！ ✨

【免费下载链接】atlantafx Modern JavaFX CSS theme collection with additional controls. 项目地址: https://gitcode.com/gh_mirrors/at/atlantafx