Document attr_labels (#1677)

Author: Azaya89

doc/ref/plotting_options/data.ipynb

@@ -13,6 +13,55 @@
     "```"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "(option-attr_labels)=\n",
+    "## `attr_labels`\n",
+    "\n",
+    "The `attr_labels` option controls whether hvPlot automatically uses xarray object attributes as labels for dimensions in your plots. This feature helps create more descriptive plots by extracting meaningful labels and units from your xarray data's metadata.\n",
+    "\n",
+    "When set to `True`, hvPlot will look for `long_name` attributes to use as dimension labels and `units` attributes to add unit information. If set to `None` (the default), hvPlot attempts to extract labels without showing warnings if attributes aren't found. Setting it to `False` disables this automatic labeling behavior entirely.\n",
+    "\n",
+    ":::{note}\n",
+    "This option only applies to xarray data objects that contain attributes. It has no effect on pandas DataFrames or other data types.\n",
+    ":::"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import hvplot.xarray # noqa\n",
+    "\n",
+    "ds = hvplot.sampledata.air_temperature(\"xarray\").sel(time='2014-02-25 12:00')\n",
+    "print(\"Longitude coordinates:\", ds.coords['lon'].attrs)\n",
+    "print(\"Latitude coordinates:\", ds.coords['lat'].attrs)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "plot1 = ds.hvplot.image(\n",
+    "    title=\"attr_labels=None (default)\",\n",
+    "    width=350, height=250,\n",
+    ")\n",
+    "\n",
+    "plot2 = ds.hvplot.image(\n",
+    "    attr_labels=False,\n",
+    "    title=\"attr_labels=False\",\n",
+    "    width=350, height=250\n",
+    ")\n",
+    "\n",
+    "plot1 + plot2"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},