有没有办法折叠/折叠Visual Studio代码中的Rust文档注释?

时间:2017-09-19 21:31:43

标签: rust visual-studio-code vscode-extensions

在VSCode中,有没有办法折叠/折叠Rust文档注释(即以//!///开头的换行符注释? Swift也有类似的评论,因此任何与Swift相关的答案也可能与Rust有关。

如果VSCode中不支持此功能,是否有任何扩展可以实现相同的目的?

1 个答案:

答案 0 :(得分:1)

我也对此感到担忧,所以我环顾四周。令人惊讶的是,自2018年3月以来,有了新的folding provider API,就有可能实现这一目标。

我做了一点POC(该代码太可怕了而且不安全,不能照原样使用):

class CommentProvider implements vscode.FoldingRangeProvider {
    // This method must return a list of the foldable ranges
    provideFoldingRanges(document: vscode.TextDocument, context: vscode.FoldingContext, token: vscode.CancellationToken): vscode.ProviderResult<vscode.FoldingRange[]> {
        let ret: vscode.FoldingRange[] = [];
        for (let i = 0; i < document.lineCount; ++i) {
            let line = document.lineAt(i).text.trim();
            if (line.startsWith("//!")) {
                let from = i;
                do {
                    ++i;
                } while (document.lineAt(i).text.trim().startsWith("//!"));
                ret.push(new vscode.FoldingRange(from, i - 1));
            }
        }
        return ret;
    }
}

export function activate(context: vscode.ExtensionContext) {
    let sel: vscode.DocumentSelector = { scheme: 'file', language: 'rust' };
    let pro = new CommentProvider();
    vscode.languages.registerFoldingRangeProvider(sel, pro);
}

,并且必须在package.json中正确注册:

"activationEvents": [
    "onLanguage:rust"
],
"contributes": {
    "languages": [
        {
            "id": "rust",
            "aliases": [
                "rs"
            ],
            "extensions": [
                "rs"
            ],
            "configuration": "./language-configuration.json"
        }
    ]
},

不过,我不确定这些值。

最好是要求进行正式防锈扩展的团队对此进行整合。