Styles¶
The styles of the UI dialect: the kinds of thing a layout is made of. A layout names a style and follows it with
what that face needs, in any order: a label for the code (total: before the style), a field name (the first
word after an input style), texts (a string, a text per language, or a quoted word of the dictionary), an icon
(#search), words of the dialect (see the words of the dialect), and blocks: the children of a
container, the items of a choice or a menu, and the action, the block at the end. stylize makes a style of
your own from one of these. See building screens.
view¶
The whole page: its children one under another. view [...] shows it; words before its first face (a width,
on-key) are the view’s own.
column¶
Children one under another.
row¶
Children side by side, wrapping onto the next line when they do not fit. With fields in it, they line up on
their controls; top, middle and bottom line them up otherwise. On a phone, a row with fields stacks them.
form¶
A form: its fields, with their labels beside them on a wide screen and above them on a narrow one. Its fields are
checked together, and its submit runs only when all of them are valid, with their values.
panel¶
A group on a raised background, with a title when it is given a text.
grid¶
Columns: grid 3 [...] gives three equal ones, grid [1 4 1] [...] the weight of each. On a narrow screen, as
many as fit, down to one.
scroll¶
An area with a scroll of its own, at most 400 pixels high (small 240, large 640). Its text names it for
screen readers, and the keyboard scrolls it.
desktop¶
A mat that takes all the height left on the page, with the image it is given (desktop %mat.png [...]) or a
color of the theme, on which tiles are laid from left to right. Its menu is the context menu.
title¶
The title of the page or of a screen: the text the browser shows for it, too.
heading¶
A heading inside a page.
text¶
Text. A date, a time, a number or an amount is shown in the format of the active language.
divider¶
A line between what comes before and after.
field¶
A line of text. Its value is a string, or none when empty.
password¶
A field whose text is hidden.
number¶
A field for a number. Its value is an integer or a decimal number; text that is not one stays on screen with its message.
money¶
A field for an amount: money price "Price" EUR. Its value is an exact money!; it shows formatted, and while
it is being edited, as a plain number in the language’s way.
date¶
A field for a date, with a calendar. Its value is a date!; it is typed in the order of the active language, or
as 2026-12-02.
date-range¶
Two dates, a start and an end, picked on one calendar: date-range stay "Stay". Its value is a block of two
date! values, the start first, or none. The first day picked stays marked until the second; the field shows
both in the active language, and they are typed apart by a dash, as 3/11/2026 – 10/11/2026. min holds for
the start and max for the end. A screen test sets it with type "Stay" [3-Nov-2026 10-Nov-2026].
time¶
A field for a time of day, with a list of times: time start "Start" step 15. Its value is a time!. It is
shown in the active language and typed as 9:30, 9.30, 930 or 9:30 pm. The list goes from its min
to its max, the whole day unless given, step minutes apart, 30 unless given, and opens on the time it holds
or the next one from now.
area¶
Several lines of text.
rich¶
Rich text: headings, bold, italic, lists and links. Its value is Markdown, a plain string; readonly shows it
formatted. Code puts text where the user’s cursor is with insert-text.
check¶
A check box. Its value is true or false.
choice¶
A list to choose one from: choice bike "Bike" ["Road" "City"]. An option is a string, both its value and its
text, or a map with a value and a text. A title followed by a block is a group of options:
["Repairs" ["Brakes" "Gears"] "Other"]. The title, like a text, may be a text per language or a word of
the dictionary.
Until one is picked it shows its hint, or Choose…. When it is required that line cannot be picked again;
when it is not, picking it puts the value back to none.
toggle¶
A switch. Its value is true or false.
slider¶
A number picked by moving a handle along a line, with the number it stands at after it:
slider volume "Volume" 0 50 step 5. The two numbers are the least and the most it takes, 0 and 100 unless
given, and step how far one move takes it, 1 unless given; a decimal step gives decimal values. It starts at
its least. The arrow keys, Home, End, Page Up and Page Down move it too. A screen test sets it with type.
radio¶
Options to choose one from, all shown: the same options as a choice, groups included, each with its title
over its options.
upload¶
A button to choose files, which is also a place to drop them. Its value is a block of objects with the name,
size, type and file of each; multiple takes more than one, accept ["pdf" "image/*"] says which.
video¶
A video, with the browser’s own controls: video %intro.mp4 "Introduction". Its text is what a screen reader
says for it. It takes poster, captions, loop, muted, autoplay and on-end (see
the words of the dialect), and as wide as it can be unless small, medium or large says
otherwise.
audio¶
A sound, with the browser’s own controls: audio %bell.m4a "Bell". It takes loop, muted, autoplay and
on-end.
widget¶
An element that the page’s JavaScript defines, as a face like any other: widget <geo-map> place "Place" [zoom: 12]. The tag names the element and comes first; the block sets its properties, and a second block is
the action. Its value is the element’s value property, both ways, as JSON; when the element sends change,
the value is read back and on-change runs. Any other on-xxx listens to the element’s event xxx, with the
event’s detail in event/detail. With a name it is a field of its form, so required and the rules apply.
The theme’s custom properties (--tb-*) reach it. See A face in JavaScript.
photo¶
An image and the buttons to choose another or remove it; clicking the image or dropping one on it chooses
too. Its value is none, the address of an image kept elsewhere (as a record from the server has it), or the
image chosen: an object with its name, size, type and file, as an upload’s. It takes images unless
accept says otherwise; round makes it a circle: photo picture "Photo" round.
lookup¶
A field that searches as the person types: its on-search gives what was found, and the person picks one, or
several with multiple. known says what each value shows as; links, the screen each links to when it is
read only.
progress¶
A bar: its value is a percent or a number from 0 to 1; with none, it moves without saying how far.
image¶
An image, from a file or an address: image %logo.png. Its text is what a screen reader says for it; without
one it is decoration. small, medium, large and fill set its width, and a pair its size, which it fills,
cut to fit: image %ada.jpg "Ada" 48x48 round. round cuts it to a circle, as for a person’s photo.
backdrop¶
An image behind what holds it: view [backdrop %entry.jpg ...]. It is not laid out with the rest; it
covers its container, and the whole window when that is the view or a screen. The theme lays a veil of the
background over it, just as strong as it takes for text on it to be easy to read on any image, in light and
dark; muted text takes the color of the text there.
canvas¶
It starts with extent: 300x150.
A drawing: canvas 120x120 [fill-pen primary circle 60x60 50]. The pair is the size of its drawing space, and
the block is in the draw dialect. It is as wide as that size, or narrower when there is no room,
and fill makes it as wide as it can be. With a string, the drawing is a picture with that name for a screen
reader; without one, it is decoration. Setting draw redraws it.
chart¶
It starts with kind: bar.
A chart of rows: chart bar income "Income" [month "Month" repairs "Repairs" parts "Parts"]. The word after
chart is its kind, bar, line, area or pie; the next one is its label, as in a table. The first
column names each point and the others are the series, each in a color of the theme; numbers, money and
percents show as they do in a table. A pie shows the first series. stacked puts the series of a bar or area
chart on top of each other, and small, medium or large sets its height. The string is its caption.
Setting data redraws it, and a screen reader reads the same numbers as a table.
orbit¶
One node of a graph in the middle and its neighbours on rings around it, joined by their edges:
view [
orbit "Organization" [
focus plenary
nodes [plenary "Plenary" [primary count 9] ana "Ana Ruiz" [accent] town "Town council"]
edges [plenary ana "Members"]
trail [town]
] [print value]
]
focus is the node in the middle; nodes gives each node an id (a word, an integer, a string or an issue), a
title, and a block of hints if it has any: a role or a color word, many for one that stands for many (a second
ring), dashed for a shortcut, count n for how many it holds (small moons and a number), and steps n at k
for a ring of n steps with the k-th the current one. edges gives two ids, a label and [solid], [dashed] or
[faint] if they have them; an edge between two neighbours bends around the middle. trail lists the nodes
the person came from, the most recent last; the last few show to one side, joined by a dotted line. Every node
given that is neither the focus nor in the trail is a neighbour; past 30, a bubble pages through them, and past
18, edge labels show only while the pointer is on a bubble.
Picking a neighbour sets value to its id and runs the action; picking a node of the trail, or Escape, runs
on-back instead, or the action when there is no on-back. The face never fetches anything: the action
sets data again, with the node picked in the middle, and the bubbles that stay move to their new places,
the new ones grow from the one picked and the rest fade. Dragging moves the view and a double click centres
it again; Ctrl and the wheel, or a pinch, zoom, and so does the wheel alone when fit makes it fill the
window. Tab goes through the neighbours and Enter picks one; a screen reader reads the node in the middle,
then each neighbour as a link with the label of its edge. small, medium or large sets its height.
icon¶
An icon of the set Trebol brings, icon #heart, drawn in the color of its role.
link¶
A link to a screen of the app: link "Clients" 'clients. It is a link for the browser too, so it opens in a
new tab when the person asks. Given a url or text instead, link "Web" client/website, it opens a web, mail
(mailto:) or phone (tel:) address or one with no scheme; any other (javascript:, data:) shows as a link
that goes nowhere, so data from a server can never run code. The same holds for the links of a lookup.
tile¶
A large icon with its name under it, for a desktop: tile #folder "Reports" [...]. linked marks with an arrow
one that stands for something kept elsewhere, and mark #list "List" puts a second, small icon on its icon.
table¶
Rows of data in columns: table board [customer "Customer" due "Due back"] names the field of each column and
its header; its data is a block of maps or objects. On a narrow screen, each row is a card. on-select lets the
rows be chosen; sortable or on-sort let the headers sort them; totals is a row shown at the foot.
Among the rows, [head 1 "Title"] is the title of a group, the width of the table, and [foot 1 row] its
subtotals; level 2 is indented. Neither is chosen or sorted: sortable sorts the rows inside each group. A
list shows them too. A column followed by image shows each row’s picture, from the address or file in its
field, and image round cuts it to a circle: table people [photo "" image round name "Name"].
list¶
The same rows as a table, as a list: the first field stands out and the rest go on a second line. The picture of a column of images goes first.
board¶
Cards in lanes: board jobs by status [todo "To do" doing "Doing" done "Done"] makes a lane for each word, with
its label, and puts in it, as a card, each row of its data whose status names it, a word or a text. A card
shows the row’s title, or the fields of card [title "Job" who "Mechanic"], the first one large, as a list
does. A card can be dragged to another lane, or moved there from its menu; then its field names that lane and
on-drop runs, with event/row, event/from and event/to: when it gives false, the card goes back.
on-select sees the card chosen as row. When the field holds a machine, a lane is a state: a card goes to the
lane only by a way of its machine from where it is to that state, whose event the drop sends.
tabs¶
It starts with value: 1.
Tabs, each with its title and its block: tabs ["General" [...] "Advanced" [...]]. Its value is the number of
the tab shown.
tab¶
One tab of tabs, which makes it: it is not written in a layout.
steps¶
It starts with value: 1.
A form filled in one step at a time: steps ["Who" [...] "Company" when [values/kind = "Company"] [...] "Check" [...]], each step a title and its block. A bar on top numbers the titles, and on a narrow screen a line says
“Step 2 of 3”. Back and Next go under the step; Next shows the messages of the step’s fields and moves on only
when they are all valid, and Enter in a field presses it. The submit buttons of the form show on the last step,
next to Back, and values holds the fields of every step. A step with when applies only while its block is
true: the bar leaves it out, and its fields are neither checked nor in values. Its value is the number of the
step on show, counting every step: setting it shows that step without checking anything. A step done is chosen
again with its title; each step moved on to is an entry in the browser’s history, so Back returns to the one
before.
step¶
One step of steps, which makes it: it is not written in a layout.
toolbar¶
A row of buttons that the keyboard reaches with one Tab and moves through with the arrows; --- puts a separator.
On a narrow screen, a button with an icon shows only the icon.
tree¶
Rows with rows inside, in their children, which open and close. Like a table, its rows can be chosen and
dragged.
screens¶
The screens of an app, one shown at a time, each with a link of its own: screens [home "Home" [...] client [id] "Client" [...]]. go goes to one; its value is the route shown.
screen¶
One screen of screens, which makes it: it is not written in a layout.
rows¶
A field made of rows the person adds and removes, each with the fields of its block:
rows lines "Lines" min 1 [field part "Part" number qty "Qty"]. Its value is a block with a map for each row.
entry¶
One row of rows, which makes it: it is not written in a layout.
submit¶
Made from button. It starts with role: primary, submit: true.
The button of a form: it runs its block only when every field of the form is valid, and Enter in any field
presses it. Its block sees the form’s values.
dialog¶
It starts with hidden: true.
A window over the page, hidden until open shows it and close hides it, with a title when it is given a text.
On a phone, it takes the whole screen.
split¶
It starts with value: 1.
Two panes side by side, with a handle between them that the mouse or the arrows move. On a narrow screen one is shown at a time: the one its value says, 1 or 2; the second has a button back to the first.