Atom飞行手册翻译: 4.1 配置API

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

在我们编写了一些主题和包之后,让我们花一些时间来深入了解一些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文档

相关文章
|
3月前
|
Java API 数据库
构建RESTful API已经成为现代Web开发的标准做法之一。Spring Boot框架因其简洁的配置、快速的启动特性及丰富的功能集而备受开发者青睐。
【10月更文挑战第11天】本文介绍如何使用Spring Boot构建在线图书管理系统的RESTful API。通过创建Spring Boot项目,定义`Book`实体类、`BookRepository`接口和`BookService`服务类,最后实现`BookController`控制器来处理HTTP请求,展示了从基础环境搭建到API测试的完整过程。
63 4
|
3月前
|
存储 安全 Java
jdk21的外部函数和内存API(MemorySegment)(官方翻译)
本文介绍了JDK 21中引入的外部函数和内存API(MemorySegment),这些API使得Java程序能够更安全、高效地与JVM外部的代码和数据进行互操作,包括调用外部函数、访问外部内存,以及使用不同的Arena竞技场来分配和管理MemorySegment。
80 1
jdk21的外部函数和内存API(MemorySegment)(官方翻译)
|
3月前
|
Java API 开发工具
API参考手册
【10月更文挑战第18天】API参考手册
69 2
|
3月前
|
IDE API 定位技术
Python--API编程:IP地址翻译成实际的物理地址
Python--API编程:IP地址翻译成实际的物理地址
74 0
|
5月前
|
前端开发 API 网络架构
【Azure 应用服务】能否通过 Authentication 模块配置 Azure AD 保护 API 应用?
【Azure 应用服务】能否通过 Authentication 模块配置 Azure AD 保护 API 应用?
|
5月前
|
安全 API 网络安全
【Azure API 管理】APIM如何配置客户端证书的CRL检测策略
【Azure API 管理】APIM如何配置客户端证书的CRL检测策略
|
5月前
|
API 数据库 索引
indexedDB 操作库IDBWRAPPER 教程翻译及API翻译第二部分part2
indexedDB 操作库IDBWRAPPER 教程翻译及API翻译第二部分part2
|
5月前
|
JSON 算法 API
【Azure API 管理】APIM 配置Validate-JWT策略,验证RS256非对称(公钥/私钥)加密的Token
【Azure API 管理】APIM 配置Validate-JWT策略,验证RS256非对称(公钥/私钥)加密的Token
|
5月前
|
API
【Azure 环境】在Azure活动目录中的应用注册,给应用添加API权限时发现API权限配置缺失
【Azure 环境】在Azure活动目录中的应用注册,给应用添加API权限时发现API权限配置缺失
|
5月前
|
前端开发 API
【API管理 APIM】APIM中如何配置使用URL路径的方式传递参数(如由test.htm?name=xxx 变为test\xxx)
【API管理 APIM】APIM中如何配置使用URL路径的方式传递参数(如由test.htm?name=xxx 变为test\xxx)