---
title: Hover help
summary: Render a hover-triggered help icon with a positioned pop-up panel.
status: draft
owner: SAIF Doc Gen
last_reviewed: 2026-08-17
library: SAIF.Presentation.Web.Controls.V2
reference_type: package
operation_id: OP-V2-018
trigger: Control initialization and rendering for a `SAIFHoverHelp` instance.
---

# Hover help

Render a hover-triggered help icon with a positioned pop-up panel. Control initialization and rendering for a `SAIFHoverHelp` instance.

| Field | Value |
| --- | --- |
| **Operation ID** | OP-V2-018 |
| **Trigger** | Control initialization and rendering for a `SAIFHoverHelp` instance. |
| **Inputs** | `HelpText`, `PanelWidth`, `PopupPosition`. |
| **Outputs** | A help icon and a positioned pop-up panel containing `HelpText`. |
| **Primary components** | `SAIFHoverHelp` |
| **Entry point** | `SAIF.Presentation.Web.Controls.V2/SAIFHoverHelp.vb` |

## Steps

1. Apply CSS class `HoverHelpV2` and register `/Resources/Scripts/Controls/HoverHelp.js`. ([BR-V2-100](../business-rules.md#br-v2-100-hover-help-uses-a-fixed-css-class-and-script))
2. Render the default help icon `/Resources/Images/DefaultHelpImage.gif` and a pop-up panel sized by `PanelWidth` and positioned per `PopupPosition`, containing `HelpText`. ([BR-V2-101](../business-rules.md#br-v2-101-default-help-icon-is-a-fixed-image), [BR-V2-102](../business-rules.md#br-v2-102-pop-up-size-and-placement-controlled-by-properties))

## Process flow

The following diagram visualizes this operation's control flow.

```mermaid
flowchart TD
	Start([Init]) --> Css[Apply HoverHelpV2 CSS class, register HoverHelp.js]
	Css --> RenderS([Render]) 
	RenderS --> Icon[Render default help icon]
	Icon --> Popup[Render pop-up panel sized/positioned per PanelWidth/PopupPosition]
	Popup --> Done([Rendered])
```

## Failure and edge-case behavior

- No exceptional failure handling beyond the branches described in **Steps** was found in the analysis findings.*

## Related documentation
- [Operations and processes](../operations-processes.md)
- [Business rules](../business-rules.md)

## Sources
- `SAIF.Presentation.Web.Controls.V2/SAIFHoverHelp.vb`