Elements Common API

Votable polls are subclasses of BasePoll class. This class should be used in code for generalization.

public class BasePoll: Frame

BasePoll encapsulates element state, voting logic contains code for State of the parent class. state manipulation, results, and notify subscribers about changes…

Elements which can be revealed are derived from RevelablePoll class.

public class RevelablePoll: BasePoll

RevelablePoll class contains methods for accessing Revealed state, if a poll has it.

Get id

Returns element id.

id: String

Get type

Returns element type.

type: String

Get content type

Returns element content type.

contentType: String

Get custom fields

Returns element custom fields as JSON.

customFields: JSON

Get duration

Returns element duration in seconds.

duration: Int

Get published time

Returns time element was published as UNIX time in seconds.

publishedAt: Int64

Has fixed duration

Returns true if element has fixed duration.

fixedDuration: Bool

Prompt during/ after voting

public var textDuringPoll: String?    
public var textAfterAnswering: String? 
public var textAfterPoll: String?

For a child of RevelablePoll Element:

public var textAfterReveal: String?
public var isRevealed: Bool 

Voting and results

Children elements overwrite, use basic method

public func baseVote(optionIndexes: [Int]) -> Bool
public var hasUserVoted: Bool 

Returns array where each element is an option index you've voted for.

userVote: [Int]?

Closures

Subscribe to element's changes.

onStateChanged: ((BasePoll.State) -> Void)?
onResults: ((Void) -> Void)?
onVote: ((Void) -> Void)?

Results

If results are available they can be determined by

....
public typealias ElementResultType = [String: AnyObject]
public typealias ElementResultsType = [ElementResultType]
....
 
public var hasResults: Bool
public var results: ElementResultsType!
public var resultsPerSource: ElementResultsType! 

Returned dictionaries might have keys from the structure:

public struct ElementResultKey {
    public static let Votes = "votes"
    public static let Percentage = "percentage"
    public static let Source = "source"
    public static let Voters = "voters"
    public static let Results = "results"
    public static let Volume = "volume"
    public static let Average = "average"
    public static let Time = "time"
}

Questions & Answers

Usually there is one question in a poll, but there can be several, in case of sliced poll Question index is defined by the following property:

public var questionIndex: Int = 0

Current question is determined by:

public var question: Question

All questions are determined by:

public var questions: [Question]

Options for current question are defined by:

public var options: [Option]

All answer options could be accessed by:

public var allOptions: [Option]

Options for specific question index can be accessed by:

public func getOptions(forQuestionIndex questionIndex: Int) -> [Option] {

State

If element can be in revealed state, it has Revealed state. Otherwise the state is not accessible.

public enum BasePoll.State: Int {
        case Started = 0
        case Stopped = 1
        case Revealed = 2
    }

For state detection there are some helper properties:

public var BasePoll.isStopped: Bool
public var RevelablePoll.isRevealed: Bool

Last updated