Skip to content
search-results-list-block / 5.18.1-arc-themes-release-version-2.1.2.4757

search-results-list-block 5.18.1-arc-themes-release-version-2.1.2.4757

Install from the command line:
Learn more about npm packages
$ npm install @wpmedia/search-results-list-block@5.18.1-arc-themes-release-version-2.1.2.4757
Install via package.json:
"@wpmedia/search-results-list-block": "5.18.1-arc-themes-release-version-2.1.2.4757"

About this version

@wpmedia/search-results-list-block

Search Results List block for Fusion News Theme. This block displays a search bar with a results list where each result card will have a description, headline, byline block and publish date.

Acceptance Criteria

  • Add AC relevant to the block

Props

Prop Required Type Description
required prop yes
optional prop no
contentConfig example Please specify which content sources are compatible

ANS Schema

Outline any schema information requirements necessary to know for ths block

ANS Fields

  • n/a

Internationalization fields

| Phrase key | Default (English) | | ------------------------------------------- | -------------------------------------------- | --- | --- | --- | --------------------------------------------- | | search-results-block.search-button | Search | | search-results-block.search-result-number | %{smart_count} result for \"%{searchTerm}\" | | | | %{smart_count} results for \"%{searchTerm}\" | | search-results-block.see-more-button | See More |

Events

Blocks can emit events. The following is a list of events that are emitted by this block.

Event Name Description
eventName Describe the event

Event Listening

Include block specific instructions for event listening.

OR

This block does not emit any events.

Additional Considerations

This block expects the user to configure its content source to the search api. The initial query and page are irrelevant as these fields will be overridden by the input text from the search bar.

It also makes use of ByLine to display authors of each story and it is included as a dependency. The behavior for the byline is as follows:

  • If there's one author, it will return By <author>
  • If there are two authors, it will return By <author_0> and <author_1>
  • If there are three or more authors, it will return with the pattern By <author_0>, <author_1>, ... <author_(n-1)> and <author_(n)>

Custom Search Action

If you are creating custom blocks that are leveraging the global content part of the Search Results List block and need to over-ride the action taken when the search box field has been submitted (for both click and keyboard submissions) an over-ride function can be passed as a prop to either the main default.jsx or to the global-content.jsx component. The prop name is called customSearchAction.

If passed into default.jsx it will pass it down to global-content. Your implementation of customSearchAction should expect one param that will be the value of the search entry. If customSearchAction is not implemented, default behavior will occur during a search submission.