Přehled
Tento widget přináší tisk map ve stylu ArcGIS Pro do ArcGIS Experience Builderu bez nutnosti tiskové služby. V ArcGIS Pro sdílíte rozvržení jako soubor (.pagx), jednou ho naimportujete v nastavení widgetu a widget pak tuto stránku znovu vytvoří v prohlížeči podle vaší aktuální mapy: mapový rám, název a text, severku, měřítko, legendu, obrázky a čáry.
https://github.com/brianmcleer/print-advanced-widget
Poznámka: V nastavení widgetu naimportujte soubor rozvržení ArcGIS Pro (.pagx), který určí stránku. K dispozici je také volitelná tisková služba Esri, pokud chcete raději použít serverovou službu ExportWebMap.
Co tento widget umí?
- Reprodukuje rozvržení ArcGIS Pro .pagx v prohlížeči (mapový rám, text, čáry, severku, měřítko, obrázky, legendu) a jeho výstup odpovídá skutečnému výstupu z Pro.
- Exportuje PDF a SVG jako skutečnou vektorovou grafiku, ale také PNG32, PNG8, JPG, GIF, TIFF a EPS. Tisková služba není potřeba.
- Volitelná tisková služba Esri (adresa URL ExportWebMap) pro rozvržení vytvářená na serveru; navíc umožňuje formát AIX.
- Náhled oblasti tisku vykreslený na mapě, abyste před exportem viděli, co se vytiskne. Zachovejte aktuální měřítko, zachovejte aktuální rozsah, nastavte pevné měřítko nebo vyberte měřítko ze seznamu; k dispozici je přepínač uzamčení.
- 12 stylů severky a 9 stylů měřítka zobrazených jako miniatury a také možnost Výchozí pro rozvržení.
- Výstupní souřadnicový systém (WKID) pro tisk v jiné projekci, než používá mapa.
- Tokeny autora, autorských práv a uvedení zdroje. Export pouze legendy nebo mapy. Vlastní písma přes URL, včetně importu písem Google Fonts.
- Seznam nedávných exportů a import a export celé konfigurace ve formátu XML.
- Správci mohou ovládat výchozí nastavení, nabízené formáty i ovládací prvky, které uvidí koncoví uživatelé.
Seznam změn:
15. 10. 2026:
Seznam exportů prošel úpravou. U každého dokončeného souboru se nyní zobrazuje stav Připraveno, čas, počet stránek a velikost. Kliknutím na název soubor otevřete na nové kartě, případně ho můžete znovu stáhnout tlačítkem Uložit. Technické podrobnosti a případné poznámky jsou skryté pod tlačítkem Podrobnosti, takže seznam zůstává přehledný. Soubory zůstávají v seznamu, dokud je aplikace otevřená, i když zavřete panel Tisk.
12. 10. 2026: Widget nyní používá jazyk aplikace (?locale=, přepínače jazyka, profilu ArcGIS nebo prohlížeče) včetně průvodce nápovědou, a to v 39 jazycích.
Máte vlastní widgety? Stejný bezplatný nástroj, exb-i18n-kit, je dokáže přeložit jediným příkazem: localize. Takto překládá jednotlivé výrazy:
- Nejprve Esri. Načítá překlady, které už jsou součástí vaší instalace Experience Builderu, takže se například výraz „Přiblížit na“ přeloží stejně jako ve vlastních widgetech Esri.
- Standardní výrazy. Názvy jednotek, například stopy a akry, pocházejí z Unicode CLDR, tedy ze stejné databáze, kterou používají prohlížeče.
- Sdílená překladová paměť. Zbývající výrazy pocházejí ze sdíleného slovníku vytvořeného pomocí open source překladače LibreTranslate a modelů Opus-MT od Helsinki-NLP pro bosenštinu, chorvatštinu a srbštinu. Běží zdarma na GitHubu, takže nepotřebujete klíč API ani účet.
- Propojení. Nástroj také vyhledá anglický text, který je pevně zapsaný mimo soubor překladů widgetu, například výchozí nastavení nebo průvodce nápovědou, a propojí ho tak, aby se také překládal.
Ruční opravy mají vždy přednost před automatickým překladem a nikdy se nepřepisují. Některé překlady vytvořil stroj, takže pokud narazíte na nevhodný překlad, odpovězte zde s lepším zněním.
24. 9. 2026:
- Náhled stránky je nyní pod názvem mapy, takže panel postupuje shora dolů: vyberete rozvržení, zadáte název, zobrazíte stránku a exportujete.
- Pokročilé možnosti jsou uspořádány do šesti karet: Oblast tisku, Série map, Na mapě, Text stránky, Styl a Výstup. Každou lze otevřít a zavřít kliknutím na záhlaví, zapamatuje si vaši volbu a po zavření zobrazuje jednořádkové shrnutí, například „PDF, 300 DPI“ nebo „Legenda, mřížka“.
- Série map se nastavují jednoduchým přepínačem, který automaticky nastaví formát PDF.
- Nastavení mají stejné pořadí, takže nastavení správce odpovídá tomu, co vidí uživatelé. Správci mohou také určit, které karty budou při spuštění otevřené.
23. 9. 2026:
- GeoPDF. Otevřete PDF v Avenza nebo Field Maps a zobrazí se modrá tečka. Funguje také s GeoTIFF, soubory world file a KMZ.
- Vrstvy PDF. V Acrobatu můžete zapínat a vypínat mapu, mřížku, legendu a text.
- Živý náhled stránky. Při posouvání mapy uvidíte celou vytištěnou stránku.
- Vektorové vrstvy. Ostré čáry a prohledávatelné popisky místo pixelů (experimentální).
- Stránky řízené daty. Jedna stránka pro každou parcelu, park nebo projekt. Funguje se skupinovými vrstvami a filtry a přidá název prvku do názvu stránky.
- Průběh série map. Zobrazuje například „Stránka 3 z 12“ a zbývající čas, spolu s tlačítkem Zrušit.
- Omezení počtu stránek. Widget běží v prohlížeči, takže správci mohou nastavit upozornění a maximální počet stránek.
- Mřížka: Změna barev čar mřížky a písma pro mřížky ve widgetu i jejich výchozího nastavení.
9. 9. 2026:
- Vybrané prvky se nyní tisknou. Pokud máte na mapě vybrané parcely nebo jiné prvky, vytisknou se přes mapu s azurovým obrysem. Widget zachytí mapu do skrytého zobrazení, které sdílí její vrstvy, ale ne samotný pohled na mapu. Zvýraznění výběru je navázáno na toto zobrazení, a proto se dříve mohlo stát, že vybraná parcela ve výtisku chyběla, i když v něm byly všechny ostatní grafické prvky. Výběr se nyní vykresluje na stránku jako vektor, takže je v PDF a SVG ostrý a živé mapy se nijak nedotkne. Panel exportu obsahuje přepínač Vybrané prvky, který je ve výchozím nastavení zapnutý, a odpovídající výchozí nastavení najdete i v nastavení widgetu.
- Průvodce nápovědou ve widgetu. Tlačítko Nápověda v záhlaví widgetu otevře stručného průvodce v běžném jazyce, ve kterém lze vyhledávat: tři kroky pro začátek, vysvětlení jednotlivých možností, doporučení typu souboru a rady, co zkontrolovat, když něco nefunguje. Zobrazuje pouze nápovědu k funkcím, které jsou ve vaší aplikaci skutečně zapnuté, takže nikdo nemusí číst o legendě nebo sérii map, které jeho rozvržení nepoužívá.
4. 9. 2026:
Už není v beta verzi, nasadil jsem ho na své weby jako ostrý widget. Nové funkce:
- Přidán export do Google Earth (KMZ) pro exporty pouze mapy
- Přidán georeferencovaný rastrový výstup: skutečný GeoTIFF pro TIFF, world file a
.prj pro PNG, JPG a GIF - Podpora souřadnicových systémů je nyní univerzální, nikoli omezená na pevný seznam; zahrnuje
.prj výstup, georeferencování GeoTIFF a tokeny názvů souřadnicových systémů - Přidána plná podpora dynamického textu ArcGIS Pro, včetně času, kreditů servisních vrstev, vlastností prostorové reference, souřadnic mapového rámu a tokenů stránek série map
- Přidáno filtrování legendy podle měřítka
- Série map tiskne panel legendy na každé stránce a znovu vytváří její mřížku podle aktuálního rámu
- Import a export XML nastavení nyní zachovává mřížku, přehledovou mapu a výchozí nastavení legendy
- Opraveny velikosti symbolů, textu a čar při vysokém DPI
- Opraven tisk snímků, které se při velkém měřítku netiskly ve správném měřítku
- Opraveny chybějící vzorky v legendě u skupinových vrstev mapových služeb
- Opraveno umístění legendy vlevo dole a vpravo dole
- Opravena možnost „Použít pro všechna rozvržení“
- Opraveno neobnovení přepínače legendy při změně rozvržení
- Legenda nyní respektuje
.pagx počet sloupců a viditelnost názvu
12. 8. 2026:
Opraveno vykreslování položek legendy v podobě šedých čtverců v Experience Builderu 1.21. Novější ArcGIS Maps SDK vykresluje widget Legend za shadow DOM, takže se vzorky symbolů při přípravě tisku skryly. Extrakce vzorků nyní proniká do shadow DOM, podporuje novou komponentu arcgis-legend a v případě nedostatečných výsledků automaticky doplní symboly z vykreslovačů vrstev. Mapy ani rozvržení není třeba měnit. Děkujeme uživateli @ncramer11 za nahlášení přes GitHub.
23. 7. 2026:
Aktualizován widget Přepínač map pro Experience Builder 1.21, aby se vyřešily chyby editoru TypeScriptu, včetně typování komponent React a neměnných importů konfigurace. Byla také zvýšena verze widgetu a nejnovější vydání je nyní dostupné na GitHubu.
17. 7. 2026:
Kompletní přepracování systému legendy
- Legenda nyní čte živý widget Legend na stránce přesně tak, jak ho vidí uživatel: pořadí vrstev, vnoření skupin, viditelnost a hierarchii podvrstev. Nastavení zdroje legendy umožňuje určit konkrétní widget nebo jej automaticky rozpoznat.
- Vykreslování symbolů ve vysokém rozlišení: vzorky mapových služeb se načítají z REST legendy v rozlišení 288 DPI a přiřazují se k řádkům legendy podle kontextu; vektorové vzorky se převzorkují; symboly se vykreslují ve správném poměru stran (vzorky čar zůstávají úzké, značky kulaté), takže už žádné roztažené ani prázdné plochy.
- Nová umístění v sousedním panelu (vpravo, vlevo, dole): mapový rám se zmenší, aby uvolnil místo; šířka panelu se přizpůsobí obsahu a sloupce jsou vyvážené; panel se přizpůsobí prvkům rozvržení, jako jsou loga v rozích; ohraničení rámu vytvořené v rozvržení obklopí mapu i legendu, takže zůstanou zachovány kompozice navržené v Pro.
- Vícestránkové legendy: umístění „Další stránky (pouze PDF)“ rozloží legendu na tolik celých stránek, kolik je potřeba, při zachování plné velikosti písma, s nadpisy pokračování a stejným formátem i orientací stránky jako u mapy.
- Chytré přizpůsobení obsahu: widget změří skutečnou živou legendu a zobrazí konkrétní upozornění („87 položek; přibližně 23 se nevejde“). Pokud by se některé položky nezobrazily, automaticky zvolí další stránky (lze jedním kliknutím vrátit zpět; při vypínání vrstev se toto nastavení vrátí samo) a upozorní na každý oříznutý export v řádku s výsledkem.
- Dlouhé popisky se zalomí do tří řádků, než se zobrazí skutečná výpustka; ochrana osamocených řádků udrží nadpisy pohromadě s jejich položkami.
- Správci mohou pro každé rozvržení v nastavení zapínat a vypínat legendu a koncoví uživatelé ji mohou přepínat ve widgetu; k dispozici je také volba umístění za běhu.
Měřítka
- Kompletní katalog 12 stylů včetně stylu Střídavé (s dílky), Čára s popisky pod ní a středové osové čáry měřítka; každý styl má přesný náhled.
- Skutečná dvojitá měřítka Pro: styly Dvojité střídavé a Dvojité duté vždy tisknou dvě měření se společnou nulou; druhá jednotka se automaticky vybere jako přirozený doplněk (míle–stopy, metry–kilometry) a lze ji změnit.
- Popisky jednotek, které se nepřekrývají, ve všech stylech a v jednoduchém i dvojitém režimu.
Použitelnost a pracovní postup
- Uživatelské změny umístění legendy a typu mřížky za běhu, řízené nastavením viditelnosti správce.
- Pole Autor a Autorská práva se nyní tisknou vždy: pokud v rozvržení není textový prvek, který by je obsahoval, zobrazí se čistě zpracovaný řádek kartografických kreditů ve spodním okraji stránky.
- Tlačítka „Použít pro všechna rozvržení“ pro nastavení přehledové mapy, mřížky a legendy; opětovným importem souboru .pagx se nyní odpovídající rozvržení aktualizuje na místě a zachová si svá nastavení.
- Náhled rozsahu tisku v reálném čase zohledňuje panel legendy, režim pouze s mapou a zadané rozměry v pixelech ještě před prvním exportem
- Optimalizace výkonu (souběžné vytváření legendy a zachycení, ukládání vzorníků do mezipaměti, paralelní extrakce) a kontrola přístupnosti podle WCAG u všech ovládacích prvků
07/09/2026:
Přidat @ncramer11 jako přispěvatele. Níže uvedený problém byl vyřešen.
Problém: setting.tsx získává seznamy položek v rozevíracích nabídkách (formáty, styly severky, styly měřítka a jednotky) ze souboru runtime/lib/pdfRenderer.ts. Tento soubor také importuje čtyři moduly esri/* a ty se tak zahrnou do zkompilovaného balíčku nastavení. Zdá se, že stránka nástroje pro tvorbu widgetů nedokáže vždy načíst moduly esri ve chvíli, kdy se otevře panel nastavení. V takovém případě modul nastavení selže a v konzoli se zobrazí chyba window.require is not a function a nástroj pro tvorbu widgetů zobrazí widget i panel nastavení, které zůstanou viset na indikátoru načítání.
Commit 1: Přesouvá tyto seznamy položek v rozevíracích nabídkách do nového souboru src/printConstants.ts, který neimportuje nic z esri. pdfRenderer.ts je znovu exportuje, takže běhový kód zůstává zcela beze změny (widget.tsx se nemění) a setting.tsx nyní importuje z nového souboru. Balíček nastavení už tak neodkazuje na esri a načítá se bez problémů. Zmenšil se také z přibližně 3,3 MB na zhruba 350 kB. Do souboru printConstants.ts jsem přidal komentář vysvětlující, proč nesmí obsahovat závislosti na esri.
Commit 2: Nahrazuje sedm vlastností indentLevel={1} komponenty SettingRow vlastností indented. Můj editor hlásí indentLevel protože tato vlastnost není v typech pro ExB 1.20. Funkčnost se nijak nemění, takže tento commit klidně přeskočte, pokud chcete.
- Novinka: Přehledová mapka. Zapněte přehledovou mapku se zmenšeným měřítkem a indikátorem rozsahu v kterémkoli rohu mapového rámu. Vše se nastavuje přímo v nastavení widgetu, rozvržení v Pro není třeba měnit.
- Novinka: Mřížky a síťové čáry ve stylu ArcGIS Pro. Vyberte si síťovou kresbu (zeměpisná šířka a délka, funguje v libovolném souřadnicovém systému), měřenou mřížku (mapové jednotky) nebo referenční mřížku (index A-1). Lze nastavit styly čar, barvy, intervaly i popisky. Popisky pro lepší čitelnost nad snímky obsahují označení polokoule a halo.
- Novinka: Uživatelé mohou pomocí přepínačů za běhu zapínat a vypínat přehledovou mapku i mřížku pro jednotlivé tisky.
- Vylepšeno: Limit snímání mapy se nyní automaticky přizpůsobuje grafické kartě, takže se rozsáhlá rozvržení tisknou ostřeji. Řádek průběhu exportu uvádí výsledné DPI.
- Vylepšeno: Dlouhé adresy URL v textu uvedení zdrojů se nyní zalamují místo toho, aby přesahovaly okraj stránky.
- Opraveno: „1 palec odpovídá 0 mílím“ u rozvržení s jednotkami v mílích a měřítkem odpovídajícím úrovni města.
07/02/2026:
První beta verze. Zveřejněna na GitHubu. Hledám zpětnou vazbu, než ji označím za stabilní.
