[Story] Render poll start events in the timeline

[Johennes]

Description

• As a user
• I want to see when polls are started in the timeline
• so that I can follow (and later vote on) them
• There will be no limit to the length of a poll option, we won't truncate the text on screen. We'll simply show all the text we have.

Size estimate

M

Dependencies

• [Prep] Expose aggregated poll start / end events in Rust SDK timeline #1829

Acceptance criteria

• Poll start events are rendered in the timeline (when poll is created from another session/app)
• If user has voted on the poll from another platform, they can see their own votes
• If a user changes their vote on another platform, the vote updates on EX in real time
• If the "show votes" switch is enabled, the results can be seen before and after voting (and when poll closes)
• If the "show votes" switch is disabled, the results cannot be seen before or after voting as long as the poll is open (can be seen once poll closes)
• Poll end events are not rendered in the timeline¹
• Poll votes are not rendered in the timeline
• When the poll has ended, the start event is updated to show closed state (radio buttons are no longer visible and total is shown in all cases, user's own vote is highlighted in green/bold)
• Poll in timeline is accessible to native OS screen readers
  • TBD: define how the poll should be announced (ideally we want question and vote options to be read, and for user to be able to vote) see comment at: [Story] Render poll start events in the timeline #1830 (comment)
• Poll matches designs for dark and light themes - dark theme designs are not provided, use compound

Testing:
Mix of unit testing and manual testing in Kiwi

Out of scope

• Creating a poll from EX
• Editing a poll
• Voting on a poll
• Vote withdrawal

Sign-off

Android

• Design sign-off on completion
• QA sign-off on completion
• Product sign-off on completion

iOS

• Design sign-off on completion
• QA sign-off on completion
• Product sign-off on completion

Subtasks

External Dependencies

Figma designs

Open Questions

What to do when there are UTDs in any of the events needed for aggregation? Should we still show partial (i.e. incorrect) results or should we not show any result? Should we also surface a human readable UTD warning?

Android

Preview Give feedback

1. "View only" polls in the timeline vector-im/element-x-android#1031
   +0
2. [Poll] Render ended poll and improve UI in the timeline vector-im/element-x-android#1113
   +0
3. New icons for Poll and Poll end vector-im/element-x-android#1280
   +0
   
4. Set proper progress indicator track color on polls vector-im/element-x-android#1295
   +0
   
5. Make PollContentView a11y friendly vector-im/element-x-android#1345
   +0
   

iOS

Preview Give feedback

1. "View only" polls in the timeline vector-im/element-x-ios#1399
   +0
   
2. Refine polls UI in the timeline vector-im/element-x-ios#1474
   +0
   

Other

Preview Give feedback

No tasks being tracked yet.

Footnotes

1. This matches other platforms and helps mitigate the impact of not using the relations API within the timeline to get accurate poll results in the initial version ↩

[sempruijs]

I think poll should be treated in the following way:

[{title}]
[{name_option_1}, {is_selected}, {percentage}]
[{name_option_2}, {is_selected}, {percentage}]
[{amount_of_votes_casted}]

each [] set is 1 element that you can hear.

I use screenreader every day and I believe that this is a good implementation for talkback as wel as VoiceOver

[julioromano]

I think poll should be treated in the following way:

[{title}] [{name_option_1}, {is_selected}, {percentage}] [{name_option_2}, {is_selected}, {percentage}] [{amount_of_votes_casted}]

each [] set is 1 element that you can hear.

I use screenreader every day and I believe that this is a good implementation for talkback as wel as VoiceOver

@kittykat @sempruijs this should improve a bit the talkback behavior on polls.
It should be out in tomorrow's nightly. Please let me know what you think about it.