2022.2

snippet.find('@firstname@').text('foobar');
results.append(snippet);
clone()
ThisfunctionreturnsacopyofoneHTMLelementorofasetofHTMLelements,whichcanbe:
l
Theelementsthatmatchtheselectorofascript(see"results"onpage844).
l
Oneelementthatmatchestheselectorofascriptthatrunsfor"Eachmatchedelement"(see
"this"onpage781and"Settingthescopeofascript"onpage373).
l
Theelementsreturnedbyaqueryinthetemplate(see"query()"onpage742).
Seealso:"Dynamicallyaddingsections(cloning)"onpage406.
Toduplicateanexistingtemplateelement,cloneitbeforecallingappend();see"append()"on
page788.
Examples
Thisscriptperformsaniterationovertheelementsintheresults(theelementsthatmatchthe
selectorofthescript).
var row = query("tbody tr", results).clone();
query("tbody", results).append(row);
Thefollowingscriptclonesanexistingtablerowtomatchthenumberofrowsinadetailtable.After-
wardsititeratesovertherowstopopulatethefields.
// Create the number of rows based on the records in the detail table
// We start at 1 so the boilerplate row is used too and there is no need to delete that row
for(var r = 1; r < record.tables['detail'].length; r++) {
results.parent().append(results.clone());
}
// Iterate over the rows and populate them with the data from the accompanying data row
query("#table_2 > tbody > tr").each(function(i) {
this.find('@ItemNumber@').text( record.tables['detail'][i].fields["ItemNumber"]);
this.find('@ItemOrdered@').text( record.tables['detail'][i].fields["ItemOrdered"]);
this.find('@ItemTotal@').text( record.tables['detail'][i].fields["ItemTotal"]);
this.find('@ItemDesc@').text( record.tables['detail'][i].fields["ItemDesc"]);
this.find('@nr@').text(i);
});
Thefollowingscriptclonesandpopulatesaboilerplaterow.Oncecompletedyouwillneedtohidethe
boilerplaterow.
closest()
Thisfunctiongetsthefirstparentelementthatmatchesaselector,bytestingtheelementitselfandtra-
versingupthroughitsancestorsintheDOMtree.(InHTML,aparentisanelementthatcontains
Page 794