嵌入块查询

嵌入块有两大功能，1是输入SQL语句，2是通过js查询。

通过SQL查找直接返回的结果是块内容，如果是文档块会获取文档的所有内容。

通过js查询，需要返回块id的数组，没查询到需要返回空数组，然后思源会根据块id获取块内容。

注意，这个输入框中的代码是在一个new Function函数体内，而这个函数体目前是不支持异步的，如果你的代码中有异步调用，比如 await xxx()等，需要外面封装已成异步函数或者用异步立即函数。

比如：

还有，如果你在该函数体内调用第三方代码，在加载时，嵌入块并不能保证第三方代码加载完后再执行，可能会出现报错第三方代码不存在情况。

解决办法，就是写代码等待第三方代码加载完毕再执行或加一定的延迟后再执行，不过，一般这种情况不多，如果第三方代码不是很复杂，一般不用特殊处理，当出错时知道原因或有解决办法就行。

下面这个函数可用于等待第三方加载完成后执行

使用方法：

怎样找到源码？

首先打开控制台，可以在思源主菜单 -> 开发者工具那里打开。

然后只需要再SQL查询输入框中输入debugger;关键词即可，在执行时，会自动在控制显示断点，断点位置就是源码的位置。

然后看到我们自己写的代码在一个匿名函数中，匿名函数传递了4个参数，分别是fetchSyncPost,item,protyle,top。

fetchSyncPost 是api请求函数

item 代表本嵌入块结点

protyle 代表嵌入块所在的文档对象

top 是滚动条距顶部位置，用于恢复滚动条位置，一般用不到

然后按F10进入后面的语句，然后来到下图的位置

这里可以看到刚才调用匿名函数的地方，通过在思源GitHub搜索startsWith("//!js")关键词就能找到源码位置

源码如下

由源码可知，这里可以传入promise或数组，然后思源会根据传入的块id查询块内容，然后返回给渲染函数。

而且，这里通过new Function调用用户代码，由于new Function是同步函数，就会出现上面所说的异步调用需要包裹一层异步函数的问题。另外，如果依赖外部代码，也需要等待加载。

思源默认的嵌入块查询不支持指定字段查询，只能使用类似这样的SQL查询。

那么，我想像下面这样查询怎么办？

能否实现这样的效果吗？

答案是肯定的。

只需要安装下面这个js代码片段即可。

然后只需要用下面两个SQL就可以立即实现上面的效果了。

但，这个查询扩展仅支持SQL查询，不支持js查询，要想支持js查询，可以以用简单查询js代码片段或QueryView插件。

传送门：