Käyttöopas Peruuta

Upotuskoodit

Upotuskoodi määrittää, miten kirjasimet ladataan sivustoosi selaimessa tai HTML-muotoiseen sähköpostiviestiin sähköpostiohjelmassa.

Oletusarvoiset upotuskoodit ja @import-upotuskoodit käyttävät vain CSS:ää kirjasimien lataamiseen (ei JavaScriptiä). Niitä voidaan käyttää kirjasimien lisäämiseen sivustoihinHTML-muotoisiin sähköpostiviesteihin tai uutiskirjeisiin, Google AMP:hen ja moniin muun tyyppisiin projekteihin, joissa verkkokirjasimia tuetaan. JavaScript-kirjasimien lataamista käytetään dynaamisessa aliasetuksessa, jota tarvitaan itäaasialaisten verkkokirjasimien toimittamiseen.

Kunkin projektin upotuskoodi löytyy Verkkoprojektit-sivulta.

Oletusarvoinen upotuskoodi

Oletusarvoinen upotuskoodi on yksittäinen <link>-tunniste, joka lataa verkkoprojektin CSS:n kirjasinverkosta (use.typekit.net) selaimeen.

<link rel=&quot;stylesheet&quot; href=&quot;https://use.typekit.net/xxxxxxx.css&quot;>
<link rel=&quot;stylesheet&quot; href=&quot;https://use.typekit.net/xxxxxxx.css&quot;>
<link rel=&quot;stylesheet&quot; href=&quot;https://use.typekit.net/xxxxxxx.css&quot;>

Löydät projektisi oletusarvoisen upotuskoodin siirtymällä Verkkoprojektit-sivulle. Lisää tämä upotuskoodi sivustosi <head>-tunnisteeseen.

kuva

@import-upotuskoodi

@import-upotuskoodia voidaan käyttää suoraan CSS-tyylisivulla. Voit etsiä projektin @import-upotuskoodin siirtymällä Verkkoprojektit-sivulle ja napsauttamalla sitten ”@import link” ‑vaihtoehtoa.

kuva

Lisää se sivustosi <head>-otsikon style-tunnisteisiin:

<style>
@import url(&quot;https://use.typekit.net/xxxxxxx.css&quot;);
</style>
<style> @import url(&quot;https://use.typekit.net/xxxxxxx.css&quot;); </style>
<style>
  @import url(&quot;https://use.typekit.net/xxxxxxx.css&quot;);
</style>

tai sijoita se CSS-tiedostosi alkuun:

@import-tunnisteen lisääminen CSS:ään

Huomautus:

Jos käytät @import-upotuskoodia, sen on oltava <style>-tunnisteen tai CSS-tiedoston alussa muiden @import-ilmoitusten kanssa, sillä muussa tapauksessa kirjasimet eivät lataudu. Vain @charset-merkintä voi olla ennen @import-rivejä.

Jommankumman CSS-upotuskoodivaihtoehdon käyttäminen tarkoittaa, että sivun loppuosa ei ehkä näy, ennen kuin verkkokirjasimen CSS on latautunut kokonaan. Toimintatapa vaihtelee selainkohtaisesti sen mukaan, miten kukin selain käsittelee ulkoisia CSS-tiedostoja.

Jos käytät asynkronista kirjasimien latausta, joka ei estä sivun loppuosaa, lisää toinen JavaScript-kirjasto CSS-upotuskoodin rinnalle kirjasimien latauksen mukauttamiseksi.

JavaScript-upotuskoodi

JavaScript-upotuskoodia tarvitaan dynaamisessa aliasetuksessa, jota käytetään itäaasialaisten verkkokirjasimien toimittamiseen.

<script>
(function(d) {
var config = {
kitId: 'xxxxxxx',
scriptTimeout: 3000,
async: true
},
h=d.documentElement,t=setTimeout(function(){h.className=h.className.replace(/\bwf-loading\b/g,&quot;&quot;)+&quot; wf-inactive&quot;;},config.scriptTimeout),tk=d.createElement(&quot;script&quot;),f=false,s=d.getElementsByTagName(&quot;script&quot;)[0],a;h.className+=&quot; wf-loading&quot;;tk.src='https://use.typekit.net/'+config.kitId+'.js';tk.async=true;tk.onload=tk.onreadystatechange=function(){a=this.readyState;if(f||a&&a!=&quot;complete&quot;&&a!=&quot;loaded&quot;)return;f=true;clearTimeout(t);try{Typekit.load(config)}catch(e){}};s.parentNode.insertBefore(tk,s)
})(document);
</script>
<script> (function(d) { var config = { kitId: 'xxxxxxx', scriptTimeout: 3000, async: true }, h=d.documentElement,t=setTimeout(function(){h.className=h.className.replace(/\bwf-loading\b/g,&quot;&quot;)+&quot; wf-inactive&quot;;},config.scriptTimeout),tk=d.createElement(&quot;script&quot;),f=false,s=d.getElementsByTagName(&quot;script&quot;)[0],a;h.className+=&quot; wf-loading&quot;;tk.src='https://use.typekit.net/'+config.kitId+'.js';tk.async=true;tk.onload=tk.onreadystatechange=function(){a=this.readyState;if(f||a&&a!=&quot;complete&quot;&&a!=&quot;loaded&quot;)return;f=true;clearTimeout(t);try{Typekit.load(config)}catch(e){}};s.parentNode.insertBefore(tk,s) })(document); </script>
<script>
  (function(d) {
    var config = {
      kitId: 'xxxxxxx',
      scriptTimeout: 3000,
      async: true
    },
    h=d.documentElement,t=setTimeout(function(){h.className=h.className.replace(/\bwf-loading\b/g,&quot;&quot;)+&quot; wf-inactive&quot;;},config.scriptTimeout),tk=d.createElement(&quot;script&quot;),f=false,s=d.getElementsByTagName(&quot;script&quot;)[0],a;h.className+=&quot; wf-loading&quot;;tk.src='https://use.typekit.net/'+config.kitId+'.js';tk.async=true;tk.onload=tk.onreadystatechange=function(){a=this.readyState;if(f||a&&a!=&quot;complete&quot;&&a!=&quot;loaded&quot;)return;f=true;clearTimeout(t);try{Typekit.load(config)}catch(e){}};s.parentNode.insertBefore(tk,s)
  })(document);
</script>

Dynaamisen projektin JavaScript-upotuskoodi on lueteltu Verkkoprojektit-sivulla.

kuva

Edistyksellinen upotuskoodi voidaan mukauttaa hyväksymällä Typekit.load-menetelmän määritysobjekti. Lisätietoja on JavaScript API ‑osiossa.

JavaScript API

JavaScript paljastaa yleisen Typekit-muuttujan yhdellä julkisella menetelmän latauksella. Typekit.load-komennon suorittaminen ilman argumentteja käynnistää kirjasimien lataamisen.

Typekit.load()
Typekit.load()
Typekit.load()

Voit myös hyväksyä Typekit.loadin määritysobjektin.

Typekit.load({
// configuration…
});
Typekit.load({ // configuration… });
Typekit.load({
      // configuration…
 });

Voit määrittää seuraavat vastakutsut:

  • loading – Tämä vastakutsu käynnistetään, kun on pyydetty kaikkia kirjasimia.
  • active – Tämä vastakutsu käynnistetään, kun kirjasimet on hahmonnettu.
  • inactive – Tämä vastakutsu käynnistetään, kun selain ei tue linkitettyjä kirjasimia *tai* jos yhtäkään kirjasinta ei voitu ladata.
  • fontloading – Tämä vastakutsu käynnistetään kerran jokaiselle ladatulle kirjasimelle. Vastakutsun ensimmäisenä argumenttina käytetään kirjasinperheen nimeä ja toisena argumenttina käytetään kirjasinmuunnelman kuvausta.
  • fontactive – Tämä vastakutsu käynnistetään kerran jokaiselle hahmonnetulle kirjasimelle. Vastakutsun ensimmäisenä argumenttina käytetään kirjasinperheen nimeä ja toisena argumenttina käytetään kirjasinmuunnelman kuvausta.
  • fontinactive – Tämä vastakutsu käynnistetään, jos kirjasinta ei voi ladata. Vastakutsun ensimmäisenä argumenttina käytetään kirjasinperheen nimeä ja toisena argumenttina käytetään kirjasinmuunnelman kuvausta.

Upotuskoodin muuttaminen sivustossa

Jos sinulla on sivusto, jossa käytetään jo kirjasimia vanhalla JavaScript-upotuskoodilla, voit vaihtaa uudempaan CSS-versioon korvaamalla koodisi <script>-tunnisteet HTML-muotoisella <link>-upotuskoodilla tai CSS:n @import-upotuskoodilla.

Vanhan upotuskoodin käyttäminen sivustossa

Vaikka Adobe muuttaa ajoittain upotuskoodiasetuksia, kun se tekee parannuksia kirjasimien tarjontaan, kaikki upotuskoodien aikaisemmat versiot toimivat edelleen.  

Jos käytät sivustossasi vanhaa upotuskoodia, sinun ei ole pakko vaihtaa sitä. Monien sivustojen toiminta kuitenkin paranee, kun päivität uudempaan versioon.

Upotuskoodin aikaisemmat versiot sisältävät JavaScript-version, joka lataa CSS-tiedoston asynkronisesti:

<script src=&quot;https://use.typekit.net/xxxxxxx.js&quot;></script>
<script>try{Typekit.load({ async: true });}catch(e){}</script>
<script src=&quot;https://use.typekit.net/xxxxxxx.js&quot;></script> <script>try{Typekit.load({ async: true });}catch(e){}</script>
<script src=&quot;https://use.typekit.net/xxxxxxx.js&quot;></script>
<script>try{Typekit.load({ async: true });}catch(e){}</script>

ja protokollan mukaisen JavaScript-version:

<script src=&quot;//use.typekit.net/xxxxxxx.js&quot;></script>
<script>try{Typekit.load({ async: true });}catch(e){}</script>
<script src=&quot;//use.typekit.net/xxxxxxx.js&quot;></script> <script>try{Typekit.load({ async: true });}catch(e){}</script>
<script src=&quot;//use.typekit.net/xxxxxxx.js&quot;></script>
<script>try{Typekit.load({ async: true });}catch(e){}</script>

(Vaikka sivustossasi käytettäisiin protokollan mukaista upotuskoodia, kirjasimien tarjontaan käytetään HTTPS:ää kaikissa pyynnöissä.)

Useiden upotuskoodien käyttäminen sivustossa

Emme suosittele useiden upotuskoodien lisäämistä samalle verkkosivulle useista syistä:

  • Jokainen upotuskoodin kopio on enimmäkseen tarpeeton.
  • Jokainen projekti tekee kirjasimille erilliset pyynnöt, mikä lisää HTTP-pyyntöjen määrää ja hidastaa lataamista entisestään.
  • Yksittäinen projekti voidaan tallentaa välimuistiin sivustosi kaikille sivuille ensimmäisen latauskerran jälkeen.

Pyydä apua nopeammin ja helpommin

Oletko uusi käyttäjä?