Overzicht
Met deze widget kunt u kaarten afdrukken in de stijl van ArcGIS Pro in ArcGIS Experience Builder, zonder afdrukservice. Deel een lay-out uit ArcGIS Pro als lay-outbestand (.pagx), importeer het bestand één keer in de widgetinstellingen en de widget bouwt de pagina opnieuw op in de browser op basis van uw live kaart: kaartframe, titel en tekst, noordpijl, schaalbalk, legenda, afbeeldingen en lijnen.
https://github.com/brianmcleer/print-advanced-widget
Let op: importeer een ArcGIS Pro-lay-outbestand (.pagx) in de widgetinstellingen om de pagina vast te leggen. U kunt ook optioneel een Esri-afdrukservice gebruiken als u liever een ExportWebMap-service aan de serverzijde gebruikt.
Wat kan deze widget?
- Geeft een ArcGIS Pro .pagx-lay-out weer in de browser (kaartframe, tekst, lijnen, noordpijl, schaalbalk, afbeeldingen, legenda), afgestemd op echte uitvoer van Pro.
- Exporteert PDF en SVG als echte vectorbestanden, plus PNG32, PNG8, JPG, GIF, TIFF en EPS. Geen afdrukservice nodig.
- Optioneel gebruik van een Esri-afdrukservice (een ExportWebMap-URL) voor lay-outs aan de serverzijde; hiermee wordt ook AIX toegevoegd.
- Voorbeeld van het afdrukgebied op de kaart, zodat u vóór het exporteren ziet wat er wordt afgedrukt. Behoud de huidige schaal of uitsnede, stel een vaste schaal in of kies er een uit een lijst, met een vergrendelingsschakelaar.
- 12 stijlen voor noordpijlen en 9 stijlen voor schaalbalken, weergegeven als miniaturen, plus een standaardoptie voor de lay-out.
- Uitvoercoördinatensysteem (WKID) om af te drukken in een andere projectie dan die van de kaart.
- Tokens voor auteur, copyright en bronvermelding. Alleen de legenda of alleen de kaart exporteren. Aangepaste lettertypen via URL, inclusief import vanuit Google Fonts.
- Lijst met recente exports en import en export van de volledige configuratie in XML.
- Beheerders bepalen de standaardinstellingen, welke indelingen worden aangeboden en welke opties eindgebruikers te zien krijgen.
Wijzigingslogboek:
15-10-2026:
De exportlijst is vernieuwd. Elk voltooid bestand wordt nu weergegeven als Gereed, met de tijd, het aantal pagina's en de bestandsgrootte. Klik op de naam om het in een nieuw tabblad te openen, of klik op Opslaan om het opnieuw te downloaden. Technische details en eventuele opmerkingen staan achter de knop Details, zodat de lijst overzichtelijk blijft. Bestanden blijven in de lijst staan zolang de app geopend is, ook als u het deelvenster Afdrukken sluit.
12-10-2026: De widget volgt nu de taal van de app (?locale=, de taalkeuzeschakelaar, het ArcGIS-profiel of de browser) in 39 talen, inclusief de hulphandleiding.
Hebt u zelfgemaakte widgets? Dezelfde gratis tool, exb-i18n-kit, kan ze met één opdracht vertalen: localize. Zo vult de tool elke uitdrukking in:
- Eerst Esri. De tool gebruikt de vertalingen die al in uw Experience Builder-installatie staan. Zo gebruikt een uitdrukking als 'Inzoomen op' dezelfde formulering als Esri's eigen widgets.
- Standaardtermen. Eenheden zoals voet en acre komen uit Unicode CLDR, dezelfde gegevens die browsers gebruiken.
- Gedeeld vertaalgeheugen. De rest komt uit een gedeeld woordenboek dat is samengesteld met LibreTranslate, een opensourcevertaalprogramma, en de Opus-MT-modellen van Helsinki-NLP voor het Bosnisch, Kroatisch en Servisch. Het draait gratis op GitHub, dus u hebt geen API-sleutel of account nodig.
- Koppelingen. De tool vindt ook Engelse tekst die buiten het vertaalbestand van de widget hardgecodeerd is, zoals een standaardinstelling of een hulphandleiding, en koppelt die zodat die ook wordt vertaald.
Handmatige correcties hebben altijd voorrang op de machinevertaling en worden nooit overschreven. Sommige vertalingen zijn automatisch gemaakt; laat hier een betere formulering weten als u een vertaling tegenkomt die niet klopt.
24-09-2026:
- Het paginavoorbeeld staat nu onder Kaarttitel, zodat het deelvenster van boven naar beneden wordt doorlopen: kies een lay-out, typ een titel, bekijk de pagina en exporteer.
- Geavanceerde opties zijn ingedeeld in zes kaarten: Afdrukgebied, Kaartserie, Op de kaart, Pagin tekst, Stijl en Uitvoer. U kunt elke kaart openen en sluiten via de kop. Uw keuze wordt onthouden en wanneer de kaart gesloten is, ziet u een samenvatting van één regel, zoals 'PDF, 300 DPI' of 'Legenda, raster'.
- Kaartserie is een eenvoudige schakelaar en stelt de indeling automatisch in op PDF.
- De instellingen volgen dezelfde volgorde, zodat de configuratie van beheerders overeenkomt met wat gebruikers zien. Beheerders kunnen ook kiezen welke kaarten standaard geopend zijn.
23-09-2026:
- GeoPDF. Open de PDF in Avenza of Field Maps en zie uw blauwe stip. Werkt ook met GeoTIFF, world files en KMZ.
- PDF-lagen. Schakel de kaart, het raster, de legenda en de tekst in Acrobat in of uit.
- Live paginavoorbeeld. Bekijk de volledige afgedrukte pagina terwijl u de kaart verschuift.
- Vectorlagen. Scherpe lijnen en doorzoekbare labels in plaats van pixels (experimenteel).
- Datagestuurde pagina's. Eén pagina per perceel, park of project. Werkt met groepslagen en filters en voegt de objectnaam toe aan de titel.
- Voortgang van kaartseries. Toont Pagina 3 van 12 en de resterende tijd, met een knop Annuleren.
- Paginagrenzen. De verwerking vindt plaats in de browser, dus beheerders kunnen een waarschuwing en een maximumaantal pagina's instellen.
- Raster: wijzig de kleuren van rasterlijnen en lettertypen voor rasters in de widget en stel de standaardwaarden in de instellingen in.
09-09-2026:
- Geselecteerde objecten worden nu afgedrukt. Als u percelen of andere objecten op de kaart hebt geselecteerd, worden ze met een cyaankleurige omlijning over de kaart afgedrukt. De widget legt de kaart vast in een weergave buiten beeld die de lagen van uw kaart deelt, maar niet uw kaartweergave. Een selectieaccentuering hoort bij de weergave, waardoor een geselecteerd perceel eerder ontbrak op een afdruk waarop alle andere grafische elementen wel stonden. De selectie wordt nu als vector op de pagina getekend, zodat deze scherp wordt afgedrukt in PDF en SVG en uw live kaart onaangeroerd blijft. In het exportdeelvenster staat de schakelaar Geselecteerde objecten, die standaard is ingeschakeld, met een overeenkomstige standaardinstelling in de widgetinstellingen.
- Ingebouwde hulphandleiding. Met de knop Help in de widgetkop opent u een korte, doorzoekbare handleiding in duidelijke taal: drie stappen om aan de slag te gaan, uitleg over elke optie, welk bestandstype u kiest en wat u controleert als iets niet goed lijkt. De handleiding toont alleen hulp bij functies die in uw app daadwerkelijk zijn ingeschakeld, zodat niemand informatie leest over een legenda of kaartserie die niet in de lay-out wordt gebruikt.
04-09-2026:
Niet meer in bèta; ik gebruik de widget nu live op mijn sites. Nieuwe functies:
- Google Earth-export (KMZ) toegevoegd voor exports met alleen de kaart
- Gegeorefereerde rasteruitvoer toegevoegd: echte GeoTIFF voor TIFF, world file plus
.prj voor PNG, JPG en GIF - Ondersteuning voor coördinatensystemen is nu universeel in plaats van beperkt tot een vaste lijst, voor
.prj-uitvoer, GeoTIFF-codering en tokens voor coördinatensysteemnamen - Volledige ondersteuning voor dynamische tekst uit ArcGIS Pro toegevoegd, waaronder tijd, credits voor servicelagen, eigenschappen van ruimtelijke referenties, coördinaten van kaartframes en tokens voor pagina's van kaartseries
- Filteren van legenda op basis van schaal toegevoegd
- Bij het afdrukken van een kaartserie wordt het legendapaneel op elke pagina weergegeven en wordt het raster opnieuw gegenereerd op basis van het effectieve frame
- Import en export van XML-instellingen nemen nu raster-, overzichts- en legendastandaardwaarden mee
- Grootte van symbolen, tekst en lijnen bij hoge DPI gecorrigeerd
- Probleem verholpen waarbij beelden bij grote schalen niet op schaal werden afgedrukt
- Ontbrekende legendavakken voor groepen met kaartservices verholpen
- Plaatsing van legenda linksonder en rechtsonder verholpen
- 'Toepassen op alle lay-outs' hersteld
- Probleem verholpen waarbij de legendaschakelaar niet werd vernieuwd bij een wijziging van de lay-out
- Legenda houdt nu rekening met het aantal kolommen en de zichtbaarheid van de titel in
.pagx-bestanden
12-08-2026:
Probleem verholpen waarbij legenda-items als grijze vierkanten werden weergegeven in Experience Builder 1.21. De nieuwere ArcGIS Maps SDK geeft de Legend-widget weer achter een shadow DOM, waardoor de symboolvakjes niet werden meegenomen bij het verzamelen van afdrukgegevens. Het ophalen van symboolvakjes doorzoekt nu ook de shadow DOM, ondersteunt het nieuwe arcgis-legend-onderdeel en valt automatisch terug op het opbouwen van symbolen op basis van laagrenderers als er bij het ophalen iets ontbreekt. U hoeft niets aan uw kaarten of lay-outs te wijzigen. Dank aan @ncramer11 voor de melding via GitHub.
23-07-2026:
De widget Kaartwisselaar bijgewerkt voor Experience Builder 1.21 om TypeScript-editorfouten op te lossen, waaronder typering van React-componenten en imports van onveranderlijke configuraties. Ook is de widgetversie verhoogd en is de nieuwste release nu beschikbaar op GitHub.
17-07-2026:
Grondige vernieuwing van het legendasysteem
- De legenda leest nu de actieve Legend-widget op de pagina en toont precies wat de gebruiker ziet: laagvolgorde, geneste groepen, zichtbaarheid en hiërarchie van sublagen. Met de instelling Legendabron kunt u een specifieke widget koppelen of automatisch een widget laten detecteren.
- Scherpe symboliek: symbolen van kaartservices worden opgehaald uit de REST-legenda op 288 DPI en contextueel gekoppeld aan legendaregels; vectorsymbolen worden met supersampling gerenderd; symbolen behouden hun juiste verhoudingen (lijnsymbolen blijven dun, markers blijven rond), zonder uitgerekte of lege vlakken
- Nieuwe plaatsingen naast de kaart (rechts, links, onderaan): het kaartframe wordt verkleind om ruimte te maken, de paneelbreedte wordt bepaald door de inhoud en de kolommen worden evenwichtig verdeeld, het paneel houdt rekening met elementen in de hoeken van de lay-out, zoals logo's, en de getekende frame-rand omvat zowel de kaart als de legenda, zodat composities die in Pro zijn ontworpen intact blijven
- Legenda's met meerdere pagina's: bij de plaatsing 'Extra pagina's (alleen PDF)' wordt de legenda over zoveel volledige pagina's verdeeld als nodig is, met de volledige lettergrootte, vervolgkoppen en hetzelfde papierformaat en dezelfde afdrukstand als de kaartpagina
- Slimme pasvormcontrole: de widget meet de actuele legenda en geeft een specifieke waarschuwing ('87 items; ongeveer 23 passen niet'), kiest automatisch Extra pagina's als er items zouden wegvallen (met één klik terug te zetten; de keuze wordt ook automatisch teruggedraaid wanneer lagen worden uitgeschakeld) en markeert afgekapt uitgevoerde legenda's op de resultatenregel
- Lange labels worden over maximaal drie regels afgebroken voordat een passend beletselteken wordt gebruikt; met weduwecontrole blijven koppen bij hun items
- Beheerders kunnen de legenda per lay-out in de instellingen in- of uitschakelen; eindgebruikers kunnen dit in de widget doen. Ook is er een keuzelijst voor de plaatsing tijdens gebruik.
Schaalbalken
- Volledige catalogus met 12 stijlen, waaronder Afwisselend (met streepjes), Lijn met labels eronder en Schaal lijn met centrale as, elk met een nauwkeurige voorbeeldafbeelding
- Echte dubbele schaalbalken uit Pro: Dubbel afwisselend en Dubbel hol geven altijd twee maten met hetzelfde nulpunt weer. De tweede eenheid wordt automatisch gekozen als een logische aanvulling (mijlen-voet, meter-kilometer) en kan worden aangepast
- Labels voor eenheden die elkaar nooit overlappen, bij elke stijl en in zowel enkele als dubbele weergave
Gebruiksgemak en workflow
- Gebruikers kunnen tijdens gebruik de plaatsing van de legenda en het rastertype aanpassen; beheerders bepalen of deze opties zichtbaar zijn
- De velden Auteur en Copyright worden nu altijd afgedrukt als een nette cartografische bronvermelding in de ondermarge van de pagina wanneer de lay-out geen tekstelement bevat dat deze gegevens weergeeft
- Knoppen 'Toepassen op alle lay-outs' voor instellingen van overzicht, raster en legenda; wanneer u een .pagx opnieuw importeert, wordt de overeenkomende lay-out bijgewerkt zonder deze te vervangen en blijven de instellingen behouden
- Live voorbeeld van het afdrukbereik volgt het legenda-paneel, de modus met alleen de kaart en expliciete pixelafmetingen vóór de eerste export
- Prestatieverbeteringen (gelijktijdig opbouwen en vastleggen van de legenda, swatch-caching, parallelle extractie) en een WCAG-toegankelijkheidsronde voor alle bedieningselementen
07/09/2026:
Voeg toe @ncramer11 als bijdrager. Onderstaand probleem opgelost.
Het probleem: setting.tsx haalt de vervolgkeuzelijsten (indelingen, stijlen voor noordpijlen, schaalbalkstijlen en eenheden) op uit runtime/lib/pdfRenderer.ts. Dat bestand importeert ook vier esri/* modules, waardoor die in de gecompileerde instellingenbundel terechtkomen. Het lijkt erop dat de builderpagina de esri-modules niet altijd kan laden op het moment dat het instellingenpaneel wordt geopend. Wanneer dat gebeurt, mislukt de instellingenmodule met window.require is not a function in de console en blijven de widget en het instellingenpaneel in de builder hangen op het laadwiel.
Commit 1: Verplaatst die vervolgkeuzelijsten naar een nieuw bestand, src/printConstants.ts, dat niets uit esri importeert. pdfRenderer.ts exporteert ze opnieuw, zodat de runtimecode helemaal niet verandert (widget.tsx blijft onaangeroerd), en setting.tsx importeert ze nu uit het nieuwe bestand. Daardoor verwijst de instellingenbundel niet langer naar esri en wordt deze probleemloos geladen. De bundel is bovendien kleiner geworden: van ongeveer 3,3 MB naar ongeveer 350 KB. Ik heb een opmerking toegevoegd aan printConstants.ts waarin wordt uitgelegd waarom het bestand esri-vrij moet blijven.
Commit 2: Vervangt de zeven indentLevel={1} props op SettingRow door indented. Mijn editor markeert indentLevel omdat het niet voorkomt in de ExB 1.20-typedeclaraties. Er verandert niets aan het gedrag, dus je kunt deze gerust overslaan als je dat liever doet.
- Nieuw: overzichtsinzetkaart. Schakel een uitgezoomde overzichtskaart in met een bereikindicator in een hoek van het kaartframe. Alles wordt ingesteld in de widgetinstellingen; aanpassingen aan je Pro-layout zijn niet nodig.
- Nieuw: rasters en graticules in de stijl van ArcGIS Pro. Kies een graticule (breedte- en lengtegraad, werkt in elk coördinatenstelsel), een gemeten raster (kaarteenheden) of een referentieraster (A-1-index). Lijnstijlen, kleuren, intervallen en labels zijn instelbaar. Labels bevatten hemisfeeraanduidingen en halo's voor betere leesbaarheid boven op beeldmateriaal.
- Nieuw: met runtime-schakelaars kunnen gebruikers de inzetkaart en het raster per afdruk in- of uitschakelen.
- Verbeterd: de limiet voor het vastleggen van de kaart wordt nu automatisch bepaald op basis van de grafische kaart, zodat grote layouts scherper worden afgedrukt. De voortgangsregel voor export vermeldt de effectieve DPI.
- Verbeterd: lange URL's in toeschrijvingstekst lopen nu door op een nieuwe regel in plaats van buiten de pagina te vallen.
- Opgelost: '1 inch is gelijk aan 0 mijl' op layouts met mijlen bij stadskaartschalen.
07/02/2026:
Eerste bètaversie uitgebracht op GitHub. Ik hoor graag feedback voordat ik de versie als stabiel markeer.
