在 ExtJS 的表格中,我們常希望當滑鼠移到某個儲存格上時能顯示提示訊息,方便使用者查看完整內容。這可以透過 column 的 renderer 函式,配合 metaData.attr 設定 ext:qtip 屬性來實現。以下範例示範了這個做法。
首先,需引入 ExtJS 提供的 qtips 範例腳本:
<script type="text/javascript" src="${pageContext.request.contextPath }/extjs/examples/simple-widgets/qtips.js"></script>
接著在欄位的 renderer 中,依業務規則決定要顯示的內容,並把它寫入 metaData.attr 的 ext:qtip 屬性:
renderer: function(value, metaData, record, rowIndex, colIndex, store) {
// 依業務規則決定顯示內容
// metaData.css : 加入 TD 元素的 CSS class 名稱
// metaData.attr : 套用於資料容器元素的 HTML 屬性字串(如 'style="color:red;"')
metaData.attr = 'ext:qtip="' + value + '"';
return value;
}
其運作原理是:renderer 回傳的 value 會作為儲存格的顯示內容,而透過設定 metaData.attr 為 ext:qtip="...",ExtJS 便會在該儲存格上掛載一個提示框。如此一來,當使用者將滑鼠停留在儲存格上時,就會看到對應的提示文字,大幅提升資料表格的可讀性與操作體驗。