Widget Aangepaste kaartlagen
Een aangepaste versie van de widget Kaartlagen van Experience Builder. Deze doet alles wat de standaardwidget doet en voegt de onderstaande functies toe. Deze versie is overgezet vanuit een vraag over aangepaste widgets, waar de oorspronkelijke versie stond.
GitHub: https://github.com/brianmcleer/map-layers-custom-widget
Toegevoegde functies ten opzichte van de standaardwidget Kaartlagen
- Nieuwe sublagen automatisch opnemen: nieuw toegevoegde sublagen van een aangewezen groep verschijnen in gepubliceerde apps zonder dat u instellingen hoeft aan te passen of de app opnieuw hoeft te publiceren.
- Laagfocus: isoleer één laag of sublaag van een kaartservice en verberg de rest, met een expliciete optie om dit te beëindigen.
- Badge met het aantal zichtbare lagen.
- Inklapbare lagenlijst, met de optie om de lijst standaard ingeklapt weer te geven.
- Gegevens toevoegen: voeg een laag toe via een URL (ArcGIS-service, vectortegels, WMS, WMTS, GeoJSON, CSV, KML) of een lokaal bestand (GeoJSON, CSV, KML, gecomprimeerde shapefile).
- Algemene dekking: met één schuifregelaar stelt u de dekking van alle lagen in.
- Kaartgalerij met de kaartachtergronden van de organisatie.
- Legenda-venster.
- Opgeslagen weergaven: sla sets met laagzichtbaarheid op en exporteer of importeer ze als JSON.
- Aantal zoekresultaten inclusief sublagen van kaartservices, plus een filter voor alleen zichtbare lagen.
- Hulpmiddelen voor meerdere lagen: alles aan- of uitzetten, zichtbaarheid herstellen, naar zichtbare lagen zoomen, kaartafbeelding exporteren, alles uit- of inklappen.
- Hulpmiddelen per laag: laten knipperen, URL kopiëren, vernieuwen, laagdetails bekijken, naar boven of beneden verplaatsen, uit de groep halen.
Elke functie kan in de widgetinstellingen worden in- of uitgeschakeld.
Vereisten
Experience Builder Developer Edition 1.19 of 1.20 (React 19). EB 1.18 en ouder worden niet ondersteund.
Installeren
- Download het zipbestand van de release en pak het uit.
- Plaats de map map-layers-custom zo dat manifest.json zich direct in client/your-extensions/widgets/map-layers-custom/ bevindt.
- Voer npm install uit in de map client.
- Start de client opnieuw op en vernieuw de builder geforceerd.
De volledige installatie-instructies en informatie over probleemoplossing staan in de README op GitHub.
Wijzigingenlogboek:
10/12/2026: De widget gebruikt nu de taal van de app (?locale=, de taalschakelaar, het ArcGIS-profiel of de browser) en ondersteunt 39 talen. De handleiding is inbegrepen.
Heb je zelf aangepaste widgets? Met hetzelfde gratis hulpmiddel, exb-i18n-kit, kun je ze met één opdracht vertalen: localize. Zo vult het elke zin in:
- Eerst Esri. Het haalt de vertalingen op die al in je Experience Builder-installatie staan. Zo wordt voor een zin als ‘Zoomen naar’ dezelfde formulering gebruikt als in de widgets van Esri zelf.
- Standaardtermen. Eenheden zoals feet en acres zijn afkomstig uit Unicode CLDR, dezelfde gegevens die browsers gebruiken.
- Gedeeld vertaalgeheugen. De rest komt uit een gedeeld woordenboek dat is opgebouwd met LibreTranslate, een open source-vertaalprogramma, en de Opus-MT-modellen van Helsinki-NLP voor Bosnisch, Kroatisch en Servisch. Het draait gratis op GitHub, dus je hebt geen API-sleutel of account nodig.
- Koppelingen. Het vindt ook Engelse tekst die buiten het vertaalbestand van de widget hard gecodeerd is, zoals een standaardinstelling of een handleiding, en koppelt die zodat die ook wordt vertaald.
Handmatig gemaakte correcties hebben altijd voorrang op de machinevertaling en worden nooit overschreven. Sommige vertalingen zijn automatisch gegenereerd. Laat hier weten hoe het beter kan als je een vertaling tegenkomt die niet klopt.
9/30/26:
- Eén laag per groep kiezen: stel een groep zo in dat er maar één laag tegelijk aan kan staan (keuzerondjes).
- Link naar deze lagen kopiëren: deel een link waarmee de app opent met dezelfde lagen ingeschakeld.
- Lagenlijst exporteren: sla elke laag, groep en sublaag met de aan/uit-status en URL op in een CSV-bestand.
- Laagstatus controleren: services worden met vaste tussenpozen gecontroleerd. Services die niet meer reageren, worden in de lijst gemarkeerd.
- Meldingen over defecte lagen: lagen die niet laden of worden getekend, worden gemeld, ook als ze diep genest zijn in groepen.
- Vooraf ingestelde weergaven: de appbouwer kan laagweergaven opslaan die voor elke gebruiker zichtbaar zijn.
- Luchtfoto's in de buurt: voeg lucht- en satellietbeelden toe die het huidige kaartbeeld bestrijken.
- Favorieten: geef lagen een ster en filter de lijst zodat alleen je favorieten worden weergegeven.
- Opgeschoonde laagnamen: optioneel nettere namen, bijvoorbeeld door underscores als spaties weer te geven.
- Zoomen tot zichtbaar: met één klik zoom je naar een laag die op de huidige schaal grijs wordt weergegeven.
- Gebruiksgegevens: bij klikken op een laag wordt nu ook het pad van de laaggroep opgenomen.
9/11/26:
Er is een Help-knop aan de kop toegevoegd. Deze opent een korte, doorzoekbare handleiding met alleen de functies die in je app zijn ingeschakeld, plus een eenmalige tip: ‘Nieuw hier?’
7/23/26: De widget Aangepaste kaartlagen is bijgewerkt voor compatibiliteit met Experience Builder 1.21 en fouten in de TypeScript-editor zijn verholpen. Dit is uitsluitend een onderhoudsupdate; de functionaliteit van de widget is niet gewijzigd.
