RSDCopyStepNavigator

public protocol RSDCopyStepNavigator : RSDStepNavigator

An extension of the step navigator to allow inserting a section into the work-flow of this step navigator.

When using a step navigator that was developed by a third-party, it can be desirable to insert into that task flow steps related to the timing of the task. For example, a tapping task may also include asking about medication or a 12 minute run may prompt a clinic participant to put on their Fitbit before running. These additional questions or instructions need to be inserted into the task flow at a logical point after showing one or more initial screens.

  • Return a copy of the step navigator that includes the desired section inserted in a position that is appropriate to this navigator.

    Declaration

    Swift

    func copyAndInsert(_ section: RSDSectionStep) -> Self

    Parameters

    section

    The section step to insert.

    Return Value

    A copy of this navigator with the inserted section.

  • Return a copy of the step navigator that includes the desired subtask inserted in a position that is appropriate to this navigator.

    Declaration

    Swift

    func copyAndInsert(_ subtask: RSDTaskInfoStep) -> Self

    Parameters

    subtask

    The task info step to insert.

    Return Value

    A copy of this navigator with the inserted section.

  • Return a copy of the step navigator that removes the steps with the given identifiers.

    Declaration

    Swift

    func copyAndRemove(_ stepIdentifiers: [String]) -> Self

    Parameters

    stepIdentifiers

    The identifiers for the steps to remove.

    Return Value

    A copy of this navigator without the given steps.