slint-pixel
基于 Rust + Slint 1.18.0 的像素风可复用组件库:16×16 像素画板 widget、 自绘像素标题栏,以及一套常用像素风控件;附带组件画廊与画板演示程序。
-
主仓:自托管 walgit(本机
http://127.0.0.1:8081/gqf2008/slint-pixel.git,remoteorigin) -
镜像 / 发版:https://github.com/gqf2008/slint-pixel(remote
github,由 walgit 自动单向同步,只读) -
许可证:MIT
-
可复用:所有组件通过
@slint_pixel导入到任意 Slint 项目(见下方组件清单)。 -
一键接线:Rust 侧调用
install_painter()/install_title_bar_controls(), 画/擦、清空、导出 PNG、窗口控制全部自动接好。 -
自绘像素标题栏:无系统边框(
no-frame),可拖拽、双击最大化,右侧最小化/最大化/关闭; Slint 1.18 起可设native-move: true把移动交给平台(拖动超过阈值才启动、单击不移动,宿主无需 Rust 接线)。 -
像素画布:16×16 网格,格子放大 24px 显示(棋盘格 + 网格线 + 立体像素块)。
-
PICO-8 色板:16 色,点击选色;画笔 1×1 / 2×2 / 3×3;左键画、右键擦除。
-
导出:一键保存为网格分辨率 PNG(透明背景),存到当前工作目录。
-
跨平台:仅依赖
slint+image(纯 Rust),无平台特定代码。

最新特性(0.2.4,未发布)
- 圆角主题:
PixelTheme.radius(默认0px)/radius-sm(默认 =radius / 2)。 全库 130+ 个可见表面(卡片、面板、按钮、输入框、下拉、表格、对话框、标签…)都接了这两个 token, 默认 0px,既有宿主升级零外观变化;宿主要圆角只需一行。 - 圆角窗口(可选):
PixelTheme.window-radius(默认0px= 直角窗口)+ 库组件PixelWindowBody(透明边距 + 圆角 + 描边 + 把内容 clip 在圆角内),Rust 侧一行slint_pixel::transparent_window()打开透明窗口即可,见下方「圆角窗口(可选,三步)」。 - 描边只有一个值:
PixelTheme.border-width(默认 2px)——所有组件(容器/覆盖层、按钮、菜单、表格、 树、列表、日历、看板、编辑器、图表、媒体,以及输入类与复选/开关/标签等小件)连同组件内部的线框全部读它, 改一处全库一起变;单个组件仍可用自己的border-width属性覆盖。 - 一行换整套观感(10 套内置预设):
PixelPresets.classic()/soft()/dark()/forest()/ocean()/sakura()/sunset()/grape()/nord()/terminal()—— 预设同时改语义色、圆角与描边,普通用户选一个名字就够:
每套预设的完整 token 配置与调优说明见 docs/themes.md(高级用户)。import { PixelPresets } from "@slint_pixel"; init => { PixelPresets.soft(); } // 暖米底 + 墨黑描边 + 暖黄主色 + 8px 圆角 // 选择器 UI 直接遍历:for name[i] in PixelPresets.names : PixelButton { text: PixelPresets.labels[i]; ... } - 语义色扩展:新增
success/warning/info/on-accent(accent面上的前景色) 与on-ink(深墨面上的恒白前景)/scrim(模态遮罩)。PixelAlert现在按kind显示语义色(信息蓝 / 成功绿 / 警告琥珀 / 错误红); 选中行、勾选标记、开关滑块统一走on-accent,顺带修掉深色主题下"白字压白底"的选中态。 - 统一风格模版:库内全部皮肤色(面 / 文字 / 描边 / 遮罩 / 选中态)只出自
PixelThemetoken 与十预设,换预设或改 token 即全库换肤;唯一的硬编码色值豁免是内容数据 (二维码/条码符号色、取色器默认数据、画板 PICO-8 品牌色),由no_hardcoded_colors_outside_theme_files守卫逐行登记防回潮。 - 可复现的视觉验证:
cargo test -p slint-pixel --test theme_radius用软件渲染器把同一场景渲染两次, 断言圆角真的改变了四角像素(阳性对照:把组件改回不读主题即报红);另有覆盖守卫防止新增组件漏接圆角。cargo run -p slint-pixel-demo --example render_gallery -- <目录>可无头导出各预设截图(docs 里的图就是这么来的)。

十套预设同一套组件、同一套 2px 描边(仅配色/圆角不同),cargo run 默认 soft:
| classic 经典 | soft 柔彩(默认) | dark 深色 | forest 森林 | ocean 海洋 |
|---|---|---|---|---|
![]() |
![]() |
![]() |
![]() |
![]() |
| sakura 樱花 | sunset 落日 | grape 葡萄 | nord 北欧 | terminal 终端 |
![]() |
![]() |
![]() |
![]() |
![]() |
最新特性(v0.3.0)
- 10 套内置主题预设:
classic()经典 /soft()柔彩 /dark()深色 /forest()森林 /ocean()海洋 /sakura()樱花 /sunset()落日 /grape()葡萄 /nord()北欧 /terminal()终端。普通用户PixelPresets.apply("sakura")一行换肤; 高级用户看 docs/themes.md——每套 20 个 token 的完整取值、 角色说明与调优指引(names/labels平行清单供选择器 UI 遍历)。 - 主题纯净化:库内全部皮肤色只出自
PixelThemetoken 与预设——46 处硬编码色值 收编为语义引用,新增on-ink(深墨面恒白前景)/scrim(模态遮罩)两枚 token; 深色预设的灰蓝孤岛全部随主题变暗。守卫no_hardcoded_colors_outside_theme_files逐行登记仅有的内容数据豁免(QR/条码符号、 取色器数据、PICO-8 品牌色),改动即变红强制复审。 - 统一 2px 线框:全部可见线宽由
PixelTheme.border-width(默认 2px)一个值驱动; 出血阴影写法全库清除;Slint 默认border-color=transparent导致的"边框消失"类 回归由守卫every_border_has_explicit_color钉死。 - 预设覆盖守卫:
every_preset_writes_every_token钉死每套预设写全 20 个 token (漏写回落 scheme 默认值、拼错被编译器拒、labels 平行与未登记函数也现形)。 - 主题编辑器升级:预设区换成 10 键选择网格(当前预设高亮),窗身圆角随主题圆角 自动开关;三个窗口(画廊/画板/编辑器)同一 apply 调度,不再各写各的。
v0.2.3
- 可统一配置的控件描边:
PixelTheme.border-width(默认 2px)和PixelTheme.primary-border-width(默认 3px)。宿主统一设成 1px 可消除卡片、按钮、 输入框之间“有粗有细”的混搭;不设置时保持原有像素风外观。 - Slint 1.18:依赖升到 slint / slint-build 1.18.0(上游生成代码更瘦 —— 编译更快、二进制更小),
并适配 1.18 的兼容性变更(
Flickable/ScrollView的viewport-*更名为content-*)。 - 可选原生窗口移动:
PixelTitleBar { native-move: true; }(成品窗口用PixelPainterWindow::set_native_move(true))改用 Slint 1.18 的WindowMoveArea把拖动交给平台—— 拖动超过阈值才启动、单击不移动,宿主无需 Rust 接线。默认关闭,既有宿主行为不变。 - 暗色主题:设置
PixelTheme.scheme = "dark"即可一键切换全部组件配色;画廊里有“切到暗色 / 切回浅色”按钮。 - 对话框可拖动:
PixelDialog支持按住标题栏拖动。 - 高级组件:图表、专业表格、虚拟滚动、校验、排期、向导、看板、甘特、地图、媒体、PDF/条码/验证码等(详见组件清单)。
- 交互增强:
PixelTransferPro搜索、PixelKanbanPro拖拽、PixelDataGrid列宽拖拽。 - UI 组件测试:compile smoke 覆盖
@slint_pixel全部组件编译,另有标题栏拖动的契约/行为守卫 (cargo test -p slint-pixel)。
文档
- 组件 API 文档与示例:全部组件属性、回调与用法示例。
组件清单
所有组件都是 in/in-out 属性 + 回调,宿主可覆盖主题色,无系统依赖、跨平台。
| 组件 | 说明 |
|---|---|
PixelPainter |
16×16 像素画板 widget(画布 + 色板 + 工具栏 + 状态栏) |
PixelTitleBar |
可拖拽像素标题栏(拖拽/最小化/最大化/关闭回调;可选 native-move 由平台负责移动) |
PixelButton |
像素按压按钮(按下下沉效果) |
PixelCheckBox |
复选框(像素勾选 + 文字标签) |
PixelSwitch |
开关(滑块滑动动画) |
PixelSlider |
滑块(拖拽取值,min/max,changed(value) 回调) |
PixelTextInput |
单行文本输入(占位符 + 焦点高亮 + accepted/edited) |
PixelProgressBar |
进度条(0..1,可选百分比文字) |
PixelBadge |
徽章/标签 |
PixelPanel |
分组面板(标题 + 内容插槽 @children) |
PixelDialog |
模态对话框(遮罩 + 标题 + 内容插槽 + 确定/取消) |
PixelRadioButton |
单选框(独立使用) |
PixelRadioGroup |
单选框组(互斥,options 数据驱动) |
PixelComboBox |
下拉选择框(PopupWindow,open 可控) |
PixelMenu |
下拉菜单("---" 项渲染分隔线) |
PixelTableView |
表格(表头 + 数据行 + 选中行回调) |
PixelScrollPanel |
滚动面板(基于 Slint 内置 ScrollView,滚轮/拖拽原生) |
PixelCollapsible |
可折叠面板(高度动画) |
PixelAccordion |
手风琴(titles/contents 数据驱动,互斥展开) |
PixelSidebar |
侧边栏(导航项 + 选中态 + 内容区 @children) |
PixelText / PixelTitle |
像素风文本 / 标题(统一字号) |
PixelForm / PixelFormItem |
表单容器 / 表单项(左标签 + 右控件插槽) |
PixelTextArea |
多行文本输入(换行 + 占位符) |
PixelIconButton |
图标按钮(通用字形图标 + 悬停高亮) |
PixelTooltip |
悬停提示气泡(延迟显示,包裹任意目标) |
PixelBubble |
富内容气泡/弹出卡片(触发图标 + 箭头 + 内容插槽) |
PixelPopconfirm |
操作确认气泡(触发按钮 + 确定/取消) |
PixelAlert |
警告/提示条(info/success/warning/error,可关闭) |
PixelToast |
通知(自动消失 + 手动关闭) |
PixelSpinner |
加载动画(像素方块循环) |
PixelSkeleton |
骨架屏(加载占位条,呼吸动画) |
PixelTabs |
标签页(数据驱动 + 激活态) |
PixelBreadcrumb |
面包屑(路径导航) |
PixelPagination |
分页(上一页/下一页 + 页码) |
PixelDrawer |
抽屉(右侧滑出 + 遮罩 + 内容插槽) |
PixelAvatar |
像素头像(方块 + 字形/首字) |
PixelTag |
标签(可关闭) |
PixelCard |
卡片(可选标题 + 内容插槽) |
PixelNavbar |
顶栏导航(品牌 + 菜单项 + 右侧插槽) |
PixelEmpty |
空状态(图标 + 标题 + 描述 + 操作插槽) |
PixelDivider |
分隔线(可带文字) |
PixelStat |
统计卡片(大数字 + 标签 + 变化) |
PixelWindowResize |
无边框窗口缩放热区(四边/四角,配合 install_window_resize) |
PixelTheme |
全局主题(bg/panel/hover/edge/border-soft/shadow/text/dim/accent/danger 语义色 + success/warning/info + on-accent/on-ink/scrim + primary-face/primary-text + border-width/primary-border-width + radius/radius-sm/window-radius,改一处全部组件实时换肤) |
PixelPresets |
内置 10 套预设:classic() 经典 / soft() 柔彩 / dark() 深色 / forest() 森林 / ocean() 海洋 / sakura() 樱花 / sunset() 落日 / grape() 葡萄 / nord() 北欧 / terminal() 终端;另有 apply(name) 按名调度与 names/labels 清单供选择器遍历,一行切换颜色 + 圆角 |
PixelWindowBody |
圆角窗身:透明边距 + 圆角 + 描边 + 内容按圆角裁切;window-radius = 0 时等价于旧的全出血观感 |
Swatch |
像素风色块(也可作图标按钮右上角数字角标) |
扩展组件(ROUND 2)
| 组件 | 说明 |
|---|---|
PixelSegmentedControl |
分段控制器(互斥选项) |
PixelSteps |
步骤条(数据驱动,可点击) |
PixelNumberInput |
数字步进输入框 |
PixelSelect |
多选下拉 |
PixelSwatchGroup / PixelColorPicker |
色板组 / 简单取色器 |
PixelContextMenu |
右键/受控上下文菜单 |
PixelRangeSlider |
双滑块范围选择 |
PixelTree / PixelTreeSelect |
树 / 树形下拉 |
PixelTransfer |
双栏穿梭框 |
PixelUpload |
上传/文件选择视觉组件 |
PixelTimeline |
时间线 |
PixelCarousel |
轮播 |
PixelSplitPane |
可拖拽分栏 |
PixelDatePicker / PixelTimePicker |
日期 / 时间选择 |
PixelCommandPalette |
命令面板 |
PixelKanban |
看板 |
PixelOnboarding |
分步引导 |
PixelImage / PixelImageViewer |
像素图片 / 图片查看器 |
PixelTagInput |
标签输入 |
PixelAutoComplete |
自动补全 |
PixelCascader |
级联选择 |
PixelDateRangePicker |
日期范围选择 |
PixelRating |
评分 |
PixelDescriptionList |
描述列表 |
PixelResult |
结果页 |
PixelAvatarGroup / PixelList / PixelVirtualList |
头像组 / 列表 / 虚拟列表 |
PixelTreeTable / PixelDataTable |
树形表格 / 数据表格 |
PixelSearchBox / PixelNotificationCenter |
搜索框 / 通知中心 |
PixelSubMenu |
二级菜单 |
PixelBackTop / PixelAffix / PixelSticky |
回到顶部 / 固钉 / 吸顶 |
PixelRichTextEditor / PixelCodeBlock |
富文本编辑器 / 代码块 |
PixelImageCrop / PixelQRCode / PixelWatermark / PixelCalendar |
图片裁切 / 二维码 / 水印 / 日历 |
高级组件(ROUND 3)
| 组件 | 说明 |
|---|---|
PixelChart / PixelSparkline |
柱状图 / 迷你趋势图 |
PixelDataGrid / PixelProTable |
专业数据表格 / Pro 表格 |
PixelVirtualScroll |
虚拟滚动列表 |
PixelTreePro |
树(levels + expanded 受控) |
PixelFormValidator |
表单校验器 |
PixelScheduler / PixelCalendarAgenda |
排期器 / 日历议程 |
PixelWizard / PixelMultiStepForm |
向导 / 多步表单 |
PixelTransferPro / PixelKanbanPro |
穿梭框 Pro / 看板 Pro |
PixelCommandPalettePro / PixelColorPickerPro |
命令面板 Pro / 取色器 Pro |
PixelMention / PixelOTPInput / PixelSignature |
提及 / 验证码 / 手写签名 |
PixelDrawerPro |
抽屉 Pro |
PixelOrgChart / PixelFlowChart / PixelMindMap |
组织架构 / 流程图 / 思维导图 |
PixelGantt / PixelMap / PixelGeo |
甘特图 / 地图 / 地理 |
PixelVideoPlayer / PixelAudioPlayer |
视频 / 音频播放器 |
PixelPDFViewer / PixelPrintPreview |
PDF 预览 / 打印预览 |
PixelBarcode / PixelCaptcha |
条码 / 图形验证码 |
主题:默认是 纯白 + 直角(纯白底 + 近黑边框 + 纯黑文字,主色黑白,功能色保留 danger 红 / success 绿 / warning 琥珀 / info 蓝;PICO-8 绘画色板不变)。想换柔和观感用
PixelPresets.soft()。 一键换肤:所有组件默认色引用全局PixelTheme(九色语义),改一处全部生效; 画廊里点 主题编辑器 可调色/切预设,点 一键生成样式 直接产出.slint覆盖代码。PixelButton支持variant(default/primary/danger/ghost)与size(small/medium/large),对齐 Tailwind 按钮语义。 所有组件主题色均为in属性,宿主可在.slint里整体覆盖为深色或任意配色。
提示:提示气泡请直接用 Slint 内置
Tooltip(延迟出现、自动跟随指针):PixelButton { text: "悬停"; Tooltip { text: @markdown("**提示文字**"); } }在盒布局中放置组件时,未显式给
width的组件会拉伸占满剩余空间, 需要固定宽度的场景请显式指定(如PixelButton { width: 90px; })。
运行演示
启动后打开 组件画廊(展示全部常用控件),点画廊里的 打开像素画板 → 可打开画板窗口。窗口为无边框自绘标题栏,四边/四角可直接拖拽缩放,标题栏可拖动/最小化/最大化/关闭。
结构(workspace)
crates/
├── slint-pixel/ # 组件库(lib)
│ ├── ui/lib.slint # @slint_pixel 汇总入口(re-export 全部组件)
│ ├── ui/pixel_theme.slint # 全局主题 PixelTheme(语义色 + 描边 + 圆角)
│ ├── ui/pixel_presets.slint # 内置预设 PixelPresets(classic / soft / dark)
│ ├── ui/pixel_painter_widget.slint # 画板 + 标题栏 + 按钮 + 色块
│ ├── ui/pixel_widgets.slint # 基础控件:复选/开关/滑块/输入/进度/徽章/面板/对话框
│ ├── ui/pixel_complex.slint # 进阶控件:单选/下拉/菜单/表格/滚动/手风琴/侧边栏
│ ├── ui/pixel_extra.slint # 表单/文本/输入/图标按钮/提示/气泡/确认
│ ├── ui/pixel_tailwind.slint # 对齐 Tailwind:警告/通知/加载/骨架/标签页/面包屑/分页/抽屉/头像/卡片/顶栏/空状态/统计
│ ├── ui/pixel_painter_window.slint # 成品窗口 PixelPainterWindow
│ ├── ui/pixel_more.slint # ROUND 2 扩展组件(分段/步骤/数字/选择/取色/上下文菜单)
│ ├── ui/pixel_p1.slint # ROUND 2 扩展组件(范围/树/穿梭/上传/时间线/轮播/分栏)
│ ├── ui/pixel_p2.slint # ROUND 2 扩展组件(日期/时间/命令/看板/引导)
│ ├── ui/pixel_p3.slint # ROUND 2 扩展组件(图片/标签/联想/级联/评分/描述/结果)
│ ├── ui/pixel_p4.slint # ROUND 2 扩展组件(列表/数据表格/搜索/通知/菜单/吸顶)
│ ├── ui/pixel_p5.slint # ROUND 2 扩展组件(富文本/代码/裁切/二维码/水印/日历)
│ ├── ui/pixel_p6.slint # ROUND 3 高级组件(图表/表格/虚拟滚动/树/校验/排期)
│ ├── ui/pixel_p7.slint # ROUND 3 高级组件(向导/穿梭/看板/命令/提及/签名)
│ ├── ui/pixel_p8.slint # ROUND 3 高级组件(架构/流程/甘特/地图/媒体/PDF/条码)
│ └── src/
│ ├── lib.rs # library_paths()、接线 trait/宏、install_painter() 等
│ └── canvas.rs # 画布数据、放大渲染、PNG 导出(含单元测试)
└── slint-pixel-demo/ # 演示程序(bin,作为下游消费者组装窗口)
├── ui/gallery.slint # 组件画廊窗口
├── ui/theme_editor.slint # 主题编辑器(一键换肤 + 生成样式代码)
├── ui/main.slint # 画板窗口(通过 @slint_pixel 组装)
└── src/main.rs # 接线:install_painter / install_title_bar_controls / 打开画板
在其它 Slint 项目里复用
1. 添加依赖
从 crates.io 引入(推荐):
[]
= "1.18"
= "0.2.3"
[]
= "1.18"
= "0.2.3"
也可以直接从 GitHub 引入:
[]
= "1.18"
= { = "https://github.com/gqf2008/slint-pixel" }
[]
= "1.18"
= { = "https://github.com/gqf2008/slint-pixel" }
本地开发时也可用 path 引入:
[]
= "1.18"
= { = "path/to/slint-pixel/crates/slint-pixel" }
[]
= "1.18"
= { = "path/to/slint-pixel/crates/slint-pixel" }
2. 在 build.rs 注册 @slint_pixel 库并编译自己的 UI
3. 在 ui/main.slint 里导入组件并组装
import { PixelPainter, PixelTitleBar } from "@slint_pixel";
export component MainWindow inherits Window {
no-frame: true;
preferred-width: 720px;
preferred-height: 560px;
in-out property <image> canvas-image;
in-out property <string> status-text: "就绪";
callback paint(length, length, bool);
callback clear-canvas();
callback save-png();
callback drag-start();
callback minimize();
callback toggle-maximize();
callback close-window();
VerticalLayout {
padding: 12px;
spacing: 10px;
PixelTitleBar {
title: "我的像素窗口";
drag-start => { root.drag-start(); }
minimize => { root.minimize(); }
toggle-maximize => { root.toggle-maximize(); }
close-window => { root.close-window(); }
}
PixelPainter {
canvas-image <=> root.canvas-image;
status-text <=> root.status-text;
paint(px, py, erase) => { root.paint(px, py, erase); }
clear-canvas => { root.clear-canvas(); }
save-png => { root.save-png(); }
}
}
}
完整参考:crates/slint-pixel-demo/ui/main.slint 与 crates/slint-pixel-demo/ui/gallery.slint。
4. Rust 侧一键接线
include_modules!;
// 把生成的 MainWindow 适配到组件库契约(一行宏,无需手写胶水代码)
impl_painter_ui!;
impl_title_bar_ui!;
不想写 .slint?直接用成品窗口
自定义主题
控件描边默认沿用 PixelTheme.border-width = 2px / primary-border-width = 3px;
如果宿主希望全部控件统一为细边框,可在根组件初始化时设为 1px,避免卡片、按钮、
输入框之间出现粗细混搭。
圆角 / 柔彩配色
默认外观是直角像素风(radius: 0px),不设置就没有任何变化。想要柔和一点的观感,两选一:
import { PixelPresets, PixelTheme } from "@slint_pixel";
init => {
// ① 一条命令切整套:颜色 + 圆角 + 描边
PixelPresets.soft(); // 10 套预设任选,或 PixelPresets.apply("sakura")
// ② 或者只调圆角,颜色保持自己的主题
PixelTheme.radius = 10px; // 卡片/面板/输入框/对话框等容器
// PixelTheme.radius-sm 默认自动 = radius / 2(复选框、开关、标签、滑块等小件)
}
圆角是主题级的:radius 给容器与大面积表面,radius-sm 给小件;单个组件仍可用
border-radius 属性单独覆盖。预设只写 PixelTheme,所以预设之后再覆盖个别 token 也没问题。
radius-sm 默认绑定 radius / 2(预设与画廊的圆角档位都只写 radius),所以改一个值小件就自动跟随;
只有宿主显式给 radius-sm 赋过值,这个派生才会断开。
配色上,除 danger 外又补了 success / warning / info 三个功能色(PixelAlert 按 kind 取用),
以及 on-accent —— 它表示"accent 底之上的前景色",选中行文字、勾选标记、开关滑块都用它,
这样把 accent 换成暖黄之类的亮色时不会出现白字压白底。on-ink 是"深墨面(shadow/edge 底)
之上的恒白前景",选中行、标签、气泡、码块等压深底的字都用它;scrim 是模态遮罩的半透明黑。
想回到纯黑白,把这几个色设回
PixelTheme.text / PixelTheme.edge 即可(或直接 PixelPresets.classic())。
所有组件暴露 in 主题属性(如 PixelPainter 的 page / panel / panel-light / edge / shadow / text-color / dim / highlight / danger 与 palette;PixelSlider 的
track / fill / thumb / border / shadow 等),宿主可在 .slint 里直接覆盖。
描边只有一个值
PixelTheme.border-width = 2px; // 默认;所有组件与组件内部的线框都读它
PixelTheme.primary-border-width = 2px; // primary 按钮,默认与普通按钮同宽
改粗细只改这一处(想全库更细就都设成 1px);某个组件要单独强调,用该组件自己的 border-width 属性覆盖即可。
圆角窗口(可选,三步)
无边框窗口默认是直角矩形;要让窗口本身也圆角(内部圆角配方角外框会显得不协调),三步:
// 1) 打开透明窗口(必须在创建任何窗口之前设置 backend)
new
.with_winit_window_attributes_hook
.select?;
// 2) 窗口底色透明 + 3) 内容包进 PixelWindowBody
import { PixelWindowBody, PixelTheme } from "@slint_pixel";
export component App inherits Window {
no-frame: true;
background: transparent;
init => { PixelTheme.window-radius = 12px; } // 0px(默认)= 直角窗口、全出血
PixelWindowBody {
VerticalLayout { /* 标题栏 + 你的内容 */ }
}
}
window-radius > 0 时 PixelWindowBody 四周留 3px 透明边距、按 border-width 描边,
并把内容裁在圆角内(自绘标题栏会顺着圆角切);window-radius = 0 时边距与描边都为 0,
与旧版一样铺满窗口。没开透明窗口就设 window-radius > 0,圆角外那圈边距会显示成黑边,
所以库预设(PixelPresets.*)不碰 window-radius,由宿主自己决定。
窗口拖动的两种接法(native-move)
默认(native-move: false)沿用老契约:标题栏按下 → drag-start 回调 → 宿主调用
install_title_bar_controls()(内部是 winit drag_window())。已有宿主不用改。
宿主只写 .slint、不想接 Rust 时,可以把移动交给 Slint 1.18 的 WindowMoveArea:
PixelTitleBar {
title: "我的像素窗口";
native-move: true; // 移动由平台完成(拖动超过阈值才启动、单击不移动);此时 drag-start 不再触发
minimize => { root.minimize(); }
toggle-maximize => { root.toggle-maximize(); }
close-window => { root.close-window(); }
}
成品窗口同样支持 ui.set_native_move(true)(PixelPainterWindow 已直通该属性)。
开启后不要再依赖 drag-start:同一次拖动若既走平台移动又调用 drag_window(),会重复发起。
平台支持:winit 后端(Windows / macOS / X11 / Wayland)与 Qt;其它后端下该元素是空操作。
实现细节:WindowMoveArea 必须包住标题栏内容(容器形态)。同层兄弟形态下,全宽 TouchArea 的鼠标抓取会
抢先中止同层派发,表现为"配了 native-move 但窗口纹丝不动";仓库内用结构守卫 + 事件路由断言防回归
(cargo test -p slint-pixel --test title_bar_native_move)。副作用:从右侧按钮上按下并拖过阈值也会移动窗口
(上游容器语义)。
验证口径:start_window_move() 只在 Slint 内核内部 trait 上,公开 API 断言不了"平台移动是否被发起"
(testing backend 的计数入口仅在 internal feature 下公开),该项在本仓由审查方用本地补丁版 backend 实测
(兄弟形态计数 0 / 容器形态拖动 40px 后计数 1)。建议升级后跑一次真机检查:cargo run 起 demo,
按住标题栏拖动看窗口是否移动,且单击标题栏不应移动窗口。
操作(画板)
| 操作 | 说明 |
|---|---|
| 左键拖动画布 | 用当前颜色/笔刷作画 |
| 右键拖动画布 | 擦除 |
| 点击色板 | 选择颜色 |
| 画笔 / 橡皮擦 | 切换工具 |
| 1×1 / 2×2 / 3×3 | 切换笔刷大小 |
| 清空 | 清空画布 |
| 存 PNG | 导出 pixel-art-<时间戳>.png |
| 标题栏拖拽 | 移动窗口 |
| 标题栏双击 | 最大化 / 还原 |
| 标题栏右侧按钮 | 最小化 / 最大化 / 关闭 |
说明
- Slint 在 crates.io 上最新稳定版为 1.18(无 0.18 版本线)。
- Linux Wayland 下合成器可能强制保留系统装饰,
no-frame效果取决于合成器。 - 高 DPI(150%)显示器下按物理像素渲染,画布仍保持像素锐利。
install_painter导出的 PNG 保存在进程当前工作目录。- 组件清单已对齐 Tailwind 常见 UI:按钮/表单/反馈/导航/数据展示/覆盖层均已覆盖;仍需按需扩展的:日期选择器、上传、时间线等,可在
pixel_tailwind.slint里继续追加(组件均遵循同一黑白像素风主题约定)。








