mirror of
https://github.com/discourse/discourse.git
synced 2025-01-06 14:15:48 +08:00
d886c55f63
This update adds a ✨ _new_ `<PostList />` component, along with it's child components (`<PostListItem/>` and `<PostListItemDetails />`). This new generic component can be used to show a list of posts.
It can be used like so:
```js
/**
* A component that renders a list of posts
*
* @component PostList
*
* @args {Array<Object>} posts - The array of post objects to display
* @args {Function} fetchMorePosts - A function that fetches more posts. Must return a Promise that resolves to an array of new posts.
* @args {String} emptyText (optional) - Custom text to display when there are no posts
* @args {String|Array} additionalItemClasses (optional) - Additional classes to add to each post list item
* @args {String} titleAriaLabel (optional) - Custom Aria label for the post title
*
*/
```
```hbs
<PostList
@posts={{this.posts}}
@fetchMorePosts={{this.loadMorePosts}}
@emptyText={{i18n "custom_identifier.empty"}}
@additionalItemClasses="custom-class"
/>
```
136 lines
5.3 KiB
Ruby
136 lines
5.3 KiB
Ruby
# frozen_string_literal: true
|
|
|
|
require "rails_helper"
|
|
|
|
RSpec.describe "Styleguide Smoke Test", type: :system do
|
|
fab!(:admin)
|
|
|
|
# keep this hash updated when adding, removing or renaming components
|
|
sections = {
|
|
"SYNTAX" => [{ href: "/syntax/bem", title: "BEM" }],
|
|
"ATOMS" => [
|
|
{ href: "/atoms/typography", title: "Typography" },
|
|
{ href: "/atoms/font-scale", title: "Font System" },
|
|
{ href: "/atoms/buttons", title: "Buttons" },
|
|
{ href: "/atoms/colors", title: "Colors" },
|
|
{ href: "/atoms/icons", title: "Icons" },
|
|
{ href: "/atoms/forms", title: "Forms" },
|
|
{ href: "/atoms/spinners", title: "Spinners" },
|
|
{ href: "/atoms/date-time-inputs", title: "Date/Time inputs" },
|
|
{ href: "/atoms/dropdowns", title: "Dropdowns" },
|
|
{ href: "/atoms/topic-link", title: "Topic Link" },
|
|
{ href: "/atoms/topic-statuses", title: "Topic Statuses" },
|
|
],
|
|
"MOLECULES" => [
|
|
{ href: "/molecules/bread-crumbs", title: "Bread Crumbs" },
|
|
{ href: "/molecules/categories", title: "Categories" },
|
|
{ href: "/molecules/char-counter", title: "Character Counter" },
|
|
{ href: "/molecules/empty-state", title: "Empty State" },
|
|
{ href: "/molecules/footer-message", title: "Footer Message" },
|
|
{ href: "/molecules/menus", title: "Menus" },
|
|
{ href: "/molecules/navigation-bar", title: "Navigation Bar" },
|
|
{ href: "/molecules/navigation-stacked", title: "Navigation Stacked" },
|
|
{ href: "/molecules/post-menu", title: "Post Menu" },
|
|
{ href: "/molecules/signup-cta", title: "Signup CTA" },
|
|
{ href: "/molecules/toasts", title: "Toasts" },
|
|
{ href: "/molecules/tooltips", title: "Tooltips" },
|
|
{ href: "/molecules/topic-list-item", title: "Topic List Item" },
|
|
{ href: "/molecules/topic-notifications", title: "Topic Notifications" },
|
|
{ href: "/molecules/topic-timer-info", title: "Topic Timers" },
|
|
],
|
|
"ORGANISMS" => [
|
|
{ href: "/organisms/post", title: "Post" },
|
|
{ href: "/organisms/post-list", title: "Post List" },
|
|
{ href: "/organisms/topic-map", title: "Topic Map" },
|
|
{ href: "/organisms/topic-footer-buttons", title: "Topic Footer Buttons" },
|
|
{ href: "/organisms/topic-list", title: "Topic List" },
|
|
{ href: "/organisms/basic-topic-list", title: "Basic Topic List" },
|
|
{ href: "/organisms/categories-list", title: "Categories List" },
|
|
{ href: "/organisms/chat", title: "Chat" },
|
|
{ href: "/organisms/modal", title: "Modal" },
|
|
{ href: "/organisms/navigation", title: "Navigation" },
|
|
{ href: "/organisms/site-header", title: "Site Header" },
|
|
{ href: "/organisms/suggested-topics", title: "Suggested Topics" },
|
|
{ href: "/organisms/user-about", title: "User About Box" },
|
|
],
|
|
}
|
|
|
|
before do
|
|
SiteSetting.styleguide_enabled = true
|
|
sign_in(admin)
|
|
end
|
|
|
|
# this test will check if the index page is rendering correctly and also ensures that all component pages are
|
|
# declared in the sections hash above
|
|
it "renders the index page correctly and collect information about the available page" do
|
|
visit "/styleguide"
|
|
expect(page).to have_css(".styleguide-contents h1.section-title", text: "Styleguide")
|
|
|
|
existing_sections = {}
|
|
page
|
|
.all(".styleguide-menu > ul")
|
|
.each do |section_node|
|
|
section = section_node.find(".styleguide-heading").text.strip
|
|
|
|
existing_sections[section] ||= []
|
|
items = existing_sections[section]
|
|
|
|
anchors = section_node.all("li a")
|
|
anchors.each { |anchor| items << { title: anchor.text.strip, href: anchor[:href] } }
|
|
end
|
|
|
|
expect(existing_sections.keys).to match_array(sections.keys)
|
|
|
|
sections.each do |section, items|
|
|
items.each do |item|
|
|
existing_items = existing_sections[section]
|
|
existing_item = existing_items.find { |i| i[:title] == item[:title] }
|
|
|
|
expect(existing_item).not_to be_nil,
|
|
"Item #{item[:title]} not declared in section #{section}"
|
|
expect(existing_item[:href]).to end_with(item[:href])
|
|
|
|
expect(existing_items.size).to eq(items.size),
|
|
"Section #{section} has a different number of items declared then what was found in the index page"
|
|
end
|
|
end
|
|
end
|
|
|
|
# uses the sections hash to generate a test for each page and check if it renders correctly
|
|
context "when testing the available pages" do
|
|
before do
|
|
SiteSetting.styleguide_enabled = true
|
|
sign_in(admin)
|
|
end
|
|
|
|
sections.each do |section, items|
|
|
items.each do |item|
|
|
xit "renders the #{section}: #{item[:title]} page correctly" do
|
|
visit "/styleguide/#{item[:href]}"
|
|
|
|
errors =
|
|
page
|
|
.driver
|
|
.browser
|
|
.logs
|
|
.get(:browser)
|
|
.select { |log| log.level == "SEVERE" }
|
|
.reject do |error|
|
|
["Failed to load resource", "Manifest", "PresenceChannelNotFound"].any? do |msg|
|
|
error.message.include?(msg)
|
|
end
|
|
end
|
|
|
|
if errors.present?
|
|
errors.each do |error|
|
|
expect(error.message).to be_nil, "smoke test failed with error: #{error.message}"
|
|
end
|
|
end
|
|
|
|
expect(page).to have_css(".styleguide-contents h1.section-title", text: item[:title])
|
|
end
|
|
end
|
|
end
|
|
end
|
|
end
|