Přehled
Tento widget přináší tisk map ve stylu ArcGIS Pro do ArcGIS Experience Builder bez potřeby tiskové služby. Sdílíte rozvržení z ArcGIS Pro jako soubor rozvržení (.pagx), jednou jej importujete v nastavení widgetu a widget tuto stránku znovu vytvoří v prohlížeči vůči vaší živé mapě: rámec mapy, název a text, severní šipka, měřítková lišta, legenda, obrázky a čáry.
https://github.com/brianmcleer/print-advanced-widget
Toto je první vydání a vydávám ho jako beta verzi. Rád bych, aby komunita vyzkoušela tento widget na reálných rozvrženích a skutečných mapách, než jej označím za stabilní. Pokud to můžete vyzkoušet a poslat zpětnou vazbu, velmi by to pomohlo. Viz "Co bych rád pomohl testovat" níže.
Poznámka: Vyžaduje ArcGIS Experience Builder Developer Edition 1.19 nebo 1.20 (React 19). Verze 1.18 a starší nejsou podporovány.
Poznámka: Závislosti widgetu se instalují automaticky pomocí standardního "npm install" ve složce klienta EB. Není potřeba žádná samostatná instalace.
Poznámka: Importujte soubor rozvržení ArcGIS Pro (.pagx) v nastavení widgetu pro definování stránky. Je také volitelná cesta k Esri tiskové službě, pokud byste raději použili serverovou službu ExportWebMap.
Co tento widget umí?
- Reprodukuje rozvržení ArcGIS Pro .pagx v prohlížeči (rámec mapy, text, čáry, severní šipka, měřítková lišta, obrázky, legenda), kalibrované vůči skutečnému výstupu Pro.
- Exportuje PDF a SVG jako skutečný vektor, plus PNG32, PNG8, JPG, GIF, TIFF a EPS. Není potřeba tisková služba.
- Volitelná cesta k Esri tiskové službě (URL ExportWebMap) pro serverová rozvržení, která také přidává AIX.
- Náhled tiskové oblasti vykreslený na mapě, takže vidíte, co se vytiskne před exportem. Zachovejte aktuální měřítko, zachovejte aktuální rozsah, nastavte pevné měřítko nebo vyberte z seznamu s přepínačem zámku.
- 12 stylů severní šipky a 9 stylů měřítkové lišty zobrazených jako miniatury, plus výchozí možnost Rozvržení.
- Výstupní souřadnicový systém (WKID) pro tisk v jiné projekci než mapa.
- Autor, copyright a tokeny atribuce. Export pouze legendy a mapy. Vlastní fonty přes URL včetně importu Google Fonts.
- Seznam nedávných exportů a XML import a export celé konfigurace.
- Správce má kontrolu nad výchozím nastavením, nabízenými formáty a runtime ovládacími prvky viditelnými pro koncové uživatele.
Co bych rád pomohl testovat
- Vaše vlastní rozvržení ArcGIS Pro .pagx. Importujte jedno a řekněte mi, jak blízko je výstup k Pro. Pokud něco nesedí, zaslání .pagx a screenshotu mi umožní to reprodukovat.
- Náhled tiskové oblasti a zámek měřítka napříč různými podkladovými mapami a projekcemi.
- Cesta k Esri tiskové službě směřující na vaši vlastní URL ExportWebMap.
- Výstupní souřadnicový systém, tisk ve WKID odlišném od vaší mapy.
- Vlastní fonty přes URL a import Google Fonts ve výstupu PDF.
Jak hlásit zpět: komentujte zde nebo otevřete issue na GitHubu. Uveďte vaši verzi EB, váš prohlížeč a případné chyby v konzoli prohlížeče. Krátký záznam obrazovky hodně pomůže (používám OBS Studio).
Změny:
09/04/2026:
Už není beta, mám to na svých webech jako živý widget. Nové funkce jsou:
- Přidán export Google Earth (KMZ) pro exporty pouze mapy
- Přidán georeferencovaný rastrový výstup: skutečný GeoTIFF pro TIFF, world file plus
.prj pro PNG, JPG a GIF - Podpora souřadnicových systémů je nyní univerzální místo pevného seznamu, pokrývá
.prj výstup, GeoTIFF klíčování a tokeny názvu souřadnicového systému - Přidána plná podpora dynamického textu ArcGIS Pro včetně času, kreditů servisních vrstev, vlastností prostorového odkazu, souřadnic rámce mapy a tokenů stránek série map
- Přidáno filtrování legendy závislé na měřítku
- Série map tiskne panel legendy na každé stránce a regeneruje jeho mřížku vůči efektivnímu rámci
- Import a export nastavení XML nyní obousměrně podporuje výchozí hodnoty mřížky, přehledu a legendy
- Opravené velikosti symbolů, textu a čar při vysokém DPI
- Opraveno nesprávné měřítko tisku obrázků při velkých měřítcích
- Opraveno chybějící vzorky legendy u skupin mapových služeb
- Opraveno umístění legendy vlevo dole a vpravo dole
- Opraveno "Použít na všechna rozvržení"
- Opraveno neobnovování přepínače legendy při změně rozvržení
- Legenda nyní respektuje
.pagx počet sloupců a viditelnost titulku
8/12/2026:
Opraveno vykreslování položek legendy jako šedých čtverců v Experience Builder 1.21. Novější ArcGIS Maps SDK vykresluje Legend widget za shadow DOM, což skrývalo vzorky symbolů před tiskem; extrakce vzorků nyní proniká shadow DOMem, podporuje nový komponent arcgis-legend a automaticky se vrací k sestavování symbolů z rendererů vrstev pokud extrakce selže. Žádné změny vašich map nebo rozvržení nejsou potřeba. Děkuji@ncramer11
7/23/2026:
Aktualizován Map Switcher widget pro Experience Builder 1.21 k vyřešení chyb TypeScript editoru včetně typování React komponent a neměnných importů konfigurace. Verze widgetu byla také zvýšena a nejnovější vydání je nyní dostupné na GitHubu.
7/17/2026:
Přepracování systému legendy
- Legenda nyní čte živý Legend widget na stránce přesně tak jak uživatel vidí: pořadí vrstev, vnoření skupin, viditelnost a hierarchii podsložek s nastavením zdroje Legendy pro svázání konkrétního widgetu nebo automatickou detekci
- Vysoce kvalitní symbolika: vzorky mapových služeb získané z REST legendy při 288 DPI a kontextově spárované s řádky legendy; vektorové vzorky supersamplované; symboly kreslené s pravým poměrem stran (čárové vzorky zůstávají tenké, značky kulaté), žádné natažené nebo prázdné plochy
- Nové umístění sousedních panelů (vpravo, vlevo, dole): rámec mapy se zmenšuje aby udělal místo; šířka panelu je řízena obsahem s vyváženými sloupci; panel ořezuje kolem nábytku rozvržení jako rohové loga; hranice autorského rámce obaluje mapu i legendu dohromady aby kompozice navržené v Pro zůstaly nedotčené
- Vícestránkové legendy: umístění "Další stránky (pouze PDF)" stránkuje legendu přes tolik plných listů kolik je potřeba při plné velikosti písma s pokračujícími nadpisy se stejnou velikostí listu i orientací jako stránka mapy
- Inteligentní přizpůsobení: widget měří skutečnou živou legendu a varuje s detaily ("87 položek; asi 23 se nevejde"), automaticky přepíná na další stránky když by položky spadly (jedním kliknutím vrátit zpět; vrací se samo jak jsou vrstvy vypínány) a označuje jakýkoli oříznutý export ve výsledném řádku
- Dlouhé popisky zalamují do tří řádků před poctivým elipsisem; kontrola vdov udržuje nadpisy s jejich položkami
- Přepínač zapnutí/vypnutí legendy dostupný administrátorům pro každé rozvržení v nastavení i koncovým uživatelům ve widgetu plus runtime volba umístění
Měřítkové lišty
- Plný katalog 12 stylů včetně Střídavých (označených), Čára s popisky dole a Středová osa Měřítkové čáry s přesným náhledem dlaždice
- Skutečné Pro dvojité měřítkové lišty: Dvojité střídavé a Dvojité duté vždy tisknou dvě měření sdílející nulový bod s druhou jednotkou automaticky vybranou jako přirozený doplněk (míle-stopy, metry-kilometry) s možností přepsání
- Bezkolizní popisky jednotek ve všech stylech i režimech jednoho i dvou měřítek
Použitelnost a pracovní postup
- Runtime uživatelské přepsání umístění legendy a typu mřížky omezené viditelností administrátora
- Pole Autor a Copyright se nyní vždy tisknou v čistém kartografickém řádku kreditů ve spodním okraji stránky pokud rozvržení nemá textový prvek který je spotřebovává
- 'Použít na všechna rozvržení' tlačítka pro nastavení přehledu, mřížky a legendy; opětovný import .pagx nyní aktualizuje odpovídající rozvržení přímo na místě a zachovává jeho nastavení
- 'Živý' náhled rozsahu tisku sleduje panel legendy, režim pouze mapa a explicitní pixelové rozměry před prvním exportem
- 'Výkonový průchod' (současná konstrukce legendy i zachytávání obrazu, ukládání vzorků do cache, paralelní extrakce) a WCAG přístupnost napříč všemi ovládacími prvky
07/09/2026:
+ Přidat@ncramer11
Problém:setting.tsx'získává své rozevírací seznamy (formáty, styly severních šipek, styly měřítkových lišt a jednotky) z runtime/lib/pdfRenderer.ts. That file also imports four esri/* modules, so those get pulled into the compiled settings bundle. It seems the builder page cannot always load esri modules at the moment the settings panel opens. When that happens the settings module fails with window.require is not a function in the console, and the builder shows the widget and the settings panel stuck on the loading spinner.
Commit 1: Moves those dropdown lists into a new file, src/printConstants.ts, which imports nothing from esri. pdfRenderer.ts re-exports them so the runtime code does not change at all (widget.tsx is untouched), and setting.tsx now imports from the new file. With that, the settings bundle no longer references esri and loads fine. It also shrank from about 3.3 MB to about 350 KB. I left a comment in printConstants.ts explaining why it needs to stay esri-free.
Commit 2: Swaps the seven indentLevel={1} props on SettingRow for indented. My editor flags indentLevel because it is not in ExB 1.20 typings. No difference in behavior, so feel free to skip this one if you would rather.
- New: Overview inset map. Turn on a zoomed-out locator map with an extent indicator in any corner of the map frame. Configured entirely in the widget settings, no changes to your Pro layout needed.
- New: Grids and graticules, ArcGIS Pro style. Choose a graticule (latitude/longitude, works in any coordinate system), a measured grid (map units), or a reference grid (A-1 index). Line styles, colors, intervals, and labels are configurable, and labels include hemisphere suffixes and halos for readability over imagery.
- New: Runtime toggles let users turn the inset and grid on or off per print.
- Improved: Map capture limit is now automatic based on the graphics card, so large layouts print sharper. The export progress line reports the effective DPI.
- Improved: Long URLs in attribution text now wrap instead of running off the page.
- Fixed: "1 inch equals 0 miles" on layouts using miles at city scales.
07/02/2026:
Initial beta release. Posted to GitHub. Looking for feedback before I mark it stable.
