sf_branch: Define a branching rule

In surveyframe: Survey Instrument Workflows

Define a branching rule

Description

Creates a single-condition branching rule that shows or hides a survey item depending on the value of a preceding item. Only single-condition rules are supported. Multi-condition AND/OR logic is planned for a later release.

Usage

sf_branch(
  item_id,
  depends_on,
  operator = c("==", "!=", "%in%", ">", ">=", "<", "<="),
  value,
  action = c("show", "hide")
)

Arguments

item_id	Character. The id of the item whose visibility this rule controls.
depends_on	Character. The id of the item whose response value triggers this rule.
operator	Character. The comparison operator. One of "==", "!=", "%in%", ">", ">=", "<", or "<=".
value	The value to compare against the response to depends_on. For "%in%", supply a character or numeric vector.
action	Character. What to do when the condition is met. Either "show" (default) or "hide".

Value

An object of class sf_branch (a named list).

See Also

sf_instrument(), validate_sframe()

Examples

# Show an open-text follow-up only when the respondent selects "Other"
rule <- sf_branch(
  item_id    = "gender_other",
  depends_on = "gender",
  operator   = "==",
  value      = "other",
  action     = "show"
)

surveyframe documentation built on July 25, 2026, 1:07 a.m.