当前位置: 首页 > 文档资料 > Atom飞行手册 >

配置API

优质
小牛编辑
133浏览
2023-12-01

在我们编写了一些主题和包之后,让我们花一些时间来深入了解一些Atom的工作方式。在这一章中,我们会更进一步了解Atom中独特的内部API和系统,甚至查看一些源码来看一看它们是如何很好地工作的。

配置API

读取配置

如果你想要编写一个可配置的包,你需要通过atom.config来整体读取配置,或者通过atom.config.get来读取一个具有命名空间的配置键的当前值。

# read a value with `config.get`
@showInvisibles() if atom.config.get "editor.showInvisibles"

或者通过atom.config.observe来跟踪任何视图对象产生的修改。

{View} = require 'space-pen'

class MyView extends View
  attached: ->
    @fontSizeObserveSubscription =
      atom.config.observe 'editor.fontSize', (newValue, {previous}) =>
        @adjustFontSize()

  detached: ->
    @fontSizeObserveSubscription.dispose()

atom.config.observe方法会使用特定键路径的当前值立即调用提供的回调函数,并且以后当这个值发生改变时也会调用。如果你只希望在下次这个值改变的时候调用回调,使用atom.config.onDidChange来代替它。

订阅(Subscription)方法会返回一个一次性的订阅对象。注意上面的例子中,我们如何将订阅保存在@fontSizeObserveSubscription实例变量中,以及视图被分离的时候如何处理它。你可以添加多个订阅到[CompositeDisposable](https://atom.io/docs/api/latest/CompositeDisposable)中来将它们组合到一起。当视图被分离的时候你可以把它处理掉。

写入配置

虽然atom.config的数据在启动时才从~/.atom/config.cson加载,但你可以通过atom.config.set用编程的方式对其写入。

# basic key update
atom.config.set("core.showInvisibles", true)

如果你通过特定键路径来访问包的配置,你也可能像将它们和你包里面的主模块的schema关联起来。更多schema的细节请阅读配置API文档