ufTable: make tableElement configurable, and check for existence

Author: alexweissman

CHANGELOG.md

@@ -7,6 +7,7 @@
 - Check if require_email_verification is set in Authenticator and sign-in page (#815)
 - Factor out hardcoded `sprinkles.json` filename (partially addresses #813)
 - Add Farsi translations (#816)
+- `ufTable`: Make tableElement configurable, and check for existence (#824)
 - Put AdminLTE menu toggle button back (Revert e8a26fb and part of a46205f)
 
 ## v4.1.13-alpha

app/sprinkles/core/assets/userfrosting/js/uf-table.js

@@ -173,7 +173,6 @@
     function Plugin (element, options) {
         this.element = element[0];
         this.$element = $(this.element);
-        var tableElement = this.$element.find('.tablesorter');
 
         var lateDefaults = {
             download: {
@@ -187,6 +186,7 @@
             overlay: {
                 container: this.$element.find('.js-uf-table-overlay')
             },
+            tableElement: this.$element.find('.tablesorter'),
             tablesorter: {
                 widgetOptions: {
                     columnSelector_container : this.$element.find('.js-uf-table-cs-options'),
@@ -249,6 +249,15 @@
 
         this.settings = $.extend(true, {}, dataAttributeDefaults, this.settings);
 
+        // Check that tableElement exists
+        var tableElement = this.settings.tableElement;
+        if (!tableElement.length) {
+            if (window.console && console.error) {
+                console.error('ufTable could not be initialized: wrapper element does not exist, or does not contain a matched tableElement (see https://learn.userfrosting.com/client-side-code/components/tables )');
+            }
+            return;
+        }
+
         // Copy over dataUrl to pager_ajaxUrl
         this.settings.tablesorter.widgetOptions.pager_ajaxUrl = this.settings.dataUrl;