[js] 文档树文档置顶和设置颜色 [0.0.8 完美版]

功能

  1. 文档树中,选择文档或文件夹,右键置顶,即在父级文件夹中置顶选中的文档或文件夹。
  2. 文档树中,选择文档或文件夹,右键选择颜色,即为选中的文档或文件夹添加指定的颜色。
  3. 文档树中,右键菜单出现时,按住 shift(手机版长按置顶按钮),可以置顶到顶层(支持文档和文件夹)。
  4. 兼容 pc 版和手机版

注意:暂不支持笔记本的置顶和设置颜色。

最新版 0.0.8

  1. 增加记住顶层置顶文件夹展开状态;
  2. 修复文件夹置顶到顶层后定位不到问题;
  3. 增加置顶/取消置顶时自动定位到目标文档;
  4. 修复文档全部折叠后顶层置顶恢复后需要刷新才能显示的问题;
  5. 修复已取消的顶层置顶无法实时同步问题;
  6. 优化交互体验细节

代码

https://gitee.com/wish163/mysoft/blob/main/%E6%80%9D%E6%BA%90/%E7%BB%99%E6%96%87%E6%A1%A3%E6%A0%91%E6%96%87%E6%A1%A3%E6%B7%BB%E5%8A%A0%E9%A2%9C%E8%89%B2%E5%92%8C%E7%BD%AE%E9%A1%B6.js

效果

动画演示
r119.gif

pc 版
image.png

手机版
image.png

使用说明

参数说明

// 是否开启置顶功能,true 开启,false 不开启
const isEnableTopmost = true;

// 是否开启颜色功能,true 开启,false 不开启
const isEnableColor = true;

// 是否开启顶层置顶功能,true 开启,false 不开启
const isEnableTopmostLevel1 = true;

// 预设颜色列表,格式 {"主题":{"明暗风格":{"编码":{style:"颜色值", "description":"颜色描述"}}}},编码值必须唯一,编码修改则原来设置的颜色将失效
// "---1": {}, 代表分割线,后面的序号必须递增
// (切换主题或亮色暗色风格时自动会切换配色方案)
// 为了让目录树的颜色更突出,默认加了加粗显示(font-weight:bold 样式),如果你不需要去掉这个样式即可

let colors = { "default": { "light": { "now": { "style": "color:#1D4ED8;font-weight:bold;", "description": "NOW" }, ... }, "dark": { "now": { "style": "color:#42A5F5;font-weight:bold;", "description": "NOW" }, ... } } };

第一次运行后,会把该默认配置保存到 /data/storage/tree_colors_user_config.json 中,以后配置颜色只需要修改该文件即可,这样不受代码片段升级的影响。

也可以把 tree_colors_user_config.json 发出来与大家分享您的创意。

该配色灵感来自 @Floria233 大佬提供的配色方案,感谢 @Floria233 大佬!

see [js] 文档树文档置顶和设置颜色 [0.0.8 完美版] - Floria233 的回帖

存储文件及使用说明
  1. 修改/data/storage/tree_colors_user_config.json 文件即可修改默认配色方案(第一次运行后生成)
  2. 取消全部置顶只需删除/data/storage/tree_topmost.json 文件即可(第一次置顶时生成)
  3. 取消全部颜色只需删除/data/storage/tree_colors.json 文件即可(第一次设置颜色时生成)
  4. 取消全部顶层置顶只需删除/data/storage/tree_topmost_level1.json 文件即可(第一次设置顶层置顶时生成)
更新说明

0.0.4 版本及以前的用户升级,需要先备份好代码里的 colors 参数配置再升级。

0.0.5 及以后的用户升级,只需要备份好/data/storage/tree_colors_user_config.json 文件即可。

缘起

看到论坛小伙伴们和我都有置顶的需求,就实现了这个功能,顺便也把我想要的颜色配置也实现了。

起初本想用插件来着,后来鉴于能用就不折腾的思想,一切从简了。

分享您的配色方案

也可以把您的 tree_colors_user_config.json 配色方案贴出来与大家分享。

默认配色方案如下(切换主题或亮色暗色风格时自动会切换颜色方案)

亮色主题
image.png

image.png

image.png

暗色主题
image.png

image.png

image.png

多个风格主题,可在不同文件夹中使用不同风格样式。

旧版本(0.0.4 版)

与 0.0.5+ 的区别是不支持根据主题及明暗风格配置颜色方案。

代码

https://gitee.com/wish163/mysoft/blob/db03ef3d4206b5235ee7b85d2dd273f717b315d1/%E6%80%9D%E6%BA%90/%E7%BB%99%E6%96%87%E6%A1%A3%E6%A0%91%E6%96%87%E6%A1%A3%E6%B7%BB%E5%8A%A0%E9%A2%9C%E8%89%B2%E5%92%8C%E7%BD%AE%E9%A1%B6.js

效果

pc 版

image.png

手机版

image.png

参数说明
// 是否开启置顶功能,true开启,false不开启 const isEnableTopmost = true; // 是否开启颜色功能,true开启,false不开启 const isEnableColor = true; // 预设颜色列表,格式 {"编码":{style:"颜色值", "description":"颜色描述"}},编码值必须唯一 // 也可以把该配置贴出来与大家分享您的创意 //默认颜色组采用20种人类最易识别的颜色 see https://zhuanlan.zhihu.com/p/508870810 const colors = { "orangeRed": { style: "color:#e6194B", description: "橙红色" }, "green": { style: "color:#3cb44b", description: "绿色" }, "yellow": { style: "color:#ffe119", description: "黄色" }, ... }

鸣谢

再次感谢 @Floria233 大佬的配色灵感及提供这么多好的配色方案!

打赏作者

image.png

  • 思源笔记

    思源笔记是一款隐私优先的个人知识管理系统,支持完全离线使用,同时也支持端到端加密同步。

    融合块、大纲和双向链接,重构你的思维。

    25282 引用 • 104305 回帖
  • 代码片段

    代码片段分为 CSS 与 JS 两种代码,添加在 [设置 - 外观 - 代码片段] 中,这些代码会在思源笔记加载时自动执行,用于改善笔记的样式或功能。

    用户在该标签下分享代码片段时需在帖子标题前添加 [css] [js] 用于区分代码片段类型。

    153 引用 • 1001 回帖

相关帖子

优质回帖

欢迎来到这里!

我们正在构建一个小众社区,大家在这里相互信任,以平等 • 自由 • 奔放的价值观进行分享交流。最终,希望大家能够找到与自己志同道合的伙伴,共同成长。

注册 关于
请输入回帖内容 ...
  • stevehfut 1 1 评论 via Android

    w 佬太强了,如果能把您的 js 全聚合在一个插件里就好了(可以方便之后的更新和管理)(感觉有点费时间,若忙就算了)

    2 回复
    ❤️ 感谢打赏!空了研究研究。
    wilsons
  • 其他回帖
  • 确实有这种情况,必须要选中文档树上的文档后,右健才会出现选项。确切说:

    • 第一次直接右击文档,是有选项的;
    • 从第二次开始,直接右击就没有选项,必须选中文档后,才有选项。
    1 回复
  • wilsons

    没有问题,就这样设计的。

    优先级别是 用户配置 > 代码默认配置

    在用户配置和代码默认配置内 主题配置 > default 配置

    这里之所以叫优先级别,是不会消失,是同名会覆盖,不同名被合并。

    这种设计,主要为了以默认为蓝本,去扩展想要修改的配置,而不需要完全去重新设计。

    如果你的配置中的编码完全不同,又不希望默认配置被生效,就要删除默认配置了。


    我想了下,你说的有道理,既然第一次运行时已经把默认文件存储到配置文件了,而用户又去掉了默认配置,大概是不希望再用了。

    下个版本改进下,已有用户配置文件的情况下,代码里的默认配置就不再效了。
    (最新版已支持!)

    2 操作
    wilsons 在 2025-04-08 21:41:55 更新了该回帖
    wilsons 在 2025-03-12 09:01:00 更新了该回帖
  • Floria233 3 评论

    大大,有个奇怪的问题,应当不是 bug,只是有种奇怪的联动感,这个让我很迷惑……

    如图,实际上在大多数情况下,我应当不会给文件夹赋予颜色(靠图标来区分文件夹属性),而是给文档赋予颜色。

    image.png

    因此,我一直将二级文档树(集市有二级文档列表这个插件)的 dock 部件固定在右边,目前大大你给的 JS 片段在思源原生文档树上的操作没有问题(我没有碰到其他题主的 bug,因为我用的是 Asri,最开始那个版本就可以用),奇怪的地方在于——

    当我用了 0.0.4 这个更新后的 JS 片段后,某一个瞬间,二级文档树的右键菜单里忽然也可以直接更改文档颜色片段(之前是不可以的),然而这个事只发生了一次,之后我再在二级文档列表里调用右键菜单时,就再也没有看到过这个“更改文档颜色”选项。

    我好奇的是,大大的这个 JS 片段是可以影响到二级文档树列表的吗?还是说这反而是我操作时无意发生的某种 bug?

    另一个关注的点是,我很希望这个功能主要是发生在“二级文档树”上(原因如前,文件夹并不需要赋予太多颜色 😂 ),这个也可以通过请求开发“二级文档列表”这个插件的大大做到跟您差不多的效果吗?还是说,大大你的这个 JS 片段本来就可以融汇到“二级文档列表”右键菜单的吗?

    非常感谢您的建议和反馈!1. 关于你说在二级文档树上出现菜单项的问题,理论上应该不会,这些菜单被限制在只有在思源文档树上右键才显示的。2. 关于你说希望二级文档树上也显示相关菜单项,理论上应该可以实现的,但通常这类操作不会太频繁,在主文档树上操作应该就行了,兼容插件会带来更多复杂性,通常不会这么做,如插件更新啥的也可能导致意外产生等,暂时先不考虑吧。
    wilsons 1
    @wilsons 收到,看来果然是 bug,哈哈哈,因为只出现了那么一次。
    Floria233
    @Floria233 不清楚耶,理论上不会才对,一次性的很难排查,再出现再说吧。
    wilsons
  • 查看全部回帖