Archetypes · Disclosure

Dialog

Blocking layer (a.k.a. Modal).

#Contract

Blocking layer (a.k.a. Modal). This is the archetype's identity: a component that keeps it is a Dialog on every target, however differently each one draws it. Its content category is a region, which decides where it may sit and what it may contain.

#Anatomy

The published parts, with the role each one carries. The role is what a target derives the element from; the file never names an element.

text
trigger: control
  label: text
backdrop: container  (optional)
surface: container
  title: text
  content: container
  close: control  (optional)

#Behaviours

Composed from the prelude's atoms. An optional one is marked.

#Realization

iOS sheet w/ detents

What the React target does with it
The React generator realizes every archetype the prelude defines, and its output is typechecked against the real React types for each one on every change. Where a part or a constraint cannot be expressed, the generator reports it rather than approximating.

#Start from it

A component that starts from Dialog, before the author touches it: the root and the published anatomy, each part with the kind its role gives it. Paste it into a file, or open it in the Playground, and add the contract, the tokens and the states.

milda
component Dialog {
  archetype Dialog

  part Dialog: container {
  }

  part trigger: control {
  }

  part trigger.label: text {
  }

  part backdrop: container {
  }

  part surface: container {
  }

  part surface.title: text {
  }

  part surface.content: container {
  }

  part surface.close: control {
  }
}

Every statement a part can carry is in the reference; the tour shows the arc from archetype to generated code.