Colors

The Colors library: the ten named system colors with their values and addresses, your own swatches, the inspector, creating and editing a color, overriding a system color, and where a color is used.

View as Markdown

Colors is the third category under the Assets root: the fixed palette the product ships and the swatches you add, each a name with one #RRGGBB value. The panel is headed "Colors", with the line "Named #RRGGBB colors returned by Color-output variables. Operator colors override a system color at the same address." and the count pill. Reading it needs View logic; creating, editing and deleting your colors need Configure logic.

The system palette

Name Address Value
Brand Assets.Colors.Brand #0369A1
Brand light Assets.Colors.Brand_light #38BDF8
Brand tint Assets.Colors.Brand_tint #E0F2FE
Red Assets.Colors.Red #C42B1C
Amber Assets.Colors.Amber #C19C00
Green Assets.Colors.Green #0F7B0F
Blue Assets.Colors.Blue #005FB8
Gray Assets.Colors.Gray #8A8A8A
Black Assets.Colors.Black #000000
White Assets.Colors.White #FFFFFF

A color has one value, used as it is in the light and in the dark theme; the palette does not switch with the theme.

The catalog and the inspector

Your colors are listed first, then the palette; filters: Origin and Per page. A card shows the swatch, the name, the hex and the origin. The inspector shows the swatch large with its hex, the name, and Address, Origin (System palette, or My library) and Format (#RRGGBB). A palette color shows "System colors are read-only."; yours offers Edit and Delete to a configuring role.

New color

The verb over the Colors row opens "New color" in place of the grid ("Choose one stable address and its six-digit RGB value.").

Field What it is Values / default Effect
Name The display name; its segment is the address. Required. The address variables hold. Edit renames it later, and every reference to the old address travels with it. A name whose segment equals a palette color's replaces that color at the address and in the list.
Picker The browser's color picker. Starts at #0369A1. Writes the hex field.
Hex The value as text. Exactly #RRGGBB; #0369A1 by default. Anything else shows "Use exactly #RRGGBB."; the value is stored in upper case.

The preview on the right shows the swatch and the normalized hex. "A name is required." and "Use exactly #RRGGBB." keep Create color greyed; Cancel or Back leaves without creating. On success the card is revealed and the feed says "Color created."

Edit and Delete

Edit opens "Edit <name>" ("Renaming saves on Enter or when focus leaves the field and carries the references along; valid color changes save automatically."): a Name field that is a rename field, with the picker and the hex under it. While you type a name, a line previews the impact ("Renaming updates the 2 locations that read this address.", "No references use the current address.", or "The effective address does not change; no references need updating."). Enter, or leaving the field, commits: the color keeps its id and its value, every rooted reference to the old address is rewritten, and the feed says "Color renamed and N references updated." A name already taken is refused in place under the field. A valid value change is saved half a second after the last edit ("Color saved."). Delete asks "Delete 'X'? References to its address will become unresolved. This cannot be undone." and, when the color overrode a palette entry, uncovers that entry again.

Where a color is used

A Color-output variable returns Assets.Colors.<name> (Variables.Level.Value > 50 ? Assets.Colors.Red : Assets.Colors.Green) and the component bound to it draws that color; the Fill color and Stroke color inputs of a symbol take a Color asset or a Color variable; the dashboard editor offers these addresses wherever a property takes a color.

What the library does not do

It does not take alpha, three-digit or named colors, does not edit the palette, and keeps no per-theme variant.