应用介绍
Weex Language Support 插件是官方提供的一款Weex语法支持插件,100down站免费提供用户们下载使用,你可以使用它在IntelliJ IDEA,WebStorm等一系列IDE上对Weex DSL进行语法高亮,自动补全和错误检查等操作。Weex Intellij的语言支持 IntelliJ IDEA PhpStorm WebStorm PyCharm RubyMine AppCode CLion GoLand Rider等。
Weex Language Support特点
weex文件结构检查
weex组件标记完成和皮棉
weex组件属性完成和lint
皮棉和快速修复胡须
引用链接并找到使用支持
自定义weex规则支持
打开组件声明
为JS完成
按标签打开文档
文件搜索
支持的IDE
你可以在任何操作系统上的下列IDE上安装和使用Weex Language Support插件:
IntelliJ IDEA Ultimate, PhpStorm, WebStorm, PyCharm, RubyMine, AppCode, CLion, Gogland, Rider
安装说明
在IDE的插件仓库中搜索Weex Language Support来安装该插件,安装完毕后重启IDE即可激活插件相关功能
配置
打开Preferences -> Other Settings -> Weex language support可配置插件的相关功能
Target Weex Version: 配置插件以哪一个版本的语法规则来对DSL进行提示及检查,默认值LATEST表示总是应用最行新版本weex的语法规则
Vue Support: 配置插件是否支持Weex 2.0版本的DSL(.vue文件),开启后重启生效(注意:如果IDE内有其他支持Vue语法的插件,则需要关闭相应的插件后Weex插件才能生效)
Custom Rules: 引入自定义的Weex DSL规则,如果你在native中定义了自己的Module或Component,可通过自定义规则引入插件中来提供相应的提示和补全支持,自定义规则的格式将在后文列出
Global Weex Components: 默认地,插件会解析当前工程及npm root路径下的node_modules目录,解析其中包含的Weex Components并对其提供补全支持。如果你的项目中引用了这两个路径以外的Components,可以在此处将其添加到搜索路径中,插件将会将其中的Components载入,并在编写DSL时为相应的标签提供补全支持
自定义规则格式
自定义规则包含在一个json文件中,json文件的根节点为数组类型,数组中的每一个元素对应DSL中的一个标签。
我们以
{
"tag": "loading", //标签名,不可为空
"attrs": [ //标签属性列表,可为空
{
"name": "display", //属性名,不可为空
"valuePattern": null, //属性值的正则表达式,用于检测值是否合法,可为空
"valueEnum": [ //属性值枚举,可为空
"show",
"hide"
],
"valueType": "var", //属性值类型,必须是var或function,决定该从数据列表还是函数列表中查找属性值补全的候选值,不可为空
"since": 0, //该属性何时被添加到sdk中,例如0.11,默认为0
"weexOnly": false //该属性是否仅在1.0语法中可用,默认为false
}
],
"events": [ //事件列表。可为空
{
"name": "loading", //事件名称,不可为空
"since": 0 //该事件何时被添加到sdk中
}
],
"parents": [ //该标签允许被作为哪些标签的子元素,空表示可以作为任意元素的子元素
"list",
"scroller"
],
"childes": [ //该标签允许哪些元素作为自己的子元素,空表示任意元素都可作为子元素
"text",
"image",
"loading-indicator"
],
"document": "/references/components/loading.html" //文档地址,配置该属性之后可在编辑界面中对应的标签上直接打开文档
}
使用说明
插件的绝大部分功能被集成到编辑器上下文中,会随用户输入在需要补全,提示或Lint时被触发,无需特殊干预。下列功能需要用户手动触发:
文档搜索
打开IDE右侧工具栏的Weex Documents即可对文档进行搜索,搜索结果与官网保持同步,勾选 EN 可切换搜索结果为英文内容
打开标签对应的文档
将光标定位到标签上,并通过Show Intention Actions操作(OSX上默认键为 option + enter,可通过Keymap查看)打开Intenion菜单,选择Open Document可打开标签对应的文档。