Auðvelt er að misskilja að flýja vegna þess að mörg mismunandi störf líta svipuð úr fjarlægð. Þú ert með texta, textinn inniheldur sérstafi og annað kerfi þarf að taka á móti honum án þess að misskilja hann. Mistökin eru að gera ráð fyrir að ein tegund af flótta virki alls staðar.
URL kóðun, HTML sleppi og JSON sleppi leysa mismunandi vandamál. Bil í fyrirspurnarstreng er ekki sama vandamálið og < stafur í genginu HTML eða gæsalappir innan JSON strengs. Case / Slug / Escape tólið hjálpar með því að halda þessum úttakum þétt saman, en gagnlegur hlutinn er að vita hvaða úttak tilheyrir áfangastaðnum sem þú ert að undirbúa.
Kóðun vefslóða er fyrir vefslóðir og fyrirspurnargildi
Notaðu kóðun vefslóðar þegar texti er að fara inn í vefslóðarhluta, sérstaklega fyrirspurnarfæribreytu eða gildi sem getur innihaldið bil, greinarmerki eða stafi sem eru óöruggir í slóð.
Segjum sem svo að stuðningstengil þurfi að innihalda leitarorð eins og pricing & billing. Að líma þessa setningu beint inn í vefslóð getur breytt því hvernig vefslóðin er túlkuð vegna þess að & hefur nú þegar merkingu inni í fyrirspurnarstreng. Kóðun vefslóða breytir textanum í form sem getur ferðast inni í vefslóðinni án þess að ruglast á setningafræði vefslóða.
Þetta er frábrugðið því að búa til slug. slug breytir titli venjulega í læsanlegan slóðahluta eins og pricing-and-billing. Kóðun vefslóðar varðveitir upprunalega gildið beint fyrir flutning.
HTML sleppi er fyrir texta sem verður sýndur í HTML
Notaðu HTML escape þegar texti þarf að birtast sem texti í HTML samhengi, ekki verða merking.
Ef kóðadæmi inniheldur <button> og þú vilt að lesendur sjái þá stafi, þarf vafrinn að sleppa stöfunum. Annars getur það túlkað þau sem raunverulegan þátt. HTML sleppur snýst um að koma í veg fyrir að texti sé lesinn sem HTML setningafræði á stöðum þar sem efnið ætti að vera sýnilegur texti.
Það skiptir máli í skjölum, CMS-reitum, breytingaskrám og vöruafriti. Það er sérstaklega viðeigandi þegar frumtextinn inniheldur dæmi um álagningu, búta eða notendagerð gildi sem ættu ekki að verða hluti af síðuskipulaginu.
JSON sleppi er fyrir strengjagildi inni í JSON
Notaðu JSON sleppa þegar texti þarf að sitja örugglega inni í JSON streng.
Tilvitnun er skaðlaus í venjulegum prósa, en inni í JSON streng getur það lokað strengnum snemma. Nýlína getur líka þurft framsetningu sem heldur JSON gildu. JSON sleppur snýst um að varðveita gildið á sama tíma og JSON í kring er greinanlegt.
Þetta birtist oft þegar teymi deila API dæmum, stillingarbútum, greiningarálagi eða sýnishornsgögnum. Ef næsta skref er víðtækari uppbygging gagna, para þessa grein við Hvernig á að forsníða JSON áður en þú deilir API dæmi og JSON / YAML / TOML breytirinn.
Veldu flóttann út frá áfangastaðnum
Einfaldasta reglan er ákvörðunarstaður fyrst.
| Áfangastaður | Notaðu | Hvers vegna |
|---|---|---|
| Gildi vefslóðafyrirspurnar eða vefslóðahluta | URL kóðun | Kemur í veg fyrir að texti sé túlkaður sem setningafræði vefslóða |
| Sýnilegur texti inni í HTML | HTML sleppur | Kemur í veg fyrir að sérstafir verði merktir |
| Strengjagildi inni í JSON | JSON sleppur | Heldur gæsalöppum, skástrikum og línuskilum greinanlegum |
| Opinber grein eða leiðarheiti | Slug kynslóð | Býr til læsilegan slóðatexta frekar en að varðveita hvern staf |
Converty hjálpar vegna þess að þú getur límt einu sinni og borið saman úttakið án þess að opna sérstakan kóðara fyrir hvert tilfelli. Það heldur starfinu í réttu hlutfalli. Þú ert ekki að byggja leiðslu; þú ert að undirbúa eitt textagildi fyrir staðinn sem það þarf að fara.
Opnaðu Case / Slug / Escape tólið þegar þú þarft að ákveða hvort næsta úttak eigi að vera slug, vefslóðarkóðað gildi, HTML-öruggur texti eða JSON-öruggur strengur.
