作用域设置、作用域和作用域描述符
Atom支持语言特定的设置。你可以在Markdown文件中软换行,或者在Python中把tab的宽度设置为4。
语言特定的设置只是一些东西的子集,我们把它叫做“作用域设置”。作用域设置可以只作用于一类特定的语法符号。比如你可以仅仅对Ruby的注释,Markdown中的代码段,或者JavaScript函数名称进行设置。
语法符号中的作用域名称
编辑器的每个符号都有一系列的作用域名称。例如,前面提到的JavaScript函数可能拥有作用域function
和name
。一个左括号可能拥有punctuation
、parameters
和begin
作用域。
作用域的名称就像CSS中的class一样工作。事实上,编辑器中的作用域名称作为CSS的class附加到符号的DOM节点。
比如这段JavaScript代码:
代码语言:javascript复制function functionName() {
console.log('Log it out');
}
在开发工具中,第一行的标记就像这样:
span标签上的所有class名称都是作用域名称。任何作用域名称都用于指向一个设置的值。
作用域选择器
作用域选择器允许你指向特性符号,就像CSS选择器指向DOM中特定的节点。这里是一些例子:
代码语言:javascript复制'.source.js' # selects all javascript tokens
'.source.js .function.name' # selects all javascript function names
'.function.name' # selects all function names in any language
Config::set
接受一个scopeSelector
。如果你想要对JavaScript 函数名称进行设置,你可以向它提供一个js函数名称的scopeSelector
:
atom.config.set('.source.js .function.name', 'my-package.my-setting', 'special value')
作用域描述符
作用域描述符是一个对象,它封装了一个字符串数组。数组描述了从语法树根节点到符号的路径,包含整个路径的所有作用域名称。
在上面的JavaScript例子中,函数名称符号的作用域描述符应该为:
代码语言:javascript复制['source.js', 'meta.function.js', 'entity.name.function.js']
Config::get
接受一个scopeDescriptor
,你可以从作用在JavaScript函数名称的设置中获取值,通过:
scopeDescriptor = ['source.js', 'meta.function.js', 'entity.name.function.js']
value = atom.config.get(scopeDescriptor, 'my-package.my-setting')
但是你并不需要手动生成作用域描述符。有一些可用的方法来从编辑器获取作用域描述符:
Editor::getRootScopeDescriptor
获取语言的描述符,例如[".source.js"]
。Editor::scopeDescriptorForBufferPosition
获取缓冲区中特定位置的描述符。Cursor::getScopeDescriptor
获取光标处的描述符。例如,如果光标在例子中的方法名称上面,会返回["source.js", "meta.function.js", "entity.name.function.js"]
。
让我们使用这些方法来回顾我们的例子:
代码语言:javascript复制editor = atom.workspace.getActiveTextEditor()
cursor = editor.getLastCursor()
valueAtCursor = atom.config.get(cursor.getScopeDescriptor(), 'my-package.my-setting')
valueForLanguage = atom.config.get(editor.getRootScopeDescriptor(), 'my-package.my-setting')