Sketch.app

您可以使用 sketch:// URL 方案将 Sketch 集成到您的应用程序或工作流程中。您甚至可以在 Sketch 中打开文档，并使其聚焦于特定图层或具有指定的缩放级别。

注意：如果文档已打开，画布视图不会改变。

目录

• 居中图层并指定缩放级别
• 运行插件命令
• 添加共享库

居中图层并指定缩放级别

URL 方案接受两个参数。如果在没有提供任何参数的情况下提供文件路径，则文件将以上次保存的方式打开。

sketch://path/to/file.sketch?centerOnLayer=LAYER_ID&zoom=ZOOM_LEVEL

centerOnLayer 字符串

要获取图层 ID，请使用 JavaScript API 或直接读取文档的 JSON 数据。

示例

要获取当前选区的 ID，请在 Sketch 中选择当前文档中的一个图层，然后从“插件”菜单中的“运行脚本...”面板运行以下脚本。

const document = require('sketch/dom').getSelectedDocument()

document.selectedLayers.forEach(layer => console.log(layer.id))

zoom 数字

实际大小 的缩放级别为 1。要缩小，请指定介于 0...1 之间的值，而使用大于 1 的值进行放大，例如 2 表示 200%。

运行插件命令

可用性：Sketch 55+

运行插件命令并将查询参数传递给 JavaScript 处理程序。

sketch://plugin/my.plugin.identifier/my.command.identifier

示例

该命令必须实现 HandleURL 操作，并在插件清单中定义，才能运行。

command.js

const sketch = require('sketch')

// If you're using skpm: export function handleURL(context)
function handleURL(context) {
  let query = context.actionContext.query
  sketch.UI.message(query.msg || '👋')
}

manifest.json

{
  "identifier": "com.example.sketch.messenger",
  "commands": [
    {
      "name": "Message",
      "identifier": "message.show",
      "script": "command.js",
      "handlers": {
        "actions": {
          "HandleURL": "handleURL"
        }
      }
    }
  ]
}

URL

打开以下链接，在打开的文档中显示“Hello World”消息。使用 msg 查询参数提供任何 URL 编码的字符串。

sketch://plugin/com.example.sketch.messenger/message.show?msg=Hello%20World

添加共享库

通过指定指向 appcast 的 URL，添加托管在任何服务器上并使用 RSS 共享的库。

sketch://add-library?url=APPCAST_RSS_URL

url 字符串

指定 appcast RSS 文件地址的 URL 编码字符串。

示例

从 Apple 设计资源 安装 Apple iOS Sketch 库的 URL。

sketch://add-library?url=https%3A%2F%2Fdeveloper.apple.com%2Fdesign%2Fdownloads%2Fsketch.rss

要了解有关共享您自己的库的更多信息，请参阅

• 共享库 Sketch 文档
• Appcast 文档

向当前文档添加助手

这在 Sketch 助手部分中有 说明。