Anropa en anpassad widget från HTML

Anropa en anpassad widget från HTML — montera, rendera element, innehållsväljare

På en enkel HTML-sida gör du inte "anropa" en widget med ID eller genom att klistra in en kortkod. Du placerar en tom montera i markupen, sedan den publicerade widgeten vars Render element matchningar som monteras injicerar spelaren. Innehållsväljare (eller Innehållstext) avgör vad som läses upp. Det är så varje anpassad Full / Knapp / Cirkel-widget refereras från HTML — inklusive widgetar du skapar själv, inte bara de tre standardmonteringsklasserna.

  • Varför användbart — rensa recept från anslutningsskript → din widget → livespelare, utan att behöva gissa med försök och fel.
  • Inget widget-ID i HTML — sidan namnger aldrig konsolwidgeten efter ID; matchningen är klass / väljare → renderingselement.
  • Standardvärden kontra anpassade — standardmonteringar (.gsp_full_player / knapp / cirkel) är genvägar; alla unika klasser fungerar på samma sätt.
  • Samma sak gäller byggare — Wix / Shopify / Squarespace Anpassade HTML-block använder exakt detta anropsmönster.

Öppna molnkonsolen Guide för HTML-anslutning Alla instruktioner

Hur du "anropar" en anpassad widget från HTML

Tänk på tre lager. Anslutningsskriptet laddas. GSpeech för hela webbplatsen. Widgeten i Cloud Console är spelardefinitionen (röst, Chrome, väljare, URL-regler). Monteringskoden i din HTML är den tomma noden där den spelaren kan visas.

  • 1. Anslutningsskript — en gång per webbplats (Integrationer → Html-webbplats), vanligtvis före </body>.
  • 2. Publicerad widget — Fullständig / Knapp / Cirkel som du skapar eller anpassar i konsolen.
  • 3. Montera i HTML - t.ex <div class="my_listen_btn"></div>; Rendering-elementet måste vara .my_listen_btn.
  • Innehållsväljare — CSS-mål för sidtext som ska uppläsas (eller lämna tomt och använd Innehållstext för fristående ljud).

Tumregel: HTML "importerar" aldrig en widget efter namn. Matchande Render Element + monteringsklass is samtalet.

Hur man skriver id, klass och kommatecken (ingen kodningsexamen krävs)

Innehållsväljaren, renderingselementet och uteslutningslistan använder samma enkla språk. Du behöver bara två prefix – sedan kan du sätta ihop talat innehåll i bitar och skära ut skräp med Exkludera.

  • id → # — i HTML id="article" → i GSpeech skriva #article (hash + exakt id).
  • klass → . — i HTML class="post-content" → skriva .post-content (punkt + den exakta klassen). Om elementet har flera klasser räcker det med en matchande klass.
  • Endast tagg — enkla taggnamn fungerar också: article, section, h1 (ej # or .).
  • Innehållsväljare + kommatecken — samla innehåll i bitar i ett fält: #intro,.chapter-body,#summaryMatchningar läses i ordning – perfekt när sidan är uppdelad på flera omslag.
  • Exkludera lista + kommatecken — ta bort brus från det valet med samma syntax: #comments,.ads,.share-buttonsUndantag gäller inom det som Content Selector samlat in.
  • Hur man hittar värden — på livesidan: högerklicka på blocket → Inspektera. Leta efter id="…" or class="…"och skriv dem sedan med # or . i konsolen. Genomgång av djupgående exkludering: Exkludera lista och ingen talfunktion.

Tre standardfästen kontra din egen anpassade widget

Dokument visar ofta de tre praktiska monteringsklasserna eftersom de levereras färdiga med Cloud-standardinställningar. En anpassad widget är inte en separat produkt – det är samma typ Full / Knapp / Cirkel med ditt Rendering-elementet (och vanligtvis din innehållsväljare).

  • Standard Fullständig — montera <div class="gsp_full_player"></div> → Rendera element .gsp_full_player.
  • Standardknapp - .gsp_button_player montering + matchande renderingselement.
  • Standardcirkel - .gsp_circle_player montering + matchande renderingselement.
  • Ditt anpassade samtal — vilken klass eller vilket id du än äger (t.ex. #promo-listen or .footer_tts) → ange exakt den väljaren som Render Element på widgeten du publicerade.

WordPress kortkoder ([gspeech] / button / circle) är en annan placeringsväg för inlägg. I rå HTML finns ingen kortkod — bara paret mount + Render Element. Se standardkortkoder endast för WP.

End-to-end: konfigurera och anropa din anpassade widget

  1. Skapa / öppna din webbplats i Cloud Console och bekräfta globala standardvärden i Inställningar (röst, språk) — se Global kontra anpassad.
  2. kopiera Html webbplats anslutningsskript från Integrationer och klistra in det en gång i din delade mall innan </body>Distribuera så att varje sida som behöver ljud laddar skriptet.
  3. Skapa en Full / Knapp / Cirkel widget (eller öppna en befintlig anpassad). Ge den ett tydligt namn så att du känner igen den senare.
  4. I sidans HTML, lägg till en tomt fäste var spelaren ska visas — välj en unik klass som du inte kommer att återanvända för orelaterat användargränssnitt. Exempel: <div class="my_custom_player"></div>.
  5. Ställ in på widgeten Render element till exakt den väljaren: .my_custom_player (inledande punkt för en klass; #id för ett ID).
  6. uppsättning Innehållsväljare till vad besökarna ska höra. Ett omslag räcker bra (#main or .product-description). Eller montera bitar med kommatecken: #intro,.body-copy,#summary. Använd parent_class / self_class när monteringen sitter inuti det innehållsblocket.
  7. Frivillig: Uteslut lista (även kommaseparerad, samma # / . regler) för navigering / annonser / kommentarer — t.ex. #comments,.ads,.share-buttonsValfritt: Tillåtna/blockerade webbadresser så att den här widgeten bara körs där du vill.
  8. Ställ in statusen till publicerade, Spara, ladda om den aktiva HTML-sidan hårt och bekräfta att spelaren fyller din montering och läser rätt text.

Behöver ljud med Nej omgivande sidtext (demo-/kioskstil)? Lämna Innehållsväljaren tom och fyll i Innehållstext istället — fullständig genomgång: Fristående spelare med innehållstext.

Minimal HTML-sida som anropar din widget

Nedan visas formen på en arbetssida. Ersätt anslutningsskriptet med ditt från Integrationer. Monteringsklassen måste matcha Render Element på den publicerade widgeten; Innehållsväljaren bör rikta in sig på #article i detta exempel.

  • Montera i HTML - <div class="my_custom_player"></div> (tömma).
  • Widget-renderingselement - .my_custom_player.
  • Widgetinnehållsväljare - #article.
  • Anslutningsskript — din enradiga HTML-webbplats bäddas in före </body>.

Skelett (kommentarer visar mappningen):

<!-- spoken content -->
<article id="article">…your text…</article>
<!-- player mount (Render Element = .my_custom_player) -->
<div class="my_custom_player"></div>
<!-- GSpeech connection script from Integrations -->

Du kan placera fästet ovanför artikeln, i ett sidofält eller i sidfoten — Innehållsväljaren pekar fortfarande på #article, så layout-chrome läses inte upp. Det layoutmönstret täcks också i Placera en anpassad widget.

Om den anpassade widgeten inte visas

  1. Anslutningsskript laddad på den URL:en (Visa källa / Nätverk).
  2. Widgetstatus är publicerade (inte utkast / inaktiverat).
  3. Monteringen finns på sidan och klass/id-stavningen matchar Render element exakt (inklusive den inledande . or #).
  4. Innehållsväljare hittar riktig text (eller Innehållstext är ifylld för fristående).
  5. Tillåtna/blockerade webbadresser utesluter inte den här sökvägen.
  6. Hård omladdning efter sparning — HTML/CDN-cache kan behålla ett gammalt skal kortvarigt.

Fullständig felsökningsväg: Spelaren visas inte.

Vanliga frågor om anpassad HTML-widget

  • Var lägger jag in widget-ID:t i min HTML-kod?

    Ingenstans. HTML refererar inte till konsolwidgetens ID. Anropet är: tom montering på sidan + Render Element på den publicerade widgeten satt till den monteringens väljare.
  • Kan jag använda en klass som inte är gsp_full_player / button / circle?

    Ja. De tre namnen är praktiska standardvärden, inte en hård gräns. Alla unika klasser eller id:n fungerar om Render Element matchar det och widgeten är Publicerad.
  • Jag skapade en anpassad widget — varför händer ingenting på sidan?

    Att skapa widgeten är bara halva anropet. Sidan behöver också en montering som matchar renderingselementet, anslutningsskriptet, publiceringsstatusen och URL-reglerna som tillåter sidan. Utan monteringen har widgeten ingenstans att injicera.
  • Kan Innehållsväljaren lista mer än ett element?

    Ja. Separera selektorer med kommatecken för att sätta ihop berättarröst från flera delar — t.ex. #intro,.chapter-body,#summaryTrimma sedan skräp med Exclude List med samma kommasyntax (#comments,.ads). Kom ihåg: HTML id → #, class → ..
  • En widget, många sidor?

    Ja. Återanvänd samma monteringsklass på varje mall; en publicerad widget fyller varje matchande montering som tillåts av Tillåtna/Blockerade webbadresser. Skapa en annan widget endast när röst, design eller väljare måste skilja sig åt.