Variable
Variable properties
变量是设计令牌,定义了其在变量集合中的每个模式下的值。这些值可以应用于各种设计属性和原型操作,启用设计令牌功能和高级原型流程。
id
id: string [readonly]变量的唯一标识符。
name
name: string变量的名称。
description
description: string变量的描述。
hiddenFromPublishing
hiddenFromPublishing: boolean是否在发布当前文件为库时隐藏该变量。只有当 remote 为 false(例如这是一个本地变量)时才能为 true。
getPublishStatusAsync
getPublishStatusAsync(): Promise<PublishStatus>返回当前文件中此变量的发布状态。
remote
remote: boolean [readonly]获取当前变量是否为远程变量或本地变量。
variableCollectionId
variableCollectionId: string [readonly]包含此变量的变量集合的 ID。
key
key: string [readonly]与 importVariableByKeyAsync 一起使用的键。请注意,虽然此键存在于本地和已发布的变量上,但您只能导入已发布的变量。
resolvedType
resolvedType: VariableResolvedDataType [readonly]变量的解析类型。
resolveForConsumer
resolveForConsumer(consumer: SceneNode): { value: VariableValue; resolvedType: VariableResolvedDataType }如果此变量已绑定到消费者,则检索此变量的解析值。
setValueForMode
setValueForMode(modeId: string, newValue: VariableValue): void为给定的模式设置变量的值。如果模式 ID 属于扩展集合,则值将在扩展上覆盖。
valuesByMode
valuesByMode: { [modeId: string]: VariableValue } [readonly]此变量在每个模式下的值。请注意,这将不会解析任何别名。要返回所有情况下完全解析的值,请考虑使用 resolveForConsumer。
remove
remove(): void从文档中删除此变量。
scopes
scopes: Array<VariableScope>在 UI 中显示此变量的作用域数组。设置此属性将在不同的字段中显示/隐藏此变量选择器 UI。
codeSyntax
codeSyntax: { [platform in CodeSyntaxPlatform]?: string} [readonly]此变量的代码语法定义。支持的平台为 'WEB'、'ANDROID' 和 'iOS'。
setVariableCodeSyntax
setVariableCodeSyntax(platform: CodeSyntaxPlatform, value: string): void设置此变量的代码语法定义。支持的平台为 'WEB'、'ANDROID' 和 'iOS'。
removeVariableCodeSyntax
removeVariableCodeSyntax(platform: CodeSyntaxPlatform): void从 codeSyntax 中删除给定平台。
Plugin data properties
getPluginData
getPluginData(key: string): string使用 setPluginData 存储在节点或样式上的自定义信息。如果未存储提供键的数据,则返回空字符串。
setPluginData
setPluginData(key: string, value: string): void允许您在任何节点或样式上存储自定义信息,对您的插件来说是私有的。您的条目(pluginId、key、value)的总大小不能超过 100 kB。
getPluginDataKeys
getPluginDataKeys(): string[]使用 setPluginData 存储在节点或样式上的自定义信息。此操作允许您遍历存储在节点或样式上的所有私有数据。
getSharedPluginData
getSharedPluginData(namespace: string, key: string): string使用 setSharedPluginData 存储在节点或样式上的共享数据。如果未存储提供命名空间和键的数据,则返回空字符串。
setSharedPluginData
setSharedPluginData(namespace: string, key: string, value: string): void允许您在任何节点上存储自定义信息。您可以使用相同的命名空间和键稍后调用 getSharedPluginData 来检索它。要查找存储在节点上的特定命名空间中的所有数据,请使用 getSharpedPluginDataKeys。
getSharedPluginDataKeys
getSharedPluginDataKeys(namespace: string): string[]使用 setSharedPluginData 存储在节点或样式上的共享数据。此操作允许您遍历存储在节点或样式上的所有共享数据。