lisn.js/dist/esm/utils/css-alter.d.ts

Simply handle user gestures and actions. Includes widgets.

/**
 * @module Utils
 *
 * @categoryDescription DOM: Querying
 * These functions query the style, attributes or other aspects of elements, but
 * could lead to forced layout if not scheduled using {@link waitForMeasureTime}.
 *
 * @categoryDescription DOM: Querying (optimized)
 * These functions query the style, attributes or other aspects of elements in
 * an optimized way. Functions that could cause a forced layout use
 * {@link waitForMeasureTime} and so are asynchronous. Functions that can
 * perform the check without forcing a re-layout are synchronous.
 *
 * @categoryDescription Style: Altering
 * These functions transition an element from one CSS class to another, but
 * could lead to forced layout if not scheduled using {@link waitForMutateTime}.
 * If a delay is supplied, then the transition is "scheduled" and if the
 * opposite transition is executed before the scheduled one, the original one
 * is cancelled. See {@link transitionElement} for an example.
 *
 * @categoryDescription Style: Altering (optimized)
 * These functions transition an element from one CSS class to another in an
 * optimized way using {@link waitForMutateTime} and so are asynchronous.
 * If a delay is supplied, then the transition is "scheduled" and if the
 * opposite transition is executed before the scheduled one, the original one
 * is cancelled. See {@link transitionElement} for an example.
 */
import { FlexDirection } from "../globals/types.js";
/**
 * Removes the given `fromCls` class and adds the given `toCls` class to the
 * element.
 *
 * Unlike {@link https://developer.mozilla.org/en-US/docs/Web/API/DOMTokenList/replace | DOMTokenList:replace},
 * this will always add `toCls` even if `fromCls` isn't in the element's class list.
 *
 * @returns True if there was a change made (class removed or added), false
 * otherwise.
 *
 * @category Style: Altering
 */
export declare const transitionElementNow: (element: Element, fromCls: string, toCls: string) => boolean;
/**
 * Like {@link transitionElementNow} except it will {@link waitForMutateTime},
 * and optionally a delay, and it finally awaits for the effective style's
 * transition-duration.
 *
 * If a delay is supplied, then the transition is "scheduled" and if the
 * opposite transition is executed before the scheduled one, this one is
 * cancelled.
 *
 * @example
 *
 * - {@link showElement} with delay of 100 schedules `lisn-hide` -> `lisn-show`
 *   in 100ms
 * - then if {@link hideElementNow} is called, or a scheduled
 *   {@link hideElement} completes  before that timer runs out, this call to
 *   {@link showElement} aborts
 *
 * ```javascript
 * hideElement(someElement, 10);
 * // this will be aborted in 10ms when the scheduled hideElement above
 * // completes
 * showElement(someElement, 100);
 * ```
 *
 * ```javascript
 * // this will be aborted in 10ms when the hideElement that will be scheduled
 * // below completes
 * showElement(someElement, 100);
 * hideElement(someElement, 10);
 * ```
 *
 * ```javascript
 * // this will be aborted immediately by hideElementNow that runs straight
 * // afterwards
 * showElement(someElement, 100);
 * hideElementNow(someElement);
 * ```
 *
 * ```javascript
 * hideElementNow(someElement);
 * // this will NOT be aborted because hideElementNow has completed already
 * showElement(someElement, 100);
 * ```
 *
 * @category Style: Altering (optimized)
 */
export declare const transitionElement: (element: Element, fromCls: string, toCls: string, delay?: number) => Promise<boolean>;
/**
 * Transitions an element from class `lisn-undisplay` (which applies `display:
 * none`) to `lisn-display` (no style associated with this).
 *
 * The difference between this and simply removing the `lisn-undisplay` class
 * is that previously scheduled transitions to `lisn-undisplay` will be
 * cancelled.
 *
 * @see {@link transitionElementNow}
 *
 * @category Style: Altering
 */
export declare const displayElementNow: (element: Element) => boolean;
/**
 * Like {@link displayElementNow} except it will {@link waitForMutateTime}, and
 * optionally a delay.
 *
 * @see {@link transitionElement}
 *
 * @category Style: Altering (optimized)
 */
export declare const displayElement: (element: Element, delay?: number) => Promise<boolean>;
/**
 * The opposite of {@link displayElementNow}.
 *
 * @see {@link transitionElementNow}
 *
 * @category Style: Altering
 */
export declare const undisplayElementNow: (element: Element) => boolean;
/**
 * Like {@link undisplayElementNow} except it will {@link waitForMutateTime},
 * and optionally a delay.
 *
 * @see {@link transitionElement}
 *
 * @category Style: Altering (optimized)
 */
export declare const undisplayElement: (element: Element, delay?: number) => Promise<boolean>;
/**
 * Transitions an element from class `lisn-hide` (which makes the element
 * hidden) to `lisn-show` (which shows it). These classes have CSS
 * transitions applied so the element is faded into and out of view.
 *
 * @see {@link transitionElementNow}.
 *
 * @category Style: Altering
 */
export declare const showElementNow: (element: Element) => boolean;
/**
 * Like {@link showElementNow} except it will {@link waitForMutateTime}, and
 * optionally a delay.
 *
 * @see {@link transitionElement}
 *
 * @category Style: Altering (optimized)
 */
export declare const showElement: (element: Element, delay?: number) => Promise<boolean>;
/**
 * The opposite of {@link showElementNow}.
 *
 * @see {@link transitionElementNow}
 *
 * @category Style: Altering
 */
export declare const hideElementNow: (element: Element) => boolean;
/**
 * Like {@link hideElementNow} except it will {@link waitForMutateTime}, and
 * optionally a delay.
 *
 * @see {@link transitionElement}
 *
 * @category Style: Altering (optimized)
 */
export declare const hideElement: (element: Element, delay?: number) => Promise<boolean>;
/**
 * If {@link isElementUndisplayed}, it will {@link displayElementNow},
 * otherwise it will {@link undisplayElementNow}.
 *
 * @see {@link transitionElementNow}
 *
 * @category Style: Altering
 */
export declare const toggleDisplayElementNow: (element: Element) => boolean;
/**
 * Like {@link toggleDisplayElementNow} except it will {@link waitForMutateTime},
 * and optionally a delay.
 *
 * @see {@link transitionElement}
 *
 * @category Style: Altering (optimized)
 */
export declare const toggleDisplayElement: (element: Element, delay?: number) => Promise<boolean>;
/**
 * If {@link isElementHidden}, it will {@link showElementNow}, otherwise
 * {@link hideElementNow}.
 *
 * @see {@link transitionElementNow}
 *
 * @category Style: Altering
 */
export declare const toggleShowElementNow: (element: Element) => boolean;
/**
 * Like {@link toggleShowElementNow} except it will {@link waitForMutateTime}, and
 * optionally a delay.
 *
 * @see {@link transitionElement}
 *
 * @category Style: Altering (optimized)
 */
export declare const toggleShowElement: (element: Element, delay?: number) => Promise<boolean>;
/**
 * Returns true if the element's class list contains `lisn-hide`.
 *
 * @category DOM: Querying (optimized)
 */
export declare const isElementHidden: (element: Element) => boolean;
/**
 * Returns true if the element's class list contains `lisn-undisplay`.
 *
 * @category DOM: Querying (optimized)
 */
export declare const isElementUndisplayed: (element: Element) => boolean;
/**
 * Returns true if the element's class list contains the given class.
 *
 * @category DOM: Querying (optimized)
 */
export declare const hasClass: (element: Element, className: string) => boolean;
/**
 * Returns true if the element's class list contains all of the given classes.
 *
 * @since v1.2.0
 *
 * @category DOM: Querying (optimized)
 */
export declare const hasAllClasses: (element: Element, ...classNames: string[]) => boolean;
/**
 * Returns true if the element's class list contains any of the given classes.
 *
 * @since v1.2.0
 *
 * @category DOM: Querying (optimized)
 */
export declare const hasAnyClass: (element: Element, ...classNames: string[]) => boolean;
/**
 * Adds the given classes to the element.
 *
 * @category Style: Altering
 */
export declare const addClassesNow: (element: Element, ...classNames: string[]) => void;
/**
 * Like {@link addClassesNow} except it will {@link waitForMutateTime}.
 *
 * @category Style: Altering (optimized)
 */
export declare const addClasses: (element: Element, ...classNames: string[]) => Promise<void>;
/**
 * Removes the given classes to the element.
 *
 * @category Style: Altering
 */
export declare const removeClassesNow: (element: Element, ...classNames: string[]) => void;
/**
 * Like {@link removeClassesNow} except it will {@link waitForMutateTime}.
 *
 * @category Style: Altering (optimized)
 */
export declare const removeClasses: (element: Element, ...classNames: string[]) => Promise<void>;
/**
 * Toggles the given class on the element.
 *
 * @param force See {@link https://developer.mozilla.org/en-US/docs/Web/API/DOMTokenList/toggle | DOMTokenList:toggle}
 *
 * @category Style: Altering
 */
export declare const toggleClassNow: (element: Element, className: string, force?: boolean) => boolean;
/**
 * Like {@link toggleClassNow} except it will {@link waitForMutateTime}.
 *
 * @category Style: Altering (optimized)
 */
export declare const toggleClass: (element: Element, className: string, force?: boolean | undefined) => Promise<boolean>;
/**
 * Toggles the given classes on the element. This function does not accept the
 * `force` parameter.
 *
 * @since v1.2.0
 *
 * @category Style: Altering
 */
export declare const toggleClassesNow: (element: Element, ...classNames: string[]) => void;
/**
 * Like {@link toggleClassesNow} except it will {@link waitForMutateTime}.
 *
 * @since v1.2.0
 *
 * @category Style: Altering (optimized)
 */
export declare const toggleClasses: (element: Element, ...classNames: string[]) => Promise<void>;
/**
 * Replaces the given class on the element with a new one.
 *
 * @since v1.2.0
 *
 * @category Style: Altering
 */
export declare const replaceClassNow: (element: Element, oldClassName: string, newClassName: string) => boolean;
/**
 * Like {@link replaceClassNow} except it will {@link waitForMutateTime}.
 *
 * @since v1.2.0
 *
 * @category Style: Altering (optimized)
 */
export declare const replaceClass: (element: Element, oldClassName: string, newClassName: string) => Promise<boolean>;
/**
 * Returns the value of the given data attribute. The name of the attribute
 * must _not_ start with `data`. It can be in either camelCase or kebab-case,
 * it is converted as needed.
 *
 * @category DOM: Querying (optimized)
 */
export declare const getData: (element: Element, name: string) => string | null;
/**
 * Returns the value of the given data attribute as a boolean. Its value is
 * expected to be either blank or "true" (which result in `true`), or "false"
 * (which results in `false`).
 *
 * The name of the attribute must _not_ start with `data`. It can be in either
 * camelCase or kebab-case, it is converted as needed.
 *
 * @since v1.2.0
 *
 * @category DOM: Querying (optimized)
 */
export declare const getBooleanData: (element: Element, name: string) => boolean;
/**
 * @ignore
 * @deprecated
 *
 * Deprecated alias for {@link getBooleanData}
 */
export declare const getBoolData: (element: Element, name: string) => boolean;
/**
 * Sets the given data attribute.
 *
 * The name of the attribute must _not_ start with `data`. It can be in either
 * camelCase or kebab-case, it is converted as needed.
 *
 * @category Style: Altering
 */
export declare const setDataNow: (element: Element, name: string, value: string) => void;
/**
 * Like {@link setDataNow} except it will {@link waitForMutateTime}.
 *
 * @category Style: Altering (optimized)
 */
export declare const setData: (element: Element, name: string, value: string) => Promise<void>;
/**
 * Sets the given data attribute with value "true" (default) or "false".
 *
 * The name of the attribute must _not_ start with `data`. It can be in either
 * camelCase or kebab-case, it is converted as needed.
 *
 * @since v1.2.0
 *
 * @category Style: Altering
 */
export declare const setBooleanDataNow: (element: Element, name: string, value?: boolean) => void;
/**
 * @ignore
 * @deprecated
 *
 * Deprecated alias for {@link setBooleanData}
 */
export declare const setBoolDataNow: (element: Element, name: string, value?: boolean) => void;
/**
 * Like {@link setBooleanDataNow} except it will {@link waitForMutateTime}.
 *
 * @since v1.2.0
 *
 * @category Style: Altering (optimized)
 */
export declare const setBooleanData: (element: Element, name: string, value?: boolean | undefined) => Promise<void>;
/**
 * @ignore
 * @deprecated
 *
 * Deprecated alias for {@link setBoolean}
 */
export declare const setBoolData: (element: Element, name: string, value?: boolean | undefined) => Promise<void>;
/**
 * Sets the given data attribute with value "false".
 *
 * The name of the attribute must _not_ start with `data`. It can be in either
 * camelCase or kebab-case, it is converted as needed.
 *
 * @since v1.2.0
 *
 * @category Style: Altering
 */
export declare const unsetBooleanDataNow: (element: Element, name: string) => void;
/**
 * @ignore
 * @deprecated
 *
 * Deprecated alias for {@link unsetBooleanNow}
 */
export declare const unsetBoolDataNow: (element: Element, name: string) => void;
/**
 * Like {@link unsetBooleanDataNow} except it will {@link waitForMutateTime}.
 *
 * @since v1.2.0
 *
 * @category Style: Altering (optimized)
 */
export declare const unsetBooleanData: (element: Element, name: string) => Promise<void>;
/**
 * @ignore
 * @deprecated
 *
 * Deprecated alias for {@link unsetBoolean}
 */
export declare const unsetBoolData: (element: Element, name: string) => Promise<void>;
/**
 * Deletes the given data attribute.
 *
 * The name of the attribute must _not_ start with `data`. It can be in either
 * camelCase or kebab-case, it is converted as needed.
 *
 * @category Style: Altering
 */
export declare const delDataNow: (element: Element, name: string) => void;
/**
 * Like {@link delDataNow} except it will {@link waitForMutateTime}.
 *
 * @category Style: Altering (optimized)
 */
export declare const delData: (element: Element, name: string) => Promise<void>;
/**
 * Returns the value of the given property from the computed style of the
 * element.
 *
 * @category DOM: Querying
 */
export declare const getComputedStylePropNow: (element: Element, prop: string) => string;
/**
 * Like {@link getComputedStylePropNow} except it will {@link waitForMeasureTime}.
 *
 * @category DOM: Querying (optimized)
 */
export declare const getComputedStyleProp: (element: Element, prop: string) => Promise<string>;
/**
 * Returns the value of the given property from the inline style of the
 * element.
 *
 * @category DOM: Querying
 */
export declare const getStylePropNow: (element: Element, prop: string) => string;
/**
 * Like {@link getStylePropNow} except it will {@link waitForMeasureTime}.
 *
 * @category DOM: Querying (optimized)
 */
export declare const getStyleProp: (element: Element, prop: string) => Promise<string>;
/**
 * Sets the given property on the inline style of the element.
 *
 * @category DOM: Altering
 */
export declare const setStylePropNow: (element: Element, prop: string, value: string) => void;
/**
 * Like {@link setStylePropNow} except it will {@link waitForMutateTime}.
 *
 * @category DOM: Altering (optimized)
 */
export declare const setStyleProp: (element: Element, prop: string, value: string) => Promise<void>;
/**
 * Deletes the given property on the inline style of the element.
 *
 * @category DOM: Altering
 */
export declare const delStylePropNow: (element: Element, prop: string) => string;
/**
 * Like {@link delStylePropNow} except it will {@link waitForMutateTime}.
 *
 * @category DOM: Altering (optimized)
 */
export declare const delStyleProp: (element: Element, prop: string) => Promise<string>;
/**
 * Returns the flex direction of the given element **if it has a flex layout**.
 *
 * @returns `null` if the element does not have a flex layout.
 *
 * @category DOM: Querying (optimized)
 *
 * @since v1.2.0
 */
export declare const getFlexDirection: (element: Element) => Promise<FlexDirection | null>;
/**
 * Returns the flex direction of the given element's parent **if it has a flex
 * layout**.
 *
 * @returns `null` if the element's parent does not have a flex layout.
 *
 * @category DOM: Querying (optimized)
 *
 * @since v1.2.0
 */
export declare const getParentFlexDirection: (element: Element) => Promise<FlexDirection | null>;
/**
 * Returns true if the given element has a flex layout. If direction is given,
 * then it also needs to match.
 *
 * @category DOM: Querying (optimized)
 *
 * @since v1.2.0
 */
export declare const isFlex: (element: Element, direction?: FlexDirection) => Promise<boolean>;
/**
 * Returns true if the given element's parent has a flex layout. If direction is
 * given, then it also needs to match.
 *
 * @category DOM: Querying (optimized)
 *
 * @since v1.2.0
 */
export declare const isFlexChild: (element: Element, direction?: FlexDirection) => Promise<boolean>;
/**
 * In milliseconds.
 *
 * @ignore
 * @internal
 */
export declare const getMaxTransitionDuration: (element: Element) => Promise<number>;
/**
 * @ignore
 * @internal
 */
export declare const disableInitialTransition: (element: Element, delay?: number) => Promise<void>;
/**
 * @ignore
 * @internal
 */
export declare const setHasModal: () => Promise<void>;
/**
 * @ignore
 * @internal
 */
export declare const delHasModal: () => Promise<void>;
/**
 * @ignore
 * @internal
 */
export declare const copyStyle: (fromElement: Element, toElement: Element, includeComputedProps?: string[]) => Promise<void>;
/**
 * If the props keys are in camelCase they are converted to kebab-case
 *
 * If a value is null or undefined, the property is deleted.
 *
 * @ignore
 * @internal
 */
export declare const setNumericStyleJsVarsNow: (element: Element, props: CssNumericProps, options?: {
    _prefix?: string;
    _units?: string;
    _numDecimal?: number;
}) => void;
/**
 * @ignore
 * @internal
 */
export declare const setNumericStyleJsVars: (element: Element, props: CssNumericProps, options?: {
    _prefix?: string;
    _units?: string;
    _numDecimal?: number;
} | undefined) => Promise<void>;
type CssNumericProps = Record<string, number | undefined | null>;
export {};
//# sourceMappingURL=css-alter.d.ts.map