Line break in categorical axis labels

[bsteubing]

Feature request (similar to #7317)

Please introduce some straightforward way to include line breaks (e.g. "\n" or "<br>") in labels of categorical axes (currently these are ignored):

factors = ["a very long label \n that needs a break", 
           "a very long label \\n that needs a break",  
           "a very long label <br> that needs a break", 
          ]
x = [50, 40, 65,]
p = figure(y_range=factors)
p.circle(x, factors, size=15, fill_color="orange", line_color="green", line_width=3)
show(p)

[bryevdv]

Unfortunately this is probably not a trivial amount of work, and is also not an especially common use case. So I am not sure when we would be justified in prioritizing it. If you really need long labels, you could use actual Label annotations for the long text and keep the categories themselves short.

[bsteubing]

Thank you, but at least in this example, the Label annotation possibility, looks a bit complicated: https://stackoverflow.com/questions/44955652/insert-a-newline-character-into-a-categorical-axis-factor-label-in-bokehjs

Our standard case is unfortunately that we have long category labels (mainly for hbar charts). Currently we implement this in matplotlib

The reason we are considering to switch to bokeh is its interactiveness.

If html could be passed instead of a string to the category labels that would be an ideal solution for us... see e.g. plotly's solution: https://plot.ly/python/horizontal-bar-charts/ (below Color Palette for Bar Chart)
But I assume you have considered this already when you say this is a non-trivial amount of work.

[bryevdv]

But I assume you have considered this already when you say this is a non-trivial amount of work.

Yes. Currently axis and tick labels are drawn directly on an HTML canvas, which is what has limitations such as no automatic handling of line breaks. Having a general ability to render and position labels as divs containing HTML instead, would indeed be useful for this and other things e.g. LaTeX labels (but it would also come with its own tradeoffs, such floating divs would not work with SVG exports for example). However as I said it is by no means trivial to make that work, there are many important, competing priorities and very limited resources. If you are interested in working on it, I'm happy to provide any guidance.

[Kprzeorski]

Having line breaks for x_axis_label would alleviate my problem. Just another user to vote for this feature... if you ever get the time/resources to do it.

[birdsarah]

Just adding my voice to needing this. I'm not sure about your categorization of uncommon @bryevdv.

[mattpap]

I will tentatively add this to 1.0 milestone, because I made a preliminary implementation. That was the easy part. The harder part is to get around mine fields like apply_label_text_heuristics(), so some more effort will be needed to get a fully functional implementation.