DataTables的columns.render屬性

DataTables的一系列文章我在學習中遇到的問題及解決方法的總結芝此,也包含對官方文檔的翻譯,希望能分享給大家,共同進步

columns.render屬性是在DataTables初始化表中需要設置的非常重要的部分

例如初始化一個簡單的表格

const stock_history_table = $('#stock_sort_table').DataTable({
            //這樣配置后拳喻,即可用DT的API來訪問表格數據
            "processing": true,
            "serverSide": true,
            "ajax": {
                "url": '<?php echo base_url(""); ?>' + '/' + stockID + '/' + startDate + '/' + endDate ,
                "type": "GET",
                // "async":true,
                "dataSrc": function(result){
            
                    //給行綁定選中事件
                    $('#stock_sort_table tbody').on( 'click', 'tr', function () {
                        if ($(this).hasClass('selected')) {
                            $(this).removeClass('selected');
                        }
                        else {
                            stock_history_table.$('tr.selected').removeClass('selected');
                            $(this).addClass('selected');
                        }
                    } );

                    return result
                }
            },
            columns: [
                {data: "date"},   // 第一列
                {data: "stock_id"},  // 第二列
                {data: "stock_name"},
                {
                    data: "digest",    // 第四列
                    render:function(data,type,row,meta){   // 通過render屬性返回不同的樣式
                        if (data === "證券買入") {
                            return "<p style='color:red'>" + data + "</p>"
                        } else {
                            return "<p style='color:blue'>" + data + "</p>"
                        }
                    }
                }
            ]
        });

通過ajax獲取到的數據如果需要進一步的處理并且對應到相應的列上,就需要對columns屬性進行設置猪腕。

columns屬性中的每一項對應了從左到右的每一列冗澈,在上面初始化的表中,第一列就是日期陋葡,第二列就是股票名稱亚亲,以此類推,第三列是股票名稱,前三列因為直接將數據展示出來就可以捌归,因此只設置了data屬性肛响,data屬性值是ajax取回來的數據里面對應的數據(如果需要對取回來的數據進行處理,可以在“ajax”屬性中的“dataSrc”屬性對應的函數進行處理)惜索,上表中通過ajax取回的json數據應該如下所示

[{
"date": "2019-08-12 10:42:04",
"stock_id": "000063",
"stock_name": "中興通訊",
"digest": "證券買入",
}]

第四列展示的是證券操作特笋,是買入或者賣出等,我們希望如果是買入顯示為紅色巾兆,如果是賣出顯示為藍色雹有,這種顯示上的變化通過數據處理是很麻煩的,因此我們通過columns中的render屬性對應的函數進行處理臼寄,實現(xiàn)功能霸奕。(這樣也可以對相同的數據進行不同的展示)

以下是官網對于columns.render屬性的介紹,我進行了翻譯和簡化

1. columns.render可以對三種特殊值進行處理
處理方法
undefined 會使用columns.defaultContent的值吉拳,如果沒有指定默認的內容质帅,那么會報錯
null 會使用columns.defaultContent的值,如果沒有指定默認的內容留攒,會將單元格顯示為空
function 將執(zhí)行該函數并使用返回的值煤惩。從DataTables 1.10.1開始,函數將在與行數據對象相同的范圍內執(zhí)行炼邀。這樣做的結果是可以使用對象實例作為行的數據源魄揉。
2. render屬性值的類型為函數時的具體使用方法

render(data,type拭宁,row洛退,meta) 各參數的意義如下:

名稱 類型 可選 備注
1 data Any no 就是此單元格的值(columns.data)
2 type string no 對這個單元格的值的類型進行過濾
3 row Any no 此單元格所在行的整行數據
4 meta object no 用來存儲額外信息(包括row,col杰标,settings)兵怯,row是本單元格的所在行的index(可以通過row().index()拿到),col是本單元格所在列的index(可以通過column().index()拿到)腔剂,settings可以用來獲取這個表的API實例

注:以上四個參數在官網中寫的是不可選媒区,但是我在實際使用中發(fā)現(xiàn)是可選的,如果有知道為什么的朋友可以在評論區(qū)討論

3. 開發(fā)實例
  • 返回的是從數組對象中獲取的以逗號分隔的列表(返回一個字符串)
$('#example').dataTable( {
  "ajaxSource": "sources/deep.txt",
  "columns": [
    { "data": "engine" },
    { "data": "browser" },
    {
      "data": "platform",
      "render": "[, ].name"
    }
  ]
} );
  • 作為一個對象掸犬,為不同的類型提取不同的數據
// This would be used with a data source such as:
//   { "phone": 5552368, "phone_filter": "5552368 555-2368", "phone_display": "555-2368", ... }
// Here the `phone` integer is used for sorting and type detection, while `phone_filter`
// (which has both forms) is used for filtering for if a user inputs either format, while
// the formatted phone number is the one that is shown in the table.
$('#example').dataTable( {
  "columnDefs": [ {
    "targets": 0,
    "data": null, // Use the full data source object for the renderer's source
    "render": {
      "_": "phone",
      "filter": "phone_filter",
      "display": "phone_display"
    }
  } ]
} );
  • 如上所述袜漩,以phone為對象:
// This would be used with a data source such as:
//   "phone": { "plain": 5552368, "filter": "5552368 555-2368", "display": "555-2368" }
$('#example').dataTable( {
  "columnDefs": [ {
    "targets": 0,
    "data": 'phone',
    "render": {
      "_": "plain",
      "filter": "filter",
      "display": "display"
    }
  } ]
} );
  • 用作從數據源創(chuàng)建鏈接的函數
$('#example').dataTable( {
  "columnDefs": [ {
    "targets": 0,
    "data": "download_link",
    "render": function ( data, type, row, meta ) {
      return '<a href="'+data+'">Download</a>';
    }
  } ]
} );
  • 顯示長字符串的省略號
$('#example').dataTable( {
  "columnDefs": [ {
    "targets": 4,
    "data": "description",
    "render": function ( data, type, row, meta ) {
      return type === 'display' && data.length > 40 ?
        '<span title="'+data+'">'+data.substr( 0, 38 )+'...</span>' :
        data;
    }
  } ]
} );
  • 使用對象實例作為行的數據源
function Person( name, age, position ) {
    this._name     = name;
    this._age      = age;
    this._position = position;
 
    this.name = function () {
        return this._name;
    };
 
    this.age = function () {
        return this._age;
    };
 
    this.position = function () {
        return this._position;
    };
}
 
 
$(document).ready(function() {
    var table = $('#example').DataTable({
        columns: [
            { data: null, render: 'name' },
            { data: null, render: 'age' },
            { data: null, render: 'position' }
        ]
    });
 
    table.row.add( new Person( 'Airi Satou',     33, 'Accountant' ) );
    table.row.add( new Person( 'Angelica Ramos', 47, 'Chief Executive Officer (CEO)' ) );
    table.row.add( new Person( 'Ashton Cox',     66, 'Junior Technical Author' ) );
    table.draw();
} );

更詳細的信息可以查閱官網對columns.render的介紹

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市湾碎,隨后出現(xiàn)的幾起案子宙攻,更是在濱河造成了極大的恐慌,老刑警劉巖胜茧,帶你破解...
    沈念sama閱讀 211,639評論 6 492
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件粘优,死亡現(xiàn)場離奇詭異仇味,居然都是意外死亡,警方通過查閱死者的電腦和手機雹顺,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,277評論 3 385
  • 文/潘曉璐 我一進店門丹墨,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人嬉愧,你說我怎么就攤上這事贩挣。” “怎么了没酣?”我有些...
    開封第一講書人閱讀 157,221評論 0 348
  • 文/不壞的土叔 我叫張陵王财,是天一觀的道長。 經常有香客問我裕便,道長绒净,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 56,474評論 1 283
  • 正文 為了忘掉前任偿衰,我火速辦了婚禮挂疆,結果婚禮上,老公的妹妹穿的比我還像新娘下翎。我一直安慰自己缤言,他們只是感情好,可當我...
    茶點故事閱讀 65,570評論 6 386
  • 文/花漫 我一把揭開白布视事。 她就那樣靜靜地躺著胆萧,像睡著了一般。 火紅的嫁衣襯著肌膚如雪俐东。 梳的紋絲不亂的頭發(fā)上跌穗,一...
    開封第一講書人閱讀 49,816評論 1 290
  • 那天,我揣著相機與錄音犬性,去河邊找鬼瞻离。 笑死腾仅,一個胖子當著我的面吹牛乒裆,可吹牛的內容都是我干的。 我是一名探鬼主播推励,決...
    沈念sama閱讀 38,957評論 3 408
  • 文/蒼蘭香墨 我猛地睜開眼鹤耍,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了验辞?” 一聲冷哼從身側響起稿黄,我...
    開封第一講書人閱讀 37,718評論 0 266
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎跌造,沒想到半個月后杆怕,有當地人在樹林里發(fā)現(xiàn)了一具尸體族购,經...
    沈念sama閱讀 44,176評論 1 303
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 36,511評論 2 327
  • 正文 我和宋清朗相戀三年陵珍,在試婚紗的時候發(fā)現(xiàn)自己被綠了寝杖。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 38,646評論 1 340
  • 序言:一個原本活蹦亂跳的男人離奇死亡互纯,死狀恐怖瑟幕,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情留潦,我是刑警寧澤只盹,帶...
    沈念sama閱讀 34,322評論 4 330
  • 正文 年R本政府宣布,位于F島的核電站兔院,受9級特大地震影響殖卑,放射性物質發(fā)生泄漏。R本人自食惡果不足惜坊萝,卻給世界環(huán)境...
    茶點故事閱讀 39,934評論 3 313
  • 文/蒙蒙 一懦鼠、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧屹堰,春花似錦肛冶、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,755評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至荣刑,卻和暖如春馅笙,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背厉亏。 一陣腳步聲響...
    開封第一講書人閱讀 31,987評論 1 266
  • 我被黑心中介騙來泰國打工董习, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人爱只。 一個月前我還...
    沈念sama閱讀 46,358評論 2 360
  • 正文 我出身青樓皿淋,卻偏偏與公主長得像,于是被迫代替她去往敵國和親恬试。 傳聞我的和親對象是個殘疾皇子窝趣,可洞房花燭夜當晚...
    茶點故事閱讀 43,514評論 2 348

推薦閱讀更多精彩內容