@mdui/jq/methods/prevUntil.d.ts

拥有和 jQuery 相似 API 的轻量级 JavaScript 工具库

import './prev.js';
import type { Selector } from '../shared/helper.js';
declare module '../shared/core.js' {
    interface JQ<T = HTMLElement> {
        /**
         * 获取当前集合中，每个元素前面所有的同辈元素，直到遇到和第一个参数匹配的元素为止（不包含匹配元素）。
         * @param selector
         * 可以是 CSS 选择器、DOM 元素、或 JQ 对象
         *
         * 表示遇到和该参数匹配的元素时，停止匹配
         *
         * 若没有指定该参数，则前面所有同辈元素都将被返回。即和 `.prevAll()` 效果一样
         * @param filter CSS 选择器。若指定了该参数，则仅返回和该参数匹配的元素
         * @example
    ```js
    // 获取 .box 元素前面所有的同辈元素
    $('.box').prevUntil();
    ```
         * @example
    ```js
    // 获取 .box 元素前面的同辈元素，直到遇到 .until 元素为止
    $('.box').prevUntil('.until')
    ```
         * @example
    ```js
    // 获取 .box 元素前面同辈的 div 元素，直到遇到 .until 元素为止
    $('.box').prevUntil('.until', 'div')
    ```
         */
        prevUntil(selector?: Selector | HTMLElement | JQ, filter?: Selector): this;
    }
}