Back to Overview
REFERENCEAvailable

UXDL 0.1 Specification

Normative reference specification for UXDL 0.1 YAML syntax, identifiers, and schema objects.


Root Schema

YAML
uxdl: "0.1" # REQUIRED format version string
app: String # Optional application name
title: String # Optional specification title
screens: Object # REQUIRED dictionary of screens
actors: Object # Optional dictionary of actors
groups: Object # Optional dictionary of screen clusters
slices: Object # Optional dictionary of requirement slices
metadata: Object # Optional open document metadata

Screen & State Schema

YAML
screens:
<screen_id>:
name: String # REQUIRED human surface label
type: String # page | modal | sheet | drawer | panel | overlay
parent: String # Optional host screen ID for sub-screens
states:
<state_id>: String | Object
actions:
<action_id>: Object

Action & Relation Schema

YAML
actions:
<action_id>:
name: String # Human action label
actor: String # Identifier of initiating actor
relations:
<relation_id>:
to: String # Target screen or state ID
external: String # External URL string
end: Boolean # True if terminal flow
when: String # Natural language condition