luci-base: ui.js: add instantiateView() helper
authorJo-Philipp Wich <jo@mein.io>
Fri, 3 Apr 2020 11:21:09 +0000 (13:21 +0200)
committerJo-Philipp Wich <jo@mein.io>
Fri, 3 Apr 2020 11:26:44 +0000 (13:26 +0200)
Signed-off-by: Jo-Philipp Wich <jo@mein.io>
modules/luci-base/htdocs/luci-static/resources/ui.js
modules/luci-base/luasrc/view/view.htm

index 8d921f77c2324116cb056fdb8e9f97cf9397bb78..61ae69f1cbbc58cc9544d4b45fc3b07ee351f958 100644 (file)
@@ -4268,6 +4268,38 @@ var UI = baseclass.extend(/** @lends LuCI.ui.prototype */ {
                }, this.varargs(arguments, 2, ctx));
        },
 
+       /**
+        * Load specified view class path and set it up.
+        *
+        * Transforms the given view path into a class name, requires it
+        * using [LuCI.require()]{@link LuCI#require} and asserts that the
+        * resulting class instance is a descendant of
+        * [LuCI.view]{@link LuCI.view}.
+        *
+        * By instantiating the view class, its corresponding contents are
+        * rendered and included into the view area. Any runtime errors are
+        * catched and rendered using [LuCI.error()]{@link LuCI#error}.
+        *
+        * @param {string} path
+        * The view path to render.
+        *
+        * @returns {Promise<LuCI.view>}
+        * Returns a promise resolving to the loaded view instance.
+        */
+       instantiateView: function(path) {
+               var className = 'view.%s'.format(path.replace(/\//g, '.'));
+
+               return L.require(className).then(function(view) {
+                       if (!(view instanceof View))
+                               throw new TypeError('Loaded class %s is not a descendant of View'.format(className));
+
+                       return view;
+               }).catch(function(err) {
+                       dom.content(document.querySelector('#view'), null);
+                       L.error(err);
+               });
+       },
+
        AbstractElement: UIElement,
 
        /* Widgets */
index 9220ecf2992e1803f46e6547f5ef65ce636da8ef..b451e8cfbf9280a63534db65a49c960554a14bcc 100644 (file)
@@ -2,10 +2,11 @@
 
 <div id="view">
        <div class="spinning"><%:Loading view…%></div>
-       <script type="text/javascript">L.require('view.<%=view%>').catch(function(err) {
-               L.dom.content(document.querySelector('#view'), null);
-               L.error(err);
-       });</script>
+       <script type="text/javascript">
+               L.require('ui').then(function(ui) {
+                       ui.instantiateView('<%=view%>');
+               });
+       </script>
 </div>
 
 <%+footer%>