Skip to content

0.3.1

Choose a tag to compare

@github-actions github-actions released this 07 Aug 04:10
· 24 commits to master since this release

[0.3.1] 2026-08-07

🚀 Added

  • Flexible background image values: Accept complete CSS background-image expressions such as var(--image), remote url(...) values, and gradients, with syntax validation and a privacy notice for remote image hosts.

⚡ Changed

  • Ready-to-use image references: Store the built-in background as an imageValue and make random selection insert var(--name) so copied local image references can be pasted directly.
  • Obsidian DOM helpers: Create dynamic style and diagnostics elements with Obsidian's createEl and createDiv helpers for API compliance.
中文说明(点击展开)

🚀 新增

  • 灵活的背景图片值:支持填写完整的 CSS background-image 表达式,例如 var(--image)、远程 url(...) 和渐变,并提供语法校验与远程图片隐私提示。

⚡ 变更

  • 可直接使用的图片引用:内置背景改为保存 imageValue,随机选择会直接填入 var(--name),复制的本地图片引用可以直接粘贴使用。
  • Obsidian DOM 辅助方法:动态样式和诊断元素改用 Obsidian 的 createElcreateDiv,符合官方 API 规范。

[0.3.0] 2026-08-06

🚀 Added

  • Built-in background image: Apply an enabled local image variable to the Obsidian canvas with random selection, opacity, blend mode, size, position, repeat, and attachment controls.
  • Background filters: Adjust the background image layer with CSS filters — brightness, contrast, saturation, grayscale, sepia, invert, hue rotate, and blur — from the new Appearance sub-page.

⚡ Changed

  • Declarative settings on Obsidian 1.13: The settings tab now uses the declarative settings API introduced in Obsidian 1.13.0, raising the minimum required Obsidian version to 1.13.0. Background display options (opacity, blend mode, size, position, repeat, attachment) and filters are grouped together in an Appearance sub-page under Background image.

🐛 Fixed

  • Resource variable publishing: Publish vault resource variables in a dedicated stylesheet so they remain available to computed-style consumers without modifying the html element's inline style.
  • Resource variable preview: Read computed styles when validating image variables, keeping the settings preview working with stylesheet-published variables.
中文说明(点击展开)

🚀 新增

  • 内置背景图片:将已启用的本地图片变量直接应用到 Obsidian 画布,支持随机选择、不透明度、混合模式、尺寸、位置、重复方式和附着方式设置。
  • 背景滤镜:在新的「外观」子页面中使用 CSS 滤镜调整背景图片图层——亮度、对比度、饱和度、灰度、褐色、反色、色相旋转和模糊。

⚡ 变更

  • 基于 Obsidian 1.13 的声明式设置:设置页改用 Obsidian 1.13.0 引入的声明式设置 API,最低所需 Obsidian 版本提升至 1.13.0。背景显示选项(不透明度、混合模式、尺寸、位置、重复方式、附着方式)与滤镜一同归入「背景图片」下的「外观」子页面。

🐛 修复

  • 资源变量发布:将库内资源变量发布到专用样式表中,使其可被计算样式读取,同时避免修改 html 元素的内联样式。
  • 资源变量预览:校验图片变量时读取计算样式,确保变量改用样式表发布后设置页预览仍能正常工作。