Προσαρμοσμένα Θέματα
Στυλ του προβολέα ώστε να ταιριάζει με την εφαρμογή σας
Ο προβολέας παρέχεται με μια ουδέτερη εμφάνιση βασισμένη στο Bootstrap, η οποία σερβίρεται από τους ενσωματωμένους πόρους (viewer.css, καθώς και φύλλα στυλ ανά χαρακτηριστικό όπως searchBar.css και annotationBar.css). Η θεματοποίηση γίνεται σε τρία επίπεδα — επιλέξτε το πιο ρηχό που σας φέρνει στο στόχο.
Επίπεδο 1 — Διαμορφώστε το περιβάλλον
ViewerConfig.ShowThumbs = false— χωρίς πίνακα μικρογραφιών.ViewerConfig.FitType = "height" | "width"— πώς οι σελίδες γεμίζουν το παράθυρο προβολής.- Επιλεκτικά πακέτα
CssConfig/ScriptConfig— κρατήστε μόνο το περιβάλλον που χρησιμοποιεί ο κεντρικός σας.
Επίπεδο 2 — Παράκαμψη του CSS
Viewer.ReferenceCss() εκδίδει απλές ετικέτες <link>· οτιδήποτε φορτώνετε μετά από αυτές κερδίζει την αλυσίδα. Μεγέθυνση και περιθώριο του προβολέα από το δικό σας φύλλο στυλ:
/* Το φύλλο στυλ σας, φορτώνεται μετά το ReferenceCss() */
/* Τα δύο containers που έχετε */
#divDocViewer { width: 100%; height: calc(100vh - 48px); }
/* Κάρτες σελίδας Widget */
.docPage { max-width: none; }Η σελίδα-ξενιστής ελέγχει πλήρως τη εξωτερική διάταξη — το widget αποδίδει μέσα σε οποιοδήποτε κουτί δώσετε #divDocViewer / #div_ctlDoc (το τυπικό ζεύγος containers από το Quick Start).
Δύο πρακτικοί κανόνες:
- Μην φορτώνετε δύο φορές το Bootstrap. Εάν η εφαρμογή σας ήδη περιλαμβάνει Bootstrap, παραλείψτε
IncludeBootstrapCss/IncludeBootstrapκαι αφήστε το widget να κληρονομήσει το δικό σας — αυτό από μόνο του κάνει τον προβολέα να φαίνεται εγγενής στην εφαρμογή σας. - Συμπεριλάβετε μόνο τα πακέτα που χρησιμοποιείτε. Κάθε σημαία
CssConfig/ScriptConfigείναι προαιρετική· λιγότερα πακέτα, λιγότερα στυλ προς αντιμετώπιση.
Επίπεδο 3 — Δημιουργήστε τη δική σας γραμμή εργαλείων
Για μια πλήρως επωνυμοποιημένη εμπειρία, ελέγξτε το widget από το δικό σας UI. Μια τέτοια γραμμή εργαλείων αποτελείται από markup του ξενιστή συν ένα βοηθητικό στοιχείο ειδικό για την εφαρμογή· δεν είναι ένα ενσωματωμένο SDK Ribbon. Η επιστρεφόμενη παρουσία docViewer κατά την αρχικοποίηση είναι η επιφάνεια API σας, μαζί με τα δικά σας endpoints:
<div id="toolbar">
<button id="btnOpen">Open</button>
<button id="btnPrev">‹</button>
<button id="btnNext">›</button>
<!-- το σύστημα σχεδίασής σας, τα εικονίδια σας -->
</div>
<div id="divDocViewer"><div id="div_ctlDoc"></div></div>
<script>
const objViewer = $('#div_ctlDoc').docViewer({
showThumbs: true,
autoLoad: false,
BasePath: 'doconut',
ResPath: 'doconut-res/images',
onViewerReady: () => { /* Ενεργοποιήστε τα κουμπιά σας */ },
onError: (msg) => console.error('DocViewer:', msg)
});
document.getElementById('btnOpen').addEventListener('click', async () => {
const resp = await fetch('/api/open?fileName=Sample.pdf', { method: 'POST' });
const token = await resp.text();
objViewer.View(token);
});
</script>Η Αναζήτηση και η Σχόλιο είναι διαφορετικές: τα προαιρετικά στοιχεία Ribbon τους είναι ενσωματωμένα στο SDK (IncludeSearchBar, IncludeAnnotationBar) και δημιουργούν το δικό τους DOM. Μπορείτε να τα χρησιμοποιήσετε μαζί με τη δική σας προσαρμοσμένη γραμμή εργαλείων Viewer ή να τα παραλείψετε και να καλέσετε εσείς τις υποκείμενες API του widget. Δείτε το πλήρες πακέτο Viewer στο Quick Start για τη σειρά ολοκληρωμένης ενσωμάτωσης.
Σκοτεινή λειτουργία και RTL
Το widget δεν παρέχει σκοτεινό θέμα· μια παράκαμψη Επιπέδου 2 που στοχεύει στην κλάση σκοτεινής λειτουργίας σας (π.χ. .dark #divDocViewer { … }) σε φόντα και περιγράμματα καλύπτει τις περισσότερες ανάγκες, καθώς το περιεχόμενο της σελίδας αποδίδεται ως εικόνα. Για ξενιστές RTL, ο προβολέας λειτουργεί άψογα μέσα σε διάταξη RTL — κρατήστε τη δική σας γραμμή εργαλείων ενήμερη για RTL.
Τι δεν πρέπει να κάνετε
Μην κάνετε fork ή επεξεργασία των ενσωματωμένων φύλλων στυλ: παρέχονται μέσα στο πακέτο και αντικαθίστανται σε κάθε ενημέρωση. Οι παρακάμψεις στο δικό σας φύλλο στυλ παραμένουν μετά τις αναβαθμίσεις· οι επεξεργασίες στο viewer.css δεν διατηρούνται.
Ήταν αυτή η σελίδα χρήσιμη;