jQuery Forum

1. You can use ${varName} or {{= varName}} to insert in a value. Both map to the same functionality and can be overridden/extended.
2. Will output an empty string if null or undefined are found.
3. All output is encoded to avoid attempts at injection or malformed output.
4. If you wish to inject raw HTML you can do:
   
   1. {{html varName}}
5. If the value is a function it is executed and its contents are substituted. Thus logic can be contained in the data object and be injected directly into the template.
   
   
   1. var user = {
   2.     firstName: "John",
   3.     lastName: "Resig",
   4.     name: function() {
   5.         return this.firstName + " " + this.lastName;
   6.     }
   7. };
   8. // Ignore the extra spaces, the forum will mess it up otherwise
      
   9. $("#users").append("< li >${name}", user);
   10. // Will insert the following:
   11. // < li >John Resig
       
   
   In this way you can continue to keep a clean separation between your template logic and the actual markup.
   

1. jQuery's each method is exposed via the 'each' template method.
   
   1. {{each someArray}} ... {{/each}}
2. You can pass the same arguments to the each callback as you would to jQuery's .each():
   
   1. {{each users}}< li >${this.name}{{/each}}
   2. {{each(i, user) users}}< li >${user.name}{{/each}}
3. Additionally the properties of each iterated object are exposed, allowing for this simple result:
   
   1. {{each users}}< li >${name}{{/each}}
4. There are also two shortcuts for substituting the current value:
   
   1. {{each name}}${this}{{/each}}
   2. {{each name}}{{=}}{{/each}}

1. The only piece of logic introduced into the templating.
2. Can do simple if statements - work similarly to the variable substitution, will pass if the result is not equal to null or undefined (thus will pass if the result is false or 0 or an empty string, for example). (Now works identically to normal JavaScript if statements - I'm considering an ifdef or some such to check to see if a variable is defined.)
   
   1. {{if user.name}} User Name: ${user.name}{{/if}}
3. You can do basic expressions as well.
   
   1. {{if user.height > 5}} This user is tall!{{/if}}
      
4. You can also do else statements.
   
   1. {{if user.name}}
   2.      User Name: ${user.name}
   3. {{else}}
   4.      No user name.
   5. {{/if}}

1. The majority of the logic in the templates will be contained within the builtin commands or in the data objects themselves.
2. New functionality can be easily snapped into the templating system.
3. Methods can be standalone (like {{= varName}}) or involve open/closing syntax (like {{each someArray}} ... {{/each}}).
4. All native functionality can be overridden, even variable substitution.
5. For example, let's add in a new 'join' method for joining the results from an array.
   
   1. jQuery.tmplcmd.join = {
   2.     prefix: "_.push($1.join('$2'))"
   3. };
   
   You can use it like so:
   
   1. {{join cities}}     // Will produce: AtlantaBostonPortland
   2. {{join(, ) cities}} // Will produce: Atlanta, Boston, Portland

Hey Everyone -

So we're in the progress of setting up the new jQuery Forum (as you can see here). We're moving away from using Google Groups, due to the excessive problems that we've had with it. On top of this we see an opportunity to combine some of the disparate jQuery discussion communities (namely the jQueryHelp.com forum).

We analyzed a number of forum solutions and so far we've found Zoho Discussions to be far and away the best. Not only that but the Zoho team has been incredibly accommodating - even going so far as to import all the old jQueryHelp.com and Google Groups posts.

At the time of this post all the old jQueryHelp.com posts and users have been imported into the system. By the end of this weekend the Google Groups (jquery-en, jquery-dev, and jquery-ui) posts and users will be moved over as well. The transition will certainly be rocky but we hope to push through so that we can have an excellent discussion solution in the end.

You'll not that the forum (at this time) isn't styled particularly like the jQuery site. We'll be working to fix this and should have it looking right by the end of the weekend.

We're going to have a full post announcing the forum on Monday, once everything is imported and the site looks correct. Thanks again everyone for your patience and feedback and here's to an exciting 2010!

-- John Resig and the jQuery Team