Atom飞行手册翻译： 4.3 作用域设置、作用域和作用域描述符

作用域设置、作用域和作用域描述符

Atom支持语言特定的设置。你可以在Markdown文件中软换行，或者在Python中把tab的宽度设置为4。

语言特定的设置只是一些东西的子集，我们把它叫做“作用域设置”。作用域设置可以只作用于一类特定的语法符号。比如你可以仅仅对Ruby的注释，Markdown中的代码段，或者JavaScript函数名称进行设置。

语法符号中的作用域名称

编辑器的每个符号都有一系列的作用域名称。例如，前面提到的JavaScript函数可能拥有作用域function和name。一个左括号可能拥有punctuation、parameters和begin作用域。

作用域的名称就像CSS中的class一样工作。事实上，编辑器中的作用域名称作为CSS的class附加到符号的DOM节点。

比如这段JavaScript代码：

function functionName() {
  console.log('Log it out');
}

在开发工具中，第一行的标记就像这样：

span标签上的所有class名称都是作用域名称。任何作用域名称都用于指向一个设置的值。

作用域选择器

作用域选择器允许你指向特性符号，就像CSS选择器指向DOM中特定的节点。这里是一些例子：

'.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例子中，函数名称符号的作用域描述符应该为：

['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"]。

让我们使用这些方法来回顾我们的例子：

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')