René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[Feature Request]: Support wrapping text relative to axes boundaries","articleBody":"### Feature Request Summary\n\nThis feature request proposes an optional axes-aware text wrapping enhancement for Text objects attached to axes.\n\nCurrently, wrap=True wraps text relative to the figure boundary, which is consistent with the documented behavior of set_wrap:\n\n“Wrapping makes sure the text is confined to the (sub)figure box. It does not take into account any other artists.”\n\nHowever, in constrained multi-panel layouts, wrapping relative to the axes boundary can help prevent text from visually overlapping neighboring axes.\n\nThis feature request explores adding an optional axes-based wrapping mode while preserving the existing default behavior for backward compatibility.\n### Code for reproduction\n\n```Python\nimport matplotlib.pyplot as plt\n\nfig, (ax1, ax2) = plt.subplots(1, 2, figsize=(6, 4))\n\nax1.set_title(\"Left Axes\")\nax1.text(0.05, 0.5,\n         \"This is a very long string that should wrap within the axes boundary and not overflow outside it\",\n         wrap=True, transform=ax1.transAxes, va='center')\n\nax2.set_title(\"Right Axes\")\nax2.text(0.05, 0.5,\n         \"This is a very long string that should wrap within the axes boundary and not overflow outside it\",\n         wrap=True, transform=ax2.transAxes, va='center')\n\nplt.show()\n```\n\n### Actual outcome\n\nText overflows outside the axes boundary into adjacent axes \nor outside the figure. The text appears on a single line \nignoring the axes boundary completely.\n\n\u003cimg width=\"1918\" height=\"1198\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/bddec8cc-0f57-4e95-9600-4c5c688c6b7c\" /\u003e\n\n### Expected outcome\n\nText should wrap within the axes boundary, staying inside \nthe axes it belongs to.\n\n\u003cimg width=\"1918\" height=\"1198\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/497da3f2-466f-4a7d-ac55-fbf15e5c4aac\" /\u003e\n\n### Additional information\n\nThe root cause is in _get_wrap_line_width() in text.py. \nIt always uses the figure boundary:\n\n    figure_box = self.get_figure().get_window_extent()\n\nIt should check whether the text belongs to an axes first \nand use the axes boundary instead:\n\n    if self.axes is not None:\n        clip_box = self.axes.get_window_extent()\n    else:\n        clip_box = self.get_figure().get_window_extent()\n\n### Operating system\n\nWindows 11\n\n### Matplotlib Version\n\n3.10.9\n\n### Matplotlib Backend\n\n_No response_\n\n### Python version\n\n_No response_\n\n### Jupyter version\n\n_No response_\n\n### Installation\n\npip","author":{"url":"https://github.com/codegnan-dm","@type":"Person","name":"codegnan-dm"},"datePublished":"2026-05-08T09:52:06.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":2},"url":"https://github.com/31635/matplotlib/issues/31635"}