widget · ui.widget

button

Keyboard-focusable logical-action button.

ui.button(label, action_id, semantic_label, focus_order?)

Stable ID

ui.widget.button

Owner

app.ScriptUiWidget

Authority

presentation

Timing

composition

Availability

Phase 14G

Side effects

Emits a Controls-owned logical action when activated.

Determinism

Action identity is independent of physical input.

Introduced

1.0.0

Usage

Compose this widget only inside a balanced ui.begin_panel and ui.end_panel block. Its semantic metadata and focus order remain part of the validated interface graph.

Parameters

• None

Returns

A stable widget contract consumed by the interface composition host.

Cost

Counts against the package composition instruction and surface work budgets; it does not traverse simulation ownership.

Fields

This symbol has no fields.

Errors

• None

Examples

ui.button("Take Control", "ui.action.actor.take-control", "Directly control the selected villager", 1)

API history

• 1.0.0: Runtime contract published from the complete Phase 14 registry.

Related symbols

• ui.widget
• ui.button

Project references

• Game Development Phase 14
• Engine extension contract
• Source: src/app/script_ui_intent.hpp