-
Notifications
You must be signed in to change notification settings - Fork 3
Hero Search
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.
| Field | Data Type | Requirement | Description | Note |
|---|---|---|---|---|
| Component ID | String | Optional | An ID for the component, useful for in-page anchor linking. |
| 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. |
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.
| Field | Data Type | Requirement | Description | Note |
|---|---|---|---|---|
| ID | String | Required | A unique identifier for this quick action link (e.g., "search-dropdown-articles"). |
| 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. |
- 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-tabsdependency).