shepherd icon indicating copy to clipboard operation
shepherd copied to clipboard

Arrow position not working when using custom FloatingUI options

Open lalpou opened this issue 1 year ago • 8 comments

I'm using the following custom FloatingUI options in the "defaultStepOptions":

const shepherdTour = new Shepherd.Tour({
    steps: tourOptions.steps,
    keyboardNavigation: true,
    defaultStepOptions: {
	    scrollTo: { behavior: 'smooth', block: 'center' },
	    floatingUIOptions: {
		    middleware: [shift({ padding: 32 }), offset(16)]
	    }
    }
});

When the position of the tooltip is calculated, the middleware of the arrow and the shift options is applied in the following order:

[flip, shift, arrow, shift, offset] // The first 3 are from internal Shepherd.js settings

This causes an issue with how the arrow is placed, since the arrow middleware should be last in the order.

I've attempted to fix this using the beforeShowPromise and the whenShow functions, but run into issues with applying the arrow middleware in those places. In the beforeShowPromise the step element hasn't been generated yet, meaning the arrow can't be targeted and in the whenShow function the computePosition function for FloatingUI has already been run.

How can I apply shift with padding while still achieving correct arrow placement?

lalpou avatar Oct 21 '24 13:10 lalpou

Reverting back to before the changes made in #3005 fixes the problem. I guess some of the default middleware should still override the user set ones (such as the arrow)

lalpou avatar Oct 22 '24 08:10 lalpou

Thanks for letting us know @lalpou. @chuckcarpenter I wonder if we need to not just merge the options but like merge some and push some onto the end etc?

RobbieTheWagner avatar Nov 01 '24 18:11 RobbieTheWagner

@RobbieTheWagner I think it's worth testing an append of arrow last, unless there's a user supplied one

chuckcarpenter avatar Nov 01 '24 20:11 chuckcarpenter

I am also running into this issue where doing a shift moved the arrow instead of keeping the arrow centered on the attachTo element. Reverting to npm version 12.0.6 fixed it and it now correctly keeps the arrow centered even if the tooltip position is shifted via FloatingUI Options.

@RobbieTheWagner Any idea if there are plans to fix this in the near future?

earlwilson avatar Nov 09 '24 02:11 earlwilson

@earlwilson thanks for verifying. It's our intent to add a test and apply a fix, but we've both not had the time to dive in quite yet. We will do that as soon as we can, but would also welcome a PR if you think you could tackle it?

chuckcarpenter avatar Nov 12 '24 18:11 chuckcarpenter

@lalpou apologies it's been awhile, but I'm actually having a hard time replicating. Do you have somewhere we can see an example? Even with arrow in the middle it seems to take the correct placement. The only thing I have different here is a reset for dialog b/c that does some weird stuff with margin.

dialog.shepherd-element {
    padding: 0;
    border: none;
    margin: 0;
    background: none;
    position: static;
    width: auto;
    height: auto;
    color: inherit;
    font: inherit;
  }
image

chuckcarpenter avatar Dec 05 '24 23:12 chuckcarpenter

Just found this issue, which I believe is related to the one I opened here: https://github.com/shipshapecode/shepherd/issues/3145

The linked issue has an example. Is what I supplied there enough?

BenJackGill avatar Mar 19 '25 09:03 BenJackGill

I just tried reverting to 12.0.6 and it did not fix my issue.

BenJackGill avatar Mar 21 '25 05:03 BenJackGill