31

If column label text is wider than column width, label text is truncated. Increasing column width is not nice since some texts are long. How to make text to word wrap into multiple lines? Header height should be determined by maximum column height.

Only solution which I found is

jQgrid: multiple column row headers

but this does not implement word wrap of text.

How to implement word wrap of header text ?

Update. I tried Oleg styles for character and word wrap.

Character wrap

    th.ui-th-column div{
word-wrap: break-word; /* IE 5.5+ and CSS3 */
    white-space: pre-wrap; /* CSS3 */
    white-space: -moz-pre-wrap; /* Mozilla, since 1999 */
    white-space: -pre-wrap; /* Opera 4-6 */
    white-space: -o-pre-wrap; /* Opera 7 */
    overflow: hidden;
    height: auto;
    vertical-align: middle;
    padding-top: 3px;
    padding-bottom: 3px

}

shows only half of second line. Third line is not shown at all:

Character wrap does not show third line

Word wrap

  th.ui-th-column div{
   white-space:normal !important;
   height:auto !important;
   padding:2px;
   }

disables column resize for wrapped columns. On those columns moving mouse icon to column divider mouse cursor does not change to sizer. Wrapped columns cannot resized.

How to fix those issues ?

Update 2

I tried character wrap (last sample in Oleg reply). I found issues if column width is decreased so that more lines appear in header:

  1. Column cannot resized if dragging in bottom of column divider: resizer height is not increased on resize.

  2. In IE9 header height increase is not sufficient: last header line is not visible after resize. In fireFox this issue does not occur.

2
  • look at the answer. So in column headers works the same wrapping like in cells. Moreover it is possible to implement character wrapping see here. The same CSS styles could be used in column headers if it needed.
    – Oleg
    Commented Aug 30, 2011 at 16:59
  • @Oleg: Thank you. I tried both methods but encountered issues. I updated question.
    – Andrus
    Commented Aug 30, 2011 at 17:55

3 Answers 3

39

In your example with character wrapping you forgot to use !important after the height: auto setting.

I agree that the problem with column resizer really exists in my demo from the my old answer. So I improved it. Moreover I try to describe in which situations can be important to use character wrapping instead of word wrapping.

The new demo with the word wrapping is here. the code is the following:

var grid = $("#list"), headerRow, rowHight, resizeSpanHeight;

grid.jqGrid({
    ...
});

// get the header row which contains
headerRow = grid.closest("div.ui-jqgrid-view")
    .find("table.ui-jqgrid-htable>thead>tr.ui-jqgrid-labels");

// increase the height of the resizing span
resizeSpanHeight = 'height: ' + headerRow.height() +
    'px !important; cursor: col-resize;';
headerRow.find("span.ui-jqgrid-resize").each(function () {
    this.style.cssText = resizeSpanHeight;
});

// set position of the dive with the column header text to the middle
rowHight = headerRow.height();
headerRow.find("div.ui-jqgrid-sortable").each(function () {
    var ts = $(this);
    ts.css('top', (rowHight - ts.outerHeight()) / 2 + 'px');
});

It use the following CSS

th.ui-th-column div {
    white-space: normal !important;
    height: auto !important;
    padding: 2px;
}

and produce the following picture

enter image description here

(I included <br/> after every character in the first column to make the text "Inv No" by placed on many rows).

Everything look very good, but it can be some situations that you can one very long word in the column header. Some languages like German build sometimes long words like "Softwareberetstellungsform" which consist from many words. In the example it was "Software", "bereitstellung" and "form". In other languages the same situation is also possible, but is not so frequently. As a result one will receive the following (less perfect) picture (see the demo here):

enter image description here

You can see that the texts "AmountInEUR", "TaxInEUR" and "TotalInEUR" are cut off. One can either include manual line brakes (<br/>) in the column text or use character wrapping which I described in the answer. If we change only the described above CSS for th.ui-th-column div to the following

th.ui-th-column div {
    word-wrap: break-word; /* IE 5.5+ and CSS3 */
    white-space: pre-wrap; /* CSS3 */
    white-space: -moz-pre-wrap; /* Mozilla, since 1999 */
    white-space: -pre-wrap; /* Opera 4-6 */
    white-space: -o-pre-wrap; /* Opera 7 */
    overflow: hidden;
    height: auto !important;
    vertical-align: middle;
}

we will receive the following results (see the demo here)

enter image description here

By the way the character wrapping work in some browsers like Google Chrome as word wrapping (!!!) if the text contains spaces. So the demo will be displayed in Google Chrome, Safari, Opera, Firefox like in the picture above with the word wrapping, but the same demo in IE (inclusive IE9) will be seen as

enter image description here

So no way is absolutely perfect, but the character wrapping have some advantages for all modern web browsers with the exception Internet Explorer (version < 10). The usage of <br/> inside of column text or the usage of CSS which depend on the currently used web browser can make the solution much better.

27
  • thank you very much. I marked and upvoted answer. Also I encountered some issues and updated question about those
    – Andrus
    Commented Aug 31, 2011 at 15:51
  • 2
    header manipulation code should be executed from resizeStop event also if header height is increased
    – Andrus
    Commented Aug 31, 2011 at 16:20
  • @Andrus: You are welcome! I full agree that the recalculation of the top and height parameters should be done on resizeStop event. I will change the code of the demos to make other people to use the better code at the beginning.
    – Oleg
    Commented Aug 31, 2011 at 16:44
  • it looks like resize span width is also too small, resizing requires presice postioning. Maybe to make it a bit wider also.
    – Andrus
    Commented Aug 31, 2011 at 17:28
  • 2
    @Andrus: I am not sure that I correct understand what setting you want to increase. The margin-top and margin-bottom can be set to 0: margin-top: 0px; margin-bottom: 0px;. To increase the width of the resize area one will be probably make the area over the div with the text. Currently the area has the width 2px which corresponds to the padding of the padding-right of the div with the text.
    – Oleg
    Commented Aug 31, 2011 at 17:43
19
<style type="text/css">
    .ui-jqgrid .ui-jqgrid-htable th div
    {
        height: auto;
        overflow: hidden;
        padding-right: 4px;
        padding-top: 2px;
        position: relative;
        vertical-align: text-top;
        white-space: normal !important;
    }
</style>
1
  • Thank you so much for sharing this!!
    – swiftBoy
    Commented Feb 15, 2017 at 15:53
4
Following code wraps row data

.ui-jqgrid tr.jqgrow td
    {           
        word-wrap: break-word; /* IE 5.5+ and CSS3 */
        white-space: pre-wrap; /* CSS3 */
        white-space: -pre-wrap; /* Opera 4-6 */
        white-space: -o-pre-wrap; /* Opera 7 */
        white-space: normal !important;
        height: auto;
        vertical-align: text-top;
        padding-top: 2px;
        padding-bottom: 3px;
    }

Following code wraps table header data    
    .ui-jqgrid .ui-jqgrid-htable th div
        {
          word-wrap: break-word; /* IE 5.5+ and CSS3 */
        white-space: pre-wrap; /* CSS3 */
        white-space: -pre-wrap; /* Opera 4-6 */
        white-space: -o-pre-wrap; /* Opera 7 */
        white-space: normal !important;
        height: auto;
        vertical-align: text-top;
        padding-top: 2px;
        padding-bottom: 3px;
        }

Not the answer you're looking for? Browse other questions tagged or ask your own question.