From 20824ceb25bf47ab7e399d2c5c83bbc260e13649 Mon Sep 17 00:00:00 2001
From: Jeremy Stretch <jstretch@netboxlabs.com>
Date: Tue, 13 Feb 2024 16:31:17 -0500
Subject: [PATCH] Closes #13283: Add context to dropdown options (#15104)

* Initial work on #13283

* Enable passing TomSelect HTML template attibutes on DynamicModelChoiceField

* Merge disabled_indicator into option_attrs

* Add support for annotating a numeric count on dropdown options

* Annotate parent object on relevant fields

* Improve rendering of color options

* Improve rendering of color options

* Rename option_attrs to context

* Expose option context on ObjectVar for custom scripts

* Document dropdown context variables
---
 docs/customization/custom-scripts.md          |  17 +++++++
 netbox/dcim/forms/bulk_edit.py                |   6 +++
 netbox/dcim/forms/connections.py              |  12 +++--
 netbox/dcim/forms/model_forms.py              |  26 ++++++++--
 netbox/extras/scripts.py                      |   5 +-
 netbox/ipam/forms/model_forms.py              |   8 ++-
 netbox/project-static/dist/netbox.js          | Bin 374348 -> 375736 bytes
 netbox/project-static/dist/netbox.js.map      | Bin 339643 -> 340629 bytes
 .../src/select/classes/dynamicTomSelect.ts    |  46 ++++++++++++++++--
 netbox/project-static/src/select/dynamic.ts   |  35 ++++++++++---
 netbox/project-static/src/select/static.ts    |  11 +++--
 netbox/utilities/forms/fields/dynamic.py      |  26 ++++++++--
 netbox/wireless/forms/model_forms.py          |   8 ++-
 13 files changed, 171 insertions(+), 29 deletions(-)

diff --git a/docs/customization/custom-scripts.md b/docs/customization/custom-scripts.md
index 96423a94b..bdc3f9104 100644
--- a/docs/customization/custom-scripts.md
+++ b/docs/customization/custom-scripts.md
@@ -304,6 +304,7 @@ A particular object within NetBox. Each ObjectVar must specify a particular mode
 
 * `model` - The model class
 * `query_params` - A dictionary of query parameters to use when retrieving available options (optional)
+* `context` - A custom dictionary mapping template context variables to fields, used when rendering `<option>` elements within the dropdown menu (optional; see below)
 * `null_option` - A label representing a "null" or empty choice (optional)
 
 To limit the selections available within the list, additional query parameters can be passed as the `query_params` dictionary. For example, to show only devices with an "active" status:
@@ -331,6 +332,22 @@ site = ObjectVar(
 )
 ```
 
+#### Context Variables
+
+Custom context variables can be passed to override the default attribute names or to display additional information, such as a parent object.
+
+| Name          | Default         | Description                                                                  |
+|---------------|-----------------|------------------------------------------------------------------------------|
+| `value`       | `"id"`          | The attribute which contains the option's value                              |
+| `label`       | `"display"`     | The attribute used as the option's human-friendly label                      |
+| `description` | `"description"` | The attribute to use as a description                                        |
+| `depth`[^1]   | `"_depth"`      | The attribute which indicates an object's depth within a recursive hierarchy |
+| `disabled`    | --              | The attribute which, if true, signifies that the option should be disabled   |
+| `parent`      | --              | The attribute which represents the object's parent object                    |
+| `count`[^1]   | --              | The attribute which contains a numeric count of related objects              |
+
+[^1]: The value of this attribute must be a positive integer
+
 ### MultiObjectVar
 
 Similar to `ObjectVar`, but allows for the selection of multiple objects.
diff --git a/netbox/dcim/forms/bulk_edit.py b/netbox/dcim/forms/bulk_edit.py
index 68d8d4f89..79ecc8383 100644
--- a/netbox/dcim/forms/bulk_edit.py
+++ b/netbox/dcim/forms/bulk_edit.py
@@ -557,6 +557,9 @@ class DeviceBulkEditForm(NetBoxModelBulkEditForm):
         label=_('Device type'),
         queryset=DeviceType.objects.all(),
         required=False,
+        context={
+            'parent': 'manufacturer',
+        },
         query_params={
             'manufacturer_id': '$manufacturer'
         }
@@ -640,6 +643,9 @@ class ModuleBulkEditForm(NetBoxModelBulkEditForm):
         required=False,
         query_params={
             'manufacturer_id': '$manufacturer'
+        },
+        context={
+            'parent': 'manufacturer',
         }
     )
     status = forms.ChoiceField(
diff --git a/netbox/dcim/forms/connections.py b/netbox/dcim/forms/connections.py
index 854c5ebed..67ef360fe 100644
--- a/netbox/dcim/forms/connections.py
+++ b/netbox/dcim/forms/connections.py
@@ -30,7 +30,9 @@ def get_cable_form(a_type, b_type):
                     attrs[f'{cable_end}_terminations'] = DynamicModelMultipleChoiceField(
                         queryset=term_cls.objects.all(),
                         label=term_cls._meta.verbose_name.title(),
-                        disabled_indicator='_occupied',
+                        context={
+                            'disabled': '_occupied',
+                        },
                         query_params={
                             'device_id': f'$termination_{cable_end}_device',
                             'kind': 'physical',  # Exclude virtual interfaces
@@ -52,7 +54,9 @@ def get_cable_form(a_type, b_type):
                     attrs[f'{cable_end}_terminations'] = DynamicModelMultipleChoiceField(
                         queryset=term_cls.objects.all(),
                         label=_('Power Feed'),
-                        disabled_indicator='_occupied',
+                        context={
+                            'disabled': '_occupied',
+                        },
                         query_params={
                             'power_panel_id': f'$termination_{cable_end}_powerpanel',
                         }
@@ -72,7 +76,9 @@ def get_cable_form(a_type, b_type):
                     attrs[f'{cable_end}_terminations'] = DynamicModelMultipleChoiceField(
                         queryset=term_cls.objects.all(),
                         label=_('Side'),
-                        disabled_indicator='_occupied',
+                        context={
+                            'disabled': '_occupied',
+                        },
                         query_params={
                             'circuit_id': f'$termination_{cable_end}_circuit',
                         }
diff --git a/netbox/dcim/forms/model_forms.py b/netbox/dcim/forms/model_forms.py
index fdb5f1d5a..a46136775 100644
--- a/netbox/dcim/forms/model_forms.py
+++ b/netbox/dcim/forms/model_forms.py
@@ -426,7 +426,7 @@ class DeviceForm(TenancyForm, NetBoxModelForm):
         widget=APISelect(
             api_url='/api/dcim/racks/{{rack}}/elevation/',
             attrs={
-                'disabled-indicator': 'device',
+                'ts-disabled-field': 'device',
                 'data-dynamic-params': '[{"fieldName":"face","queryParam":"face"}]'
             },
         )
@@ -434,6 +434,9 @@ class DeviceForm(TenancyForm, NetBoxModelForm):
     device_type = DynamicModelChoiceField(
         label=_('Device type'),
         queryset=DeviceType.objects.all(),
+        context={
+            'parent': 'manufacturer',
+        },
         selector=True
     )
     role = DynamicModelChoiceField(
@@ -461,6 +464,9 @@ class DeviceForm(TenancyForm, NetBoxModelForm):
         label=_('Virtual chassis'),
         queryset=VirtualChassis.objects.all(),
         required=False,
+        context={
+            'parent': 'master',
+        },
         selector=True
     )
     vc_position = forms.IntegerField(
@@ -568,6 +574,9 @@ class ModuleForm(ModuleCommonForm, NetBoxModelForm):
     module_type = DynamicModelChoiceField(
         label=_('Module type'),
         queryset=ModuleType.objects.all(),
+        context={
+            'parent': 'manufacturer',
+        },
         selector=True
     )
     comments = CommentField()
@@ -774,7 +783,10 @@ class VCMemberSelectForm(forms.Form):
 class ComponentTemplateForm(forms.ModelForm):
     device_type = DynamicModelChoiceField(
         label=_('Device type'),
-        queryset=DeviceType.objects.all()
+        queryset=DeviceType.objects.all(),
+        context={
+            'parent': 'manufacturer',
+        }
     )
 
     def __init__(self, *args, **kwargs):
@@ -789,12 +801,18 @@ class ModularComponentTemplateForm(ComponentTemplateForm):
     device_type = DynamicModelChoiceField(
         label=_('Device type'),
         queryset=DeviceType.objects.all().all(),
-        required=False
+        required=False,
+        context={
+            'parent': 'manufacturer',
+        }
     )
     module_type = DynamicModelChoiceField(
         label=_('Module type'),
         queryset=ModuleType.objects.all(),
-        required=False
+        required=False,
+        context={
+            'parent': 'manufacturer',
+        }
     )
 
     def __init__(self, *args, **kwargs):
diff --git a/netbox/extras/scripts.py b/netbox/extras/scripts.py
index 40301e5c9..3a7b361da 100644
--- a/netbox/extras/scripts.py
+++ b/netbox/extras/scripts.py
@@ -193,16 +193,19 @@ class ObjectVar(ScriptVariable):
 
     :param model: The NetBox model being referenced
     :param query_params: A dictionary of additional query parameters to attach when making REST API requests (optional)
+    :param context: A custom dictionary mapping template context variables to fields, used when rendering <option>
+        elements within the dropdown menu (optional)
     :param null_option: The label to use as a "null" selection option (optional)
     """
     form_field = DynamicModelChoiceField
 
-    def __init__(self, model, query_params=None, null_option=None, *args, **kwargs):
+    def __init__(self, model, query_params=None, context=None, null_option=None, *args, **kwargs):
         super().__init__(*args, **kwargs)
 
         self.field_attrs.update({
             'queryset': model.objects.all(),
             'query_params': query_params,
+            'context': context,
             'null_option': null_option,
         })
 
diff --git a/netbox/ipam/forms/model_forms.py b/netbox/ipam/forms/model_forms.py
index f6a67d643..892378179 100644
--- a/netbox/ipam/forms/model_forms.py
+++ b/netbox/ipam/forms/model_forms.py
@@ -267,14 +267,20 @@ class IPRangeForm(TenancyForm, NetBoxModelForm):
 
 class IPAddressForm(TenancyForm, NetBoxModelForm):
     interface = DynamicModelChoiceField(
-        label=_('Interface'),
         queryset=Interface.objects.all(),
         required=False,
+        context={
+            'parent': 'device',
+        },
         selector=True,
+        label=_('Interface'),
     )
     vminterface = DynamicModelChoiceField(
         queryset=VMInterface.objects.all(),
         required=False,
+        context={
+            'parent': 'virtual_machine',
+        },
         selector=True,
         label=_('Interface'),
     )
diff --git a/netbox/project-static/dist/netbox.js b/netbox/project-static/dist/netbox.js
index 71b1fc77422eb9353a08b8fb782da9debf10974a..a13a594178a31d7d39a1c09f5ad4b95149171df7 100644
GIT binary patch
delta 9209
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
Cf;o@?

delta 8098
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
Am;e9(

diff --git a/netbox/project-static/dist/netbox.js.map b/netbox/project-static/dist/netbox.js.map
index 8f4dde4e2c7bcf6a7e0f4ca418cd71c0070a82a5..593f076970d28b84f07336361b58f3894ee8a1e1 100644
GIT binary patch
delta 1356
zcmb7EyKWOf6qU_D2?c2gpTJm#7!v}*(%sq3GFn-SV=TvX#(6r4EtE)6+-wTd(W0&L
z3sguh_ytN@3JOF?g+$4@cP82u6cNp8XXe~<&V9^$`nvS~`_lQmGOy0BeN+dva6t4X
z&@s`zd>;ndklBlLn<&-Ob)xAyPR)$Jl<1>?Ov=CVN%V-~W{_XR>TdqFrfRnU-Ove9
zTc^=#u(kMAQ|5YxjYRi}hJ2JTcUup62|AXS-7ZlVAhQ~|_5b2WM7y4<5IBawDN-vG
zMr0=IZoQAgqklrqu)7i<Gt;=*NtaALbZn^PD5r+HU8iFvHRG$p6N>9$UU{sR7oCRs
zUCH`f{v9rGTU(+7X-Y?T$Ta0wHq1$&Q?3^B>@lp%Q4a(lVO`g(17v~#OXkGzPRALw
z6z#bFwkeiwB}~H7Pn>q*x`PnbU}mW(K$ev@9ldlA7>m<hbMdaJHY%B&8SQm(G+?-M
zZdqfS*JCki9f>q%KxPX$LJcv=WjW16bp50W5R%(m+C8ID?qLb;Cn;-Fv?j@x`4Ki^
zWmh8aq>vh7=)_aXWgReUdTAmW8%|zgyfeUGaWW|%^h+Lw6s<T3kKDy=@lZ_ns077H
zB+y>C`1VL$+^E)j`S~;TG~=;>0TE15lz7wW!&%Cz34846o;NDDse=eJ4xK3k$Lv1U
z(6o&973@<yk<!T8V<cC6nAXe!oykAu?L~?0$l#h5p$T_5nuRVO#Fer4F?4uE3SQi@
zXwPF&x-#|*yenni(;%a0A_ed!`xHF~nSIF(p9*jJrNZSax&tS~W5ngSOd74nt59A?
uhvDC#0a;urK&K|Z*HYWn_;voFrIv3N&zU8=k$-NfJJq#t@uQ`_{QLuI_-*L`

delta 381
zcmZvYF-yci5QWLzdY#=hTIe5`)51HBQxM-yVpxtN#Fz_LNfZSWL<Bvs5sS2zlFI*J
zA*8U;|6prjVQp*a&P7ncX4u{L=G%F5``&(hZC@8o(I}b^D({r{9p!Tb#N-3VT54Al
zgZnOxfPiuaa+dc%%8(Ku`E@<f-c+A&SFIJrbLHE*TBvTi>eJy+DC4>(1=9Ky0+9uC
z#)2P_0gM=T{~C=|<3Y9AS36EK&bWFSsJm8U8kKunYU9YuJZU!+$XJ#!BnwU`1|~Jg
z3K4nW9*Yu^jri^UFGLDIb8F*I(6pS_>U7EM(*bZO*nnn1E;Mkd?caXSEw8j%TsAOc
YS<FNxIGgQnRm+3{1-!=9vsN!3U#f>|6#xJL

diff --git a/netbox/project-static/src/select/classes/dynamicTomSelect.ts b/netbox/project-static/src/select/classes/dynamicTomSelect.ts
index 90bd64f1d..758462b60 100644
--- a/netbox/project-static/src/select/classes/dynamicTomSelect.ts
+++ b/netbox/project-static/src/select/classes/dynamicTomSelect.ts
@@ -31,6 +31,15 @@ export class DynamicTomSelect extends TomSelect {
     // Glean the REST API endpoint URL from the <select> element
     this.api_url = this.input.getAttribute('data-url') as string;
 
+    // Override any field names set as widget attributes
+    this.valueField = this.input.getAttribute('ts-value-field') || this.settings.valueField;
+    this.labelField = this.input.getAttribute('ts-label-field') || this.settings.labelField;
+    this.disabledField = this.input.getAttribute('ts-disabled-field') || this.settings.disabledField;
+    this.descriptionField = this.input.getAttribute('ts-description-field') || 'description';
+    this.depthField = this.input.getAttribute('ts-depth-field') || '_depth';
+    this.parentField = this.input.getAttribute('ts-parent-field') || null;
+    this.countField = this.input.getAttribute('ts-count-field') || null;
+
     // Set the null option (if any)
     const nullOption = this.input.getAttribute('data-null-option');
     if (nullOption) {
@@ -82,10 +91,20 @@ export class DynamicTomSelect extends TomSelect {
     // Make the API request
     fetch(url)
       .then(response => response.json())
-      .then(json => {
-          self.loadCallback(json.results, []);
+      .then(apiData => {
+        const results: Dict[] = apiData.results;
+        let options: Dict[] = []
+        for (let result of results) {
+          const option = self.getOptionFromData(result);
+          options.push(option);
+        }
+        return options;
+      })
+      // Pass the options to the callback function
+      .then(options => {
+        self.loadCallback(options, []);
       }).catch(()=>{
-          self.loadCallback([], []);
+        self.loadCallback([], []);
       });
 
   }
@@ -126,6 +145,27 @@ export class DynamicTomSelect extends TomSelect {
     return queryString.stringifyUrl({ url, query });
   }
 
+  // Compile TomOption data from an API result
+  getOptionFromData(data: Dict) {
+    let option: Dict = {
+      id: data[this.valueField],
+      display: data[this.labelField],
+      depth: data[this.depthField] || null,
+      description: data[this.descriptionField] || null,
+    };
+    if (data[this.parentField]) {
+      let parent: Dict = data[this.parentField] as Dict;
+      option['parent'] = parent[this.labelField];
+    }
+    if (data[this.countField]) {
+      option['count'] = data[this.countField];
+    }
+    if (data[this.disabledField]) {
+      option['disabled'] = data[this.disabledField];
+    }
+    return option
+  }
+
   /**
    * Transitional methods
    */
diff --git a/netbox/project-static/src/select/dynamic.ts b/netbox/project-static/src/select/dynamic.ts
index 9f29efe1d..20912140b 100644
--- a/netbox/project-static/src/select/dynamic.ts
+++ b/netbox/project-static/src/select/dynamic.ts
@@ -10,12 +10,34 @@ const MAX_OPTIONS = 100;
 
 // Render the HTML for a dropdown option
 function renderOption(data: TomOption, escape: typeof escape_html) {
-  // If the option has a `_depth` property, indent its label
-  if (typeof data._depth === 'number' && data._depth > 0) {
-    return `<div>${'─'.repeat(data._depth)} ${escape(data[LABEL_FIELD])}</div>`;
+  let html = '<div>';
+
+  // If the option has a `depth` property, indent its label
+  if (typeof data.depth === 'number' && data.depth > 0) {
+    html = `${html}${'─'.repeat(data.depth)} `;
   }
 
-  return `<div>${escape(data[LABEL_FIELD])}</div>`;
+  html = `${html}${escape(data[LABEL_FIELD])}`;
+  if (data['parent']) {
+    html = `${html} <span class="text-secondary">${escape(data['parent'])}</span>`;
+  }
+  if (data['count']) {
+    html = `${html} <span class="badge">${escape(data['count'])}</span>`;
+  }
+  if (data['description']) {
+    html = `${html}<br /><small class="text-secondary">${escape(data['description'])}</small>`;
+  }
+  html = `${html}</div>`;
+
+  return html;
+}
+
+// Render the HTML for a selected item
+function renderItem(data: TomOption, escape: typeof escape_html) {
+  if (data['parent']) {
+    return `<div>${escape(data['parent'])} > ${escape(data[LABEL_FIELD])}</div>`;
+  }
+  return `<div>${escape(data[LABEL_FIELD])}<div>`;
 }
 
 // Initialize <select> elements which are populated via a REST API call
@@ -30,16 +52,13 @@ export function initDynamicSelects(): void {
       // Disable local search (search is performed on the backend)
       searchField: [],
 
-      // Reference the disabled-indicator attr on the <select> element to determine
-      // the name of the attribute which indicates whether an option should be disabled
-      disabledField: select.getAttribute('disabled-indicator') || undefined,
-
       // Load options from API immediately on focus
       preload: 'focus',
 
       // Define custom rendering functions
       render: {
         option: renderOption,
+        item: renderItem,
       },
 
       // By default, load() will be called only if query.length > 0
diff --git a/netbox/project-static/src/select/static.ts b/netbox/project-static/src/select/static.ts
index 7df9a7d8a..619655c7f 100644
--- a/netbox/project-static/src/select/static.ts
+++ b/netbox/project-static/src/select/static.ts
@@ -17,13 +17,18 @@ export function initStaticSelects(): void {
 
 // Initialize color selection fields
 export function initColorSelects(): void {
+  function renderColor(item: TomOption, escape: typeof escape_html) {
+    return `<div><span class="dropdown-item-indicator color-label" style="background-color: #${escape(
+      item.value,
+    )}"></span> ${escape(item.text)}</div>`;
+  }
+
   for (const select of getElements<HTMLSelectElement>('select.color-select')) {
     new TomSelect(select, {
       ...config,
       render: {
-        option: function (item: TomOption, escape: typeof escape_html) {
-          return `<div style="background-color: #${escape(item.value)}">${escape(item.text)}</div>`;
-        },
+        option: renderColor,
+        item: renderColor,
       },
     });
   }
diff --git a/netbox/utilities/forms/fields/dynamic.py b/netbox/utilities/forms/fields/dynamic.py
index eb0dc9b59..cb24ea08d 100644
--- a/netbox/utilities/forms/fields/dynamic.py
+++ b/netbox/utilities/forms/fields/dynamic.py
@@ -63,8 +63,19 @@ class DynamicModelChoiceMixin:
         initial_params: A dictionary of child field references to use for selecting a parent field's initial value
         null_option: The string used to represent a null selection (if any)
         disabled_indicator: The name of the field which, if populated, will disable selection of the
-            choice (optional)
+            choice (DEPRECATED: pass `context={'disabled': '$fieldname'}` instead)
+        context: A mapping of <option> template variables to their API data keys (optional; see below)
         selector: Include an advanced object selection widget to assist the user in identifying the desired object
+
+    Context keys:
+        value: The name of the attribute which contains the option's value (default: 'id')
+        label: The name of the attribute used as the option's human-friendly label (default: 'display')
+        description: The name of the attribute to use as a description (default: 'description')
+        depth: The name of the attribute which indicates an object's depth within a recursive hierarchy; must be a
+            positive integer (default: '_depth')
+        disabled: The name of the attribute which, if true, signifies that the option should be disabled
+        parent: The name of the attribute which represents the object's parent object (e.g. device for an interface)
+        count: The name of the attribute which contains a numeric count of related objects
     """
     filter = django_filters.ModelChoiceFilter
     widget = widgets.APISelect
@@ -77,6 +88,7 @@ class DynamicModelChoiceMixin:
             initial_params=None,
             null_option=None,
             disabled_indicator=None,
+            context=None,
             selector=False,
             **kwargs
     ):
@@ -85,6 +97,7 @@ class DynamicModelChoiceMixin:
         self.initial_params = initial_params or {}
         self.null_option = null_option
         self.disabled_indicator = disabled_indicator
+        self.context = context or {}
         self.selector = selector
 
         super().__init__(queryset, **kwargs)
@@ -96,12 +109,17 @@ class DynamicModelChoiceMixin:
         if self.null_option is not None:
             attrs['data-null-option'] = self.null_option
 
-        # Set the disabled indicator, if any
+        # Set any custom template attributes for TomSelect
+        for var, accessor in self.context.items():
+            attrs[f'ts-{var}-field'] = accessor
+
+        # TODO: Remove in v4.1
+        # Legacy means of specifying the disabled indicator
         if self.disabled_indicator is not None:
-            attrs['disabled-indicator'] = self.disabled_indicator
+            attrs['ts-disabled-field'] = self.disabled_indicator
 
         # Attach any static query parameters
-        if (len(self.query_params) > 0):
+        if len(self.query_params) > 0:
             widget.add_query_params(self.query_params)
 
         # Include object selector?
diff --git a/netbox/wireless/forms/model_forms.py b/netbox/wireless/forms/model_forms.py
index 666bddaa9..04e6fce83 100644
--- a/netbox/wireless/forms/model_forms.py
+++ b/netbox/wireless/forms/model_forms.py
@@ -108,7 +108,9 @@ class WirelessLinkForm(TenancyForm, NetBoxModelForm):
             'kind': 'wireless',
             'device_id': '$device_a',
         },
-        disabled_indicator='_occupied',
+        context={
+            'disabled': '_occupied',
+        },
         label=_('Interface')
     )
     site_b = DynamicModelChoiceField(
@@ -148,7 +150,9 @@ class WirelessLinkForm(TenancyForm, NetBoxModelForm):
             'kind': 'wireless',
             'device_id': '$device_b',
         },
-        disabled_indicator='_occupied',
+        context={
+            'disabled': '_occupied',
+        },
         label=_('Interface')
     )
     comments = CommentField()