# `LabelSpec.text`

> Contract 2.0.0 · package sha256 `a857eca95b35921109faf997094bb4192f12527d9d0fcd4be7e97f06425bad6e` · generated from `configurator-runtime.d.ts` by `services/onsite-scripter/scripts/build-contract-docs.mjs`; edit the source, not this file.

Property of [`LabelSpec`](LabelSpec.md) · stable · since 2.0.0

```ts
text?: string;
```

Plain text, on one line, centred in the quad, in `el`'s computed `font-family` and '#000000'
with no plate, scaled uniformly to the largest size that fits inside [`size`](LabelSpec.size.md): never stretched
or clipped, so a longer string draws smaller. A [`Frame.text`](Frame.text.md) write changes it while it holds
([`Frame`](Frame.md)) and fits the same way. Exact type or a plate: an [`image`](LabelSpec.image.md).

**Default:** undefined

## Generic-API test (spec 3.1)

| Rule | Result |
| --- | --- |
| 1. Neutral name | pass: `text` names no product |
| 2. A precedent | pass (through its owner [`LabelSpec`](LabelSpec.md)): [Babylon.js SpriteManager](https://github.com/BabylonJS/Babylon.js/blob/master/packages/dev/core/src/Sprites/spriteManager.ts) (row `K50`); [model-viewer (ar, camera-orbit, auto-rotate)](https://modelviewer.dev/docs/) (row `K50`) |
| 3. Two apps, or labs | pass (through its owner [`LabelSpec`](LabelSpec.md)): 3 apps (ledger: app-ddfb017681, app-fc07850558, app-fc306ec3dc) |
| 4. The cheaper fix first | decided per need in Appendix B: rows `K50` (through its owner [`LabelSpec`](LabelSpec.md)) at tier stable (a member only where no rule, data, asset or app code serves the need) |
