|
|
declare namespace place {
|
|
|
interface PlacePosition {
|
|
|
x: number;
|
|
|
y: number;
|
|
|
}
|
|
|
|
|
|
interface PlaceWidthHeight {
|
|
|
w: number;
|
|
|
h: number;
|
|
|
}
|
|
|
|
|
|
interface PlaceRectangle extends PlacePosition, PlaceWidthHeight { }
|
|
|
|
|
|
type PlaceCorner = 'BL' | 'TR' | 'BR' | 'TL';
|
|
|
|
|
|
type PlacePositions = 'before' | 'after' | 'before-centered' | 'after-centered' | 'above-centered' | 'above' | 'above-alt' | 'below-centered' | 'below' | 'below-alt';
|
|
|
|
|
|
interface PlaceChoice {
|
|
|
corner: PlaceCorner;
|
|
|
pos: PlacePosition;
|
|
|
aroundCorner?: PlaceCorner;
|
|
|
}
|
|
|
|
|
|
interface PlaceLocation extends PlaceRectangle {
|
|
|
corner: PlaceCorner;
|
|
|
aroundCorner: PlaceCorner;
|
|
|
overflow: number;
|
|
|
spaceAvailable: PlaceWidthHeight;
|
|
|
}
|
|
|
|
|
|
interface LayoutNodeFunction {
|
|
|
(node: HTMLElement, aroundCorner: string, corner: string, spaceAvailable: PlaceWidthHeight, aroundNodeCoords: PlaceWidthHeight): number;
|
|
|
}
|
|
|
|
|
|
interface Place {
|
|
|
/**
|
|
|
* Positions node kitty-corner to the rectangle centered at (pos.x, pos.y) with width and height of
|
|
|
* padding.x * 2 and padding.y * 2, or zero if padding not specified. Picks first corner in corners[]
|
|
|
* where node is fully visible, or the corner where it's most visible.
|
|
|
*
|
|
|
* Node is assumed to be absolutely or relatively positioned.
|
|
|
*/
|
|
|
at(node: Element, pos?: PlacePosition, corners?: PlaceCorner[], padding?: PlacePosition, layoutNode?: LayoutNodeFunction): PlaceLocation;
|
|
|
|
|
|
/**
|
|
|
* Position node adjacent or kitty-corner to anchor
|
|
|
* such that it's fully visible in viewport.
|
|
|
*/
|
|
|
around(node: Element, anchor: Element | PlaceRectangle, positions: PlacePositions[], leftToRight?: boolean, layoutNode?: LayoutNodeFunction): PlaceLocation;
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
declare const place: place.Place;
|
|
|
export = place;
|
|
|
|
