TAG: Default options can be overridden on init

- Added init parameter for overriding default options

Author: ZechyW

demo/demo.min.js

@@ -57,7 +57,12 @@ $(async () => {
     // String.
     // See the full documentation for details.
     data: require("../data/test-odin.json"),
-    format: "odin"
+    format: "odin",
+
+    // Overrides for default options
+    options: {
+      showTopArgLabels: true
+    }
   });
 
   // -------------------

demo/src/demo.js

@@ -42408,8 +42408,10 @@ function () {
    * @param {String|Element|jQuery} container - Either a string containing the
    *     ID of the container element, or the element itself (as a
    *     native/jQuery object)
+   * @param {Object} options - Overrides for default library options
    */
   function Main(container) {
+    var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
     (0, _classCallCheck2.default)(this, Main);
     this.config = new _config.default(); // SVG.Doc expects either a string with the element's ID, or the element
     // itself (not a jQuery object).
@@ -42432,7 +42434,8 @@ function () {
     this.words = [];
     this.links = []; // Options
 
-    this.options = {
+    this.options = _lodash.default.defaults(options, // Default options
+    {
       // Category of top Links to show
       topLinksCategory: "default",
       // Category of bottom Links to show
@@ -42445,7 +42448,7 @@ function () {
       showTopArgLabels: false,
       showBottomMainLabel: true,
       showBottomArgLabels: false
-    }; // Initialisation
+    }); // Initialisation
 
     this.resize();
 

dist/tag/js/tag.js

@@ -28,8 +28,9 @@ class Main {
    * @param {String|Element|jQuery} container - Either a string containing the
    *     ID of the container element, or the element itself (as a
    *     native/jQuery object)
+   * @param {Object} options - Overrides for default library options
    */
-  constructor(container) {
+  constructor(container, options = {}) {
     this.config = new Config();
 
     // SVG.Doc expects either a string with the element's ID, or the element
@@ -56,22 +57,27 @@ class Main {
     this.links = [];
 
     // Options
-    this.options = {
-      // Category of top Links to show
-      topLinksCategory: "default",
-      // Category of bottom Links to show
-      bottomLinksCategory: "none",
-
-      // Continue to display top/bottom Links when moving Words?
-      showTopLinksOnMove: true,
-      showBottomLinksOnMove: false,
-
-      // Show main/argument labels on Links?
-      showTopMainLabel: true,
-      showTopArgLabels: false,
-      showBottomMainLabel: true,
-      showBottomArgLabels: false
-    };
+    this.options = _.defaults(
+      options,
+
+      // Default options
+      {
+        // Category of top Links to show
+        topLinksCategory: "default",
+        // Category of bottom Links to show
+        bottomLinksCategory: "none",
+
+        // Continue to display top/bottom Links when moving Words?
+        showTopLinksOnMove: true,
+        showBottomLinksOnMove: false,
+
+        // Show main/argument labels on Links?
+        showTopMainLabel: true,
+        showTopArgLabels: false,
+        showBottomMainLabel: true,
+        showBottomArgLabels: false
+      }
+    );
 
     // Initialisation
     this.resize();

dist/tag/js/tag.min.js

@@ -12,13 +12,22 @@ import Main from "./main";
  * @param {Object} [params.data] - Initial data to load, if any
  * @param {String} [params.format] - One of the supported format identifiers for
  *     the data
+ * @param {Object} [params.options] - Overrides for various default
+ *     library options
  */
 function tag(params) {
+  // Core params
   if (!params.container) {
     throw "No TAG container element specified.";
   }
-  const instance = new Main(params.container);
 
+  if (!params.options) {
+    params.options = {};
+  }
+
+  const instance = new Main(params.container, params.options);
+
+  // Initial data load
   if (params.data && params.format) {
     instance.loadData(params.data, params.format);
   }