Konfigurace
| Volba | Typ | Povinná | Popis |
|---|---|---|---|
bootstrapui_css |
string nebo string[] | ano | Adresa Bootstrap CSS pro náhledy v dialozích. Pole umožní přidat vlastní motiv za Bootstrap. Bez ní plugin běží, ale chybějící volbu hlásí v editoru, v konzoli a v každém náhledu. |
bootstrapui_js |
string nebo string[] | ne | Adresa bootstrap.bundle.min.js, nebo pole adres; skripty se do náhledu vkládají v zadaném pořadí. Potřeba jen pro Přehrát / otevřít u interaktivních komponent. U Bootstrapu 4 patří před bundle jQuery, viz níže. |
bootstrapui_image_picker |
(callback, editor) => void |
ne | Váš správce souborů. Volá se z dialogů Karta a Obrázek; vybraný obrázek předejte callback(url). |
bootstrapui_version |
'5' nebo '4' |
ne | Řada Bootstrapu na vašem webu. Výchozí 5. S 4 dialogy používají názvy tříd a datové atributy Bootstrapu 4 (data-toggle místo data-bs-toggle) a skryjí, co ta řada nemá, viz Bootstrap 4. Neznámou hodnotu plugin ohlásí. |
bootstrapui_grid_defaults |
objekt | ne | Třídy sloupců, které návrhář mřížky dá pro daný počet sloupců, např. { 4: 'col-12 col-sm-6 col-xl-3' }. Neuvedené počty berou vestavěnou sadu (třeba 4 → col-12 col-md-6 col-lg-3). |
bootstrapui_styles |
logická hodnota nebo objekt | ne | Třídy Bootstrapu v nabídce TinyMCE Styly a v tlačítku bootstrapuistyles. Výchozí true; false vypne; objekt { groups, breakpoints, title } ji zúží, viz Nabídka Styly. |
language |
string | ne | Standardní volba TinyMCE. Angličtina a čeština (cs) jsou v pluginu; slovenština, němčina, španělština, francouzština, brazilská portugalština, italština a polština (sk, de, es, fr, pt_BR, it, pl) se načtou z langs/. Viz Překlady. |
Volby TinyMCE, na které plugin spoléhá
| Volba | Proč |
|---|---|
content_css |
Dejte sem i Bootstrap CSS, jinak plocha editoru vypadá jinak než náhled. |
plugins: 'table' |
Dialog tabulky přenechává řádky, sloupce a slučování liště TinyMCE. |
table_toolbar |
Přidejte bootstrapuieditui bootstrapuitablecell bootstrapuitablemenu, ať je nastavení tabulky dostupné z její plovoucí lišty. |
table_resize_bars: false |
Úchopy zapisují inline width/height, které mohou omezit responzivní chování tabulky. |
toolbar s styles |
Nabídka TinyMCE Styly ukáže skupinu Bootstrap (nebo přidejte tlačítko bootstrapuistyles). |
plugins: 'quickbars' + quickbars_selection_toolbar |
Přidejte bootstrapuitypography, ať je nastavení textu jedno kliknutí od výběru. |
Bootstrap 4 a jQuery v náhledu
Náhled v dialogu běží v izolovaném iframe, takže jQuery z vaší stránky v něm není. JavaScript Bootstrapu 4 přitom jQuery potřebuje a jeho bootstrap.bundle obsahuje Popper, ale ne jQuery. Do bootstrapui_js proto dejte jQuery jako první:
bootstrapui_version: '4',
bootstrapui_css: '/assets/bootstrap-4.6.2.min.css',
bootstrapui_js: ['/assets/jquery.min.js', '/assets/bootstrap-4.6.2.bundle.min.js'],
Použijte verzi jQuery, kterou podporuje váš Bootstrap 4: ten 4.6 vyžaduje jQuery od 1.9.1 do verze 3.x (včetně). Adresy určujete vy, plugin nic z CDN netahá. Nespustí-li se Bootstrap JavaScript v náhledu, náhled to napíše do horní části (u čtyřky s odkazem na jQuery) a Přehrát / otevřít nefunguje.
Volba se týká jen náhledů v dialozích. Na publikované stránce si Bootstrap JavaScript (u čtyřky i jQuery) zajišťuje váš web sám; plugin je tam nevkládá.
Kontrola verze
Po inicializaci plugin přečte začátek bootstrapui_css a porovná nalezenou verzi Bootstrapu s bootstrapui_version. Nesoulad hlásí jako varování v editoru. Na file:// nebo při blokovaném CORS se kontrola neprovede.