什么是BootstrapTableAPI中文版-創(chuàng)新互聯(lián)

本篇文章為大家展示了什么是Bootstrap Table API 中文版,代碼簡(jiǎn)明扼要并且容易理解,絕對(duì)能使你眼前一亮,通過(guò)這篇文章的詳細(xì)介紹希望你能有所收獲。

成都創(chuàng)新互聯(lián)公司-專業(yè)網(wǎng)站定制、快速模板網(wǎng)站建設(shè)、高性價(jià)比鋼城網(wǎng)站開發(fā)、企業(yè)建站全套包干低至880元,成熟完善的模板庫(kù),直接使用。一站式鋼城網(wǎng)站制作公司更省心,省錢,快速模板網(wǎng)站建設(shè)找我們,業(yè)務(wù)覆蓋鋼城地區(qū)。費(fèi)用合理售后完善,10余年實(shí)體公司更值得信賴。

看網(wǎng)上有中文版的,但有些就是字面直接譯過(guò)來(lái)了,而且有的就沒(méi)有翻譯,那就打算自己再翻譯一遍,每一條會(huì)盡大可能結(jié)合盡可能多資料翻譯,如果發(fā)現(xiàn)譯的內(nèi)容比英文多,是添加了更詳細(xì)的說(shuō)明,表的名稱,屬性,類型,默認(rèn)值不翻譯,例如:"class"、"id"等不翻譯。有錯(cuò)請(qǐng)?zhí)岢觯瑫?huì)及時(shí)改正,謝謝。

1、“名稱”可以寫在$('#table').bootstrapTable({});的大括號(hào)中,可以定義一些想要的值,如:

$("#realTime_Table").bootstrapTable({
		       search: true,
	            pagination: false,
	            pageSize: 15,
	            pageList: [5, 10, 15, 20],
	            showColumns: true,
	            showRefresh: false,
	            showToggle: true,
	            locale: "zh-CN",
	            striped: true
        });

2、“屬性”放在聲明表內(nèi),如:


<!--例子應(yīng)該很好看懂Table options和Column options 所放的位置不同,隨便寫的,主要為了懂得如何用--!>

 <table id="realTime_Table" data-click-to-select="true" class="table table-bordered" data-page-size="20">
      <thead>
          <tr >
              <th data-sortable="true" data-field="realTimeDate">日期</th>
              <th data-sortable="true" data-field="newPlayerNum">新增用戶</th>
              <th data-sortable="true" data-field="activePlayerNum">活躍用戶</th>
          </tr>
      </thead>
      <tbody>
      </tbody>
</table>

3、如果名稱和屬性功能類似,則任意一個(gè)地方就夠了,不用重復(fù)定義,有的屬性寫在js里比名稱寫在聲明表中更為簡(jiǎn)單,or vice verse(有的屬性必須要寫,對(duì)應(yīng)的名稱只是表示是否啟用那個(gè)屬性)


表的各項(xiàng)(Table options )

名稱屬性類型默認(rèn)值作用描述
-data-toggleStringtable只要引入 jquery、bootstrap 、bootstrap-table的包,不用在js里面定義就可以使用
默認(rèn)有寫data-toggle="table",data-toggle應(yīng)該知道吧,常用的有"tooltip、popover等等",這邊就不說(shuō)了
classesdata-classesStringtable table-hover表的class屬性,如果沒(méi)有自己定義,則默認(rèn)有邊框,并且當(dāng)鼠標(biāo)懸浮在那一行,背景會(huì)變?yōu)闇\灰色.
sortClassdata-sort-classStringundefined聲明表格td的class名,代表此列元素的class名將被排序
heightdata-heightNumberundefined表格的高度
undefinedTextdata-undefined-textString-當(dāng)不寫任何內(nèi)容默認(rèn)顯示'-'
stripeddata-stripedBooleanfalse默認(rèn)false,當(dāng)設(shè)為true,則每行表格的背景會(huì)顯示灰白相間
sortNamedata-sort-nameStringundefined定義哪一列的值會(huì)被排序,寫data-field的自定義名,沒(méi)定義默認(rèn)都不排列,同下面的sortOrder結(jié)合使用,沒(méi)寫的話列默認(rèn)遞增(asc)
sortOrderdata-sort-orderStringasc同上面的結(jié)合使用,默認(rèn)遞增(asc),也可設(shè)為遞減(desc)
sortStabledata-sort-stableBooleanfalse(別看錯(cuò)了,是sortStable,sortable在下面)默認(rèn)false,設(shè)為true,則和sort部分一樣,區(qū)別是:在排序過(guò)程中,如果存在相等的元素,則原來(lái)的順序不會(huì)改變。原文還有一句:(如果你把此屬性設(shè)為了true)我們將為此行添加'_position'屬性
iconsPrefixdata-icons-prefixStringglyphicon定義字體庫(kù) ('Glyphicon' or 'fa' for FontAwesome),使用"fa"時(shí)需引用 FontAwesome,并且配合 icons 屬性實(shí)現(xiàn)效果 Glyphicon 集成于Bootstrap可免費(fèi)使用
iconSizedata-icon-sizeStringundefined定義的圖標(biāo)大小:
   - undefined =>默認(rèn)表示默認(rèn)的按鈕尺寸(btn)
   - xs  =>超小按鈕的尺寸(btn-xs)
   - sm  =>小按鈕的尺寸(btn-sm)
   - lg   =>大按鈕的尺寸(btn-lg)
buttonsClassdata-buttons-classStringdefault按鈕的類,默認(rèn)為default。
      - 可選的有:primary、danger、warning等等
   - 寫了之后會(huì)自動(dòng)轉(zhuǎn)換為btn-primary(藍(lán)色)、btn-danger(紅色)、btn-warning(黃色)等格式,所以前面不要再加"btn-",默認(rèn)為btn-default(白色)
   - 參考菜鳥教程:Bootstrap 按鈕
iconsdata-iconsObject{ paginationSwitchDown: 'glyphicon-collapse-down icon-chevron-down',
paginationSwitchUp: 'glyphicon-collapse-up icon-chevron-up',
refresh: 'glyphicon-refresh icon-refresh',
toggle: 'glyphicon-list-alt icon-list-alt',
columns: 'glyphicon-th icon-th',
detailOpen: 'glyphicon-plus icon-plus',
detailClose: 'glyphicon-minus icon-minus'
}
定義在工具欄、分頁(yè)、詳細(xì)視圖中使用的圖標(biāo)
       - 沒(méi)辦法解釋,請(qǐng)參考菜鳥教程的圖標(biāo):Bootstrap 字體圖標(biāo)
columns-Array[]默認(rèn)空數(shù)組,在JS里面定義,field即data-field,title就是每列表頭名等等。
       - 請(qǐng)參考:查Bootstrap-table的Usage
data-Array[]被加載的數(shù)據(jù)。
   - 也就是從服務(wù)器獲取的數(shù)據(jù),通過(guò)"."運(yùn)算符獲取,例如"data.date/data.anything",后面是服務(wù)器發(fā)來(lái)的字段名
dataFielddata-data-fieldStringrows- 名稱寫自己定義的每列的字段名,也就是key,通過(guò)key才能給某行的某列賦value。
   -  原文:獲取每行數(shù)據(jù)json內(nèi)的key
   - 例如:{"name":"zz","age":20},name和age就是key,如果這是從服務(wù)端請(qǐng)求的json,那可能和每列定義的字段不同,但都是唯一的
ajaxdata-ajaxFunctionundefined- ajax方法,和jQuery的ajax方法類似
methoddata-methodStringget向服務(wù)器請(qǐng)求遠(yuǎn)程數(shù)據(jù)的方式,默認(rèn)為'get',可選'post'
urldata-urlStringundefined向服務(wù)器請(qǐng)求的url。
   - 例如:server + "get_app_player"和server + 'get_channel_list',兩者都是向server(server是自己定義的,例如"http://kanshakan.nichousha.com/")請(qǐng)求數(shù)據(jù),只是接口不同,一個(gè)是請(qǐng)求該游戲玩家信息,一個(gè)是請(qǐng)求渠道信息
下面看看原文:
   - 向遠(yuǎn)程站點(diǎn)請(qǐng)求數(shù)據(jù)的URL
   - 請(qǐng)記住,如果服務(wù)端分頁(yè)選項(xiàng)使用了自定義的,那么請(qǐng)求的服務(wù)器響應(yīng)格式是不同的,參考下面兩個(gè)數(shù)據(jù)格式:
   Without server-side pagination(沒(méi)有啟用服務(wù)端分頁(yè) - data1.json)
   With server-side pagination(啟用服務(wù)端分頁(yè) - data2.json)
cachedata-cacheBooleantrue默認(rèn)緩存ajax請(qǐng)求,設(shè)為false則禁用緩存
contentTypedata-content-typeStringapplication/json請(qǐng)求數(shù)據(jù)的contentType(內(nèi)容類型),用于定義文件的類型,決定接收方以什么形式讀取這個(gè)文件。
   - 默認(rèn)application/json,用來(lái)告訴接收端從服務(wù)器發(fā)來(lái)的消息是序列化后的json字符串
dataTypedata-data-typeStringjson期望從服務(wù)器獲取的數(shù)據(jù)的類型,默認(rèn)為json格式字符串
ajaxOptionsdata-ajax-optionsObject{}向服務(wù)器請(qǐng)求ajax時(shí)的附加項(xiàng),默認(rèn)無(wú)附加
   - 參考 jQuery.ajax()
queryParamsdata-query-paramsFunction
function(params){
return params;}
當(dāng)請(qǐng)求數(shù)據(jù)時(shí),你可以通過(guò)修改queryParams向服務(wù)器發(fā)送其余的參數(shù)。
   - queryParamsType="limit",它的參數(shù)包括:limit,offset,search,sort,order Else
   - params包括:pageSize,pageNumber,searchText,sortName,sortOrder
   - 當(dāng)return false,請(qǐng)求則終止
queryParamsTypedata-query-params-typeStringlimit默認(rèn)"limit",設(shè)置該屬性用來(lái)發(fā)送符合RESTful格式的參數(shù)
responseHandlerdata-response-handlerFunction
function(res){
return res;}
在加載服務(wù)器發(fā)送來(lái)的數(shù)據(jù)之前,處理數(shù)據(jù)的格式,參數(shù)res表示the response data(獲取的數(shù)據(jù))
paginationdata-paginationBooleanfalse默認(rèn)為false,表格的底部工具欄不會(huì)顯示分頁(yè)條(pagination toolbar),可以設(shè)為true來(lái)顯示
paginationLoopdata-pagination-loopBooleantrue默認(rèn)true,分頁(yè)條無(wú)限循環(huán)
onlyInfoPaginationdata-only-info-paginationBooleanfalse前提:pagination設(shè)為true,啟用了分頁(yè)功能。
   - 默認(rèn)false,設(shè)為true顯示總記錄數(shù)
sidePaginationdata-side-paginationStringclient設(shè)置在哪進(jìn)行分頁(yè),默認(rèn)"client",可選"server",如果設(shè)置 "server",則必須設(shè)置url或者重寫ajax方法
   - 請(qǐng)記住,如果服務(wù)端分頁(yè)選項(xiàng)使用了自定義的,那么請(qǐng)求的服務(wù)器響應(yīng)格式是不同的,參考下面兩個(gè)數(shù)據(jù)格式:
   Without server-side pagination(沒(méi)有啟用服務(wù)端分頁(yè))
   With server-side pagination(啟用服務(wù)端分頁(yè))
pageNumberdata-page-numberNumber1前提:pagination設(shè)為true,啟用了分頁(yè)功能。
   - 默認(rèn)第1頁(yè),用于設(shè)置初始的頁(yè)數(shù)
pageSizedata-page-sizeNumber10前提:pagination設(shè)為true,啟用了分頁(yè)功能。
   - 默認(rèn)每頁(yè)顯示10條記錄,用于設(shè)置每頁(yè)初始顯示的條數(shù)
pageListdata-page-listArray[10, 25, 50, 100]前提:pagination設(shè)為true,啟用了分頁(yè)功能。
   - 默認(rèn)為[10, 25, 50, 100],即可以選擇"每頁(yè)顯示10/25/50/100條記錄",用于設(shè)置選擇每頁(yè)顯示的條數(shù)
selectItemNamedata-select-item-nameStringbtSelectItemradio(單選按鈕)或checkbox(復(fù)選框)的字段名
smartDisplaydata-smart-displayBooleantrue默認(rèn)為true,會(huì)根據(jù)情況顯示分頁(yè)(pagination)或卡片視圖(card view)
escapedata-escapeBooleanfalse跳過(guò)插入HTML中的字符串,替換掉特殊字符(后面符號(hào)沒(méi)有逗號(hào)):&,<,>,",`,'
searchdata-searchBooleanfalse默認(rèn)false不顯示表格右上方搜索框 ,可設(shè)為true,在搜索框內(nèi)只要輸入內(nèi)容即開始搜索
searchOnEnterKeydata-search-on-enter-keyBooleanfalse默認(rèn)false不啟用,設(shè)為true啟用,比功能是與上面相比,在搜索框內(nèi)輸入內(nèi)容并且按下回車鍵才開始搜索
strictSearchdata-strict-searchBooleanfalse設(shè)為true,開啟精確搜索
searchTextdata-search-textString""前提:search設(shè)為true,啟用了搜索功能。
   - 搜索框初始顯示的內(nèi)容,默認(rèn)空字符串
searchTimeOutdata-search-time-outNumber500前提:search設(shè)為true,啟用了搜索功能。
   - 設(shè)置搜索文件的超時(shí)時(shí)間(原文:Set timeout for search fire,不知道是寫錯(cuò)了還是我知識(shí)面太窄,"search fire"是什么意思,官方API錯(cuò)了?給我整蒙逼了)
trimOnSearchdata-trim-on-searchBooleantrue默認(rèn)true,自動(dòng)忽略空格
showHeaderdata-show-headerBooleantrue默認(rèn)為true顯示表頭,設(shè)為false隱藏
showFooterdata-show-footerBooleanfalse默認(rèn)為false隱藏表尾,設(shè)為true顯示
showColumnsdata-show-columnsBooleanfalse默認(rèn)為false隱藏某列下拉菜單,設(shè)為true顯示
showRefreshdata-show-refreshBooleanfalse默認(rèn)為false隱藏刷新按鈕,設(shè)為true顯示
showToggledata-show-toggleBooleanfalse默認(rèn)為false隱藏視圖切換按鈕,設(shè)為true顯示
showPaginationSwitchdata-show-pagination-switchBooleanfalse默認(rèn)為false隱藏每頁(yè)數(shù)據(jù)條數(shù)選擇,設(shè)為true顯示
minimumCountColumnsdata-minimum-count-columnsNumber1每列的下拉菜單最小數(shù)
idFielddata-id-fieldStringundefined表明哪個(gè)是字段是標(biāo)識(shí)字段
uniqueIddata-unique-idStringundefined表明每行唯 一的標(biāo)識(shí)符
cardViewdata-card-viewBooleanfalse默認(rèn)false,設(shè)為true顯示card view(卡片視圖)
detailViewdata-card-viewBooleanfalse默認(rèn)false,設(shè)為true顯示detail view(細(xì)節(jié)視圖)
detailFormatterdata-detail-formatterFunctionfunction(index, row, element){
return '';}
前提:detailView設(shè)為true,啟用了顯示detail view。
   - 用于格式化細(xì)節(jié)視圖
   - 返回一個(gè)字符串,通過(guò)第三個(gè)參數(shù)element直接添加到細(xì)節(jié)視圖的cell(某一格)中,其中,element為目標(biāo)cell的jQuery element
searchAligndata-search-alignStringright搜索框的位置,默認(rèn)right(最右),可選left
buttonsAligndata-buttons-alignStringright工具欄按鈕的位置,默認(rèn)right(最右),可選left
toolbarAligndata-toolbar-alignStringleft自定義工具欄的位置,默認(rèn)right(最右),可選left
paginationVAligndata-pagination-v-alignStringbottom分頁(yè)條垂直方向的位置,默認(rèn)bottom(底部),可選top、both(頂部和底部均有分頁(yè)條)
paginationHAligndata-pagination-h-alignStringright分頁(yè)條水平方向的位置,默認(rèn)right(最右),可選left
paginationDetailHAligndata-pagination-detail-h-alignStringleft如果解譯的話太長(zhǎng),舉個(gè)例子,paginationDetail就是“顯示第 1 到第 8 條記錄,總共 15 條記錄  每頁(yè)顯示 8  條記錄”,默認(rèn)left(最左),可選right
paginationPreTextdata-pagination-pre-textString?還是舉例子,如果你內(nèi)容太多,底部最右邊會(huì)顯示:"? 1 2 3 4 5 ?"來(lái)選擇頁(yè)數(shù),默認(rèn)就是最左邊那個(gè)符號(hào),下同
paginationNextTextdata-pagination-next-textString?參考上面一條
clickToSelectdata-click-to-selectBooleanfalse默認(rèn)false不響應(yīng),設(shè)為true則當(dāng)點(diǎn)擊此行的某處時(shí),會(huì)自動(dòng)選中此行的checkbox(復(fù)選框)或radiobox(單選按鈕)
singleSelectdata-single-selectBooleanfalse默認(rèn)false,設(shè)為true則允許復(fù)選框僅選擇一行
toolbardata-toolbarString | NodeundefinedjQuery的選擇器,例如:#toolbar,.toolbar,或者是DOM 結(jié)點(diǎn)
checkboxHeaderdata-checkbox-headerBooleantrue如果你有聲明復(fù)選框,默認(rèn)顯示表頭行的全選復(fù)選框,設(shè)為false隱藏(就是表格第一行的不顯示,從第二行往后都顯示)
maintainSelecteddata-maintain-selectedBooleanfalse設(shè)為true則保持被選的那一行的狀態(tài)
sortabledata-sortableBooleantrue默認(rèn)true,設(shè)為false禁用所有的行排列(也就是每列表頭不會(huì)顯示排序的按鈕,這個(gè)需要在th聲明data-sortable="true",寫在js中只是啟不啟用)
slientSortdata-silent-sortBooleantrue前提:sidePagination設(shè)為server(服務(wù)端)
   - 默認(rèn)true,設(shè)為false則靜默排序數(shù)據(jù)
rowStyledata-row-styleFunction{}改變某行的格式,需要兩個(gè)參數(shù):
   - row:此行的數(shù)據(jù)
   - index:此行的索引
支持classes和css,用法如下: function rowStyle(row, index){
  return {   classes: 'text-nowrap another-class',
  css: {"color": "blue", "font-size": "50px"}
 }; }
rowAttributesdata-row-attributesFunction{}改變某行的屬性,需要兩個(gè)參數(shù):
   - row:此行的數(shù)據(jù)          
   - index:此行的索引
支持所有自定義的屬性。
customSearchdata-custom-searchFunction$.noop自定義搜索功能(用來(lái)代替自帶的搜索功能),需要一個(gè)參數(shù):
   - text:想要搜索的內(nèi)容
用法如下:
function customSearch(text){
  //必須使用'this.data'對(duì)數(shù)據(jù)進(jìn)行過(guò)濾(filter the data,感覺(jué)這個(gè)詞也不用譯),不要使用'this.options.data' }
customSortdata-custom-sortFunction$.noop自定義排序功能(用來(lái)代替自帶的排序功能),需要兩個(gè)參數(shù)(可以參考前面):
   - sortName:需要排序的那列
   - sortOrder:排序方式
用法:和上面一樣,不用擔(dān)心,注釋也一模一樣
localedata-localeStringundefined本地化(動(dòng)詞)。
本地化的文件必須被預(yù)加載,允許fallback(簡(jiǎn)單來(lái)說(shuō)就是如果要使用的文件不可用,就可以用別的替代它,例如球場(chǎng)替補(bǔ),沒(méi)替補(bǔ),如果有人受傷了,比賽不就廢了),如果加載,將按如下順序:
   - 首先嘗試加載的是指定的"本地化"文件
   - 然后是'_'(下劃線)寫成'-'(破折號(hào)),并且區(qū)域代碼被大寫的
   - 然后是短區(qū)域代碼(例如:用'fr'代替'fr-CA')
   - 最后使用的是剩下的本地化文件(當(dāng)沒(méi)有文件可加載則使用默認(rèn)的)
如果剩余的undefined,或者是空字符,則使用最后一次使用的那個(gè)文件(當(dāng)沒(méi)有本地化文件可被加載,則使用自帶的'en_US')
footerStyledata-footer-styleFunction{}改變footer格式,需要兩個(gè)參數(shù):
   - row:此行的數(shù)據(jù)
   - index:此行的索引
支持classes和css,用法如下:
function rowStyle(value,row, index){
  return {   css: { "font-weight": "bold" }  };  }

列的各項(xiàng)(Column options )


名稱屬性類型默認(rèn)值作用描述
radiodata-radioBooleanfalse默認(rèn)false不顯示radio(單選按鈕),設(shè)為true則顯示,radio寬度是固定的
checkboxdata-checkboxBooleanfalse默認(rèn)false不顯示checkbox(復(fù)選框),設(shè)為true則顯示,checkbox的每列寬度已固定
fielddata-fieldStringundefined是每列的字段名,不是表頭所顯示的名字,通過(guò)這個(gè)字段名可以給其賦值,相當(dāng)于key,表內(nèi)唯一
titledata-titleStringundefined這個(gè)是表頭所顯示的名字,不唯一,如果你喜歡,可以把所有表頭都設(shè)為相同的名字
titleTooltipdata-title-tooltipStringundefined當(dāng)懸浮在某控件上,出現(xiàn)提示
   - 參考 Bootstrap 提示工具(Tooltip)插件
classclass/data-classStringundefined沒(méi)什么好說(shuō)的,就是class
rowspanrowspan/data-rowspanNumberundefined每格所占的行數(shù)
colspancolspan/data-colspanNumberundefined每格所占的列數(shù)
aligndata-alignStringundefined每格內(nèi)數(shù)據(jù)的對(duì)齊方式,有:left(靠左)、right(靠右)、center(居中)
haligndata-halignStringundefinedtable header(表頭)的對(duì)齊方式,有:left(靠左)、right(靠右)、center(居中)
faligndata-falignStringundefinedtable footer(表腳,就這樣譯,任性,其實(shí)隨便譯啦,知道就好)的對(duì)齊方式,有:left(靠左)、right(靠右)、center(居中)
valigndata-valignStringundefined每格數(shù)據(jù)的對(duì)齊方式,有:top(靠上)、middle(居中)、bottom(靠下)
widthdata-widthNumber(單位:px或%)undefined每列的寬度。
   - 如果沒(méi)有自定義寬度,那么寬度會(huì)根據(jù)內(nèi)容的寬度自適應(yīng)。
   - 如果表是左適應(yīng)(left responsive)或者設(shè)置的寬度小于內(nèi)容的寬度,那么,寬度還是會(huì)自適應(yīng)(可以在class或其他的屬性中使用 min-width 或 max-width)。
   - 你也可以使用"%"作為單位,這樣的話,bootstapTable將按百分比劃分,如果你想使用"pixels(像素值)",你可以只寫數(shù)字(只要不加"%",單位默認(rèn)"px",不嫌麻煩,或者想更清晰,你也可以加上"px")
sortabledata-sortableBooleanfalse默認(rèn)false就默認(rèn)顯示,設(shè)為true則會(huì)被排序
orderdata-orderStringasc默認(rèn)的排序方式為"asc(升序)",也可以設(shè)為"desc(降序)"。
   - 與上面的結(jié)合使用,不然都不讓排序了,你還考慮什么升降。
visibledata-visibleBooleantrue默認(rèn)為true顯示該列,設(shè)為false則隱藏該列。
   - 還是很有用的,例如隱藏自定義index列,按某屬性排序后會(huì)變亂,你可以讀取某行的index來(lái)進(jìn)行賦值
cardVisibledata-card-visibleBooleantrue默認(rèn)為true顯示該列,設(shè)為false則隱藏。
switchabledata-switchableBooleantrue默認(rèn)為true顯示該列,設(shè)為false則禁用列項(xiàng)目的選項(xiàng)卡。
clickToSelectdata-click-to-selectBooleantrue默認(rèn)true不響應(yīng),設(shè)為false則當(dāng)點(diǎn)擊此行的某處時(shí),不會(huì)自動(dòng)選中此行的checkbox(復(fù)選框)或radiobox(單選按鈕)
formatterdata-formatterFunctionundefined需要此列的對(duì)象。    
   某格的數(shù)據(jù)轉(zhuǎn)換函數(shù),需要三個(gè)參數(shù):    
    -value: field(字段名)    
    -row:行的數(shù)據(jù)    
    -index:行的(索引)index
footerFormatterdata-footer-formatterFunctionundefined需要此列的對(duì)象。    
   某格的數(shù)據(jù)轉(zhuǎn)換函數(shù),需要一個(gè)參數(shù):    
    -data: 所有行數(shù)據(jù)的數(shù)組    
   函數(shù)需要返回(return)footer某格內(nèi)所要顯示的字符串的格式,還要包括內(nèi)容
eventsdata-eventsObjectundefined當(dāng)某格使用formatter函數(shù)時(shí),事件監(jiān)聽會(huì)響應(yīng),需要四個(gè)參數(shù):
    -event:jQuery事件(參考Events)。
    - value:字段名
    - row:行數(shù)據(jù)
    - index:此行的index
舉個(gè)例子:
  <th .. data-events="operateEvent"> var operateEvents = {'click .like': function (e, value, row, index) {}};
sorterdata-sorterFunctionundefined自定義的排序函數(shù),實(shí)現(xiàn)本地排序,需要兩個(gè)參數(shù):
    - a:第一個(gè)字段名
    - b:第二個(gè)字段名
sortNamedata-sort-nameStringundefined除了表頭默認(rèn)的sort-name或列的字段名,還可以使用自定義的sort-name
   對(duì)特殊情況說(shuō)明:
    - 一個(gè)列顯示的內(nèi)容或許是"html"代碼,如:<b><span style="color:red">abc</span></b>,但是被排列的是html代碼中的內(nèi)容(content):abc
cellStyledata-cell-styleFunctionundefined對(duì)某格中顯示樣式(style)進(jìn)行改變,需要三個(gè)函數(shù):
    - value:字段名
    - row:行數(shù)據(jù)
    - index:此行的index
    - field:行的字段名
支持classes和css,用法如下:
  function cellStyle(value, row, index, field) {  return {   classes: 'text-nowrap another-class',   css: {"color": "blue", "font-size": "50px"}  }; }
searchable        data-searchableBooleantrue默認(rèn)true,表示此列數(shù)據(jù)可被查詢
searchFormatterdata-search-formatterBooleantrue默認(rèn)true,可使用格式化的數(shù)據(jù)查詢
escapedata-escapeBooleanfalse跳過(guò)插入HTML中的字符串,替換掉特殊字符(后面符號(hào)沒(méi)有逗號(hào)):&,<,>,",`,'

事件(Events)

定義事件的格式:

$(’#table’).bootstrapTable({
onEventName: function (arg1, arg2, …) {
// …
} });

$(’#table’).on(‘event-name.bs.table’, function (e, arg1, arg2, …) {
// …
});
事件名定義在jQuery中的事件名參數(shù)作用描述
onAllall.bs.tablename, args當(dāng)所有觸發(fā)器被觸發(fā)時(shí)都執(zhí)行此函數(shù),就是所有的事件都會(huì)觸發(fā)該事件,參數(shù)包括:    
    - name:事件名
    - args:事件的數(shù)據(jù)
onClickRowclick-row.bs.tablerow, $element, field當(dāng)單擊此行的任意一處,就會(huì)觸發(fā)該事件,所需參數(shù)如下(只是按原文譯過(guò)來(lái)的,在bootstraptable的js中不需要這些參數(shù),因?yàn)閱螕粼撔芯蜁?huì)獲得一個(gè)row,row中包括此行所有數(shù)據(jù),只要通過(guò)此行某列的字段名即可取出):    
    - row:哪一行(從0開始)  
    - $element:該行(tr)    
    - field:當(dāng)點(diǎn)擊該行,你想獲取此行哪一格的數(shù)據(jù),field就是此列字段名  
onDblClickRowdbl-click-row.bs.tablerow, $element, field和上面差不多,當(dāng)雙擊(666)此行的任意一處,就會(huì)觸發(fā)該事件,所需參數(shù)如下(只是按原文譯過(guò)來(lái)的,在bootstraptable的js中不需要這些參數(shù),因?yàn)殡p擊該行就會(huì)獲得一個(gè)row,row中包括此行所有數(shù)據(jù),只要通過(guò)此行某列的字段名即可取出):    
    - row:哪一行(從0開始)  
    - $element:該行(tr)    
    - field:當(dāng)點(diǎn)擊該行,你想獲取此行哪一格的數(shù)據(jù),field就是此列字段名  
onClickCellclick-cell.bs.tablefield, value, row, $element當(dāng)單擊某一格,就會(huì)觸發(fā)該事件,所需參數(shù)如下:    
    - field:此格所在列的字段名  
    - value:此格的數(shù)據(jù)    
    - $element:此行的此列,就是此格(td)
onDblClickCelldbl-click-cell.bs.table          field, value, row, $element當(dāng)雙擊某一格,就會(huì)觸發(fā)該事件,所需參數(shù)如下:    
    - field:此格所在列的字段名  
    - value:此格的數(shù)據(jù)    
    - $element:此行的此列,就是此格(td)
onSortsort.bs.tablename, order當(dāng)對(duì)某列進(jìn)行排序時(shí)觸發(fā)該事件,所需參數(shù)如下:    
    - name:所排序的列的字段名  
    - order:所排的順序
onCheckcheck.bs.tablerow, $element當(dāng)選擇(check)此行時(shí)觸發(fā),所需的參數(shù)如下:    
    - row:所選擇的行的字段名  
    - $element:此行的DOM元素
onUncheckuncheck.bs.tablerow, $element當(dāng)取消選擇(uncheck)此行時(shí)觸發(fā),所需的參數(shù)如下:    
    - row:所取消選擇的行的字段名  
    - $element:此行的DOM元素
onCheckAllcheck-all.bs.tablerows當(dāng)全選行時(shí)觸發(fā),所需的參數(shù)如下:    
    - rows:最近(newly)所選擇的行的字段名的數(shù)組
onUncheckAlluncheck-all.bs.tablerows當(dāng)取消全選行時(shí)觸發(fā),所需的參數(shù)如下:    
    - rows:之前或上次(previously)所選擇的行的字段名的數(shù)組
onCheckSome          check-some.bs.tablerows當(dāng)選擇(check)某些行(多行,rows)時(shí)觸發(fā),所需的參數(shù)如下:    
    - rows:之前或上次(previously)所選擇的行的字段名的數(shù)組
onUncheckSomeuncheck-some.bs.tablerows當(dāng)取消選擇(uncheck)某些行(多行,rows)時(shí)觸發(fā),所需的參數(shù)如下:    
    - rows:之前或上次(previously)所選擇的行的字段名的數(shù)組
onLoadSuccess          load-success.bs.tabledata當(dāng)所有數(shù)據(jù)被加載時(shí)觸發(fā)
onLoadErrorload-error.bs.tablestatus, res當(dāng)加載某些數(shù)據(jù)出現(xiàn)錯(cuò)誤時(shí)觸發(fā)
onColumnSwitchcolumn-switch.bs.tablefield, checked當(dāng)某列改變是否可見(jiàn)的狀態(tài)時(shí)觸發(fā)
onColumnSearchcolumn-search.bs.tablefield, text當(dāng)某列被查詢時(shí)觸發(fā)
onPageChangepage-change.bs.tablenumber, size當(dāng)改變此頁(yè)所顯示的數(shù)據(jù)條數(shù)或改變頁(yè)碼時(shí)觸發(fā)
onSearchsearch.bs.tabletext當(dāng)查詢此表時(shí)觸發(fā)
onToggletoggle.bs.tablecardView當(dāng)改變表的視圖時(shí)觸發(fā)
onPreBodypre-body.bs.tabledata當(dāng)<tbody></tbody>中的內(nèi)容沒(méi)顯示前觸發(fā)
onPostBodypost-body.bs.tabledata當(dāng)<tbody></tbody>中的內(nèi)容被加載完后或者在你所用的DOM中有定義則被觸發(fā)
onPostHeaderpost-header.bs.tablenone當(dāng)<thead></thead>中的內(nèi)容被加載完后或者在你所用的DOM中有定義則被觸發(fā)
onExpandRowexpand-row.bs.tableindex, row, $detail當(dāng)查看詳細(xì)視圖(點(diǎn)擊查看detail的圖標(biāo))時(shí)觸發(fā)
onCollapseRowcollapse-row.bs.tableindex, row當(dāng)關(guān)閉詳細(xì)視圖(再次點(diǎn)擊查看detail的圖標(biāo))時(shí)觸發(fā)
onRefreshOptionsrefresh-options.bs.tableoptions當(dāng)刷新各項(xiàng)后或在初始化表(也包括銷毀了再初始化)之前觸發(fā)
onResetViewreset-view.bs.table
當(dāng)重置(reset)表的視圖時(shí)觸發(fā)
onRefresh          refresh.bs.tableparams當(dāng)點(diǎn)擊刷新按鈕(refresh,不是瀏覽器的,而是表格右上角的刷新按鈕)后觸發(fā)

方法(Methods)

$('#table').bootstrapTable('method', parameter);

方法名參數(shù)描述舉例
getOptionsnone返回各項(xiàng)的object$table.bootstrapTable('getOptions');
   - 請(qǐng)查看:  getOptions
getSelectionsnone返回被選擇的行,當(dāng)沒(méi)有行被選擇,則返回空數(shù)組(但并不是undefined,也不是null,是長(zhǎng)度為0的空數(shù)組,所以可以判斷長(zhǎng)度是否大于0來(lái)確定是否選擇了行)$table.bootstrapTable('getSelections');
   - 請(qǐng)查看: getSelections
getAllSelectionsnone返回所有被選的行(原文中:contain search or filter,其實(shí)就是你選擇的篩選之后的數(shù)據(jù)),當(dāng)沒(méi)有行被選擇,則返回空數(shù)組$table.bootstrapTable('getAllSelections');
   - 請(qǐng)查看: getAllSelections
showAllColumnsnone顯示所有的列$table.bootstrapTable('showAllColumns');
   -  就是顯示所有的列,并沒(méi)什么可說(shuō)的
hideAllColumnsnone隱藏所有的列$table.bootstrapTable('hideAllColumns');
   - 就是隱藏所有的列
getDatauseCurrentPage獲取被加載的表的數(shù)據(jù),如果你設(shè)置了使用當(dāng)前頁(yè)的數(shù)據(jù)(useCurrentPage),則返回當(dāng)前頁(yè)的數(shù)據(jù)$table.bootstrapTable('getData');
   - 請(qǐng)查看: getData
getRowByUniqueIdid獲取你想要的某行的數(shù)據(jù)(設(shè)置某行的id)$table.bootstrapTable('getRowByUniqueId', 1);后面的1就是你要的那一行的ID
   - 請(qǐng)查看: getRowByUniqueId
loaddata向表中加載數(shù)據(jù),原來(lái)的數(shù)據(jù)將被移除$table.bootstrapTable('load', data);
   - 請(qǐng)查看: load
appenddata將數(shù)據(jù)追加在最后一行后$table.bootstrapTable('append', data);data可以是數(shù)組
   - 請(qǐng)查看: append
prependdata也是追加,只是在第一行之前$table.bootstrapTable('prepend', data);data可以是數(shù)組
   - 請(qǐng)查看: prepend
removeparams移除一行或多行你所選的數(shù)據(jù)$table.bootstrapTable('remove', {field: 'id', values: ids});    
   - id:所需移除的那一行(rows,一或多行)的字段    
   - values:被移除的行的數(shù)組    
   - 請(qǐng)查看: remove
removeAll-移除表中所有的數(shù)據(jù)$table.bootstrapTable('removeAll');    
   - 請(qǐng)查看: removeAll
removeByUniqueId-移除某行數(shù)據(jù)(設(shè)置某行的id)$table.bootstrapTable('removeByUniqueId', 1);后面的1就是你想移除的那一行的ID    
   - 請(qǐng)查看: removeByUniqueId
insertRowparams新增一行,所需的參數(shù)如下:
   - index:你想插入到哪(只要愿意,想插哪就插哪,想插誰(shuí)就插誰(shuí))
   - row:你想插入的數(shù)據(jù)
$table.bootstrapTable('insertRow', {index: 1, row: row});    
   - 請(qǐng)查看: insertRow
updateRowparams更新行數(shù)據(jù),所需的參數(shù)如下:
   - index:所要更新的行的索引(index)
   - row:你想換的新的數(shù)據(jù)
$table.bootstrapTable('updateRow', {index: 1, row: row});    
   - 請(qǐng)查看: updateRow      
updateByUniqueIdparams更新某行數(shù)據(jù),所需的參數(shù)如下:
   - id:你想更新那行的id(唯一),(只要愿意,想換哪個(gè)換哪個(gè))
   - row:你想換的新的數(shù)據(jù)
$table.bootstrapTable('updateByUniqueId', {id: 3, row: row});    
   - 請(qǐng)查看: updateByUniqueId
showRowparams顯示特定行,所需的參數(shù)至少包括下面所列的一個(gè):
   - id:所要顯示的行的索引(index)
   - uniqueId:那一行的id
$table.bootstrapTable('showRow', {index:1});    
   - 請(qǐng)查看: showRow/hideRow
hideRowparams隱藏特定行,所需的參數(shù)至少包括下面所列的一個(gè):
   - id:所要隱藏的行的索引(index)
   - uniqueId:那一行的id
$table.bootstrapTable('hideRow', {index:1});    
   - 請(qǐng)查看: showRow/hideRow
getRowsHiddenboolean獲取隱藏的行(官方原話很多,其實(shí)總結(jié)起來(lái)就前面那一句)$table.bootstrapTable('getRowsHidden');
mergeCellsoptions融合~(把多格合并為一格),所需的參數(shù)如下:
   - index:所要合并的格所在行的索引(index)
   - field:所在列的字段名
   - rowspan:合并的行總數(shù)目
   - colspan:合并的列總數(shù)目
$table.bootstrapTable('mergeCells', {index: 1, field: 'name', colspan: 2, rowspan: 3});
   - 請(qǐng)查看: mergeCells
updateCellparams更新某格數(shù)據(jù),所需的參數(shù)如下:
   - index:所要合并的格所在行的索引(index)
   - field:所在列的字段名
   - value:要換的新的數(shù)據(jù)
你也可以設(shè)置{reinit:false}來(lái)禁用表格的再次初始化
$table.bootstrapTable('updateCell',{index:index,field:'id',value:value});
refreshparams刷新服務(wù)端的數(shù)據(jù):
   - 可以設(shè)置{silent:true}來(lái)刷新
   - 設(shè)置{url:newUrl,pageNumber:pageNumber,
pageSize:pageSize}改變請(qǐng)求的地址,頁(yè)數(shù),每頁(yè)所顯示的條數(shù)
   - 可以設(shè)置{query:{foo:'bar'}}增加特定的參數(shù)
$table.bootstrapTable('refresh');
   - 請(qǐng)查看: refresh
refreshOptionsoptions看例子吧- 請(qǐng)查看: refreshOptions
resetSearchtext重置搜索的文本(text)- 請(qǐng)查看: resetSearch
showLoadingnone顯示正在加載……- 請(qǐng)查看: showLoading/hideLoading
hideLoadingnone隱藏正在加載……- 請(qǐng)查看: showLoading/hideLoading
checkAllnone選擇當(dāng)前頁(yè)的所有行$table.bootstrapTable('checkAll');
   - 請(qǐng)查看: checkAll/uncheckAll
uncheckAllnone取消選擇當(dāng)前頁(yè)的所有行$table.bootstrapTable('uncheckAll');
   - 請(qǐng)查看: checkAll/uncheckAll
checkInvertnone反向選擇,不難理解吧$table.bootstrapTable('checkInvert');
checkindex選擇某一行,索引(index)從0開始$table.bootstrapTable('check', 1);
   - 請(qǐng)查看: check/uncheck
uncheckindex取消選擇某一行,索引(index)從0開始$table.bootstrapTable('uncheck', 1);
   - 請(qǐng)查看: check/uncheck
checkByparams通過(guò)數(shù)組選擇某一行,所需的參數(shù)如下:
   - field:所要選的字段名
   - values:所要選的那些值(數(shù)組)
官方?jīng)],啊,有例紙:
- $("#table").bootstrapTable("checkBy", { field:"field_name",  values:["value1","value2","value3"]});
   - 請(qǐng)查看: checkBy/uncheckBy
uncheckByparams通過(guò)數(shù)組選擇某一行,所需的參數(shù)如下:
   - field:所要取消選擇的字段名
   - values:所要取消選擇的那些值(數(shù)組)
$("#table").bootstrapTable("uncheckBy", { field:"field_name",  values:["value1","value2","value3"]});
   - 請(qǐng)查看: checkBy/uncheckBy
resetViewparams改變表格的樣式,例如改變表格的高度(height)$table.bootstrapTable('resetView');
   - 請(qǐng)查看: resetView
resetWidthnone自動(dòng)改變表頭和表腳(就譯成腳,任性)的寬度來(lái)適應(yīng)每列的寬度$table.bootstrapTable('resetWidth');
destroynone銷毀表格 A!T!T!A!C!K!$table.bootstrapTable('destroy');
   - 請(qǐng)查看: destroy
showColumnfield顯示特定的列$table.bootstrapTable('showColumn', 'name');
   - 請(qǐng)查看: showColumn/hideCoulumn
hideColumnfield隱藏特定的列$table.bootstrapTable('hideColumn', 'name');
   - 請(qǐng)查看: showColumn/hideCoulumn
getHiddenColumns-獲取所有隱藏的列$table.bootstrapTable('getHiddenColumns');
getVisibleColumns-獲取所有顯示的列$table.bootstrapTable('getVisibleColumns');
scrollTovalue滾……到哪個(gè)位置,單位是'px',如果設(shè)為'bottom',嗖,恭喜你已到表尾$table.bootstrapTable('scrollTo', 0);
   - 請(qǐng)查看: scrollTo
getScrollPositionnone獲取當(dāng)前所滾到的位置,單位你懂得,就是'px'$table.bootstrapTable('getScrollPosition');
filterBynone只能在客戶端(client-side,相對(duì)server-side)這邊用,過(guò)濾表中的數(shù)據(jù)
例如:
   - 可以設(shè)置{age:10}來(lái)只顯示age為10的數(shù)據(jù)
   - 不僅單的,你還可以雙飛,甚至多p,設(shè)置{age: 10, hairColor: ["blue", "red", "green"]} ,這樣你就得到了一群10歲的,頭發(fā)顏色為藍(lán),紅,綠的……數(shù)據(jù)
$table.bootstrapTable('filterBy', {   id: [1, 2, 3] });
   - 請(qǐng)查看: filterBy
selectPagepage跳轉(zhuǎn)到特定的頁(yè)面$table.bootstrapTable('selectPage', 1);
   - 請(qǐng)查看: selectPage/prevPage/nextPage
prevPagenone跳轉(zhuǎn)到上一頁(yè)$table.bootstrapTable('prevPage');
   - 請(qǐng)查看: selectPage/prevPage/nextPage
nextPagenone跳轉(zhuǎn)到下一頁(yè)$table.bootstrapTable('nextPage');
   - 請(qǐng)查看: selectPage/prevPage/nextPage
togglePaginationnone詞窮,請(qǐng)看例紙$table.bootstrapTable('togglePagination');
   - 請(qǐng)查看: togglePagination
toggleViewnone改變視圖$table.bootstrapTable('toggleView');
   - 請(qǐng)查看: toggleView
expandRowindex可使用條件:detail view設(shè)為了true,不然無(wú)法使用視圖功能,這個(gè)也沒(méi)用
   - 通過(guò)參數(shù)index來(lái)展開此列的詳細(xì)視圖
- 請(qǐng)查看: expandRow-collapseRow
collapseRowindex可使用條件:detail view設(shè)為了true
   - 通過(guò)參數(shù)index來(lái)關(guān)閉此列的詳細(xì)視圖
- 請(qǐng)查看: expandRow-collapseRow
expandAllRows
新版有更改(原來(lái)為"expandAllRow"),下同
感謝 @zhq449681061
is subtable可使用條件:detail view設(shè)為了true
   - 展開所有列的詳細(xì)視圖
$table.bootstrapTable('expandAllRows');
   - 參考上面的實(shí)例,上面是展開(折疊)某一行的視圖,這個(gè)是所有行的
collapseAllRowsis subtable可使用條件:detail view設(shè)為了true
   - 關(guān)閉所有列的詳細(xì)視圖
$table.bootstrapTable('collapseAllRows');
   - 參考上面

本地化,切換為另一種語(yǔ)言(Localizations)

默認(rèn)顯示英文,如果想使用中文,首先引入:

<script src="bootstrap-table-zh-CN.js"></script>

然后是三種聲明使用的方法(個(gè)人只使用第二、三種),如下:


第一種:

$.extend($.fn.bootstrapTable.defaults, $.fn.bootstrapTable.locales['zh-CN']);

第二種:


<table data-toggle="table" data-locale="zh-CN"></table>

第三種:


$('table').bootstrapTable({locale:'zh-CN'});

以下說(shuō)明除了數(shù)字外均為中文默認(rèn)顯示,本來(lái)不用寫的,只要引入就顯示中文了


名稱參數(shù)默認(rèn)說(shuō)明
formatLoadingMessage-'Loading, please wait…'“加載中,請(qǐng)等待……”
formatRecordsPerPagepageNumber'%s records per page'“每頁(yè)顯示 15  條記錄”
formatShowingRowspageFrom, pageTo, totalRows'Showing %s to %s of %s rows'“顯示第 1 到第 15 條記錄”
formatDetailPaginationtotalRows'Showing %s rows'“總共 15 條記錄”
formatSearch-'Search'“搜索”(占位符)
formatNoMatches-'No matching records found'“沒(méi)有找到匹配的記錄”
formatRefresh-'Refresh'“刷新”(鼠標(biāo)懸浮顯示的文字,下同)
formatToggle-'Toggle'“切換”
formatColumns-'Columns'“列”

上述內(nèi)容就是什么是Bootstrap Table API 中文版,你們學(xué)到知識(shí)或技能了嗎?如果還想學(xué)到更多技能或者豐富自己的知識(shí)儲(chǔ)備,歡迎關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道。

另外有需要云服務(wù)器可以了解下創(chuàng)新互聯(lián)scvps.cn,海內(nèi)外云服務(wù)器15元起步,三天無(wú)理由+7*72小時(shí)售后在線,公司持有idc許可證,提供“云服務(wù)器、裸金屬服務(wù)器、高防服務(wù)器、香港服務(wù)器、美國(guó)服務(wù)器、虛擬主機(jī)、免備案服務(wù)器”等云主機(jī)租用服務(wù)以及企業(yè)上云的綜合解決方案,具有“安全穩(wěn)定、簡(jiǎn)單易用、服務(wù)可用性高、性價(jià)比高”等特點(diǎn)與優(yōu)勢(shì),專為企業(yè)上云打造定制,能夠滿足用戶豐富、多元化的應(yīng)用場(chǎng)景需求。

本文題目:什么是BootstrapTableAPI中文版-創(chuàng)新互聯(lián)
文章轉(zhuǎn)載:http://muchs.cn/article10/coecgo.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián),為您提供手機(jī)網(wǎng)站建設(shè)、微信小程序、網(wǎng)站策劃搜索引擎優(yōu)化、網(wǎng)站建設(shè)網(wǎng)站收錄

廣告

聲明:本網(wǎng)站發(fā)布的內(nèi)容(圖片、視頻和文字)以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主,如果涉及侵權(quán)請(qǐng)盡快告知,我們將會(huì)在第一時(shí)間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng),如需處理請(qǐng)聯(lián)系客服。電話:028-86922220;郵箱:631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載,或轉(zhuǎn)載時(shí)需注明來(lái)源: 創(chuàng)新互聯(lián)

外貿(mào)網(wǎng)站制作