Ինչպես անել
Կանչել HTML-ից հատուկ վիջեթ՝ mount, Render Element, Content Selector
Հիմնական HTML էջում դուք անում եք Նշում «կանչեք» վիջեթին ID-ով կամ կարճ կոդ տեղադրելով։ Դուք տեղադրում եք դատարկ դաշտ։ լեռ նշագրման մեջ, ապա հրապարակված վիջեթը, որի Render տարր համընկնում է, որ լեռը ներարկում է խաղացողին։ Բովանդակության ընտրիչ (կամ Content Text)-ը որոշում է, թե ինչ է արտասանվելու։ Ահա թե ինչպես է HTML-ից հղվում յուրաքանչյուր Full / Button / Circle վիջեթ՝ ներառյալ ձեր կողմից ստեղծված վիջեթները, այլ ոչ թե միայն երեք լռելյայն միացման դասերը։
- Ինչո՞ւ է օգտակար — մաքրել բաղադրատոմսը միացման սկրիպտից → ձեր վիջեթից → ուղիղ եթերի նվագարկիչ՝ առանց փորձերի և սխալների միջոցով գուշակելու։
- HTML-ում վիջեթի ID չկա — էջը երբեք չի անվանում կոնսոլի վիջեթը ID-ով. համապատասխանությունը class / selector → Render Element-ն է։
- Լռելյայններն ընդդեմ սովորականի — լռելյայն միացումներ (.gsp_full_player / button / circle)-ները կարճ ճանապարհներ են; ցանկացած եզակի դաս աշխատում է նույն կերպ։
- Նույնը շինարարների մոտ — Wix / Shopify / Squarespace Հատուկ HTML բլոկները օգտագործում են այս ճշգրիտ կանչի ձևանմուշը։
Բացեք Cloud Console-ը
HTML միացման ուղեցույց
Բոլոր հրահանգները
Related
Տեղադրել ըստ պատվերի (դասավորություն)
Առանձին բովանդակության տեքստ
Գլոբալ vs. Պատվերով
Խաղացողը չի ներկայանում
Ստեղծել լիարժեք խաղացող
Ստեղծել կոճակների նվագարկիչ
մոդել
Ինչպես «կանչել» HTML-ից հատուկ վիջեթը
Մտածեք երեք շերտի մասին։ Միացման սկրիպտը բեռնվում է։ GSpeech ամբողջ կայքի համար: Cloud Console-ի վիջեթը խաղացողի սահմանումն է (ձայն, Chrome, ընտրիչներ, URL կանոններ): Ձեր HTML-ում միացումը դատարկ հանգույցն է, որտեղ այդ խաղացողը կարող է հայտնվել:
- 1. Միացման սկրիպտ — մեկ անգամ մեկ կայքի համար (Ինտեգրացիաներ → Html կայք), սովորաբար նախքան </body>.
- 2. Հրապարակված վիջեթ — Լրիվ / Կոճակ / Շրջանակ, որը դուք ստեղծում կամ հարմարեցնում եք կոնսոլում։
- 3. HTML-ում տեղադրել — օրինակ <div class="my_listen_btn"></div>; Render տարրը պետք է լինի .my_listen_btn.
- Բովանդակության ընտրիչ — CSS թիրախ էջի տեքստի համար, որը պետք է ներկայացվի (կամ թողեք դատարկ և օգտագործեք «Բովանդակության տեքստ»՝ առանձին աուդիոյի համար):
Նիշի կանոն. HTML-ը երբեք չի «ներմուծում» վիջեթը անունով։ Համապատասխան Render տարր + mount դաս is զանգը։
HTML արժեքներ
Ինչպես գրել id, class և ստորակետեր (ծրագրավորման աստիճան անհրաժեշտ չէ)
Բովանդակության ընտրիչը, Render Element-ը և Exclude List-ը օգտագործում են նույն պարզ լեզուն: Ձեզ անհրաժեշտ է միայն երկու նախածանց, այդ դեպքում կարող եք բանավոր բովանդակությունը մասերի հավաքել և աղբը փորագրել Բացառման հետ։
- id → # — HTML-ում id="article" → մեջ GSpeech գրել #article (հեշ + ճշգրիտ id):
- դաս → . — HTML-ում class="post-content" → գրել .post-content (կետ + ճշգրիտ դասը): Եթե տարրն ունի մի քանի դաս, մեկ համապատասխան դասը բավարար է:
- Միայն պիտակ — մերկ պիտակների անունները նույնպես աշխատում են. article, section, h1 (no # or .).
- Բովանդակության ընտրիչ + ստորակետեր — հավաքեք բովանդակությունը մասերով մեկ դաշտում. #intro,.chapter-body,#summaryՀամընկնումները կարդացվում են հերթականությամբ՝ կատարյալ է, երբ էջը բաժանված է մի քանի փաթեթավորողների։
- Բացառությունների ցանկ + ստորակետեր — նույն շարահյուսությամբ հեռացնել աղմուկը այդ ընտրությունից՝ #comments,.ads,.share-buttonsԲացառությունները վերաբերում են բովանդակության ընտրիչի կողմից հավաքվածին։
- Ինչպես գտնել արժեքներ — ակտիվ էջում՝ աջ սեղմեք բլոկի վրա → Ստուգել։ Փնտրեք id="…" or class="…", ապա մուտքագրեք դրանք՝ # or . կոնսոլում։ Խորը բացառման ուղեցույց։ Բացառվածների ցանկ և ոչ խոսքի սահմանափակում.
Լռելյայն
Երեք լռելյայն մոնտաժներ ընդդեմ ձեր սեփական վիջեթի
Փաստաթղթերը հաճախ ցույց են տալիս երեք հարմար միացման դասերը, քանի որ դրանք առաքվում են պատրաստ՝ Cloud-ի լռելյայն կարգավորումներով: Պատվերով վիջեթը տարբեր ապրանք չէ՝ այն նույն Full / Button / Circle տեսակն է՝ Ձեր Render տարրը (և սովորաբար ձեր բովանդակության ընտրիչը):
- Լռելյայն լրիվ — լեռ <div class="gsp_full_player"></div> → Ռենդերի տարր .gsp_full_player.
- Լռելյայն կոճակ - .gsp_button_player mount + համապատասխան Render տարր։
- Լռելյայն շրջանակ - .gsp_circle_player mount + համապատասխան Render տարր։
- Ձեր անհատական զանգը — ձեր ունեցած ցանկացած դաս կամ ID (օրինակ՝ #promo-listen or .footer_tts) → սահմանեք հենց այդ ընտրիչը որպես Render Element ձեր հրապարակած վիջեթի վրա։
WordPress-ի կարճ կոդերը ([gspeech] / button / circle) գրառումների տեղադրման տարբեր ուղի են։ Raw HTML-ում կարճ կոդ չկա՝ միայն mount + Render Element զույգը։ Տես լռելյայն կարճ կոդեր միայն WP-ի համար։
Մատչ
Ամբողջականից մինչև ամբողջական. կարգավորեք և կանչեք ձեր անհատական վիջեթը
- Ստեղծեք / բացեք ձեր կայքը է Cloud Console և հաստատեք գլոբալ լռելյայն կարգավորումները Կարգավորումներ (ձայն, լեզու) — տե՛ս Գլոբալ vs. Պատվերով.
- Պատճեն Html կայք միացման սկրիպտը ինտեգրացիաներից և մեկ անգամ տեղադրեք այն ձեր համօգտագործվող ձևանմուշում նախքան </body>Տեղակայեք այնպես, որ ձայնի կարիք ունեցող յուրաքանչյուր էջ բեռնի սկրիպտը։
- Ստեղծել Լրիվ / Կոճակ / Շրջան վիջեթ (կամ բացեք արդեն իսկ գոյություն ունեցող մեկը): Տվեք դրան հստակ անուն, որպեսզի հետագայում ճանաչելի լինի:
- Էջի HTML-ում ավելացրեք դատարկ մոնտաժ որտեղ պետք է հայտնվի խաղացողը՝ ընտրեք եզակի դաս, որը չեք վերօգտագործի անկապ UI-ի համար։ Օրինակ՝ <div class="my_custom_player"></div>.
- Վիջեթի վրա սահմանեք Render տարր հենց այդ ընտրողին՝ .my_custom_player (դասի համար առաջատար կետը;) #id անձնագրի համար)։
- հավաքածու Բովանդակության ընտրիչ այն, ինչ այցելուները պետք է լսեն։ Մեկ փաթեթավորումը բավարար է (#main or .product-descriptionԿամ հավաքեք կտորները ստորակետերով՝ #intro,.body-copy,#summary: Օգտագործում parent_class / self_class երբ մոնտաժը գտնվում է այդ բովանդակության բլոկի ներսում։
- Optional: Բացառել ցուցակը (նաև ստորակետով բաժանված, նույնը # / . կանոններ) նավիգացիայի / գովազդների / մեկնաբանությունների համար՝ օրինակ՝ #comments,.ads,.share-buttons. Ըստ ցանկության՝ թույլատրված / արգելափակված URL-ներ, որպեսզի այս վիջեթը աշխատի միայն այնտեղ, որտեղ դուք ցանկանում եք։
- Սահմանել կարգավիճակը Հրատարակված է, Փրկել, վերաբեռնեք ուղիղ հեռարձակվող HTML էջը և համոզվեք, որ նվագարկիչը լրացնում է ձեր միացումը և կարդում է ճիշտ տեքստը։
Անհրաժեշտ է աուդիո ոչ շրջապատող էջի տեքստը (ցուցադրական / տաղավարի ոճ): Թողեք բովանդակության ընտրիչը դատարկ և լրացրեք Բովանդակության տեքստ փոխարենը՝ ամբողջական ուղեցույց. Առանձին նվագարկիչ՝ բովանդակության տեքստով.
Օրինակ
Ձեր վիջեթը կանչող նվազագույն HTML էջ
Ստորև ներկայացված է աշխատանքային էջի ձևը։ Փոխարինեք կապի սկրիպտը Integrations-ից ձեր սկրիպտով։ Mount դասը պետք է համապատասխանի հրապարակված վիջեթի Render Element-ին։ Content Selector-ը պետք է ուղղված լինի #article այս օրինակում.
- HTML-ում տեղադրել - <div class="my_custom_player"></div> (դատարկ):
- Վիջեթի արտապատկերման տարր - .my_custom_player.
- Վիջեթի բովանդակության ընտրիչ - #article.
- Միացման սկրիպտ — ձեր մեկ տողանոց Html կայքի ներդրման նախօրոք </body>.
Կմախք (մեկնաբանություններում ներկայացված է քարտեզագրումը):
<!-- 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 -->
Կարող եք տեղադրել ամրակը հոդվածի վերևում, կողային վահանակում կամ ստորին մասում՝ Content Selector-ը դեռևս մատնացույց է անում #article, ուստի Chrome-ի դասավորությունը չի արտասանվում։ Այդ դասավորության ձևանմուշը նույնպես ներառված է Տեղադրեք անհատական վիջեթ.
Checklist
Եթե հարմարեցված վիջեթը չի երևում
- Միացման սկրիպտ բեռնված է այդ URL-ի վրա (Դիտել աղբյուրը / ցանցը):
- Վիջեթի կարգավիճակը՝ Հրատարակված է (ոչ նախագիծ / անջատված):
- Միացումը գոյություն ունի էջում, և դասի/իդենտիֆիկացիայի ուղղագրությունը համընկնում է Render տարր ճիշտ (ներառյալ առաջատարը) . or #).
- Բովանդակության ընտրիչ գտնում է իրական տեքստ (կամ Content Text-ը լրացվում է առանձին տեքստի համար):
- Թույլատրված / արգելափակված URL-ները չեն բացառում այս ուղին։
- Պահպանումից հետո վերաբեռնում — HTML/CDN քեշը կարող է կարճ ժամանակով պահպանել հին shell-ը։
Լրիվ խնդրի լուծման ուղին՝ Խաղացողը չի ներկայանում.
ՀՏՀ
Հաճախակի տրվող հարցեր հատուկ HTML վիջեթի վերաբերյալ
-
Ոչ մի տեղ։ HTML-ը չի հղում անում կոնսոլի վիջեթի ID-ին։ Կանչը հետևյալն է՝ դատարկ միացում էջում + Render տարր հրապարակված վիջեթի վրա, որը սահմանված է այդ միացման ընտրիչի վրա։
-
Այո։ Այդ երեք անունները հարմար լռելյայն արժեքներ են, ոչ թե խիստ սահմանափակում։ Ցանկացած եզակի դաս կամ ID աշխատում է, եթե Render Element-ը համապատասխանում է դրան, և վիջեթը Հրապարակված է։
-
Վիջեթի ստեղծումը միայն կեսն է։ Էջին նաև անհրաժեշտ է միացում, որը համապատասխանում է Render Element-ին, միացման սկրիպտին, հրապարակված կարգավիճակին և URL կանոններին, որոնք թույլատրում են այդ էջը։ Առանց միացման, վիջեթը տեղ չունի ներարկելու։
-
Այո։ Ընտրիչները բաժանեք ստորակետերով՝ մի քանի մասերից պատմությունը հավաքելու համար, օրինակ՝ #intro,.chapter-body,#summaryԱյնուհետև կտրեք անպետք ֆայլերը Exclude List-ով՝ օգտագործելով նույն ստորակետային շարահյուսությունը (#comments,.adsՀիշե՛ք՝ HTML id → #, class → ..
-
Այո։ Նույն միացման դասը վերօգտագործեք յուրաքանչյուր ձևանմուշի վրա. մեկ հրապարակված վիջեթը լրացնում է թույլատրված / արգելափակված URL-ների կողմից թույլատրված յուրաքանչյուր համապատասխան միացմանը։ Ստեղծեք մեկ այլ վիջեթ միայն այն դեպքում, երբ ձայնը, դիզայնը կամ ընտրիչները պետք է տարբերվեն։