Hur-tos
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
Relaterad
Placera anpassad (layout)
Fristående innehållstext
Global kontra anpassad
Spelaren visas inte
Skapa fullständig spelare
Skapa knappspelare
Modell
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.
HTML-värden
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.
Standardvärden
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.
Inställning
End-to-end: konfigurera och anropa din anpassade widget
- Skapa / öppna din webbplats i Cloud Console och bekräfta globala standardvärden i Inställningar (röst, språk) — se Global kontra anpassad.
- 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.
- Skapa en Full / Knapp / Cirkel widget (eller öppna en befintlig anpassad). Ge den ett tydligt namn så att du känner igen den senare.
- 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>.
- 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).
- 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.
- 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.
- 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.
Exempelvis
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.
Checklista
Om den anpassade widgeten inte visas
- Anslutningsskript laddad på den URL:en (Visa källa / Nätverk).
- Widgetstatus är publicerade (inte utkast / inaktiverat).
- Monteringen finns på sidan och klass/id-stavningen matchar Render element exakt (inklusive den inledande . or #).
- Innehållsväljare hittar riktig text (eller Innehållstext är ifylld för fristående).
- Tillåtna/blockerade webbadresser utesluter inte den här sökvägen.
- Hård omladdning efter sparning — HTML/CDN-cache kan behålla ett gammalt skal kortvarigt.
Fullständig felsökningsväg: Spelaren visas inte.
FAQ
Vanliga frågor om anpassad HTML-widget
-
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.
-
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.
-
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.
-
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 → ..
-
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.