Files
nairobi/spec/system/communities_spec.rb
Javi Martín 5214d89c88 Use order links to sort comments and topics
We use order links in many places in the web. However, in the comments
section and the list of community topics, we were displaying a
`<select>` element, and changing the location when users select an
option.

This has several disadvantages.

First, and most important, it's terrible for keyboard users. `<select>`
fields allow using the arrow keys to navigate through their options, and
typing a letter will select the first option starting with that letter.
This will trigger the "change" event and so users will navigate through
a new page while they were probably just checking the available options
[1]. For these reasons, WCAG Success Criterion 3.2.2 [2] states:

> Changing the setting of any user interface component does not
> automatically cause a change of context unless the user has been
> advised of the behavior before using the component.

Second, the form didn't have a submit button. This might confuse screen
reader users, who might not know how that form is supposed to be
submitted.

Finally, dropdowns have usability issues of their own [3], particularly
on mobile phones [4]

The easiest solution is to use the same links we generally use to allow
users select an order, so using them here we make the user experience
more consistent. They offer one disadvantage, though; on small screens
and certain languages, these links might take too much space and not
look that great. This issue affects pretty much every place where we use
order or filter links, so we might revisit it in the future.

Note we're moving the links to order comments after the form to add a
new comment. In my opinion, having an element such as a form to add a
new comment between the element to select the desired order of the
comments and the comments themselves is a bit confusing.

[1] https://webaim.org/techniques/forms/controls#javascript
[2] https://www.w3.org/WAI/WCAG21/Understanding/on-input.html
[3] https://www.youtube.com/watch?v=CUkMCQR4TpY
[4] https://www.lukew.com/ff/entry.asp?1950
2021-06-28 00:08:18 +02:00

143 lines
4.9 KiB
Ruby

require "rails_helper"
describe "Communities" do
context "Show" do
scenario "Should display default content" do
proposal = create(:proposal)
community = proposal.community
user = create(:user)
login_as(user)
visit community_path(community)
expect(page).to have_content "PROPOSAL COMMUNITY"
expect(page).to have_content proposal.title
expect(page).to have_content "Participate in the community of this proposal"
expect(page).to have_link("Create topic", href: new_community_topic_path(community))
end
scenario "Should display without_topics_text and participants when there are not topics" do
proposal = create(:proposal)
community = proposal.community
visit community_path(community)
expect(page).to have_content "Create the first community topic"
expect(page).to have_content "Participants (1)"
end
scenario "Should display order links and topic content when there are topics" do
proposal = create(:proposal)
community = proposal.community
topic = create(:topic, community: community)
create(:comment, commentable: topic)
visit community_path(community)
expect(page).to have_link "Newest first", class: "is-active"
expect(page).to have_link "Most commented"
expect(page).to have_link "Oldest first"
within "#topic_#{topic.id}" do
expect(page).to have_content topic.title
expect(page).to have_content "#{topic.comments_count} comment"
expect(page).to have_content I18n.l(topic.created_at.to_date)
expect(page).to have_content topic.author.name
end
end
scenario "Topic order" do
proposal = create(:proposal)
community = proposal.community
topic1 = create(:topic, community: community)
topic2 = create(:topic, community: community)
topic3 = create(:topic, community: community)
create(:comment, :with_confidence_score, commentable: topic1)
create(:comment, :with_confidence_score, commentable: topic3)
create(:comment, :with_confidence_score, commentable: topic3)
visit community_path(community, order: :most_commented)
expect(topic3.title).to appear_before(topic1.title)
expect(topic1.title).to appear_before(topic2.title)
visit community_path(community, order: :oldest)
expect(topic1.title).to appear_before(topic2.title)
expect(topic2.title).to appear_before(topic3.title)
visit community_path(community, order: :newest)
expect(topic3.title).to appear_before(topic2.title)
expect(topic2.title).to appear_before(topic1.title)
end
scenario "Should order by newest when order param is invalid" do
proposal = create(:proposal)
community = proposal.community
topic1 = create(:topic, community: community)
topic2 = create(:topic, community: community)
visit community_path(community, order: "invalid_param")
expect(topic2.title).to appear_before(topic1.title)
end
scenario "Should display topic edit button on topic show when author is logged" do
proposal = create(:proposal)
community = proposal.community
user = create(:user)
topic1 = create(:topic, community: community, author: user)
topic2 = create(:topic, community: community)
login_as(user)
visit community_topic_path(community, topic1)
expect(page).to have_link("Edit topic", href: edit_community_topic_path(community, topic1))
visit community_topic_path(community, topic2)
expect(page).not_to have_link("Edit topic", href: edit_community_topic_path(community, topic2))
end
scenario "Should display participant when there is topics" do
proposal = create(:proposal)
community = proposal.community
topic = create(:topic, community: community)
visit community_path(community)
within ".communities-participant" do
expect(page).to have_content "Participants (2)"
expect(page).to have_content topic.author.name
expect(page).to have_content proposal.author.name
end
end
scenario "Should display participants when there are topics and comments" do
proposal = create(:proposal)
community = proposal.community
topic = create(:topic, community: community)
comment = create(:comment, commentable: topic)
visit community_path(community)
within ".communities-participant" do
expect(page).to have_content "Participants (3)"
expect(page).to have_content topic.author.name
expect(page).to have_content comment.author.name
expect(page).to have_content proposal.author.name
end
end
scenario "Should redirect root path when communities are disabled" do
Setting["feature.community"] = nil
proposal = create(:proposal)
community = proposal.community
visit community_path(community)
expect(page).to have_current_path(root_path)
end
end
end