API 获取并处理块的一些疑问

因为突然想要写一个插件来帮我格式化一下普通的内容块,所以今天研究了一个晚上的插件开发和 api,现在发现内容块 API 有点问题不好理解,希望各位能帮我解答一二。

  1. 在更新块 API 里支持两种模式:markdownDOM。不过这两种元素我感觉都不是很好获取。
    1. 使用 api 能获取的是 kramdown,这个会带有 {: updated id} 属性,要是用 markdown 再发回去就会当成普通的文字放进去。
    2. DOM 也不算好获取,从块标里面的插件按钮获取到的结果是不带 HTML 的,没法获取当前元素的 html。这样难道只能用 ts 去页面里获取吗?
  2. 获取了 kramdown 之后,如果要更新块一定要去掉 {: updated id} 这个属性吗,有没有可能不处理这个属性也不影响文本显示的办法?
  3. 有可能通过 api 获取到当前块的 dom?或者获取到当前块的类型?
  4. 还在继续思考中...感谢各位的帮助。如果想要先行了解代码可以先在这里了解最新的进度。目前通过 ai 暂时解决了 {: updated id} 属性,不过这个方法不算好,也希望各位能帮我提出一些建议。
  • 思源笔记

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

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

    23020 引用 • 92599 回帖
  • Q&A

    提问之前请先看《提问的智慧》,好的问题比好的答案更有价值。

    8449 引用 • 38491 回帖 • 155 关注
被采纳的回答
  • "/api/block/insertBlock" "/api/block/updateBlock" 可以传入 kramdown。 内容与属性需要用 '\n' 来隔开。

    id updated 可以不用去掉。 如果你要插入新的块,需要生成新的 id 避免重复。

    "/api/block/getBlockDOM" 可以按块 id 读取 dom.

    "/api/transactions" 可以按 dom 来更新或者插入等。

    另外, dom 与 markdown 的转换可以用:
    export const NewLute: () => Lute = (globalThis as any).Lute.New;

    lute = NewLute();

    const md = lute.BlockDOM2Md(div.outerHTML);

    export class Lute {
        public static WalkStop: number;
        public static WalkSkipChildren: number;
        public static WalkContinue: number;
        public static Version: string;
        public static Caret: string;
    
        public static New(): Lute;
    
        public static EChartsMindmapStr(text: string): string;
    
        public static NewNodeID(): string;
    
        public static Sanitize(html: string): string;
    
        public static EscapeHTMLStr(str: string): string;
    
        public static UnEscapeHTMLStr(str: string): string;
    
        public static GetHeadingID(node: ILuteNode): string;
    
        public static BlockDOM2Content(html: string): string;
    
        private constructor();
    
        public BlockDOM2Content(text: string): string;
    
        public BlockDOM2EscapeMarkerContent(text: string): string;
    
        public SetSpin(enable: boolean): void;
    
        public SetTextMark(enable: boolean): void;
    
        public SetHTMLTag2TextMark(enable: boolean): void;
    
        public SetHeadingID(enable: boolean): void;
    
        public SetProtyleMarkNetImg(enable: boolean): void;
    
        public SetSpellcheck(enable: boolean): void;
    
        public SetFileAnnotationRef(enable: boolean): void;
    
        public SetSetext(enable: boolean): void;
    
        public SetYamlFrontMatter(enable: boolean): void;
    
        public SetChineseParagraphBeginningSpace(enable: boolean): void;
    
        public SetRenderListStyle(enable: boolean): void;
    
        public SetImgPathAllowSpace(enable: boolean): void;
    
        public SetKramdownIAL(enable: boolean): void;
    
        public BlockDOM2Md(html: string): string;
    
        public BlockDOM2StdMd(html: string): string;
    
        public SetSuperBlock(enable: boolean): void;
    
        public SetTag(enable: boolean): void;
    
        public SetInlineMath(enable: boolean): void;
    
        public SetGFMStrikethrough(enable: boolean): void;
    
        public SetGFMStrikethrough1(enable: boolean): void;
    
        public SetMark(enable: boolean): void;
    
        public SetSub(enable: boolean): void;
    
        public SetSup(enable: boolean): void;
    
        public SetInlineAsterisk(enable: boolean): void;
    
        public SetInlineUnderscore(enable: boolean): void;
    
        public SetBlockRef(enable: boolean): void;
    
        public SetSanitize(enable: boolean): void;
    
        public SetHeadingAnchor(enable: boolean): void;
    
        public SetImageLazyLoading(imagePath: string): void;
    
        public SetInlineMathAllowDigitAfterOpenMarker(enable: boolean): void;
    
        public SetToC(enable: boolean): void;
    
        public SetIndentCodeBlock(enable: boolean): void;
    
        public SetParagraphBeginningSpace(enable: boolean): void;
    
        public SetFootnotes(enable: boolean): void;
    
        public SetLinkRef(enable: boolean): void;
    
        public SetEmojiSite(emojiSite: string): void;
    
        public PutEmojis(emojis: IObject): void;
    
        public SpinBlockDOM(html: string): string;
    
        public Md2BlockDOM(html: string): string;
    
        public SetProtyleWYSIWYG(wysiwyg: boolean): void;
    
        public MarkdownStr(name: string, md: string): string;
    
        public GetLinkDest(text: string): string;
    
        public BlockDOM2InlineBlockDOM(html: string): string;
    
        public BlockDOM2HTML(html: string): string;
    
        public HTML2Md(html: string): string;
    
        public HTML2BlockDOM(html: string): string;
    }
    

欢迎来到这里!

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

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

    /api/transactions 的参数是只有 HTML 还是同时兼容 markdown 呢

    只有 html
    player
  • 其他回帖
  • 一般没必要使用/api/transactions 这个 api 吧,这个 api 的使用场景应该是那些需要事务的操作,比如多个操作保证原子性。

    image.png

    1 回复
  • 数据库的,有些可能不通用。

     transSetAttrViewColWrap(avID: string, blockID: string, colID: string, wrap = true) {
            const op = {} as IOperation;
            op.action = "setAttrViewColWrap";
            op.avID = avID;
            op.blockID = blockID;
            op.id = colID;
            op.data = wrap;
            return op;
        },
        transSetAttrViewColHidden(avID: string, blockID: string, colID: string, hide = true) {
            const op = {} as IOperation;
            op.action = "setAttrViewColHidden";
            op.avID = avID;
            op.blockID = blockID;
            op.id = colID;
            op.data = hide
            return op;
        },
        transSetAttrViewSorts(avID: string, blockID: string, colID: string, order: "ASC" | "DESC") {
            const op = {} as IOperation;
            op.action = "setAttrViewSorts";
            op.avID = avID;
            op.blockID = blockID;
            op.data = [{ column: colID, order }]
            return op;
        },
        transSetAttrViewColCalc(avID: string, blockID: string, colID: string, operator: CalcOperator) {
            const op = {} as IOperation;
            op.action = "setAttrViewColCalc";
            op.avID = avID;
            op.data = { operator };
            op.blockID = blockID;
            op.id = colID;
            return op;
        },
        transSetAttrViewFilters(avID: string, blockID: string, filters: IAVFilter[]) {
            const op = {} as IOperation;
            op.action = "setAttrViewFilters";
            op.avID = avID;
            op.data = filters;
            op.blockID = blockID;
            return op;
        },
        transSetAttrViewViewName(avID: string, viewID: string, name: string) {
            const op = {} as IOperation;
            op.action = "setAttrViewViewName";
            op.avID = avID;
            op.id = viewID;
            op.data = name;
            return op;
        },
        transUpdateAttrViewCol(avID: string, colId: string, name: string, type?: TAVCol) {
            const op = {} as IOperation;
            op.action = "updateAttrViewCol";
            op.id = colId;
            op.avID = avID;
            op.name = name;
            op.type = type;
            return op;
        },
        transSetAttrViewName(avID: string, name: string) {
            const op = {} as IOperation;
            op.action = "setAttrViewName";
            op.id = avID;
            op.data = name;
            return op;
        },
        transRemoveAttrViewCol(avID: string, colID: string) {
            const op = {} as IOperation;
            op.action = "removeAttrViewCol";
            op.avID = avID;
            op.id = colID;
            return op;
        },
        transAddAttrViewCol(avID: string, name: string, id = NewNodeID(), type: TAVCol = "text", previousID = "") {
            const op = {} as IOperation;
            op.action = "addAttrViewCol";
            op.avID = avID;
            op.name = name;
            op.previousID = previousID;
            op.type = type;
            op.id = id;
            return op;
        },
        transUpdateAttrViewCellBatch(args: { avID: string, cellID?: string, colID: string, rowID_BlockID: string, value: IAVCellValue }[]) {
            return args.map(arg => {
                const op = {} as IOperation;
                op.action = "updateAttrViewCell";
                op.avID = arg.avID;
                op.id = arg.cellID;
                op.keyID = arg.colID;
                op.rowID = arg.rowID_BlockID;
                op.data = arg.value;
                return op;
            })
        },
        transInsertAttrViewBlock(avID: string, blockID: string, srcs: IOperationSrcs[], previousID = "", ignoreFillFilter = true) {
            const op = {} as IOperation;
            op.action = "insertAttrViewBlock";
            op.avID = avID;
            op.blockID = blockID;
            op.previousID = previousID;
            op.ignoreFillFilter = ignoreFillFilter;
            op.srcs = srcs;
            return op;
        },
        transDoUpdateUpdated(blockID: string, data = timeUtil.getYYYYMMDDHHmmss()) {
            const op = {} as IOperation;
            op.action = "doUpdateUpdated";
            op.id = blockID
            op.data = data
            return op;
        },
    
  • EmptyLight 1 赞同

    大佬,我在用 transactions 更新之后块内容显示[object Object],需要刷新才能显示内容是不是哪里没用对,还是事务执行本身需要刷新


    不需要了,我已经试出来了,是我传入的时候把获取到的 dom 整个传进入了,把里面的 html 取出来就可以了

    1 操作
    EmptyLight 在 2024-12-20 20:54:35 更新了该回帖
  • 查看全部回帖

推荐标签 标签

  • Tomcat

    Tomcat 最早是由 Sun Microsystems 开发的一个 Servlet 容器,在 1999 年被捐献给 ASF(Apache Software Foundation),隶属于 Jakarta 项目,现在已经独立为一个顶级项目。Tomcat 主要实现了 JavaEE 中的 Servlet、JSP 规范,同时也提供 HTTP 服务,是市场上非常流行的 Java Web 容器。

    162 引用 • 529 回帖 • 1 关注
  • CAP

    CAP 指的是在一个分布式系统中, Consistency(一致性)、 Availability(可用性)、Partition tolerance(分区容错性),三者不可兼得。

    11 引用 • 5 回帖 • 612 关注
  • Angular

    AngularAngularJS 的新版本。

    26 引用 • 66 回帖 • 535 关注
  • 笔记

    好记性不如烂笔头。

    308 引用 • 793 回帖
  • NetBeans

    NetBeans 是一个始于 1997 年的 Xelfi 计划,本身是捷克布拉格查理大学的数学及物理学院的学生计划。此计划延伸而成立了一家公司进而发展这个商用版本的 NetBeans IDE,直到 1999 年 Sun 买下此公司。Sun 于次年(2000 年)六月将 NetBeans IDE 开源,直到现在 NetBeans 的社群依然持续增长。

    78 引用 • 102 回帖 • 684 关注
  • JavaScript

    JavaScript 一种动态类型、弱类型、基于原型的直译式脚本语言,内置支持类型。它的解释器被称为 JavaScript 引擎,为浏览器的一部分,广泛用于客户端的脚本语言,最早是在 HTML 网页上使用,用来给 HTML 网页增加动态功能。

    728 引用 • 1273 回帖
  • B3log

    B3log 是一个开源组织,名字来源于“Bulletin Board Blog”缩写,目标是将独立博客与论坛结合,形成一种新的网络社区体验,详细请看 B3log 构思。目前 B3log 已经开源了多款产品:SymSoloVditor思源笔记

    1063 引用 • 3454 回帖 • 189 关注
  • Flume

    Flume 是一套分布式的、可靠的,可用于有效地收集、聚合和搬运大量日志数据的服务架构。

    9 引用 • 6 回帖 • 637 关注
  • 开源中国

    开源中国是目前中国最大的开源技术社区。传播开源的理念,推广开源项目,为 IT 开发者提供了一个发现、使用、并交流开源技术的平台。目前开源中国社区已收录超过两万款开源软件。

    7 引用 • 86 回帖
  • 阿里云

    阿里云是阿里巴巴集团旗下公司,是全球领先的云计算及人工智能科技公司。提供云服务器、云数据库、云安全等云计算服务,以及大数据、人工智能服务、精准定制基于场景的行业解决方案。

    89 引用 • 345 回帖 • 1 关注
  • FreeMarker

    FreeMarker 是一款好用且功能强大的 Java 模版引擎。

    23 引用 • 20 回帖 • 465 关注
  • IDEA

    IDEA 全称 IntelliJ IDEA,是一款 Java 语言开发的集成环境,在业界被公认为最好的 Java 开发工具之一。IDEA 是 JetBrains 公司的产品,这家公司总部位于捷克共和国的首都布拉格,开发人员以严谨著称的东欧程序员为主。

    181 引用 • 400 回帖
  • Node.js

    Node.js 是一个基于 Chrome JavaScript 运行时建立的平台, 用于方便地搭建响应速度快、易于扩展的网络应用。Node.js 使用事件驱动, 非阻塞 I/O 模型而得以轻量和高效。

    139 引用 • 269 回帖 • 29 关注
  • IBM

    IBM(国际商业机器公司)或万国商业机器公司,简称 IBM(International Business Machines Corporation),总公司在纽约州阿蒙克市。1911 年托马斯·沃森创立于美国,是全球最大的信息技术和业务解决方案公司,拥有全球雇员 30 多万人,业务遍及 160 多个国家和地区。

    17 引用 • 53 回帖 • 139 关注
  • Shell

    Shell 脚本与 Windows/Dos 下的批处理相似,也就是用各类命令预先放入到一个文件中,方便一次性执行的一个程序文件,主要是方便管理员进行设置或者管理用的。但是它比 Windows 下的批处理更强大,比用其他编程程序编辑的程序效率更高,因为它使用了 Linux/Unix 下的命令。

    123 引用 • 74 回帖 • 2 关注
  • 安全

    安全永远都不是一个小问题。

    200 引用 • 816 回帖
  • 一些有用的避坑指南。

    69 引用 • 93 回帖 • 1 关注
  • JSON

    JSON (JavaScript Object Notation)是一种轻量级的数据交换格式。易于人类阅读和编写。同时也易于机器解析和生成。

    52 引用 • 190 回帖
  • Sym

    Sym 是一款用 Java 实现的现代化社区(论坛/BBS/社交网络/博客)系统平台。

    下一代的社区系统,为未来而构建

    524 引用 • 4601 回帖 • 699 关注
  • SMTP

    SMTP(Simple Mail Transfer Protocol)即简单邮件传输协议,它是一组用于由源地址到目的地址传送邮件的规则,由它来控制信件的中转方式。SMTP 协议属于 TCP/IP 协议簇,它帮助每台计算机在发送或中转信件时找到下一个目的地。

    4 引用 • 18 回帖 • 623 关注
  • 倾城之链
    23 引用 • 66 回帖 • 138 关注
  • 电影

    这是一个不能说的秘密。

    121 引用 • 604 回帖 • 1 关注
  • Unity

    Unity 是由 Unity Technologies 开发的一个让开发者可以轻松创建诸如 2D、3D 多平台的综合型游戏开发工具,是一个全面整合的专业游戏引擎。

    25 引用 • 7 回帖 • 158 关注
  • Solidity

    Solidity 是一种智能合约高级语言,运行在 [以太坊] 虚拟机(EVM)之上。它的语法接近于 JavaScript,是一种面向对象的语言。

    3 引用 • 18 回帖 • 400 关注
  • 阿里巴巴

    阿里巴巴网络技术有限公司(简称:阿里巴巴集团)是以曾担任英语教师的马云为首的 18 人,于 1999 年在中国杭州创立,他们相信互联网能够创造公平的竞争环境,让小企业通过创新与科技扩展业务,并在参与国内或全球市场竞争时处于更有利的位置。

    43 引用 • 221 回帖 • 106 关注
  • Mac

    Mac 是苹果公司自 1984 年起以“Macintosh”开始开发的个人消费型计算机,如:iMac、Mac mini、Macbook Air、Macbook Pro、Macbook、Mac Pro 等计算机。

    166 引用 • 595 回帖
  • Quicker

    Quicker 您的指尖工具箱!操作更少,收获更多!

    34 引用 • 148 回帖 • 1 关注