Scripted 0.4 版本发布

工程 | Andy Clement | 2013年3月5日 | ...

本周,我们发布了面向 JavaScript 的代码编辑器 Scripted 的 0.4 版本。您可以在此处阅读 Scripted 的背景信息。

0.4 版本的完整发行说明在此处,但在本文中,我将重点介绍一些更有趣的更改。

工具提示


Scripted 使用推理引擎来理解您的 JavaScript 代码。Scripted 0.3 提供了一些基本的工具提示,显示了关于函数调用的推断信息。在 Scripted 0.4 中,这一点得到了进一步改进——不仅格式更好,而且现在还包括任何发现的 jsdoc。您可以看到将鼠标悬停在函数调用上时出现的工具提示。


 

模板


模板支持得到了增强,您现在可以使用嵌入原始选择的文本扩展来替换选择。在第一张图片中,我们选择了一个函数调用并按下了Ctrl/Cmd+Space

选择第一个模板完成之后,编辑器内容将变为


 

可扩展性


此版本的 Scripted 包含一个基本的插件机制。只需编写一个 .js 文件,将其放到正确的位置,它就会扩展 Scripted 的行为。插件 API 绝对是一个正在进行的工作,但您已经可以实现一些有用的功能。例如,我们有保存时源代码转换插件,可以执行删除空格和添加版权信息等操作。在发行说明此处的 wiki中可以找到有关插件系统的更多信息。基本上,插件开发涉及编写一个 AMD 模块,'require' API 片段,然后就可以开始了。

我们考虑到的一个关键用例是使您能够编写一个插件,该插件为编辑器贡献新的注释(出现在左侧标尺中,并允许设置编辑器文本的样式)。这是一个非常简单的插件。它只是定位代码中水果的名称并为其添加注释。也许这不是*最*有用的插件,但它应该显示插件的关键部分是什么,而不是陷入注释计算中。

define(function (require) {

	// Grab the editor API
	var editorApi = require('scripted/api/editor-extensions');

	var pathExp = new RegExp('.*\\.js$');

	// Register the new annotation type
	editorApi.registerAnnotationType('example.message');

	// Load the styling for our annotation (very simple bit of css)
	editorApi.loadCss(require('text!./styling.css'));

	// Register an 'annotation computer'.
	// The return value of the function is the new set of annotations
	// which replace any added on previous calls to the function.
	editorApi.addAnnotationComputer(function (editor) {
		// Only interested in .js files
		var path = editor.getFilePath();
		if (!path || !pathExp.test(path)) {
			return;
		}
		var text = editor.getText();
		var fruits = ['apple', 'banana', 'kiwi', 'orange'];

		var annotations=[];
		for (var f=0; f<fruits.length; f++) {
			var fruit = fruits[f];
			var index = text.indexOf(fruit);
			while (index!=-1) {
				// Create the annotation: needs type/start/end/text
				annotations.push({type:'example.message', start:index, 
				  end:index+fruit.length, text:'Found '+fruit });
				index = text.indexOf(fruit,index+1);
			}
		}
		return annotations;
	});
	console.log('Annotation adding sample plugin');
});

此插件的其他两个部分是样式 CSS(对于内联图像数据,很抱歉,只是方便重用我们从 Eclipse Orion 继承的一些图像)

/* Styling for the text in the editor */
.annotationRange.message {
	/* the icon for a 'squiggly' underline */
	background-image: url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAQAAAADCAYAAAC09K7GAAAAAXNSR0IArs4c6QAAAAZiS0dEAP8A/wD/oL2nkwAAAAlwSFlzAAALEwAACxMBAJqcGAAAAAd0SU1FB9sJFhQXEbhTg7YAAAAZdEVYdENvbW1lbnQAQ3JlYXRlZCB3aXRoIEdJTVBXgQ4XAAAAMklEQVQI12NkgIIvJ3QXMjAwdDN+OaEbysDA4MPAwNDNwMCwiOHLCd1zX07o6kBVGQEAKBANtobskNMAAAAASUVORK5CYII=");
	background-color: cyan;
	color: blue;
}
/* Styling for the right hand overview ruler */
.annotationOverview.message {
	background-color: grey;
	border: 1px solid #000080;
}
/* Styling for the left hand annotation ruler */
.annotationHTML.message {
	/* the icon for a 'flashlight' */
	background-image: url("data:image/gif;base64,R0lGODlhEAAQANUAALClrLu1ubOpsKqdp6eapKufqMTAw7attLSrsrGnr62jq8C7v765vaebpb22vLmyuMbCxsnGycfEx8G+wcrIysTBxUltof//yf///v70jergpPvws+nWc/npqvrpqvrpq/raffffnvXVkfTVkvXUkd+9f+SiOemvV+uyXa2OX7mYZqeIXKuNX/ClO7KQYqiIXJ59Vp19VpFvTo9uTZBvTpNyUJNyUf///////wAAAAAAAAAAAAAAAAAAAAAAAAAAACH5BAEAADgALAAAAAAQABAAAAZ4QJxwSCwajS2aS1U6DlunzcagcuKgG4sn5HJiLZ2QiHbEbj6hEapVTKVYr3OItG5TIhVGLF0npigUEAsPAjV9Q24pEhMBCAoybEUmGRcrDgcAAzNGkxcYNzAJBQSbRJ0YqBc2DaVEHJ6pGTStRBqfGBcZILRWvThBADs=");
}

和 plugin.json(对于完全微不足道的插件,.json 文件不是必需的)。


{	
	"name": "annotation-adding-plugin",
	"version": "0.1",
	"description": "Scripted plugin to add markers in the editor",
	"main": "annotation-adding-plugin",
	"scripted": {
		"plugin": true
	}
}

所有这些部分都在git 仓库中的此处。激活后,添加注释时的样式将如下所示:

基于此模型,我们实现了一个更现实的插件,该插件基于 Ariya Hidayat 的一篇博文,该博文描述了如何'检测布尔陷阱'。该插件的源代码在此处

请咨询 wiki 以获取有关插件开发的更多信息。
 

日/夜模式

最后但并非最不重要的是,我们正在构建 Orion 中的主题支持,现在为编辑器提供了一个深色主题。各个颜色目前不可配置,但我们仍然觉得已设置的默认颜色看起来非常不错:  

入门

想试一试吗?如果您已安装 node/npm,只需键入

  npm install -g scripted
scr foo.js

自述文件描述了其他安装选项,它可以作为独立的 zip 文件提供。许多用户乐于关注 master 分支并每周/每天更新。

获取 Spring 电子简报

通过 Spring 电子简报保持联系

订阅

领先一步

VMware 提供培训和认证,以加快您的进度。

了解更多

获取支持

Tanzu Spring 在一个简单的订阅中提供对 OpenJDK™、Spring 和 Apache Tomcat® 的支持和二进制文件。

了解更多

即将举行的活动

查看 Spring 社区中所有即将举行的活动。

查看全部