Javascript-форум (https://javascript.ru/forum/)
-   jQuery (https://javascript.ru/forum/jquery/)
-   -   Проблемы с чтением jquery.com (https://javascript.ru/forum/jquery/31012-problemy-s-chteniem-jquery-com.html)

lancer 23.08.2012 14:20

Проблемы с чтением jquery.com
 
Вложений: 1
Что это за формат записи? Не нашел на jquery.com как его читать.

Deff 23.08.2012 14:39

lancer,
Ну вот в старых версиях - ток два параметра
http://jquery-docs.ru/Effects/stop/#clearQueuegotoEnd
там true, true - тогда удаляются и прекращаются все анимации для данного элемента, не наю чо за третий сейчас

devote 23.08.2012 14:54

все что в квадратных скобках, является не обязательным, при этом каждый параметр не имеет точного определения где его укажут.. то есть второй параметр может быть первым и т.д. Тут уже все зависит от типа данных

lancer 23.08.2012 15:16

Цитата:

все что в квадратных скобках, является не обязательным, при этом каждый параметр не имеет точного определения где его укажут.. то есть второй параметр может быть первым и т.д.
Откуда знаете? Я тоже хочу почитать. Например в CSS есть описание стенографического свойства - как его читать. Т.е. такое же и для этого должно быть.

Deff 23.08.2012 15:19

http://jquery.page2page.ru/index.php...имац ии

lancer 23.08.2012 15:22

Это все не то. Я хочу понять как читать эти записи, это какой-то формат.

LittlePony 23.08.2012 16:27

это традиционный формат описания функций в документации.
в квадратных скобках пишутся опциональные аргументы.

lancer 23.08.2012 16:45

LittlePony, майнэ это понимает. Но где этот традиционный формат описан? Название какое-то должен иметь.

devote 23.08.2012 17:47

Цитата:

Сообщение от lancer
Откуда знаете? Я тоже хочу почитать. Например в CSS есть описание стенографического свойства - как его читать. Т.е. такое же и для этого должно быть.

ну где почитать понятия не имею, но есть давно используемые стандарты описания документации. К примеру если написать так:
.stop([ queue [, clearQueue [, jumpToEnd ]]]);
то этот вариант так же говорит об опциональности параметров, но с одной разницей в том что их четко нужно писать в своем порядке, тоесть нельзя указывать второй параметр без первого... В варианте что вы привели на картинке, писать второй параметр можно вместо первого, и метод просто проверит тип входных данных.. Учитывая что первый параметр это строка, а второй болевое значение. Этим собственно и различается. Такой подход в других языках называется overload (перегрузка) когда компилятор выбирает нужный метод по его входным данным.

devote 23.08.2012 17:52

хотя в документации jQuery конечно указано ошибочно, правильнее оно должно быть написано так:
.stop( [ queue ] [, clearQueue [, jumpToEnd ]] );
так как первый параметр может и не быть, а вот второй и третий четко должны быть в своей очереди.. то есть если идти логике описанной в документации джуквери, то метод можно писать например так:
.stop( jumpToEnd, clearQueue );
что не является правильным, так как на сколько я знаю в данном случае первый аргумент будет рассматриваться как clearQueue а не jumpToEnd.


Часовой пояс GMT +3, время: 07:28.