The enable-source-map Element

{{ZKConfigurationReferencePageHeader}}


'''Syntax:'''
 <enable-source-map>true|'''false'''</enable-source-map>

 [Default: <code>false</code>]

It specifies whether to produce source map links for browsers to load the JavaScript/TypeScript source. By default, ZK only loads <code>*.wpd</code>, the merged JavaScript files of the same package. One wpd file contains multiple JavaScript files. Those files are merged upon JavaScript widget packages (e.g. zk.wpd or zkbind.wpd).

[[File:DisabledSourceMap.png|center]]

When enabling it, you can open the browser developer tool to check loaded source files and help you debug. You will see <code>//# sourceMappingURL=/link-to-source-map.map</code> in a wpd file.

= ZK 8 and 9 =
A browser loads and shows each JavaScript widget file under <code>src</code>:

[[File:zk9SourceMap.png|center]]

(A known issue that the line number in a source file might not always match the actual running code)

= ZK 10 = 
A browser loads and shows each TypeScript widget file under <code>zk-build-utils</code>:

[[File:zk10SourceMap.png|center]]

Each loaded wpd file is split into multiple files e.g. zul1.wpd, zul1.wpd, zul3.wpd.

{{ZKConfigurationReferencePageFooter}}