Swagger plugins support

README.md

@@ -1302,13 +1302,17 @@ app.UseSwaggerUI(c =>
     c.MaxDisplayedTags(5);
     c.ShowExtensions();
     c.ShowCommonExtensions();
+    c.Plugins = new string[]{"myCustomPlugin"}
     c.EnableValidator();
     c.SupportedSubmitMethods(SubmitMethod.Get, SubmitMethod.Head);
     c.UseRequestInterceptor("(request) => { return request; }");
     c.UseResponseInterceptor("(response) => { return response; }");
 });
 ```
 
+ > [!NOTE]
+ > When adding custom plugins, make sure you added custom `js` file that defines the plugin function(s).
+
 ### Inject Custom JavaScript ###
 
 To tweak the behavior, you can inject additional JavaScript files by adding them to your `wwwroot` folder and specifying the relative paths in the middleware options:

src/Swashbuckle.AspNetCore.SwaggerUI/PublicAPI/PublicAPI.Unshipped.txt

@@ -0,0 +1,2 @@
+Swashbuckle.AspNetCore.SwaggerUI.ConfigObject.Plugins.get -> System.Collections.Generic.IList<string>
+Swashbuckle.AspNetCore.SwaggerUI.ConfigObject.Plugins.set -> void

src/Swashbuckle.AspNetCore.SwaggerUI/SwaggerUIOptions.cs

@@ -190,6 +190,12 @@ public class ConfigObject
         [JsonPropertyName("validatorUrl")]
         public string ValidatorUrl { get; set; } = null;
 
+        /// <summary>
+        /// Any custom plugins' function names.
+        /// </summary>
+        [JsonPropertyName("plugins")]
+        public IList<string>  Plugins { get; set; } = null;
+
         [JsonExtensionData]
         public Dictionary<string, object> AdditionalItems { get; set; } = [];
     }

src/Swashbuckle.AspNetCore.SwaggerUI/index.js

@@ -57,6 +57,10 @@ window.onload = function () {
     if (interceptors.ResponseInterceptorFunction)
         configObject.responseInterceptor = parseFunction(interceptors.ResponseInterceptorFunction);
 
+    if(configObject.plugins) {
+        configObject.plugins = configObject.plugins.map(eval);
+    }
+
     // Begin Swagger UI call region
 
     const ui = SwaggerUIBundle(configObject);

test/WebSites/CustomUIConfig/Startup.cs

@@ -73,14 +73,17 @@ public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
                 // Other
                 c.DocumentTitle = "CustomUIConfig";
                 c.StylesPath = "/ext/custom-stylesheet.css";
+                c.InjectStylesheet("/ext/custom-stylesheet.css");
                 c.ScriptBundlePath = "/ext/custom-javascript.js";
                 c.ScriptPresetsPath = "/ext/custom-javascript.js";
-                c.InjectStylesheet("/ext/custom-stylesheet.css");
                 c.InjectJavascript("/ext/custom-javascript.js");
+                c.InjectJavascript("/ext/custom-plugin.js");
                 c.UseRequestInterceptor("(req) => { req.headers['x-my-custom-header'] = 'MyCustomValue'; return req; }");
                 c.UseResponseInterceptor("(res) => { console.log('Custom interceptor intercepted response from:', res.url); return res; }");
                 c.EnablePersistAuthorization();
 
+                c.ConfigObject.Plugins = ["customPlugin"];
+
                 c.ConfigObject.AdditionalItems.Add("syntaxHighlight", false);
                 c.ConfigObject.AdditionalItems.Add("charProperty", 'c');
                 c.ConfigObject.AdditionalItems.Add("stringProperty", "value");

test/WebSites/CustomUIConfig/wwwroot/ext/custom-plugin.js

@@ -0,0 +1,10 @@
+
+const customPlugin = function (system) {
+    var elem = document.createElement("div");
+    elem.innerHTML =
+        "<div style=\"text-align: center; font-family: Titillium Web,sans-serif; margin: 16px;\">This text was injected via /ext/custom-plugin.js, using the SwaggerUIOptions.Plugins method.</div>";
+
+    document.body.insertBefore(elem, document.body.firstChild);
+    return {
+    }
+}