set text batch (r9)

The set text batch widget is used to create multiple set text widgets at once.

set text batch: COMMON_INSTRUCTIONS 
SELECTALL. Select all that apply 
SELECTONE. Select one 

1. What types of books do you like to read? 
instructions: __SELECTALL__ 
type: checkbox 
1. mystery
2. sci-fi
3. spy thrillers
4. romance novels

2. What is your favorite color? 
instructions: __SELECTONE__ 
type: radio 
1. red
2. blue
3. green
4. black

First, provide a descriptive ID for the set text batch widget. Then, define an ID for each set text to be created, followed by the text to be displayed.

Each ID can then be piped elsewhere in the survey by including double underscores around the set text ID -- e.g., __SELECTONE__.

Details

• Programmers can include decorators to modify each set text individually.
• To modify all set texts defined with a set text batch, apply tags directly to the widget.
  • At this time explain, translate, and unchain are supported as decorators or tags.
• Lists and spreadsheets can also be used to define a series of set texts with set text batch. Use the items from tag to specify your source.

Additional examples

Modifying individual set texts

The example below adds tooltips for each set text using the explain decorator.

set text batch: INSTRUMENTS
SAX. saxophone { explain: A woodwind instrument }
TBONE. trombone { explain: A brass instrument }
SNARE. snare drum { explain: A percussion instrument }

Modifying set texts in bulk

By applying translate: n at the widget level, each set text will inherit the tag, indicating they should not be translated for other languages.

set text batch: ACTORS
translate: n 
JL. Jennifer Lawrence
DW. Denzel Washington
MY. Michelle Yeoh

Using lists with set text batch

Use the items from tag with set text batch to reference a list or spreadsheet.

set list: INST
SELECTALL. Select all that apply
SELECTONE. Select one
SELECTONEPERROW. Select one for each row

set text batch: COMMONINSTRUCTIONS
items from: INST