Κλήση ενός προσαρμοσμένου γραφικού στοιχείου από HTML

Κλήση ενός προσαρμοσμένου γραφικού στοιχείου από HTML — mount, Render Element, Content Selector

Σε μια βασική σελίδα HTML κάνετε δεν «κλήση» ενός γραφικού στοιχείου με αναγνωριστικό ή επικόλληση ενός σύντομου κωδικού. Τοποθετείτε ένα κενό τοποθετήσετε στη σήμανση, έπειτα το δημοσιευμένο γραφικό στοιχείο του οποίου Στοιχείο απόδοσης ταιριάζει που η τοποθέτηση εγχέει τον παίκτη. Επιλογέας περιεχομένου (ή Κείμενο Περιεχομένου) αποφασίζει τι θα εκφωνηθεί. Έτσι αναφέρεται κάθε προσαρμοσμένο γραφικό στοιχείο Full / Button / Circle από την HTML — συμπεριλαμβανομένων των γραφικών στοιχείων που δημιουργείτε οι ίδιοι, όχι μόνο των τριών προεπιλεγμένων κλάσεων mount.

  • Γιατί χρήσιμο — διαγραφή συνταγής από το σενάριο σύνδεσης → το γραφικό σας στοιχείο → ζωντανό πρόγραμμα αναπαραγωγής, χωρίς μαντέματα με δοκιμές και σφάλματα.
  • Δεν υπάρχει αναγνωριστικό γραφικού στοιχείου σε HTML — η σελίδα δεν ονομάζει ποτέ το γραφικό στοιχείο κονσόλας με βάση το αναγνωριστικό. Η αντιστοίχιση είναι κλάση / επιλογέας → Στοιχείο απόδοσης.
  • Προεπιλογές έναντι προσαρμοσμένων — προεπιλεγμένες βάσεις στήριξης (.gsp_full_player / button / circle) είναι συντομεύσεις· οποιαδήποτε μοναδική κλάση λειτουργεί με τον ίδιο τρόπο.
  • Το ίδιο και οι κατασκευαστές — Wix / Shopify / Squarespace Τα προσαρμοσμένα μπλοκ HTML χρησιμοποιούν αυτό ακριβώς το μοτίβο κλήσεων.

Άνοιγμα κονσόλας cloud Οδηγός σύνδεσης HTML Όλες οι οδηγίες

Πώς «καλείτε» ένα προσαρμοσμένο γραφικό στοιχείο από HTML

Σκεφτείτε τρία επίπεδα. Το σενάριο σύνδεσης φορτώνει GSpeech για ολόκληρο τον ιστότοπο. Το γραφικό στοιχείο στο Cloud Console είναι ο ορισμός του παίκτη (φωνή, chrome, επιλογείς, κανόνες URL). Το mount στο HTML σας είναι ο κενός κόμβος όπου μπορεί να εμφανιστεί αυτός ο παίκτης.

  • 1. Σενάριο σύνδεσης — μία φορά ανά ιστότοπο (Ενσωματώσεις → Ιστότοπος Html), συνήθως πριν από </body>.
  • 2. Δημοσιευμένο γραφικό στοιχείο — Πλήρες / Κουμπί / Κύκλος που δημιουργείτε ή προσαρμόζετε στην κονσόλα.
  • 3. Προσάρτηση σε HTML - π.χ <div class="my_listen_btn"></div>Το στοιχείο απόδοσης πρέπει να είναι .my_listen_btn.
  • Επιλογέας περιεχομένου — Στόχος CSS για το κείμενο της σελίδας προς αφήγηση (ή αφήστε το κενό και χρησιμοποιήστε το Κείμενο Περιεχομένου για αυτόνομο ήχο).

Κανόνας: Η HTML δεν «εισάγει» ποτέ ένα γραφικό στοιχείο με βάση το όνομά του. Αντιστοίχιση στοιχείου Render + κλάσης mount is η κλήση.

Πώς να γράψετε id, class και commas (δεν απαιτείται πτυχίο κωδικοποίησης)

Ο Επιλογέας Περιεχομένου, το Στοιχείο Απόδοσης και η Λίστα Εξαίρεσης χρησιμοποιούν την ίδια απλή γλώσσα. Χρειάζεστε μόνο δύο προθέματα — τότε μπορείτε συναρμολογήστε το προφορικό περιεχόμενο σε κομμάτια και ξεχωρίζω σκουπίδια με Εξαίρεση.

  • αναγνωριστικό → # — σε HTML id="article" → σε GSpeech γράφω #article (κατακερματισμός + το ακριβές αναγνωριστικό).
  • τάξη → . — σε HTML class="post-content" → γράψε .post-content (τελεία + η ακριβής κλάση). Εάν το στοιχείο έχει πολλές κλάσεις, αρκεί μία αντίστοιχη κλάση.
  • Μόνο ετικέτα — λειτουργούν και τα γυμνά ονόματα ετικετών: article, section, h1 (αρ # or .).
  • Επιλογέας περιεχομένου + κόμματα — συγκεντρώστε περιεχόμενο σε κομμάτια σε ένα πεδίο: #intro,.chapter-body,#summaryΟι αντιστοιχίσεις διαβάζονται με τη σειρά — τέλεια όταν η σελίδα χωρίζεται σε πολλά περιτυλίγματα.
  • Λίστα εξαιρέσεων + κόμματα — αφαιρέστε τον θόρυβο από αυτήν την επιλογή με την ίδια σύνταξη: #comments,.ads,.share-buttonsΕξαιρούνται όσα συλλέχθηκαν από τον Επιλογέα Περιεχομένου.
  • Πώς να βρείτε τιμές — στη σελίδα ζωντανής προβολής: κάντε δεξί κλικ στο μπλοκ → Επιθεώρηση. Αναζητήστε id="…" or class="…"και, στη συνέχεια, πληκτρολογήστε τα με # or . στην κονσόλα. Αναλυτική περιγραφή εξαιρέσεων σε βάθος: Λίστα εξαιρέσεων και nospeech.

Τρεις προεπιλεγμένες βάσεις δεδομένων έναντι του δικού σας προσαρμοσμένου widget

Τα έγγραφα συχνά εμφανίζουν τις τρεις βολικές κλάσεις προσάρτησης επειδή αποστέλλονται έτοιμες με τις προεπιλογές Cloud. Ένα προσαρμοσμένο γραφικό στοιχείο δεν είναι διαφορετικό προϊόν — είναι ο ίδιος τύπος Full / Button / Circle με your Στοιχείο απόδοσης (και συνήθως ο Επιλογέας περιεχομένου σας).

  • Προεπιλεγμένο Πλήρες — όρος <div class="gsp_full_player"></div> → Στοιχείο απόδοσης .gsp_full_player.
  • Προεπιλεγμένο κουμπί - .gsp_button_player mount + αντίστοιχο στοιχείο απόδοσης.
  • Προεπιλεγμένος κύκλος - .gsp_circle_player mount + αντίστοιχο στοιχείο απόδοσης.
  • Η προσαρμοσμένη κλήση σας — οποιαδήποτε κλάση ή ταυτότητα που κατέχετε (π.χ. #promo-listen or .footer_tts) → ορίστε αυτόν ακριβώς τον επιλογέα ως Στοιχείο Απόδοσης στο γραφικό στοιχείο που δημοσιεύσατε.

Οι σύντομοι κώδικες του WordPress ([gspeech] / button / circle) αποτελούν διαφορετική διαδρομή τοποθέτησης για τις αναρτήσεις. Σε raw HTML δεν υπάρχει σύντομος κώδικας — μόνο το ζεύγος mount + Render Element. Δείτε προεπιλεγμένοι σύντομοι κωδικοί μόνο για WP.

Από άκρο σε άκρο: διαμορφώστε και καλέστε το προσαρμοσμένο γραφικό σας στοιχείο

  1. Δημιουργήστε / ανοίξτε το δικό σας στο Cloud Console και επιβεβαιώστε τις καθολικές προεπιλογές στο Ρυθμίσεις (φωνή, γλώσσα) — βλ. Παγκόσμια έναντι προσαρμοσμένης.
  2. αντιγράψτε το Ιστοσελίδα HTML σενάριο σύνδεσης από τις Ενοποιήσεις και επικολλήστε το μία φορά στο κοινόχρηστο πρότυπό σας πριν </body>Αναπτύξτε το έτσι ώστε κάθε σελίδα που χρειάζεται ήχο να φορτώνει το σενάριο.
  3. Δημιουργία Πλήρες / Κουμπί / Κύκλος γραφικό στοιχείο (ή ανοίξτε ένα υπάρχον προσαρμοσμένο). Δώστε του ένα σαφές όνομα για να το αναγνωρίζετε αργότερα.
  4. Στον κώδικα HTML της σελίδας, προσθέστε ένα κενή βάση όπου θα πρέπει να εμφανίζεται ο παίκτης — επιλέξτε μια μοναδική κλάση που δεν θα επαναχρησιμοποιήσετε για άσχετο περιβάλλον χρήστη. Παράδειγμα: <div class="my_custom_player"></div>.
  5. Στο γραφικό στοιχείο, ορίστε Στοιχείο απόδοσης σε αυτόν ακριβώς τον επιλογέα: .my_custom_player (αρχική τελεία για μια κλάση· #id για μια ταυτότητα).
  6. σετ Επιλογέας περιεχομένου σε αυτό που πρέπει να ακούσουν οι επισκέπτες. Ένα περιτύλιγμα είναι μια χαρά (#main or .product-description). Ή συναρμολογήστε κομμάτια με κόμματα: #intro,.body-copy,#summary. Χρήση parent_class / self_class όταν το mount βρίσκεται μέσα σε αυτό το μπλοκ περιεχομένου.
  7. Προαιρετικά: Λίστα εξαιρέσεων (επίσης διαχωρισμένο με κόμμα, το ίδιο # / . κανόνες) για πλοήγηση / διαφημίσεις / σχόλια — π.χ. #comments,.ads,.share-buttonsΠροαιρετικά: Επιτρεπόμενες / Αποκλεισμένες διευθύνσεις URL, ώστε αυτό το γραφικό στοιχείο να εκτελείται μόνο όπου θέλετε.
  8. Ορισμός κατάστασης σε Δημοσιευμένα, Αποθήκευση, επαναφορτώστε τη σελίδα HTML σε πραγματικό χρόνο και επιβεβαιώστε ότι το πρόγραμμα αναπαραγωγής γεμίζει το mount σας και διαβάζει το σωστό κείμενο.

Χρειάζομαι ήχο με Όχι. κείμενο γύρω από τη σελίδα (στυλ επίδειξης / κιόσκι); Αφήστε τον Επιλογέα Περιεχομένου κενό και συμπληρώστε Κείμενο περιεχομένου αντί αυτού — πλήρης αναλυτική παρουσίαση: Αυτόνομο πρόγραμμα αναπαραγωγής με κείμενο περιεχομένου.

Ελάχιστη σελίδα HTML που καλεί το γραφικό σας στοιχείο

Παρακάτω φαίνεται το σχήμα μιας σελίδας που λειτουργεί. Αντικαταστήστε το σενάριο σύνδεσης με το δικό σας από το Integrations. Η κλάση mount πρέπει να ταιριάζει με το Render Element στο δημοσιευμένο γραφικό στοιχείο. Ο Επιλογέας Περιεχομένου θα πρέπει να στοχεύει #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 -->

Μπορείτε να τοποθετήσετε την ανάρτηση πάνω από το άρθρο, σε μια πλαϊνή μπάρα ή στο υποσέλιδο — Ο Επιλογέας Περιεχομένου εξακολουθεί να δείχνει προς #article, επομένως η διάταξη του Chrome δεν εκφωνείται. Αυτό το μοτίβο διάταξης καλύπτεται επίσης στο Τοποθέτηση ενός προσαρμοσμένου γραφικού στοιχείου.

Εάν το προσαρμοσμένο γραφικό στοιχείο δεν εμφανίζεται

  1. Σενάριο σύνδεσης φορτώθηκε σε αυτήν τη διεύθυνση URL (Προβολή πηγής / Δίκτυο).
  2. Η κατάσταση του γραφικού στοιχείου είναι Δημοσιευμένα (όχι πρόχειρο / απενεργοποιημένο).
  3. Η τοποθέτηση υπάρχει στη σελίδα και η ορθογραφία κλάσης/id ταιριάζει Στοιχείο απόδοσης ακριβώς (συμπεριλαμβανομένων των κορυφαίων . or #).
  4. Επιλογέας περιεχομένου βρίσκει πραγματικό κείμενο (ή το Κείμενο Περιεχομένου συμπληρώνεται για αυτόνομη λειτουργία).
  5. Οι επιτρεπόμενες / αποκλεισμένες διευθύνσεις URL δεν εξαιρούν αυτήν τη διαδρομή.
  6. Επαναφόρτωση μετά την αποθήκευση — Η προσωρινή μνήμη HTML/CDN μπορεί να διατηρήσει ένα παλιό κέλυφος για λίγο.

Πλήρης διαδρομή αντιμετώπισης προβλημάτων: Ο παίκτης δεν εμφανίζεται.

Συχνές ερωτήσεις για το προσαρμοσμένο γραφικό στοιχείο HTML

  • Πού μπορώ να τοποθετήσω το αναγνωριστικό του γραφικού στοιχείου στην HTML μου;

    Πουθενά. Η HTML δεν αναφέρει το αναγνωριστικό του γραφικού στοιχείου της κονσόλας. Η κλήση είναι: κενό mount στη σελίδα + Στοιχείο απόδοσης στο δημοσιευμένο γραφικό στοιχείο που έχει οριστεί στον επιλογέα αυτού του mount.
  • Μπορώ να χρησιμοποιήσω μια κλάση που δεν είναι gsp_full_player / button / circle;

    Ναι. Αυτά τα τρία ονόματα είναι βολικές προεπιλογές, όχι αυστηρό όριο. Οποιαδήποτε μοναδική κλάση ή αναγνωριστικό λειτουργεί εάν το Render Element ταιριάζει με αυτό και το γραφικό στοιχείο είναι Δημοσιευμένο.
  • Δημιούργησα ένα προσαρμοσμένο γραφικό στοιχείο — γιατί δεν συμβαίνει τίποτα στη σελίδα;

    Η δημιουργία του γραφικού στοιχείου είναι μόνο η μισή προσπάθεια. Η σελίδα χρειάζεται επίσης ένα mount που να ταιριάζει με το Render Element, το σενάριο σύνδεσης, την κατάσταση δημοσίευσης και τους κανόνες URL που επιτρέπουν αυτήν τη σελίδα. Χωρίς το mount, το γραφικό στοιχείο δεν έχει πουθενά να κάνει injection.
  • Μπορεί ο Επιλογέας Περιεχομένου να εμφανίσει περισσότερα από ένα στοιχεία;

    Ναι. Διαχωρίστε τους επιλογείς με κόμματα για να συναρμολογήσετε την αφήγηση από πολλά κομμάτια — π.χ. #intro,.chapter-body,#summaryΣτη συνέχεια, περικόψτε τα ανεπιθύμητα με τη Λίστα Εξαιρέσεων χρησιμοποιώντας την ίδια σύνταξη κόμματος (#comments,.ads). Υπενθύμιση: HTML id → #, class → ..
  • Ένα γραφικό στοιχείο, πολλές σελίδες;

    Ναι. Επαναχρησιμοποιήστε την ίδια κλάση προσάρτησης σε κάθε πρότυπο. Ένα δημοσιευμένο γραφικό στοιχείο συμπληρώνει κάθε αντίστοιχη προσάρτηση που επιτρέπεται από τις Επιτρεπόμενες / Αποκλεισμένες διευθύνσεις URL. Δημιουργήστε ένα άλλο γραφικό στοιχείο μόνο όταν η φωνή, ο σχεδιασμός ή οι επιλογείς πρέπει να διαφέρουν.
Έγγραφα και οδηγοί