Spring til indholdet

Indhold

Biblioteker i HTML-sider i SharePoint

HTML-sider i SharePoint kan bruge Chart.js, D3, Mermaid og andre biblioteker fra Microsoft. Man skriver navnet, ikke adressen.

Opdateret SharePoint OnlineTilpasninghtml i sharepoint 2 min. læsning

En HTML-side i SharePoint må ikke hente script udefra. <script src> virker ikke, heller ikke fra sitets egne biblioteker (Microsoft). Microsoft skriver, at et udvalg af biblioteker ligger på en CDN, Microsoft styrer (Microsoft). Adressen får man aldrig at se.

Man skriver bibliotekernes navne i en JSON-blok før sine egne script:

1<script type="application/json" class="ka-lib-manifest">["chart.js", "mermaid"]</script>

SharePoint henter Microsofts egne filer, tjekker dem mod en fastlåst SHA-384-hash og lægger koden direkte ind i siden, før sidens script kører (Microsoft). Der må højst stå seks navne, hvert bibliotek må fylde 8 MiB og alle tilsammen 16 MiB. Ukendte navne ignoreres (Microsoft).

De tilgængelige#

Ved udgangen af oktober 2026 var der tolv navne (Microsoft):

NavnGlobal variabel
chart.jsChart
d3d3
mermaidmermaid
reactReact, ReactDOM
fluentuiFluentUI, React, ReactDOM
babylonBABYLON
topojson-clienttopojson
world-countries-110mworldCountries110m
us-counties-10musCounties10m
@floating-ui/coreFloatingUICore
@floating-ui/domFloatingUIDOM
lucidelucide

Supportartiklen og blogindlægget nævner kun de første fem (Microsoft).

Versionen vælger man ikke#

Skriver man et versionsnummer, ignoreres det (Microsoft). Vejledningen nævner D3 7.9.0, topojson-client 3.1.0, Floating UI 1.7.3 og 1.7.4 og lucide 1.17.0 (Microsoft). For de fem første målte Denis Molodtsov sidst i oktober Chart.js 2.9.4, React 17.0.1, Fluent UI 9.70.0, Babylon 8.56.2 og Mermaid 11.15.0. Chart.js og React er fra 2020, så eksempler skrevet til nye versioner virker ikke nødvendigvis (spdenis.com).

Alle andre biblioteker#

Reglen er, at JavaScript skal stå i selve filen (Microsoft). Lægger man hele bibliotekets kode i et <script>, kører det. Molodtsov fik 16 biblioteker til at virke på den måde, blandt andre D3, Grid.js og Alpine.js. Med Copilot kan man lægge .js-filen i Site Assets og bede Copilot indsætte “the complete, unmodified source” (spdenis.com). Koden tæller med i sidens grænse på 10 MB (Microsoft).

Faldgruber#

  • Det virkede ikke fra starten. Den 6. oktober sendte Site Pages blokken videre uden at indsætte noget (GitHub). Sidst i oktober virkede alle fem første (spdenis.com).
  • Hvert bibliotek fylder. Alle fem første tilsammen lægger omkring 12,9 MB kode ind ved hver visning (spdenis.com). Skriv kun de navne, siden bruger.
  • Ingen netværksindlæsning. d3.json og d3.csv virker ikke; data skal komme fra filen eller fra live data (Microsoft).

Del

Alle noter