Skip to content

Hero Search

Alfred J Lin edited this page Jun 16, 2026 · 1 revision

Introduction

The Hero Search (Homepage Hero Search Box) is a specialized component built specifically for the UMD Libraries homepage. It is the primary gateway to the Libraries' search features — surfacing the UMD Discover and Search All tools as tabs, along with optional quick-action shortcuts, resource links, and a feedback prompt over a hero background image.

Specialized component. This is not a general-purpose content component. It is purpose-built for the Libraries homepage as the entry point into search, and is not intended for use on standard content pages.

It is composed of two components: the Hero Search (the parent box) and one or more Hero Search Quick Action components placed inside it. The search tabs reuse the Tab component's behavior, so the umd-libraries-tabs library is loaded automatically as a dependency.

Component Structure

Hero Search (Parent)

Props

Field Data Type Requirement Description Note
Component ID String Optional An ID for the component, useful for in-page anchor linking.

Slots

Field Data Type Requirement Description Note
Page Title String Optional The main heading for the page. It is visually hidden and read by screen readers only. Defaults to "UMD Libraries".
Search Title String Optional The heading displayed above the search tabs. Defaults to "Search".
Learn More Link Text String Optional Text for the support link next to the search title. Defaults to "Learn about search options". Only shown when Learn More URL is set.
Learn More URL String Optional URL for the support link next to the search title.
UMD Discover URL String Optional Base URL for UMD Discover. The search term is appended directly to this URL.
Search All URL String Optional URL for the Search All form. The search term is appended as a "query" parameter.
UMD Discover Input Placeholder String Optional Placeholder text for the UMD Discover search input. Defaults to "Search for books, articles, journals, and more...".
Search All Input Placeholder String Optional Placeholder text for the Search All search input. Defaults to "Search libraries collections, websites, research guides and more...".
UMD Discover Tab Description String Optional Short description displayed below the UMD Discover search input.
Search All Tab Description String Optional Short description displayed below the Search All search input.
Quick Actions UMD Lib Hero Search Quick Action component(s) Optional Place Hero Search Quick Action components here to add shortcut links in the UMD Discover quick-actions dropdown.
Resources Section Title String Optional Heading for the resources section. Defaults to "Resources". Only shown when resource links are added.
Resource Links UMD Lib Emphasized Link component(s) Optional Place Emphasized Link components here to list resource shortcuts below the search.
Feedback Link Text String Optional The linked portion of the feedback footer text. Defaults to "this feedback form". Only shown when Feedback Form URL is set.
Feedback Form URL String Optional URL for the feedback form link in the footer.
Hero Image URL String Optional URL of the hero background image.
Hero Image Alt Text String Conditional Alt text for the hero image. Required if Hero Image URL is used.
Hero Image Caption WYSIWYG Optional Caption text displayed over the hero image.

Hero Search Quick Action

One Quick Action component is placed inside the parent's Quick Actions slot for each shortcut. Each renders a link that points the entered search term at a specific content type and search tool.

Props

Field Data Type Requirement Description Note
ID String Required A unique identifier for this quick action link (e.g., "search-dropdown-articles").

Slots

Field Data Type Requirement Description Note
Content Type String Optional The search target content type (e.g., "Articles").
Search Tool String Optional The search tool (e.g., "UMD Discover").
URL String Required The fallback URL used when no search term has been entered.
Search URL String Optional The base URL that the search term is appended to (Primo format — query=any,contains,{term}). If omitted, falls back to URL.

Embedded Components

  • Emphasized Link — used to populate the Resource Links slot.
  • Tab — the search tab behavior is shared with the Tab component (loaded automatically as the umd-libraries-tabs dependency).

Clone this wiki locally