Add labelalias to various axes

draftlogs/6481_add.md

@@ -0,0 +1 @@
+ - Add `labelalias` to various axes namely cartesian, gl3d, polar, smith, ternary, carpet, indicator and colorbar [[#6481](https://github.com/plotly/plotly.js/pull/6481)]

src/components/colorbar/attributes.js

@@ -168,6 +168,7 @@ module.exports = overrideAll({
     tickcolor: axesAttrs.tickcolor,
     ticklabelstep: axesAttrs.ticklabelstep,
     showticklabels: axesAttrs.showticklabels,
+    labelalias: axesAttrs.labelalias,
     tickfont: fontAttrs({
         description: 'Sets the color bar\'s tick label font'
     }),

src/components/colorbar/draw.js

@@ -931,6 +931,7 @@ function mockColorBarAxis(gd, opts, zrange) {
         tickwidth: opts.tickwidth,
         tickcolor: opts.tickcolor,
         showticklabels: opts.showticklabels,
+        labelalias: opts.labelalias,
         ticklabelposition: opts.ticklabelposition,
         ticklabeloverflow: opts.ticklabeloverflow,
         ticklabelstep: opts.ticklabelstep,

src/plots/cartesian/axes.js

@@ -1660,6 +1660,11 @@ axes.tickText = function(ax, x, hover, noSuffixPrefix) {
         if(ax.ticksuffix && !isHidden(ax.showticksuffix)) out.text += ax.ticksuffix;
     }
 
+    if(ax.labelalias) {
+        var t = ax.labelalias[out.text];
+        if(typeof t === 'string') out.text = t;
+    }
+
     // Setup ticks and grid lines boundaries
     // at 1/2 a 'category' to the left/bottom
     if(ax.tickson === 'boundaries' || ax.showdividers) {

src/plots/cartesian/layout_attributes.js

@@ -633,6 +633,17 @@ module.exports = {
         editType: 'ticks',
         description: 'Determines whether or not the tick labels are drawn.'
     },
+    labelalias: {
+        valType: 'any',
+        dflt: false,
+        editType: 'ticks',
+        description: [
+            'Determines the alias for certain labels for ticks and hover.',
+            'For example using {US: \'USA\', CA: \'Canada\'} maps US to USA',
+            'and CA to Canada if tick or hover labels match US or Canada i.e.',
+            'after adding prefix and suffix to labels.'
+        ].join(' ')
+    },
     automargin: {
         valType: 'flaglist',
         flags: ['height', 'width', 'left', 'right', 'top', 'bottom'],

src/plots/cartesian/tick_label_defaults.js

@@ -8,6 +8,9 @@ var handleArrayContainerDefaults = require('../array_container_defaults');
 
 module.exports = function handleTickLabelDefaults(containerIn, containerOut, coerce, axType, options) {
     if(!options) options = {};
+
+    coerce('labelalias');
+
     var showAttrDflt = getShowAttrDflt(containerIn);
 
     var showTickLabels = coerce('showticklabels');

src/plots/gl3d/layout/axis_attributes.js

@@ -86,6 +86,7 @@ module.exports = overrideAll({
     tickwidth: axesAttrs.tickwidth,
     tickcolor: axesAttrs.tickcolor,
     showticklabels: axesAttrs.showticklabels,
+    labelalias: axesAttrs.labelalias,
     tickfont: axesAttrs.tickfont,
     tickangle: axesAttrs.tickangle,
     tickprefix: axesAttrs.tickprefix,

src/plots/polar/layout_attributes.js

@@ -35,6 +35,7 @@ var axisTickAttrs = overrideAll({
     tickcolor: axesAttrs.tickcolor,
     ticklabelstep: axesAttrs.ticklabelstep,
     showticklabels: axesAttrs.showticklabels,
+    labelalias: axesAttrs.labelalias,
     showtickprefix: axesAttrs.showtickprefix,
     tickprefix: axesAttrs.tickprefix,
     showticksuffix: axesAttrs.showticksuffix,

src/plots/smith/layout_attributes.js

@@ -22,6 +22,7 @@ var axisTickAttrs = overrideAll({
     tickwidth: extendFlat({}, axesAttrs.tickwidth, {dflt: 2}),
     tickcolor: axesAttrs.tickcolor,
     showticklabels: axesAttrs.showticklabels,
+    labelalias: axesAttrs.labelalias,
     showtickprefix: axesAttrs.showtickprefix,
     tickprefix: axesAttrs.tickprefix,
     showticksuffix: axesAttrs.showticksuffix,

src/plots/ternary/layout_attributes.js

@@ -27,6 +27,7 @@ var ternaryAxesAttrs = {
     tickcolor: axesAttrs.tickcolor,
     ticklabelstep: axesAttrs.ticklabelstep,
     showticklabels: axesAttrs.showticklabels,
+    labelalias: axesAttrs.labelalias,
     showtickprefix: axesAttrs.showtickprefix,
     tickprefix: axesAttrs.tickprefix,
     showticksuffix: axesAttrs.showticksuffix,

src/traces/carpet/axis_attributes.js

@@ -185,6 +185,7 @@ module.exports = {
             'the high side, both, or neither side of the axis.'
         ].join(' ')
     },
+    labelalias: extendFlat({}, axesAttrs.labelalias, {editType: 'calc'}),
     tickfont: fontAttrs({
         editType: 'calc',
         description: 'Sets the tick font.'

src/traces/indicator/attributes.js

@@ -319,6 +319,7 @@ module.exports = {
             tickcolor: axesAttrs.tickcolor,
             ticklabelstep: axesAttrs.ticklabelstep,
             showticklabels: axesAttrs.showticklabels,
+            labelalias: axesAttrs.labelalias,
             tickfont: fontAttrs({
                 description: 'Sets the color bar\'s tick label font'
             }),

test/image/mocks/carpet_grid_dash.json

@@ -37,6 +37,7 @@
         "minorgriddash": "dash"
       },
       "baxis": {
+        "labelalias": { "0": "ZERO" },
         "minorgridcount": 3,
         "gridcolor": "black",
         "minorgridcolor": "red",

test/image/mocks/grid_subplot_types.json

@@ -13,18 +13,23 @@
       "domain": {"row": 2, "column": 0}
     },
     {"type": "scattergeo", "lon": [0, -75], "lat": [0, 45], "marker": {"size": [20, 30]}},
-    {"type": "heatmap", "z": [[1, 2], [4, 1]], "showscale": false, "xaxis": "x3", "yaxis": "y3"}
+    {"type": "heatmap", "z": [[1, 2], [4, 1]], "showscale": true, "xaxis": "x3", "yaxis": "y3", "colorbar": {
+      "yanchor": "bottom",
+      "y": 0,
+      "len": 0.3,
+      "labelalias": {"2": "TWO"}
+    }}
   ],
   "layout": {
-    "xaxis": {"title": {"text": "x"}},
-    "xaxis2": {"title": {"text": "x2"}},
-    "yaxis": {"title": {"text": "y"}},
-    "yaxis2": {"title": {"text": "y2"}},
-    "xaxis3": {"title": {"text": "x3"}},
-    "yaxis3": {"title": {"text": "y3"}},
+    "xaxis": {"title": {"text": "x"}, "labelalias": {"0": "ZERO"}},
+    "xaxis2": {"title": {"text": "x2"}, "labelalias": {"0": "ZERO"}},
+    "yaxis": {"title": {"text": "y"}, "labelalias": {"0": "ZERO"}},
+    "yaxis2": {"title": {"text": "y2"}, "labelalias": {"0": "ZERO"}},
+    "xaxis3": {"title": {"text": "x3"}, "labelalias": {"0": "ZERO"}},
+    "yaxis3": {"title": {"text": "y3"}, "labelalias": {"0": "ZERO"}},
     "grid": {"rows": 3, "columns": 3, "xgap": 0.3, "ygap": 0.3},
-    "scene": {"domain": {"row": 1, "column": 1}},
-    "ternary": {"domain": {"row": 1, "column": 2}},
+    "scene": {"domain": {"row": 1, "column": 1}, "zaxis": {"labelalias": {"2": "TWO"}}},
+    "ternary": {"domain": {"row": 1, "column": 2}, "caxis": {"labelalias": {"1": "ONE"}}},
     "geo": {"domain": {"row": 2, "column": 1}},
     "width": 700,
     "height": 700

test/image/mocks/indicator_bullet.json

@@ -14,6 +14,9 @@
     "gauge": {
       "shape": "bullet",
       "axis": {
+        "labelalias": {
+          "0": "ZERO"
+        },
         "range": [null, 300]
       },
       "threshold": {

test/image/mocks/indicator_format_extremes.json

@@ -171,6 +171,13 @@
         {
             "type": "indicator",
             "mode": "number+delta+gauge",
+            "gauge": {
+                "axis": {
+                    "labelalias": {
+                        "1": "ONE"
+                    }
+                }
+            },
             "title": {
                 "text": "null"
             },

test/image/mocks/polar_blank.json

@@ -33,6 +33,9 @@
         "x": [0, 0.46],
         "y": [0.56, 1]
       },
+      "angularaxis": {
+        "labelalias": { "0": "ZERO" }
+      },
       "radialaxis": {
         "title": {"text": "blank"},
         "angle": 180

test/image/mocks/smith_blank.json

@@ -41,6 +41,9 @@
         "x": [0, 0.46],
         "y": [0.56, 1]
       },
+      "imaginaryaxis": {
+        "labelalias": { "0": "ZERO" }
+      },
       "realaxis": {
         "side": "top"
       }