2022.2

WhenthislibraryisincludedinaWebtemplateinsteadofaCOTGtemplate,itwon'taffectthetem-
plate,exceptwhentheusersubmitsaForm.Atthatmomentthepluginwillautomaticallyaddahidden
fieldforeveryuncheckedcheckboxontheForm.
Tip: Ifyouwanttotakealookatthecontents,youcanopenthepluginwithintheDesigner:
double-clickcotg-2.1.0.jsontheResourcespane.
Changingdefaultsettingsforwidgets
TheCameraandGeolocationwidgetshaveoptionsthatyoucanconfigureperelement.Youcan
decide,forexample,whichbuttonswillbevisibleinaspecificCameraelement(see"Elementspecific
settings"onpage537).
ThedefaultsettingsfortheseoptionsarespecifiedintheCOTGplugin.Itispossibletochangethese
defaultswithoutmodifyingthepluginitself.
Todothat,createaJavaScriptfile(see"AddingJavaScriptfilestotheResources"onpage513)and
specifythedesireddefaultsettingsinthatfilelikethis:
$.fn.widget.defaults.setting = value;
MakesuretoincludeyourJavaScriptfileintheWebcontextorintheWebsectionthatcontainsthe
COTGForm(see"IncludingaJavaScriptfileinaWebcontext"onpage515).
AllavailablesettingsarelistedintheCaptureOnTheGoAPI:"CaptureOnTheGoAPI"onpage557.
ThefollowingcodesetsthedefaulttimeoutandaccuracyforGeolocationobjects.andthedefaultmax-
imumheightandwidthforCamerawidgets.
$.fn.cotgGeolocation.defaults.timeout = 6000; // 6 secs
$.fn.cotgGeolocation.defaults.enableHighAccuracy = true;
$.fn.cotgPhotoWidget.defaults.width = 1024;
$.fn.cotgPhotoWidget.defaults.height = 768;
$.fn.cotgPhotoWidget.defaults.quality = 60;
Reactingto,ortriggering,widgetevents
ThenewCOTGpluginintroducescustomeventsforCOTGcontrols.Youcantriggerand/orreactto
themastheuserinteractswiththeForm.
l
UsejQuery’s.on()methodtoattachaneventhandlertoanelement(orsetofelements).Callthis
functiononthe$(document).readyevent,whichistriggeredwhentheFormisloadedinthe
app.
l
Usethe.trigger()methodtotriggeranelement'sevent.
TheeventsofallCOTGwidgetsarelistedintheCaptureOnTheGoAPI:"CaptureOnTheGoAPI"on
page557.
Page 547