Button, Container, Switch, Frame, Video

A Button's label and cursor, a Container's clipping, a Switch's checked state, the Page a Frame shows, and a Video's playback. The rules common to every Element node are in Element.

Button

Button nodes take an element:nl.button pin. Get Button Label reads the label on screen. The label Set Button Label writes shows as written in every language, ahead of a Translation key and a Blueprint Value, until the page is opened again. The Self forms are in Button.

Get Button Label

blueprint.element.button.getLabel · Pure

Reads the label on screen, in the player's current language.

Set Button Label

blueprint.element.button.setLabel · Latent

Sets the button's label text.

Set Button Pointer

blueprint.element.button.setPointer · Latent

Chooses the button's default cursor. There is no data pin for it — the card carries the same icon dropdown as the button's Appearance inspector.

On-card fields

Get Button Variant

blueprint.element.button.getVariant · Pure

The old id-based read. Kept registered so graphs that already contain it keep running; the palette does not offer it.

Set Button Variant

blueprint.element.button.setVariant · Latent

The old id-based write, likewise hidden. It has no variantId pin — it reads a stored parameter — and there is no author-facing way to fill that parameter any more. Use Set Element Variant, which picks Variants by name.

Container

Container nodes take an element:nl.container pin. The Self forms are in Container.

Get Container Clip Content

blueprint.element.container.getClipContent · Pure

Reads whether the container clips its overflowing content.

Set Container Clip Content

blueprint.element.container.setClipContent · Latent

Sets whether the container clips its overflowing content.

Get Container Variant

blueprint.element.container.getVariant · Pure

The old id-based read, hidden from the palette for the same reason as the Button pair.

Set Container Variant

blueprint.element.container.setVariant · Latent

The old id-based write, hidden from the palette. Use Set Element Variant.

Switch

Switch nodes take an element:nl.switch pin. The Self forms are in Switch; the Switch's visible and enabled pair is with the rest of that family on Displayable.

None of these dispatch the Switch's Changed, Turned On or Turned Off heads — those are for the player toggling it. A graph that writes the Switch it also listens to does not trigger itself.

Get Switch Checked

blueprint.element.switch.getChecked · Pure

Set Switch Checked

blueprint.element.switch.setChecked · Latent

Turn Switch On

blueprint.element.switch.turnOn · Latent

Set Switch Checked with true, as its own card so the common case reads as one word.

Turn Switch Off

blueprint.element.switch.turnOff · Latent

Toggle Switch

blueprint.element.switch.toggle · Latent

Flips the state and hands back what it became, so the branch after it does not need a second read.

Frame

Frame nodes take an element:nl.frame pin and act on the Frame's own target Page and params. Moving the player to a different Page is a different job, done by Go Page in App. The Self forms are in Frame.

Get Frame Target Page

blueprint.element.frame.getTargetPage · Pure

Reads the target Page's surface id, or an empty string when the Frame shows nothing.

Set Frame Page

blueprint.element.frame.setTargetPage · Latent

Switches the Frame to another Page. The dropdown filters out the Page the Frame itself sits on and any Page that leads back to it, directly or through a component. This Element form finds the Frame through the wired Element node, so until the reference is connected the dropdown lists every Page. The Frame then plays its normal enter and exit animation.

On-card fields

When the picked Page declares params, the card grows one input per param in front of props, as on the Self form in Frame.

Get Frame Params

blueprint.element.frame.getParams · Pure

Reads the params object handed to the embedded Page.

Set Frame Params

blueprint.element.frame.setParams · Latent

Writes the params object. A non-object value is normalized to an empty object.

Video

Video nodes take an element:nl.video pin named video, so they work from any graph on the page that holds a binding for a video, such as the blueprint of a skip button beside it. Each one does to the wired video what the node of the same name in Video does to its own video. The video's Playback Ended head is on the video's own blueprint.

Play Video

blueprint.element.video.play · Latent

Starts the video, resumes it from where it was paused, or plays it again from the start after it has ended.

Pause Video

blueprint.element.video.pause · Latent

Pauses the video where it is.

Stop Video

blueprint.element.video.stop · Latent

Pauses the video and returns it to the start of the clip.

Seek Video

blueprint.element.video.seek · Latent

Moves the video to time. A playing video moved to its end runs its Playback Ended.

Get Video Time

blueprint.element.video.getTime · Pure

Where the video is, in seconds from the start of the clip. 0 while there is no clip on screen.

Get Video Duration

blueprint.element.video.getDuration · Pure

How long the clip is, in seconds. 0 until the clip has loaded.

Is Video Playing

blueprint.element.video.isPlaying · Pure

true while the video is playing.

Is Video Ended

blueprint.element.video.isEnded · Pure

true once the clip has played to its end, until it is played or moved again. Always false while Loop is on.

Set Video Volume

blueprint.element.video.setVolume · Latent

Sets the video's volume in place of the Volume set on the widget.

Set Video Muted

blueprint.element.video.setMuted · Latent

Mutes or unmutes the video.

Set Video Loop

blueprint.element.video.setLoop · Latent

Turns Loop on or off.

Set Video Speed

blueprint.element.video.setPlaybackRate · Latent

Sets how fast the video plays: 1 is normal speed.

Get Video Volume

blueprint.element.video.getVolume · Pure

The video's volume, from 0 to 1, without the player's volume settings.

Is Video Muted

blueprint.element.video.isMuted · Pure

true while the video is muted.