2022.2

results
Theresultsobject(type:QueryResults)istheresultofthequeryforHTMLelementsthatmatch
theselectorofthescript.TheselectorofascriptcanbespecifiedintheScriptEditorandisvisiblein
thesecondcolumnoftheScriptspane,nexttothenameofthescript.
If,forexample,ascriptwouldhavetheselectorp.onlyCanada,thescriptwouldapplytoallpara-
graphsthathavetheclassonlyCanada.(ClassescanbedefinedintheAttributespaneattheright:
selecttheelementinthecontentandtypetheclass(es)intheClassfield.)
Thescriptcouldthenusetheresultsobjecttohideorshowthoseparagraphs,dependingonthe
valueofthedatafieldCountryinthecurrentrecord:
if (record.fields["Country"] == "CANADA") {
results.show();
} else {
results.hide();
}
Note: Thisobjectcan'tbeusedinControlScripts,becausetheydon'thaveaselector.
Tip: Theeasiestwaytoaccesstheelementsinaresultsetonebyone,isbysettingthescopeof
thescriptto"Eachmatchedelement"andusingthethisobject(see"this"onpage1237).
Property
Field Type Description
length Number Number of elements in this result set. Equivalent to calling size().
Functions
Thefunctionsbelowcanbecalledbytheresultsobjectandbyanyotherresultsetthatisreturnedby
aquery,see"query()"onpage1197.
Function Description
"add()"onpage1239 AddselementstoasetofHTMLelements.
"addClass()"on
page1241
AddsthespecifiedclasstoeachelementinasetofHTMLelements.Hasnoeffectiftheclassisalreadypresent.
"after()"on
page1242
InsertscontentaftereachelementinasetofHTMLelements..
Page 1202