README
ReportJS Designer
A javascript plugin to create PDF and XLSX report templates.
Plug-in Javascript para projetar visualmente layouts de relatório (para pdf e Excel)
Install via npm:
npm install reportjs-designer --save
Basic usage
Include the ReportJS and jQuery JavaScript files as well as the ReportJS stylesheet in the <head> of your page. Make sure to load jQuery before ReportJS's JavaScript.
<link rel="stylesheet" href="reportjs/reportjs.css"/>
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.6.0/jquery.min.js"></script>
<script src="reportjs/reportjs.js"></script>
Place an empty div within the <body> of a web page:
<div id="reportjs"></div>
Initialize ReportJS:
<script type="text/javascript">
$(document).ready(function() {
$("#reportjs").reportJs();
});
</script>
Build
prerequisites:
Install Node.js and npm.
Troubleshooting for Ubuntu/Linux: If you get an error like "/usr/bin/env: node: No such file or directory" you can easily fix it with a symbolic link:
ln -s /usr/bin/nodejs /usr/bin/node
Go to reportjs-designer root directory and install node modules:
npm install
development:
npm run build
This is a fast way to build ReportJS Designer and easily debug the code. You can use the generated reportjs.js file from the dist folder in any modern browser supporting ES6 (ECMAScript 2015).
production:
npm run build-prod
Transpiles javascript code from ES6 to ES5 to support older browsers and minifies the generated js file. Use this build step to generate ReportJS Designer for production environment.
Notes
Running demos from local filesystem
You need to run
npm run build-prod
at least once before starting any local demos. This build step copies the external plugins to the ../dist/ext folder which are referenced in the demos.
Running demos from local filesystem with Firefox
Due to Firefox's strict origin policy the icon fonts cannot be loaded (from ../dist/iconfonts)
with default settings. Go to about:config and make sure
security.fileuri.strict_origin_policy is set to false.
Testing with MS Edge on localhost
You have to enable loopback first
CheckNetIsolation LoopbackExempt -a -n=Microsoft.MicrosoftEdge_8wekyb3d8bbwe