可显示对象

两组适用于所有控件类型的节点：Displayable 的几何与外观节点，以及八种内建控件都重复一遍的 visible / enabled 四件套。所有 Element 节点共通的规则——创建浮窗何时提供它、目标缺失时如何失败——见 Element

Displayable

这些节点用的是通用 element 引脚，因此接受任意可显示元素的引用，而不限定某一种控件类型。坐标使用当前 Surface 的设计坐标系——和检视器里显示的是同一组数字。透明度只有一份有效值：Appearance Variant 的 transformOpacity 会解析到它，nl.image Variant 中相对 Default 改动过的 fillOpacity 也会解析到它，Get Element Property、Set Element Property 和 Animate Element Property 操作的都是这同一个数

本节末尾的七个读取节点——position、size、bounds、rotation、opacity、visible 和 variant——已被 Get Element Property 取代，并在创建浮窗中隐藏。它们仍然注册，好让已经用到它们的蓝图继续能跑。这里列出它们是因为你会在旧图里遇到，而不是建议你新建

它们全部的 Self 形态见 Displayable

Get Element Property

blueprint.element.displayable.getProperty · Pure

推荐使用的读取入口。在卡片上选属性，value 引脚输出对应的值

卡片字段

Set Element Property

blueprint.element.displayable.setProperty · Latent

写入目标元素的一个运行时属性。列表里刻意没有 variant——Variant 走 Set Element Variant

卡片字段

Animate Element Property

blueprint.element.displayable.animateProperty · Latent

启动一段属性动画。动画一开始就先写出 animation token；执行链要等动画自然结束、或被 Stop Element Animation 提前跳过之后才进入 next。它是属性驱动的基础节点，不内建 Fade / Shake 之类的序列——那些可以基于它做成宏

卡片字段

Stop Element Animation

blueprint.element.displayable.stopAnimation · Latent

这个分类里唯一没有元素目标的节点：token 本身已经定位到某个元素上的某段动画。它只停止 token 对应的那一段，并让正在等待它的 Animate Element Property 提前进入 next。传入缺失值、非 AnimationToken、或者已经不再 pending 的 token 时静默 no-op 并继续执行。也正因为它不需要绑定，它是创建浮窗中唯一无条件出现的 Element 节点

Set Element Variant

blueprint.element.displayable.setVariant · Latent

设置目标元素的运行时 Appearance Variant 覆盖。节点没有 variantId 引脚，也无法手输 id：当连入的引用让目标可以被静态推断时，卡片会按名称列出该元素已有的 Variants，内部 UUID 只作为隐藏值保存。卡片上还有一个 Wait For Animation 字段，用来选择立即继续、还是等所选 Variant 上最长的字段 transition 结束。对不支持 Appearance Variant 的元素执行时会提交错误，而不是静默忽略

它还会清理之前的 runtime opacity override，让当前 Variant 决定透明度——所以先切到透明 Variant、再把 opacity 从 0 动画到 100，会从那个透明状态正常进入，而不会被锁在 0

Get Element Display

blueprint.element.displayable.getDisplay · Pure

读取运行时渲染开关，默认为 true

Set Element Display

blueprint.element.displayable.setDisplay · Latent

设为 false 时，元素和它的子树通过 CSS display: none 隐藏，但仍然挂载在 SurfaceElementTree 中。它不是 visible：visible 仍然是布局/可见性属性，通过 Get Element Property / Set Element Property 读写

Get Element Measured Rect

blueprint.element.displayable.getMeasuredRect · Pure

元素最后实际落在哪里，是从画出来的东西上量出来的，而不是从文档里读出来的。Get Element Property 取 bounds 键回答的是 authored layout 加上写在它上面的运行时 patch，所以连还没被画过的元素也答得出来；这一个量的是真实的那个盒子

Get Element Center

blueprint.element.displayable.getCenter · Pure

上面那个矩形的中心点。Move Mouse To Element 瞄准的就是这同一次测量；当图要的是那个点而不是那次移动时用它

Get Element Position

blueprint.element.displayable.getPosition · Pure

以设计坐标读取布局位置，输出 Vector2D

Get Element Size

blueprint.element.displayable.getSize · Pure

读取宽高，输出 Vector2D

Get Element Bounds

blueprint.element.displayable.getBounds · Pure

一次读取 { x, y, width, height }

Get Element Rotation

blueprint.element.displayable.getRotation · Pure

读取视觉旋转角度，单位为度

Get Element Opacity

blueprint.element.displayable.getOpacity · Pure

读取有效透明度，范围 0..1

Get Element Visible

blueprint.element.displayable.getVisible · Pure

读取 visible 属性——不是 display

Get Element Variant

blueprint.element.displayable.getVariant · Pure

读取当前 Variant 的内部 UUID。现在的编辑器不再要求作者接触这个 id，整条基于 id 的 Variant 路径因此被淘汰

Visible 与 Enabled

八种控件带同样的四个节点：读写 visible、读写 enabled。它们是 Button、Container、Frame、Image、List、Slider、Switch 和 Text——nl.textInput 是唯一没有这一对 Element 节点的内建控件，要改它请用 Get Element Property / Set Element Property。它们各自的目标引脚按自己的控件类型定型，所以创建浮窗提供哪四个，取决于当前图绑定了哪些控件类型。Set … Enabled 传 false 会映射到渲染器的禁用交互机制；节点面上刻意不暴露 interactionDisabled

要隐藏元素但不卸载它，用 Set Element Display——visible 和 display 是两个开关，只有 display 会折叠整棵子树

Get Button Visible

blueprint.element.button.getVisible · Pure

Set Button Visible

blueprint.element.button.setVisible · Latent

Get Button Enabled

blueprint.element.button.getEnabled · Pure

Set Button Enabled

blueprint.element.button.setEnabled · Latent

Get Container Visible

blueprint.element.container.getVisible · Pure

Set Container Visible

blueprint.element.container.setVisible · Latent

Get Container Enabled

blueprint.element.container.getEnabled · Pure

Set Container Enabled

blueprint.element.container.setEnabled · Latent

Get Frame Visible

blueprint.element.frame.getVisible · Pure

Set Frame Visible

blueprint.element.frame.setVisible · Latent

Get Frame Enabled

blueprint.element.frame.getEnabled · Pure

Set Frame Enabled

blueprint.element.frame.setEnabled · Latent

Get Image Visible

blueprint.element.image.getVisible · Pure

Set Image Visible

blueprint.element.image.setVisible · Latent

Get Image Enabled

blueprint.element.image.getEnabled · Pure

Set Image Enabled

blueprint.element.image.setEnabled · Latent

Get List Visible

blueprint.element.list.getVisible · Pure

Set List Visible

blueprint.element.list.setVisible · Latent

Get List Enabled

blueprint.element.list.getEnabled · Pure

Set List Enabled

blueprint.element.list.setEnabled · Latent

Get Slider Visible

blueprint.element.slider.getVisible · Pure

Set Slider Visible

blueprint.element.slider.setVisible · Latent

Get Slider Enabled

blueprint.element.slider.getEnabled · Pure

Set Slider Enabled

blueprint.element.slider.setEnabled · Latent

Get Switch Visible

blueprint.element.switch.getVisible · Pure

Set Switch Visible

blueprint.element.switch.setVisible · Latent

Get Switch Enabled

blueprint.element.switch.getEnabled · Pure

Set Switch Enabled

blueprint.element.switch.setEnabled · Latent

Get Text Visible

blueprint.element.text.getVisible · Pure

Set Text Visible

blueprint.element.text.setVisible · Latent

Get Text Enabled

blueprint.element.text.getEnabled · Pure

Set Text Enabled

blueprint.element.text.setEnabled · Latent