Archetypes · Actions

Button

Label/icon, fires action.

#Contract

Label/icon, fires action. This is the archetype's identity: a component that keeps it is a Button on every target, however differently each one draws it. Its content category is a interactive phrase, 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
icon: icon  (optional)
label: text

#Behaviours

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

#Realization

Material FAB/elevated/tonal; iOS .borderedProminent

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 Button, 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 Button {
  archetype Button

  part Button: container {
  }

  part icon: icon {
  }

  part label: text {
  }
}

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