DIV CSS 佈局教程網

jQuery easyUI DataGrid 欄位內容過長時自動截字加省略符號
編輯:JavaScript綜合知識     

DataGrid 的欄位內容太長會撐開列高、破壞版面。實務上常見的做法是在 formatter 中依欄位寬度估算可容納的字數,超出就截斷並補上「..」。

formatter 實作

columns: [[
    {
        field: "activitycontent",
        title: '活動內容',
        width: fixWidth(0.18),
        align: "center",
        halign: "center",
        formatter: function (value, rec) {
            if (value.indexOf("src") < 0) {          // 含圖片標籤者不截斷
                var limit = Math.ceil(document.documentElement.clientWidth * 0.18) / 11.5;
                if (rec.activitycontent.length > limit) {
                    return rec.activitycontent.substring(0, limit) + '..';
                } else {
                    return rec.activitycontent.substring(0, limit);
                }
            }
        }
    }
    // {...其他欄位}
]]

幾個關鍵常數的意義

  • activitycontent 與 0.18 必須一致。前者是欄位名稱,後者是欄位佔整體寬度的比例。這裡的 fixWidth(0.18) 與運算式中的 0.18 講的是同一件事——欄位佔畫面寬度的 18%。兩邊若不同步修改,截字位置就會失準。
  • 11.5 是每個漢字平均佔的像素寬。用「欄位像素寬 ÷ 單字寬」估算可顯示字數。這個數字會隨字型與 font-size 而變,需要依實際版面調整;英文或數字較窄,混排時估算難免有誤差。
  • 用 indexOf("src") 排除圖片內容。若欄位裡嵌了 <img>,截斷會破壞標籤結構,所以直接跳過處理。

效果對照

超出長度:測試長度8 測試長度74 測試..
未超長:  測試長度8 測試長度74 測試

更好的替代做法

靠「字數估算」终究不精準,因為它無法處理中英混排、可變字型與不同 DPI。若你的環境允許,改用 CSS 是更穩健的方案:

.datagrid-cell {
    overflow: hidden;
    white-space: nowrap;
    text-overflow: ellipsis;   /* 由瀏覽器依真實寬度決定截在哪裡 */
}

瀏覽器知道字型的實際度量,因此 text-overflow: ellipsis 永遠能給出正確的截斷點,還會自動顯示標準的省略號「…」。若要讓滑鼠移上去看全文,再搭配 title 屬性即可:

formatter: function (value) {
    return '<span title="' + value + '">' + value + '</span>';
}

此外,easyUI 的 DataGrid 本身支援 nowrap: false 讓內容自動換行並撐高列高,若版面允許變高,這往往比截字更符合使用者期待。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved