textColor

Experiments

Sets the text color for a single trial. A plain color value recolors all of the trial’s text. When the color column is left empty, textColor also accepts that column’s per-element target:color syntax, so you can color the fixation cross or an individual stimulus from this column instead.

Syntax

Put a CSS color in the cell and the trial’s text is shown in that color: black, #FF0000 and rgb(0,0,0) all work.

To color individual elements instead, write a ;-separated list of target:color pairs, for example fixation:blue;stim1:green. See the color page for the list of targets. In this form only named colors and hex values are recognized.

Options

Value	Effect
empty	Nothing; the project default stays
CSS color (no ;)	Text color for this trial
target:color;... list	Per-element colors, as in the color column

Defaults & missing values

When the column is absent or the cell is left blank, the trial uses the text color set for the project, which is black unless you changed it.

A value applies to one trial only. Both the whole-trial color and any per-element colors are cleared when the trial ends, and the next trial starts again from the project default.

Works with

• color takes precedence: textColor is only read for per-element colors when color is empty. A plain whole-trial color in textColor applies either way.
• Feedback screens restore the text color from the project’s setup value, and expect that value to be a hex color written without the leading #. This concerns the project setting, not your cell, which is always used as written.
• Form trials repaint their text with the project’s text color, so a per-trial textColor has no effect on form rows.

Examples

type	stim1	stimFormat	textColor
test	apple	word	white

White text (stimulus word and trial text) for this trial.

type	stim1	stimFormat	fixation	textColor
test	apple	word	500	fixation:red;stim1:#00FF00

With color absent, the multi-target textColor colors the fixation cross red and the first word stimulus green, leaving the base text color at the default.

Tips & gotchas

• In the target:color form only the listed elements are recolored; the trial’s base text color stays at the project default.
• Write the list without spaces. fixation : red matches no element, fixation:red works.
• Nothing checks the color for validity or contrast: an invalid single value simply does nothing.

Caution

In the target:color form only named colors and hex values are recognized. rgb(...) values work as a single whole-trial color but not inside a target:color list.