refactor(tabs): allow overriding button props

especially necessary for analytics tracking, so we can consistently recognize clicks inside the button padding
owid · Oct 17, 2024 · 7d2c1d1 · 7d2c1d1
1 parent 67f056e
commit 7d2c1d1
Show file tree

Hide file tree

Showing 4 changed files with 41 additions and 33 deletions.
diff --git a/packages/@ourworldindata/grapher/src/controls/ContentSwitchers.tsx b/packages/@ourworldindata/grapher/src/controls/ContentSwitchers.tsx
@@ -7,7 +7,7 @@ import { faTable, faEarthAmericas } from "@fortawesome/free-solid-svg-icons"
 import { ChartTypeName, GrapherTabOption } from "@ourworldindata/types"
 import { chartIcons } from "./ChartIcons"
 import { Bounds, capitalize } from "@ourworldindata/utils"
-import { Tabs } from "../tabs/Tabs.js"
+import { TabLabel, Tabs } from "../tabs/Tabs.js"
 
 export interface ContentSwitchersManager {
     availableTabs?: GrapherTabOption[]
@@ -91,17 +91,19 @@ export class ContentSwitchers extends React.Component<{
         }
     }
 
-    @computed private get tabLabels(): React.ReactElement[] {
-        return this.availableTabs.map((tab) => (
-            <span
-                key={tab}
-                data-track-note={"chart_click_" + tab}
-                aria-label={tab}
-            >
-                {this.tabIcon(tab)}
-                {this.showTabLabels && <span className="label">{tab}</span>}
-            </span>
-        ))
+    @computed private get tabLabels(): TabLabel[] {
+        return this.availableTabs.map((tab) => ({
+            element: (
+                <span key={tab}>
+                    {this.tabIcon(tab)}
+                    {this.showTabLabels && <span className="label">{tab}</span>}
+                </span>
+            ),
+            buttonProps: {
+                "data-track-note": "chart_click_" + tab,
+                "aria-label": tab,
+            },
+        }))
     }
 
     render(): React.ReactElement {

diff --git a/packages/@ourworldindata/grapher/src/modal/SourcesModal.tsx b/packages/@ourworldindata/grapher/src/modal/SourcesModal.tsx
@@ -36,7 +36,7 @@ import { CoreColumn } from "@ourworldindata/core-table"
 import { Modal } from "./Modal"
 import { SourcesKeyDataTable } from "./SourcesKeyDataTable"
 import { SourcesDescriptions } from "./SourcesDescriptions"
-import { Tabs } from "../tabs/Tabs"
+import { TabLabel, Tabs } from "../tabs/Tabs"
 import { ExpandableTabs } from "../tabs/ExpandableTabs"
 import { LoadingIndicator } from "../loadingIndicator/LoadingIndicator"
 import { isContinentsVariableId } from "../core/GrapherConstants"
@@ -113,20 +113,22 @@ export class SourcesModal extends React.Component<
         return this.manager.columnsWithSourcesExtensive
     }
 
-    @computed private get tabLabels(): ReactElement[] {
+    @computed private get tabLabels(): TabLabel[] {
         return this.columns.map((column) => {
             const attribution = joinTitleFragments(
                 column.titlePublicOrDisplayName.attributionShort,
                 column.titlePublicOrDisplayName.titleVariant
             )
-            return (
-                <React.Fragment key={column.slug}>
-                    {column.titlePublicOrDisplayName.title}
-                    {attribution && (
-                        <span className="attribution">{attribution}</span>
-                    )}
-                </React.Fragment>
-            )
+            return {
+                element: (
+                    <React.Fragment key={column.slug}>
+                        {column.titlePublicOrDisplayName.title}
+                        {attribution && (
+                            <span className="attribution">{attribution}</span>
+                        )}
+                    </React.Fragment>
+                ),
+            }
         })
     }
 
@@ -214,20 +216,18 @@ export class SourcesModal extends React.Component<
         }
 
         // compute the subset of tabs that fit into a single line
-        const getVisibleLabels = (
-            labels: React.ReactElement[]
-        ): React.ReactElement[] => {
+        const getVisibleLabels = (labels: TabLabel[]): TabLabel[] => {
             // take width of the "Show more" button into account
             let width =
                 measureTabWidth("Show more") +
                 13 + // icon width
                 6 // icon padding
 
-            const visibleLabels: React.ReactElement[] = []
+            const visibleLabels: TabLabel[] = []
             for (const [label, labelWidth] of zip(labels, clippedLabelWidths)) {
                 width += labelWidth as number
                 if (width > maxWidth) break
-                visibleLabels.push(label as React.ReactElement)
+                visibleLabels.push(label!)
             }
 
             return visibleLabels

diff --git a/packages/@ourworldindata/grapher/src/tabs/ExpandableTabs.tsx b/packages/@ourworldindata/grapher/src/tabs/ExpandableTabs.tsx
@@ -2,21 +2,21 @@ import React, { useState } from "react"
 import { FontAwesomeIcon } from "@fortawesome/react-fontawesome/index.js"
 import { faPlus, faMinus } from "@fortawesome/free-solid-svg-icons"
 import cx from "classnames"
-import { Tabs } from "./Tabs"
+import { TabLabel, Tabs } from "./Tabs"
 
 export const ExpandableTabs = ({
     labels,
     activeIndex,
     setActiveIndex,
     isExpandedDefault = false,
-    getVisibleLabels = (labels: React.ReactElement[]) => labels.slice(0, 3),
+    getVisibleLabels = (labels: TabLabel[]) => labels.slice(0, 3),
     maxTabWidth = 240,
 }: {
-    labels: React.ReactElement[]
+    labels: TabLabel[]
     activeIndex: number
     setActiveIndex: (index: number) => void
     isExpandedDefault?: boolean
-    getVisibleLabels?: (tabLabels: React.ReactElement[]) => React.ReactElement[]
+    getVisibleLabels?: (tabLabels: TabLabel[]) => TabLabel[]
     maxTabWidth?: number | null // if null, don't clip labels
 }) => {
     const [isExpanded, setExpanded] = useState(isExpandedDefault)

diff --git a/packages/@ourworldindata/grapher/src/tabs/Tabs.tsx b/packages/@ourworldindata/grapher/src/tabs/Tabs.tsx
@@ -1,6 +1,11 @@
 import React, { useRef } from "react"
 import cx from "classnames"
 
+export interface TabLabel {
+    element: React.ReactElement
+    buttonProps?: React.ButtonHTMLAttributes<HTMLButtonElement>
+}
+
 export const Tabs = ({
     labels,
     activeIndex,
@@ -11,7 +16,7 @@ export const Tabs = ({
     extraClassNames,
     variant = "default",
 }: {
-    labels: React.ReactElement[]
+    labels: TabLabel[]
     activeIndex: number
     setActiveIndex: (label: number) => void
     horizontalScroll?: boolean
@@ -83,8 +88,9 @@ export const Tabs = ({
                         aria-selected={isActive}
                         onClick={() => setActiveIndex(index)}
                         onKeyDown={handleKeyDown}
+                        {...label.buttonProps}
                     >
-                        {label}
+                        {label.element}
                     </button>
                 )
             })}