Item9080: $.noConflict() causes much confusion

I just had to deal with another user who was wailing:

"why don't any of my jQuery calls work"

The answer was, of course, $.noConflict().

I have no problem with noConflict being enabled by default; but I do have a problem with this not being mentioned anywhere in the documentation.

The following need to document the use of $.noConflict():

• JQueryPlugin
• JQueryCodingStandards
• UsingJQueryWithFoswiki

-- CrawfordCurrie - 31 May 2010

Later, OK, I admit my ignorance; I don't know exactly why this user was having problems, all I know is that switching to jQuery() instead of $() fixed it for them. Under what circumstances is noConflict actually included? How does a user detect this situation? These are the questions that have to be answered in the doc.

-- CrawfordCurrie - 31 May 2010

This is another instance of an RTFM.

-- MichaelDaum - 31 May 2010

If RTFM stands for "Rewrite The F***ing Manual", I totally agree. When I went to look for information on this topic, I found it is totally obscure. To say "use $" and then just a few lines later say "if you want to use $, you have to do this" is very confusing.

I improved it in UsingJQueryWithFoswiki but the plugin doc also needs fixing.

-- CrawfordCurrie - 31 May 2010

Done.

-- CrawfordCurrie - 04 Jun 2010

Commenting is disabled while not logged in