Проблемы с чтением jquery.com

[lancer]

Что это за формат записи? Не нашел на jquery.com как его читать.

[Deff]

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

[devote]

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

[lancer]

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

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

[Deff]

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

[lancer]

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

[LittlePony]

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

[lancer]

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

[devote]

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

ну где почитать понятия не имею, но есть давно используемые стандарты описания документации. К примеру если написать так:

.stop([ queue [, clearQueue [, jumpToEnd ]]]);

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

[devote]

хотя в документации jQuery конечно указано ошибочно, правильнее оно должно быть написано так:

.stop( [ queue ] [, clearQueue [, jumpToEnd ]] );

так как первый параметр может и не быть, а вот второй и третий четко должны быть в своей очереди.. то есть если идти логике описанной в документации джуквери, то метод можно писать например так:

.stop( jumpToEnd, clearQueue );

что не является правильным, так как на сколько я знаю в данном случае первый аргумент будет рассматриваться как clearQueue а не jumpToEnd.