Add fallback value to attributes files

plotly · camdecoster · Oct 27, 2025 · Sep 29, 2025 · Sep 29, 2025 · Oct 2, 2025
commit 52c29ccc8c591c527085f08e6399ebd6ea889bd8
diff --git a/src/components/shapes/attributes.js b/src/components/shapes/attributes.js
@@ -8,7 +8,7 @@ var extendFlat = require('../../lib/extend').extendFlat;
 var templatedArray = require('../../plot_api/plot_template').templatedArray;
 var axisPlaceableObjs = require('../../constants/axis_placeable_objects');
 var basePlotAttributes = require('../../plots/attributes');
-var shapeTexttemplateAttrs = require('../../plots/template_attributes').shapeTexttemplateAttrs;
+const { shapeTexttemplateAttrs, templatefallbackAttrs } = require('../../plots/template_attributes');
 var shapeLabelTexttemplateVars = require('./label_texttemplate');
 
 module.exports = templatedArray('shape', {
@@ -331,6 +331,7 @@ module.exports = templatedArray('shape', {
             ].join(' ')
         },
         texttemplate: shapeTexttemplateAttrs({}, { keys: Object.keys(shapeLabelTexttemplateVars) }),
+        texttemplatefallback: templatefallbackAttrs(),
         font: fontAttrs({
             editType: 'calc+arraydraw',
             colorEditType: 'arraydraw',

diff --git a/src/components/shapes/draw_newshape/attributes.js b/src/components/shapes/draw_newshape/attributes.js
@@ -5,7 +5,7 @@ var basePlotAttributes = require('../../../plots/attributes');
 var fontAttrs = require('../../../plots/font_attributes');
 var dash = require('../../drawing/attributes').dash;
 var extendFlat = require('../../../lib/extend').extendFlat;
-var shapeTexttemplateAttrs = require('../../../plots/template_attributes').shapeTexttemplateAttrs;
+const { shapeTexttemplateAttrs, templatefallbackAttrs } = require('../../../plots/template_attributes');
 var shapeLabelTexttemplateVars = require('../label_texttemplate');
 
 module.exports = overrideAll(
@@ -150,6 +150,7 @@ module.exports = overrideAll(
                     { newshape: true },
                     { keys: Object.keys(shapeLabelTexttemplateVars) }
                 ),
+                texttemplatefallback: templatefallbackAttrs(),
                 font: fontAttrs({
                     description: 'Sets the new shape label text font.'
                 }),

diff --git a/src/traces/bar/attributes.js b/src/traces/bar/attributes.js
@@ -2,8 +2,7 @@
 
 var scatterAttrs = require('../scatter/attributes');
 var axisHoverFormat = require('../../plots/cartesian/axis_format_attributes').axisHoverFormat;
-var hovertemplateAttrs = require('../../plots/template_attributes').hovertemplateAttrs;
-var texttemplateAttrs = require('../../plots/template_attributes').texttemplateAttrs;
+const { hovertemplateAttrs, texttemplateAttrs, templatefallbackAttrs } = require('../../plots/template_attributes');
 var colorScaleAttrs = require('../../components/colorscale/attributes');
 var fontAttrs = require('../../plots/font_attributes');
 var constants = require('./constants');
@@ -78,19 +77,11 @@ module.exports = {
     yhoverformat: axisHoverFormat('y'),
 
     text: scatterAttrs.text,
-    texttemplate: texttemplateAttrs(
-        { editType: 'plot' },
-        {
-            keys: constants.eventDataKeys
-        }
-    ),
+    texttemplate: texttemplateAttrs({ editType: 'plot' }, { keys: constants.eventDataKeys }),
+    texttemplatefallback: templatefallbackAttrs(),
     hovertext: scatterAttrs.hovertext,
-    hovertemplate: hovertemplateAttrs(
-        {},
-        {
-            keys: constants.eventDataKeys
-        }
-    ),
+    hovertemplate: hovertemplateAttrs({}, { keys: constants.eventDataKeys }),
+    hovertemplatefallback: templatefallbackAttrs(),
 
     textposition: {
         valType: 'enumerated',

diff --git a/src/traces/barpolar/attributes.js b/src/traces/barpolar/attributes.js
@@ -1,6 +1,6 @@
 'use strict';
 
-var hovertemplateAttrs = require('../../plots/template_attributes').hovertemplateAttrs;
+const { hovertemplateAttrs, templatefallbackAttrs } = require('../../plots/template_attributes');
 var extendFlat = require('../../lib/extend').extendFlat;
 var scatterPolarAttrs = require('../scatterpolar/attributes');
 var barAttrs = require('../bar/attributes');
@@ -59,6 +59,7 @@ module.exports = {
 
     hoverinfo: scatterPolarAttrs.hoverinfo,
     hovertemplate: hovertemplateAttrs(),
+    hovertemplatefallback: templatefallbackAttrs(),
 
     selected: barAttrs.selected,
     unselected: barAttrs.unselected

diff --git a/src/traces/box/attributes.js b/src/traces/box/attributes.js
@@ -5,7 +5,7 @@ var scatterAttrs = require('../scatter/attributes');
 var barAttrs = require('../bar/attributes');
 var colorAttrs = require('../../components/color/attributes');
 var axisHoverFormat = require('../../plots/cartesian/axis_format_attributes').axisHoverFormat;
-var hovertemplateAttrs = require('../../plots/template_attributes').hovertemplateAttrs;
+const { hovertemplateAttrs, templatefallbackAttrs } = require('../../plots/template_attributes');
 var extendFlat = require('../../lib/extend').extendFlat;
 
 var scatterMarkerAttrs = scatterAttrs.marker;
@@ -410,6 +410,7 @@ module.exports = {
     }),
     hovertext: extendFlat({}, scatterAttrs.hovertext, { description: 'Same as `text`.' }),
     hovertemplate: hovertemplateAttrs({ description: 'N.B. This only has an effect when hovering on points.' }),
+    hovertemplatefallback: templatefallbackAttrs(),
 
     hoveron: {
         valType: 'flaglist',

diff --git a/src/traces/choropleth/attributes.js b/src/traces/choropleth/attributes.js
@@ -1,6 +1,6 @@
 'use strict';
 
-var hovertemplateAttrs = require('../../plots/template_attributes').hovertemplateAttrs;
+const { hovertemplateAttrs, templatefallbackAttrs } = require('../../plots/template_attributes');
 var scatterGeoAttrs = require('../scattergeo/attributes');
 var colorScaleAttrs = require('../../components/colorscale/attributes');
 var baseAttrs = require('../../plots/attributes');
@@ -84,6 +84,7 @@ module.exports = extendFlat(
             flags: ['location', 'z', 'text', 'name']
         }),
         hovertemplate: hovertemplateAttrs(),
+        hovertemplatefallback: templatefallbackAttrs(),
         showlegend: extendFlat({}, baseAttrs.showlegend, { dflt: false })
     },
 

diff --git a/src/traces/choroplethmap/attributes.js b/src/traces/choroplethmap/attributes.js
@@ -2,7 +2,7 @@
 
 var choroplethAttrs = require('../choropleth/attributes');
 var colorScaleAttrs = require('../../components/colorscale/attributes');
-var hovertemplateAttrs = require('../../plots/template_attributes').hovertemplateAttrs;
+const { hovertemplateAttrs, templatefallbackAttrs } = require('../../plots/template_attributes');
 var baseAttrs = require('../../plots/attributes');
 var extendFlat = require('../../lib/extend').extendFlat;
 
@@ -98,6 +98,7 @@ module.exports = extendFlat(
 
         hoverinfo: choroplethAttrs.hoverinfo,
         hovertemplate: hovertemplateAttrs({}, { keys: ['properties'] }),
+        hovertemplatefallback: templatefallbackAttrs(),
         showlegend: extendFlat({}, baseAttrs.showlegend, { dflt: false })
     },
 

diff --git a/src/traces/choroplethmapbox/attributes.js b/src/traces/choroplethmapbox/attributes.js
@@ -2,7 +2,7 @@
 
 var choroplethAttrs = require('../choropleth/attributes');
 var colorScaleAttrs = require('../../components/colorscale/attributes');
-var hovertemplateAttrs = require('../../plots/template_attributes').hovertemplateAttrs;
+const { hovertemplateAttrs, templatefallbackAttrs } = require('../../plots/template_attributes');
 var baseAttrs = require('../../plots/attributes');
 var extendFlat = require('../../lib/extend').extendFlat;
 
@@ -98,6 +98,7 @@ module.exports = extendFlat(
 
         hoverinfo: choroplethAttrs.hoverinfo,
         hovertemplate: hovertemplateAttrs({}, { keys: ['properties'] }),
+        hovertemplatefallback: templatefallbackAttrs(),
         showlegend: extendFlat({}, baseAttrs.showlegend, { dflt: false })
     },
 

diff --git a/src/traces/cone/attributes.js b/src/traces/cone/attributes.js
@@ -2,7 +2,7 @@
 
 var colorScaleAttrs = require('../../components/colorscale/attributes');
 var axisHoverFormat = require('../../plots/cartesian/axis_format_attributes').axisHoverFormat;
-var hovertemplateAttrs = require('../../plots/template_attributes').hovertemplateAttrs;
+const { hovertemplateAttrs, templatefallbackAttrs } = require('../../plots/template_attributes');
 var mesh3dAttrs = require('../mesh3d/attributes');
 var baseAttrs = require('../../plots/attributes');
 
@@ -146,6 +146,7 @@ var attrs = {
     },
 
     hovertemplate: hovertemplateAttrs({ editType: 'calc' }, { keys: ['norm'] }),
+    hovertemplatefallback: templatefallbackAttrs(),
     uhoverformat: axisHoverFormat('u', 1),
     vhoverformat: axisHoverFormat('v', 1),
     whoverformat: axisHoverFormat('w', 1),

diff --git a/src/traces/contour/attributes.js b/src/traces/contour/attributes.js
@@ -42,12 +42,14 @@ module.exports = extendFlat(
         yhoverformat: axisHoverFormat('y'),
         zhoverformat: axisHoverFormat('z', 1),
         hovertemplate: heatmapAttrs.hovertemplate,
+        hovertemplatefallback: heatmapAttrs.hovertemplatefallback,
         texttemplate: extendFlat({}, heatmapAttrs.texttemplate, {
             description: [
                 'For this trace it only has an effect if `coloring` is set to *heatmap*.',
                 heatmapAttrs.texttemplate.description
             ].join(' ')
         }),
+        texttemplatefallback: heatmapAttrs.texttemplatefallback,
         textfont: extendFlat({}, heatmapAttrs.textfont, {
             description: [
                 'For this trace it only has an effect if `coloring` is set to *heatmap*.',

diff --git a/src/traces/densitymap/attributes.js b/src/traces/densitymap/attributes.js
@@ -1,7 +1,7 @@
 'use strict';
 
 var colorScaleAttrs = require('../../components/colorscale/attributes');
-var hovertemplateAttrs = require('../../plots/template_attributes').hovertemplateAttrs;
+const { hovertemplateAttrs, templatefallbackAttrs } = require('../../plots/template_attributes');
 var baseAttrs = require('../../plots/attributes');
 var scatterMapAttrs = require('../scattermap/attributes');
 
@@ -76,6 +76,7 @@ module.exports = extendFlat(
             flags: ['lon', 'lat', 'z', 'text', 'name']
         }),
         hovertemplate: hovertemplateAttrs(),
+        hovertemplatefallback: templatefallbackAttrs(),
         showlegend: extendFlat({}, baseAttrs.showlegend, { dflt: false })
     },
     colorScaleAttrs('', {

diff --git a/src/traces/densitymapbox/attributes.js b/src/traces/densitymapbox/attributes.js
@@ -1,7 +1,7 @@
 'use strict';
 
 var colorScaleAttrs = require('../../components/colorscale/attributes');
-var hovertemplateAttrs = require('../../plots/template_attributes').hovertemplateAttrs;
+const { hovertemplateAttrs, templatefallbackAttrs } = require('../../plots/template_attributes');
 var baseAttrs = require('../../plots/attributes');
 var scatterMapboxAttrs = require('../scattermapbox/attributes');
 
@@ -76,6 +76,7 @@ module.exports = extendFlat(
             flags: ['lon', 'lat', 'z', 'text', 'name']
         }),
         hovertemplate: hovertemplateAttrs(),
+        hovertemplatefallback: templatefallbackAttrs(),
         showlegend: extendFlat({}, baseAttrs.showlegend, { dflt: false })
     },
     colorScaleAttrs('', {

diff --git a/src/traces/funnel/attributes.js b/src/traces/funnel/attributes.js
@@ -4,8 +4,7 @@ var barAttrs = require('../bar/attributes');
 var lineAttrs = require('../scatter/attributes').line;
 var baseAttrs = require('../../plots/attributes');
 var axisHoverFormat = require('../../plots/cartesian/axis_format_attributes').axisHoverFormat;
-var hovertemplateAttrs = require('../../plots/template_attributes').hovertemplateAttrs;
-var texttemplateAttrs = require('../../plots/template_attributes').texttemplateAttrs;
+const { hovertemplateAttrs, texttemplateAttrs, templatefallbackAttrs } = require('../../plots/template_attributes');
 var constants = require('./constants');
 var extendFlat = require('../../lib/extend').extendFlat;
 var Color = require('../../components/color');
@@ -28,12 +27,8 @@ module.exports = {
     yhoverformat: axisHoverFormat('y'),
 
     hovertext: barAttrs.hovertext,
-    hovertemplate: hovertemplateAttrs(
-        {},
-        {
-            keys: constants.eventDataKeys
-        }
-    ),
+    hovertemplate: hovertemplateAttrs({}, { keys: constants.eventDataKeys }),
+    hovertemplatefallback: templatefallbackAttrs(),
 
     hoverinfo: extendFlat({}, baseAttrs.hoverinfo, {
         flags: ['name', 'x', 'y', 'text', 'percent initial', 'percent previous', 'percent total']
@@ -52,12 +47,8 @@ module.exports = {
         ].join(' ')
     },
     // TODO: incorporate `label` and `value` in the eventData
-    texttemplate: texttemplateAttrs(
-        { editType: 'plot' },
-        {
-            keys: constants.eventDataKeys.concat(['label', 'value'])
-        }
-    ),
+    texttemplate: texttemplateAttrs({ editType: 'plot' }, { keys: constants.eventDataKeys.concat(['label', 'value']) }),
+    texttemplatefallback: templatefallbackAttrs(),
 
     text: barAttrs.text,
     textposition: barAttrs.textposition,

diff --git a/src/traces/funnelarea/attributes.js b/src/traces/funnelarea/attributes.js
@@ -3,8 +3,7 @@
 var pieAttrs = require('../pie/attributes');
 var baseAttrs = require('../../plots/attributes');
 var domainAttrs = require('../../plots/domain').attributes;
-var hovertemplateAttrs = require('../../plots/template_attributes').hovertemplateAttrs;
-var texttemplateAttrs = require('../../plots/template_attributes').texttemplateAttrs;
+const { hovertemplateAttrs, texttemplateAttrs, templatefallbackAttrs } = require('../../plots/template_attributes');
 
 var extendFlat = require('../../lib/extend').extendFlat;
 
@@ -47,23 +46,15 @@ module.exports = {
         flags: ['label', 'text', 'value', 'percent']
     }),
 
-    texttemplate: texttemplateAttrs(
-        { editType: 'plot' },
-        {
-            keys: ['label', 'color', 'value', 'text', 'percent']
-        }
-    ),
+    texttemplate: texttemplateAttrs({ editType: 'plot' }, { keys: ['label', 'color', 'value', 'text', 'percent'] }),
+    texttemplatefallback: templatefallbackAttrs(),
 
     hoverinfo: extendFlat({}, baseAttrs.hoverinfo, {
         flags: ['label', 'text', 'value', 'percent', 'name']
     }),
 
-    hovertemplate: hovertemplateAttrs(
-        {},
-        {
-            keys: ['label', 'color', 'value', 'text', 'percent']
-        }
-    ),
+    hovertemplate: hovertemplateAttrs({}, { keys: ['label', 'color', 'value', 'text', 'percent'] }),
+    hovertemplatefallback: templatefallbackAttrs(),
 
     textposition: extendFlat({}, pieAttrs.textposition, {
         values: ['inside', 'none'],

diff --git a/src/traces/heatmap/attributes.js b/src/traces/heatmap/attributes.js
@@ -1,14 +1,12 @@
 'use strict';
 
-var scatterAttrs = require('../scatter/attributes');
-var baseAttrs = require('../../plots/attributes');
-var fontAttrs = require('../../plots/font_attributes');
-var axisHoverFormat = require('../../plots/cartesian/axis_format_attributes').axisHoverFormat;
-var hovertemplateAttrs = require('../../plots/template_attributes').hovertemplateAttrs;
-var texttemplateAttrs = require('../../plots/template_attributes').texttemplateAttrs;
-var colorScaleAttrs = require('../../components/colorscale/attributes');
-
-var extendFlat = require('../../lib/extend').extendFlat;
+const colorScaleAttrs = require('../../components/colorscale/attributes');
+const { extendFlat } = require('../../lib/extend');
+const baseAttrs = require('../../plots/attributes');
+const { axisHoverFormat } = require('../../plots/cartesian/axis_format_attributes');
+const fontAttrs = require('../../plots/font_attributes');
+const { hovertemplateAttrs, templatefallbackAttrs, texttemplateAttrs } = require('../../plots/template_attributes');
+const scatterAttrs = require('../scatter/attributes');
 
 module.exports = extendFlat(
     {
@@ -117,15 +115,9 @@ module.exports = extendFlat(
         zhoverformat: axisHoverFormat('z', 1),
 
         hovertemplate: hovertemplateAttrs(),
-        texttemplate: texttemplateAttrs(
-            {
-                arrayOk: false,
-                editType: 'plot'
-            },
-            {
-                keys: ['x', 'y', 'z', 'text']
-            }
-        ),
+        hovertemplatefallback: templatefallbackAttrs(),
+        texttemplate: texttemplateAttrs({ arrayOk: false, editType: 'plot' }, { keys: ['x', 'y', 'z', 'text'] }),
+        texttemplatefallback: templatefallbackAttrs(),
         textfont: fontAttrs({
             editType: 'plot',
             autoSize: true,

diff --git a/src/traces/histogram/attributes.js b/src/traces/histogram/attributes.js
@@ -2,8 +2,7 @@
 
 var barAttrs = require('../bar/attributes');
 var axisHoverFormat = require('../../plots/cartesian/axis_format_attributes').axisHoverFormat;
-var hovertemplateAttrs = require('../../plots/template_attributes').hovertemplateAttrs;
-var texttemplateAttrs = require('../../plots/template_attributes').texttemplateAttrs;
+const { hovertemplateAttrs, texttemplateAttrs, templatefallbackAttrs } = require('../../plots/template_attributes');
 var fontAttrs = require('../../plots/font_attributes');
 var makeBinAttrs = require('./bin_attributes');
 var constants = require('./constants');
@@ -192,22 +191,11 @@ module.exports = {
         ].join(' ')
     },
 
-    hovertemplate: hovertemplateAttrs(
-        {},
-        {
-            keys: constants.eventDataKeys
-        }
-    ),
-
-    texttemplate: texttemplateAttrs(
-        {
-            arrayOk: false,
-            editType: 'plot'
-        },
-        {
-            keys: ['label', 'value']
-        }
-    ),
+    hovertemplate: hovertemplateAttrs({}, { keys: constants.eventDataKeys }),
+    hovertemplatefallback: templatefallbackAttrs(),
+
+    texttemplate: texttemplateAttrs({ arrayOk: false, editType: 'plot' }, { keys: ['label', 'value'] }),
+    texttemplatefallback: templatefallbackAttrs(),
 
     textposition: extendFlat({}, barAttrs.textposition, {
         arrayOk: false

diff --git a/src/traces/histogram2d/attributes.js b/src/traces/histogram2d/attributes.js
@@ -5,8 +5,7 @@ var makeBinAttrs = require('../histogram/bin_attributes');
 var heatmapAttrs = require('../heatmap/attributes');
 var baseAttrs = require('../../plots/attributes');
 var axisHoverFormat = require('../../plots/cartesian/axis_format_attributes').axisHoverFormat;
-var hovertemplateAttrs = require('../../plots/template_attributes').hovertemplateAttrs;
-var texttemplateAttrs = require('../../plots/template_attributes').texttemplateAttrs;
+const { hovertemplateAttrs, texttemplateAttrs, templatefallbackAttrs } = require('../../plots/template_attributes');
 var colorScaleAttrs = require('../../components/colorscale/attributes');
 
 var extendFlat = require('../../lib/extend').extendFlat;
@@ -70,7 +69,9 @@ module.exports = extendFlat(
         yhoverformat: axisHoverFormat('y'),
         zhoverformat: axisHoverFormat('z', 1),
         hovertemplate: hovertemplateAttrs({}, { keys: ['z'] }),
+        hovertemplatefallback: templatefallbackAttrs(),
         texttemplate: texttemplateAttrs({ arrayOk: false, editType: 'plot' }, { keys: ['z'] }),
+        texttemplatefallback: templatefallbackAttrs(),
         textfont: heatmapAttrs.textfont,
         showlegend: extendFlat({}, baseAttrs.showlegend, { dflt: false })
     },