Update app.py

app.py

@@ -36,6 +36,48 @@ def get_param_from_url(param):
     user_id = st.query_params.get(param, "")
     return user_id
 
+def ensure_tooltip_css():
+    if st.session_state.get("_tt_css_done"): 
+        return
+    st.markdown("""
+<style>
+.tt-wrap{display:inline-block; position:relative;}
+.help-tt{display:inline-flex; justify-content:center; align-items:center;
+  width:1.1rem; height:1.1rem; border-radius:999px; font-weight:700; 
+  border:1px solid rgba(0,0,0,.3); color:rgba(0,0,0,.75); 
+  background:rgba(0,0,0,.04); cursor:help; margin-left:.5rem;
+}
+.help-tt::before{content:"?"; font-size:.8rem; line-height:1;}
+.tt-panel{
+  position:absolute; z-index:9999; left:0; top:140%;
+  background:#111; color:#fff; padding:.6rem .8rem; border-radius:.5rem;
+  width:max-content; max-width:32rem; box-shadow:0 8px 24px rgba(0,0,0,.2);
+  opacity:0; transform:translateY(-4px); pointer-events:none;
+  transition:opacity .12s ease, transform .12s ease;
+}
+.tt-wrap:hover .tt-panel, .help-tt:focus + .tt-panel{
+  opacity:1; transform:translateY(0); pointer-events:auto;
+}
+.tt-panel dl{margin:0;}
+.tt-panel dt{font-weight:700; margin:.25rem 0 0;}
+.tt-panel dd{margin:0 0 .25rem 0;}
+</style>
+""", unsafe_allow_html=True)
+    st.session_state["_tt_css_done"] = True
+
+
+def deflist_tooltip_html(defs: list[tuple[str, str]]) -> str:
+    # build the <dl> content
+    import html as _html
+    dl = "".join(
+        f"<dt>{_html.escape(k)}</dt><dd>{_html.escape(v)}</dd>"
+        for k, v in defs
+    )
+    return f"""<span class="tt-wrap">
+        <span class="help-tt" tabindex="0" aria-label="definitions"></span>
+        <div class="tt-panel"><dl>{dl}</dl></div>
+    </span>"""
+
 ########################################################################################
 
 # 'local' or 'hf'. hf is for Hugging Face file system but has limits on the number of access per hour
@@ -131,7 +173,12 @@ fields: List[Field] = [
                    title="Level of priority", other_params={'labels': priority_labels}, mandatory=True),
     ]),
 
-    Field(type="container", title="##### Rupture Markers", children=[
+    Field(type="container", title="##### Rupture Markers", other_params={
+        "defs": [
+            ("Withdrawal", "Patient moves away from therapist/therapy."),
+            ("Confrontation", "Patient moves against therapist/therapy."),
+            ("Mixed", "Both withdrawal and confrontation markers present."),
+        ]}, children=[
         Field(type="expander", title="**Overview of rupture markers** *(expand)*", children=[
             Field(type="markdown", title="", other_params={"path": "rupture_marker_overview.md"}),
         ]),
@@ -443,6 +490,13 @@ def validate_current_page(fields: List[Field], index: int) -> bool:
     if not ok:
         st.error("Please fill in all mandatory fields.")
     return ok
+
+def render_container_header(title_md: str, defs: list[tuple[str,str]] | None = None):
+    ensure_tooltip_css()
+    tip = deflist_tooltip_html(defs) if defs else ""
+    # Title supports Markdown; append HTML “?” fragment
+    st.markdown(f"{title_md} {tip}", unsafe_allow_html=True)
+    
 #################################### Streamlit App ####################################
 
 # Function to navigate rows
@@ -528,6 +582,8 @@ def show_field(f: Field, index: int, data_collected):
                         show_field(child, index, data_collected)
 
             case 'container':
+                defs = f.other_params.get("defs") if f.other_params else None
+                render_container_header(f.title, defs)
                 with st.container(border=True):
                     st.markdown(f.title)
                     for child in (f.children or []):