Juhend · 6 min lugemist
Kuidas vorm oma veebisaidile sisestada
Vormi saab saidile lisada mitmel viisil, alates ühe rea koodijupist kuni täiesti kohandatud API-integratsioonini. See juhend tutvustab reasiseseid sisestusi, hüpikaknaid, veebikomponenti ja JS SDK-d ning avalikku REST API-t, et saaksid valida oma ülesehitusele sobiva lähenemise.
Reasisene sisestus
Reasisene sisestus paigutab vormi otse lehe sisuvoogu, nii et see asetseb muu sisu vahel nagu iga teine osa. Sa kleebid väikese koodijupi kohta, kus soovid vormi kuvada, ja see renderdub paigale, ilma ümbersuunamise või eraldi sihtleheta.
Lihtsaim viis on veebikomponent: lisa <yeetform-embed> silt oma vormi slugiga ja vorm laeb reasiseselt. Soovi korral saab sama tulemuse ühe JS SDK kutsega, mis renderdab vormi sinu valitud sihtelementi.
Hüpikaken ehk modaal
Mõnikord ei taha sa vormi lehel üldse, enne kui keegi seda küsib. Hüpikaken ehk modaal hoiab paigutuse puhtana ja avab vormi kihina, kui külastaja nupule klõpsab, ideaalne kontaktinuppude, tagasisidevidinate või ekraani nurgas oleva üleskutse jaoks.
JS SDK-ga ühendad nupu kutsega YeetForm.open(slug) ja vorm ilmub tsentreeritud modaalina su lehe peale. Külastaja täidab selle lehelt lahkumata ning kiht sulgub esitamisel, nii et vorm ei võistle põhisisuga ruumi pärast.
Veebikomponent ja JS SDK
Enamiku saitide jaoks katavad veebikomponent ja JS SDK kõik vajaliku. <yeetform-embed> silt on koodivaba valik, see töötab tavalises HTML-is, CMS-i plokis või igas raamistikus, mis lubab kohandatud elemente. JS SDK annab programmilise kontrolli, kui seda vajad.
SDK (public/sdk.js) pakub väikest hulka meetodeid:
- YeetForm.render(slug, target, options), sisesta vorm reasiseselt sinu valitud elementi.
- YeetForm.open(slug, options), ava vorm hüpikmodaalina.
- YeetForm.load(slug, lang), laadi vormi struktuur ilma kasutajaliideseta, näiteks väljade loendamiseks või vaatamiseks.
- YeetForm.submit(slug, answers), esita vastus programmiliselt omaenda koodist.
API kohandatud integratsioonideks
Kui vajad täielikku kontrolli, eritellimuslikku kasutajaliidest, mobiilirakendust või serveripoolset voogu, kasuta avalikku REST API-t. See on CORS-toega, nii et saad seda kutsuda otse brauserikoodist, ja avalike vormide puhul autentimata, nii et struktuuri laadimiseks või vastuse postitamiseks pole API-võtit vaja.
Tüüpiline integratsioon toob vormi struktuuri GET-päringuga, renderdab väljad sinu soovitud viisil omaenda liideses ja postitab seejärel kogutud vastused POST-päringuga tagasi. Kuna struktuur on lihtsalt JSON, saad luua täiesti kohandatud paigutusi, samal ajal kui YeetForm hoolitseb salvestamise, teavituste ja analüüsi eest kulisside taga.