Smartface Extension for running AM Charts in a WebView
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
sample
scripts
.gitignore
.npmignore
CODE_OF_CONDUCT.md
LICENSE.txt
README.md
amcharts.js
index.html
package.json

README.md

AMCharts from Smartface

Twitter: @Smartface_io License

Lorem ipsum

Installation

Utility extension can be installed via npm easily from our public npm repository. The installation is pretty easy via Smartface Cloud IDE. Run the following code in terminal

(cd ~/workspace/scripts && npm i -S sf-extension-amcharts)

How to use

Please review the sampe page.

  1. require AMCharts
const AMCharts = require("sf-extension-amcharts");
  1. Create your AMCharts instance
var amCharts = new AMCharts({
     webView: wvChart //optional. If not provided use the the one amCharts.webView
});

Ready is a Promise. It is a good practice to run other codes when the promise is resolved.

  1. When the chart web page is ready, install other AMCharts libraries.
amCharts.loadScritsByName("serial");
//OR load multiple files
amCharts.loadScritsByName("serial", "funnel");

This loadScritsByName function loads files within assets/amcharts/amcharts folder. Those libraries are the libraries that AMCharts provides as is. loadScritsByName function returns a Promise. When it is done, the libraries are loaded.

  1. It is a good practice to run the Chart code with data after the libraries are loaded
amCharts.evaluateJS(chartScript);

In the example above chartScript is a string that contains the JavaScript code to render the Chart and its data. In the webPage there is a div element with id chartdiv. Use this div element to render your chart.

Quick Run

After installation please add the following code to the app.js by commenting out the other run codes.

Router.add("pgChart", require("sf-extension-amcharts/sample/pgChart"));
Router.go("pgChart");

Coding Advice

Running & rendering of the chart can take time. You can show an activity indicator while the chart is being rendered. After your last evaluateJS callback you can change the visibities of the ActivityIndicator and the WebView.

Need Help?

Please submit an issue on GitHub and provide information about your problem.

Support & Documentation & Useful Links

Code of Conduct

We are committed to making participation in this project a harassment-free experience for everyone, regardless of the level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, religion, or nationality. Please read and follow our Code of Conduct.

License

This project is licensed under the terms of the MIT license. See the LICENSE file. Within the scope of this license, all modifications to the source code, regardless of the fact that it is used commercially or not, shall be committed as a contribution back to this repository.