Skip to content

Conversation

snowystinger
Copy link
Member

Closes

✅ Pull Request Checklist:

  • Included link to corresponding React Spectrum GitHub Issue.
  • Added/updated unit tests and storybook for this change (for new code or code which already has tests).
  • Filled out test instructions.
  • Updated documentation (if it already exists for this component).
  • Looked at the Accessibility Practices for this feature - Aria Practices

📝 Test Instructions:

🧢 Your Project:

// Have to put the portal in a div with popover="manual" so it is also in the top layer and renders on top of the coachmark
// Note, this isn't great because I'm not honestly sure what would happen if the page scrolled or their is a parent which affects that placement, is
// top-layer unaffected by parent stacking context? scroll parent?
let internalContainer = useRef<HTMLDivElement>(null);
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

could remove this if we say menus aren't allowed in coachmarks, would need more examples and somewhere to put a 'X' button maybe?

@rspbot
Copy link

rspbot commented Apr 15, 2025

@rspbot
Copy link

rspbot commented Apr 15, 2025

@rspbot
Copy link

rspbot commented Apr 15, 2025

## API Changes

@react-spectrum/s2

/@react-spectrum/s2:UNSTABLE_CoachMark

+UNSTABLE_CoachMark {
+  UNSAFE_className?: string
+  UNSAFE_style?: CSSProperties
+  aria-describedby?: string
+  aria-details?: string
+  aria-label?: string
+  aria-labelledby?: string
+  boundaryElement?: Element = document.body
+  children: ReactNode
+  className?: string | ((PopoverRenderProps & {
+    defaultClassName: string | undefined
+})) => string
+  containerPadding?: number = 12
+  crossOffset?: number = 0
+  defaultOpen?: boolean
+  isOpen?: boolean
+  maxHeight?: number
+  offset?: number = 8
+  onOpenChange?: (boolean) => void
+  placement?: Placement = 'bottom'
+  shouldFlip?: boolean = true
+  shouldUpdatePosition?: boolean = true
+  slot?: string | null
+  style?: CSSProperties | ((PopoverRenderProps & {
+    defaultStyle: CSSProperties
+})) => CSSProperties | undefined
+  styles?: StylesProp
+}

/@react-spectrum/s2:UNSTABLE_CoachMarkTrigger

+UNSTABLE_CoachMarkTrigger {
+  children: ReactNode
+  isOpen?: boolean
+  onOpenChange?: (boolean) => void
+}

{...props}
<div
popover="manual"
role="dialog"
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

dialog? alert dialog? something else?

}
}

@starting-style {
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it should work to put this in the style macro as a condition?

let s = style({
  translateY: {
    default: 0,
    '@starting-style': 4
  }
});

Base automatically changed from coachmarks to main April 22, 2025 21:03
@snowystinger
Copy link
Member Author

Closing until we decide to pick this up again

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants