update cliponaxis description

Author: emilykl

draftlogs/7558_fix.md

@@ -0,0 +1 @@
+ - Set `cliponaxis: false` by default for bar traces with `text` and `textposition: 'outside'`, to prevent text clipping [#7558](https://github.com/plotly/plotly.js/pull/7558)

src/traces/scatter/attributes.js

@@ -362,7 +362,9 @@ module.exports = {
             'Determines whether or not markers and text nodes',
             'are clipped about the subplot axes.',
             'To show markers and text nodes above axis lines and tick labels,',
-            'make sure to set `xaxis.layer` and `yaxis.layer` to *below traces*.'
+            'make sure to set `xaxis.layer` and `yaxis.layer` to *below traces*.',
+            'Defaults to *true*, except for bar traces with `textposition` set to *outside*',
+            'in which case the default is *false*.'
         ].join(' ')
     },
 

test/plot-schema.json

@@ -58647,7 +58647,7 @@
      "valType": "string"
     },
     "cliponaxis": {
-     "description": "Determines whether or not markers and text nodes are clipped about the subplot axes. To show markers and text nodes above axis lines and tick labels, make sure to set `xaxis.layer` and `yaxis.layer` to *below traces*.",
+     "description": "Determines whether or not markers and text nodes are clipped about the subplot axes. To show markers and text nodes above axis lines and tick labels, make sure to set `xaxis.layer` and `yaxis.layer` to *below traces*. Defaults to *true*, except for bar traces with `textposition` set to *outside* in which case the default is *false*.",
      "dflt": true,
      "editType": "plot",
      "valType": "boolean"
@@ -74276,7 +74276,7 @@
    "animatable": false,
    "attributes": {
     "cliponaxis": {
-     "description": "Determines whether or not markers and text nodes are clipped about the subplot axes. To show markers and text nodes above axis lines and tick labels, make sure to set `xaxis.layer` and `yaxis.layer` to *below traces*.",
+     "description": "Determines whether or not markers and text nodes are clipped about the subplot axes. To show markers and text nodes above axis lines and tick labels, make sure to set `xaxis.layer` and `yaxis.layer` to *below traces*. Defaults to *true*, except for bar traces with `textposition` set to *outside* in which case the default is *false*.",
      "dflt": false,
      "editType": "plot",
      "valType": "boolean"
@@ -78753,7 +78753,7 @@
    "animatable": false,
    "attributes": {
     "cliponaxis": {
-     "description": "Determines whether or not markers and text nodes are clipped about the subplot axes. To show markers and text nodes above axis lines and tick labels, make sure to set `xaxis.layer` and `yaxis.layer` to *below traces*.",
+     "description": "Determines whether or not markers and text nodes are clipped about the subplot axes. To show markers and text nodes above axis lines and tick labels, make sure to set `xaxis.layer` and `yaxis.layer` to *below traces*. Defaults to *true*, except for bar traces with `textposition` set to *outside* in which case the default is *false*.",
      "dflt": false,
      "editType": "plot",
      "valType": "boolean"
@@ -81062,7 +81062,7 @@
      "valType": "data_array"
     },
     "cliponaxis": {
-     "description": "Determines whether or not markers and text nodes are clipped about the subplot axes. To show markers and text nodes above axis lines and tick labels, make sure to set `xaxis.layer` and `yaxis.layer` to *below traces*.",
+     "description": "Determines whether or not markers and text nodes are clipped about the subplot axes. To show markers and text nodes above axis lines and tick labels, make sure to set `xaxis.layer` and `yaxis.layer` to *below traces*. Defaults to *true*, except for bar traces with `textposition` set to *outside* in which case the default is *false*.",
      "dflt": true,
      "editType": "plot",
      "valType": "boolean"