$(...).parents()

Возвращает новую FlyNode, содержащую всю цепочку родителей, удовлетворяющих селектору, для каждого узла текущей.


                                    FlyDomNode: {
                        __constructor: function(context) {
                            var array = fnNodeList.makeDomNodeArray(context);
                            for (var a = 0, al = array.length; a < al; a++) {
                                this[a] = array[a];
                            }
                            this.length = al;
                        },

                        size: function() {
                            return this.length;
                        },

                        get: function(index) {
                            return $.isNumber(index) ? this[index] : [].slice.call(this);
                        },

                        addNode: function(flyNode) {
                            return fnNodeList.changeNodeContext(this, flyNode, function(child, context) {
                                context.indexOf(child) === -1 && context.push(child);
                            });
                        },

                        removeNode: function(flyNode) {
                            return fnNodeList.changeNodeContext(this, flyNode, function(child, context) {
                                var position = context.indexOf(child);
                                if (position !== -1) context.splice(position, 1);
                            });
                        },

                        eq: function(index) {
                            if (index < 0) index = index + this.length;
                            return new this.__self(this[index]);
                        },

                        lt: function(index) {
                            return new this.__self(this.slice(0, index));
                        },

                        gt: function(index) {
                            return new this.__self(this.slice(index));
                        },

                        last: function(selector) {
                            var element = this[this.length - 1];
                            return new this.__self(fnStyle.isMatch(element, selector) ? element : []);
                        },

                        first: function(selector) {
                            var element = this[0];
                            return new this.__self(fnStyle.isMatch(element, selector) ? element : []);
                        },

                        normalize: function() {
                            return fnNodeList.transformNodeContext(this, function(item, context) {
                                if ($.isNode(item)) context.push(item);
                            });
                        },

                        each: function(callback, context) {
                            $.each(this, callback, context);
                            return this;
                        },

                        name: function() {
                            return this[0].tagName.toLowerCase() || null;
                        }
                    }

$(...).parents([selector])
Возвращает: FlyNode^[$]

selector: String^ABC

Селектор CSS для фильтрации результатов.

Метод не изменяет текущую FlyNode, а возвращает новую.

Результат работы метода будет содержать всю цепочку родителей, удовлетворяющих селектору, включая document.documentElement для каждого узла текущей FlyNode.

Не используйте $(...).parents() для проверки вложенности! Этой цели служит метод $(...).has().

Если требуется исключить корневой элемент документа из результирующей FlyNode, следует воспользоваться методом $(...).normalize().

Пример: Изменение всех родителей DOM узла.

<!DOCTYPE html>
    <head>
        <meta charset="utf-8"/>
        <title>Fly.js - $(...).parents()</title>

        <script src="/scripts/fly.js"></script>
    </head>
    <body>
        <div>
            <div>
                <div>
                    <span>Hello world!</span>
                </div>
            </div>
        </div>
        <script>
            $('span')
                .parents()
                .normalize()
                .css({
                    border: '1px yellow solid',
                    padding: '3px'
                });
        </script>
    </body>
</html>

$(...).parents()

$(...).parents([selector])Возвращает: FlyNode [$]

selector: String ABC

Пример: Изменение всех родителей DOM узла.

$(...).parents([selector])
Возвращает: FlyNode^[$]

selector: String^ABC