Symbol

One of Tacit's symbols, by name, drawn in a square of the size you give it.

Symbol is the part under every symbol in the kit: the rail's, a row's, a button's. Use it for a kind of thing or a place. The symbols page shows the set and the rule that symbols never stand for actions; this page is the part.

Anatomy

A folder symbol, enlarged to seven times a row's size, in its square with a thin outline. Callouts name the drawing, the square's outline, and the room on each side of the square. — One symbol with its square and the room beside it.

DrawingCentred in the square, in one line weight.
Squaresize wide and high. The part takes this room whatever the drawing.
Room beside itPut 16 pixels before a row symbol and 16 after it; rows do this themselves.

Styles and ink

A folder symbol four times, numbered: in line in the secondary ink, filled in the secondary ink, in line in the main ink, and filled in the main ink. — Line and filled, in the two inks a symbol takes.

Line, secondary inkThe default.
Filled, secondary inkfilled: true.
Line, main inkA symbol under the pointer goes to the main ink; the part that holds it sets color.
Filled, main inkfilled: true with the same color.

A symbol has no states and answers to nothing itself; the row, rail row or button that holds it changes its colour.

Sizes

The folder symbol at three times each size, in its square: 17, 20 and 22 pixels, named rail, row and nav. — The three sizes at three times their size.

Token	Pixels	Where
`icon.rail`	17	The rail
`icon.row`	20	Rows and tools; the default
`icon.nav`	22	Back and forward

Accessibility

A symbol has no states of its own and is not a stop for Tab. To press one, use an icon button.
A symbol is hidden from screen readers. A symbol that is the only content of a control needs the control to be named: an icon button requires label.
Tacit installs carry only the Tacit symbol font, so a name the set does not have draws nothing, not a stand-in. tools/lint.py reports such names.

Names

Use the name the set gives it: folder, music_note, picture_as_pdf. Names are listed on the symbols page.

Do and don't

Two rows, a song and a folder, each with a symbol of the same size and ink. — DoTake the size from the place: rows and tools use 20.

The same rows with the symbols in the accent colour. — Don'tTint a kind symbol with the accent. The accent marks the current place and the primary ring, and a symbol in it reads as a state.

Code

import Tacit.Kit

Row {
    Symbol { text: "folder" }                              // 20, line, secondary ink
    Symbol { text: "folder"; filled: true; size: Kit.tokens.icon.rail }
    Symbol { text: "home"; color: Kit.tokens.inkMain }
}

Property	What it does
`text`	The symbol's name
`filled`	The filled style; line by default
`size`	The square, from `Kit.tokens.icon`; 20 by default
`color`	The ink; the secondary ink by default

Experimental, in Tacit.Kit 0.1.

Text and figures: CC BY 4.0. Tacit.Kit: LGPL-3.0 code, OFL fonts. The Tacit name.