chore: Make FormField analyticsMetadata public

cloudscape-design · Feb 5, 2025 · 6490f51 · 6490f51
1 parent 1ade36a
commit 6490f51
Show file tree

Hide file tree

Showing 3 changed files with 15 additions and 1 deletion.
diff --git a/pages/funnel-analytics/static-single-page-flow.page.tsx b/pages/funnel-analytics/static-single-page-flow.page.tsx
@@ -147,6 +147,9 @@ export default function StaticSinglePageCreatePage() {
               >
                 <SpaceBetween size="s">
                   <FormField
+                    analyticsMetadata={{
+                      instanceIdentifier: 'field1',
+                    }}
                     info={
                       <Link data-testid="external-link" external={true} href="#">
                         Learn more

diff --git a/src/form-field/interfaces.ts b/src/form-field/interfaces.ts
@@ -79,9 +79,20 @@ export interface FormFieldProps extends BaseComponentProps {
    * non-empty string, it will render the form field in a warning state.
    */
   warningText?: React.ReactNode;
+
+  /**
+   * Specifies additional analytics-related metadata.
+   * * `instanceIdentifier` - A unique string that identifies this component instance in your application.
+   * @analytics
+   */
+  analyticsMetadata?: FormFieldProps.AnalyticsMetadata;
 }
 
 export namespace FormFieldProps {
+  export interface AnalyticsMetadata {
+    instanceIdentifier?: string;
+  }
+
   export interface I18nStrings {
     /**
      * Provides a text alternative for the error icon in the error message.

diff --git a/src/internal/analytics/__integ__/static-single-page-flow.test.ts b/src/internal/analytics/__integ__/static-single-page-flow.test.ts
@@ -325,7 +325,7 @@ describe.each(['refresh', 'refresh-toolbar'] as Theme[])('%s', theme => {
         stepNumber: 1,
         subStepName: 'Container 1 - header',
         fieldErrorContext: null,
-        fieldIdentifier: null,
+        fieldIdentifier: 'field1',
         subStepErrorContext: null,
       });