Options
All
  • Public
  • Public/Protected
  • All
Menu

Interface FixedPositioningOptions<FixedToElement, FixedElement>

remarks

@since 4.0.0

Type parameters

  • FixedToElement: HTMLElement

    An HTMLElement type for the static element.

  • FixedElement: HTMLElement

    An HTMLElement type for the fixed element.

Hierarchy

Index

Properties

anchor?: PositionAnchor

The configuration to anchor the fixed element to the container element.

defaultvalue

BELOW_CENTER_ANCHOR

disableSwapping?: boolean

Boolean if the auto-swapping behavior should be disabled. It's normally recommended to not disable this since it'll allow elements to appear off screen.

defaultvalue

false

remarks

@since 5.0.0 This will always be true if the FixedPositionOptions.container is null. @remarks @since 5.1.6 Allow this to be false while the container is null. I can't figure out why I prevented that.

disableVHBounds?: boolean

Boolean if the fixed positioning should no longer prevent the fixed element to be positioned within the viewport. This is nice if you want to allow for full page scrolling instead and manually set a max-height on your element.

defaultvalue

false

fixedTo: RefObject<FixedToElement>

A ref pointing to an element that another element should be fixed to. This must be provided for the positioning to work.

initialX?: number

The initial x value to use when calculating the position instead of finding the container element to determine the the correct position. All the other positioning logic will still be in effect to ensure the element will be visible within the viewport.

initialY?: number

The initial y value to use when calculating the position instead of finding the container element to determine the the correct position. All the other positioning logic will still be in effect to ensure the element will be visible within the viewport.

nodeRef?: Ref<FixedElement>

{@inheritDoc TransitionOptions.nodeRef}

This function will be called once the TransitionStage has been set to "enter".

see

TransitionEnterHandler

This function will be called once the TransitionStage has been set to "entering".

see

TransitionEnterHandler

This function will be called once the TransitionStage has been set to "enter".

see

TransitionEnterHandler

This function will be called once the TransitionStage has been set to "exited".

see

TransitionExitHandler

onResize?: EventListener

An optional function to call if the page resizes while the {@link FixedElement} is visible.

onScroll?: TransitionScrollCallback<FixedToElement, FixedElement>

{@inheritDoc TransitionScrollCallback}

preventOverlap?: boolean

Boolean if the fixed element should no longer be able to overlap the container element. This is useful for autocomplete menus or other components that retain focus on the container element while the fixed element becomes visible.

defaultvalue

false

style?: CSSProperties

An optional style that will be merged with the fixed positioning required styles.

see

FixedPositionStyle

transformOrigin?: boolean

Boolean if the style object should include the transformOrigin value based on the x and y positions.

defaultvalue

false

vhMargin?: number

The viewwidth margin to apply so that the element doesn't need to be directly on the screen edge.

defaultvalue

16

vwMargin?: number

The viewwidth margin to apply so that the element doesn't need to be directly on the screen edge.

defaultvalue

16

width?: PositionWidth

{@inheritDoc PositionWidth}

xMargin?: number

The container width margin to apply so that the element doesn't need to be directly on the container's edge.

defaultvalue

0

yMargin?: number

The container height margin to apply so that the element doesn't need to be directly on the container's edge

defaultvalue

0

Methods

  • getFixedPositionOptions(): CalculateFixedPositionOptions
  • An optional function that can be used to override positioning options if some options require the element to be in the DOM for specific calculations.

    Returns CalculateFixedPositionOptions

Generated using TypeDoc