Søg i Septima Widget K

Udskriv (print) ​

Udskriv kortet som PDF eller et billede. Det er også muligt at gemme kortet som et billede i udklipsholderen.

Bemærk at for at kunne printe, skal alle services, der vises i kortet, tillade CORS. Dette skylles billedet hentes ud som data for at kunne danne et samlet billede. I nogle tilfælde er det nødvendigt at tilføje "crossOrigin": "anonymous" til laget.

Options ​

Herunder findes en beskrivelse af de enkelte egenskaber, der kan sættes på funktionen.

disable ​

  • Type: boolean
  • Default: false

Skal kontrollen deaktiveres. Herved fungerer det, som om kontrollen ikke var tilføjet. Kan bruges til midlertidig at fjerne en kontrol.

css ​

  • Type: string | string[]

Angiv en sti til en css-fil, der skal loades efter denne kontrol. Herved vil det være muligt at lave en brugertilpasset style af kontrollen.

className ​

  • Type: string

Tilføj en speciel CSS class til elementet. Dette kan bruges til at styre hvordan elementet ser ud eller placeres på siden.

buttonIndex ​

  • Type: number
  • Default: 0

Hvis der er flere kompoenter med knapper i kortet, så bliver de tilføjet i en tilfældig rækkefølge. Ved at angive buttonIdex er det muligt at bestemme rækkefølgen. Laveste index kommer først. Hvis to knapper har samme index vil det være tilfældigt hvilken der kommer færst.

translations ​

  • Type: object

Det er muligt at styre alle tekster i Septima Widget. Det gøres på de enkelte komponenter vha. et translations objekt. Det er muligt blot at overskrive en enkelt tekst eller angive et helt nyt sprog. Herunder ses hvilke teskter, der er default for denne komponent.

Vis tekster
json
{
  "da-DK": {
    "print": "Udskriv",
    "fenceText": "Kortudsnit, der kommer med på udskrift",
    "error": "Kortet kunne desværre ikke udskrives. Prøv igen.",
    "clipboard": "Kortet er kopieret til din udklipsholder",
    "creating": "Danner billede...",
    "clicktoremove": "Klik her for at fjerne beskeden",
    "close": "Luk",
    "format": "Papirstørrelse",
    "orientation": "Layout",
    "landscape": "Liggende",
    "portrait": "Stående",
    "scale": "Målforhold",
    "current": "Aktuel",
    "scalebar": "Inkludér målestok",
    "legend": "Inkludér signaturforklaring",
    "printtitle": "Titel for kort"
  },
  "en-US": {
    "print": "Print",
    "fenceText": "Extent for the print",
    "error": "Error printing the map. Please try again.",
    "clipboard": "The map is copied to clipboard",
    "creating": "Creating image...",
    "clicktoremove": "Click to remove the message",
    "close": "Close",
    "format": "Paper size",
    "orientation": "Layout",
    "landscape": "Landscape",
    "portrait": "Portrait",
    "scale": "Scale",
    "current": "Current",
    "scalebar": "Include scalebar",
    "legend": "Include legend",
    "printtitle": "Title for map"
  }
}

title ​

  • Type: string
  • Default: Print

Tooltip på knappen.

  • Type: boolean
  • Default: false

Giver brugeren mulighed for selv at vælge format og orientering.

popupTitle ​

  • Type: string
  • Default: Udskriv

Ved "popup": true. Angiv titlen på popup'en.

popupSubTitle ​

  • Type: string

Ved "popup": true. Angiv en tekst, der vises i toppen af popup'en.

popupButton ​

  • Type: string
  • Default: Udskriv

Ved "popup": true. Angiv teksten på knappen i popup'en.

fenceText ​

  • Type: string
  • Default: Kortudsnit, der kommer med på udskrift

Ved "popup": true. Angiv teksten, der vises i kortet.

orientations ​

  • Type: boolean
  • Default: true

Ved "popup": true. Angiv om brugeren skal have mulighed for at vælge orientering på udskriften.

formats ​

  • Type: boolean | object
  • Default: true

Ved "popup": true. Hvis angives til false, så vises valgmuligheden for papirstørrelser ikke i popup'en.

Det er også muligt at angive hvilke papirstørrelse, der skal være tilgængelige for brugeren. Det gøres med f.eks.:

json
"formats": [
  {
    "name": "A4",
    "value": "a4",
    "selected": true
  },
  {
    "name": "A3",
    "value": "a3"
  }
]

scales ​

  • Type: boolean | object
  • Default: false

Ved "popup": true. Hvis angives til true, vises valgmuligheden for an vælge imellem nogle faste målforhold (ud over det aktuelle).

Det er også muligt at angive en liste med målforhold, som brugeren skal kunne vælge imellem. Det gøres f.eks. som her:

json
"scales": [
  {
    "name": "1:500",
    "value": 500
  },
  {
    "name": "1:1000",
    "value": 1000
  }
]
  • Type: boolean | 'string'
  • Default: false

Hvis sat til true, giver det mulighed for brugeren selv at angive en overskrift, der vises på printet. Hvis sat til en streng, bliver teksten sat ind som overskrift i printet og brugeren har ikke mulighed for selv at ændre teksten.

Sammen med teksten, tilføjes en dato og et klokkeslet for hvprnår printet er dannet.

legend ​

  • Type: boolean | 'input'
  • Default: false

Hvis sat til true, vises signaturforklaringen i printet. Hvis sat til input, kan brugeren selv vælge om signaturforklaringen skal med eller ej.

Kun signature for tændte lag medtages.

Bemærk at hvis signaturforklaringen er meget lang, så vil der ikke være plads til den i printet.

scalebar ​

  • Type: boolean
  • Default: true

Hvis sat til false, vises målestokkn ikke i printet. Hvis sat til input, kan brugeren selv vælge om målestokkn skal med eller ej.

dpi ​

  • Type: number
  • Default: 150

Det er muligt at styre hvor høj opløsning der udskrives med. Bemærk at opløsningen vil pråvirke performance og hvad det er der udskrives, så vælg med omtanke.

margin ​

  • Type: number
  • Default: 0

Angiv hvor stor en margen der skal være på udskriftet. Margen angives i milimeter. Hvis margen angives, vil der blive placeret en ramme omkring kortet. Bemærk at indstillinger på selve printeren kan påvirke hvordan det kommer ud når der printes på papir.

filename ​

  • Type: string

Angiv navnet på den fil, der bliver dannet. Filnavnet skal inkludere formatet, f.eks. .pdf.

templates ​

  • Type: object[]

Bemærk

templates kan ikke bruges sammen med popup. Hvis popup er angivet, bliver templates ignoreret.

Her angives hvilke formater, der skal kunne udskrives i. P.t. er det kun muligt at angive ét format.

Som default oprettes der et PDF-dokument med kortet. I templates angives hvor stort kortet skal være samt opløsningen. Bemærk at det kan tage lidt tid at generere dokumentet, hvis opløsningen er høj. Angiv orientation til enten "langscape" (default) eller "portrait". Derudover er det muligt at angive parpirformatet med format til f.eks. "a4" (default).

Angiv filename med navnet på den fil, der bliver dannet. Filnavnet skal inkludere formartet, f.eks. .pdf.

Det er også muligt at udskrive som et billede. Dette gøres ved at angive outputformat med værdien image.

json
"templates": [{
  "name":"Udskriv i A4 liggende",
  "orientation": "landscape",
  "format": "a4",
  "ppi": 150,
  "map_height": 210,
  "map_width": 297
}]

Hvis man har en service, der kan generere en udskrift af kortet, er dette også muligt. Det kan f.eks. være QGIS Server, Geoserver eller Spatial Suite. Det kræver dog, at servicen indeholder alle lag, der skal udskrives:

json
"templates": [{
  "name": "Udskriv i A4 liggende",
  "map_height": 187,
  "map_width": 277,
  "url": "https://kort.haderslev.dk/spatialmap?page=print.pdf.new&mapheight={{height}}&mapwidth={{width}}&map_size={{width}} {{height}}&mapext={{extentspace}}&layers={{layersspace}}&opacities=1&scalebarname=pdf&pageformat=a4&orientation=landscape&map_resolution=200&printscale={{scale}}8&pdfprintlegend=true&printformats=a4_landscape&map_angle=360&ppi=200&titleblock=true&copyrighttext={{copyright}}&date=&profile=widget_kp17"
}]

Eksempler ​

Eksempler, der bruger denne komponent: