{hero}

language.searchBuilder.title

始於:SearchBuilder 1.0.0

設定 SearchBuilder 標題文字。
請注意 - 此屬性需要 DataTables 的 SearchBuilder 擴充功能。

描述

Searchbuilder 可以在標題欄位中顯示目前實作的篩選器數量摘要資訊,為終端使用者提供快速且有用的資訊。

在內部,DataTables 的 i18n() 方法用於決定要顯示的字串值,它可以為真正的多語言支援提供複雜的單數、複數、雙數等語言字串。詳細資訊請參閱下面的 object 區段。

請注意,從 1.1.0 開始,此語言選項會以 HTML 格式寫入文件,因此如果您使用使用者輸入的資料,必須先進行清理。

類型

字串

描述

要顯示的語言字串,不考慮任何複數形式。字串可以包含 %d,它將被所選篩選器的數量取代。

物件

描述

作為物件,此選項可用於定義不同字串,以用於許多語言所需的各種單數、複數、雙數等選項。如果所選篩選器的數量與物件中的參數名稱匹配,則將使用該參數的值。如果沒有匹配項,則使用 _ (必須 定義) 作為預設值。

與上面的字串情況一樣,在此物件中定義的任何參數值都可以包含字串 %d,它將被所選篩選器的數量取代。

預設值

  • 值:{0: '搜尋建立器', _: '搜尋建立器 (%d)'}

範例

變更按鈕內 SearchBuilder 標題的訊息

new DataTable('#myTable', {
	language: {
		searchBuilder: {
			title: 'Search Builder Title'
		}
	},
	layout: {
		topStart: {
			buttons: ['searchBuilder']
		}
	}
});

在標題中包含計數

new DataTable('#myTable', {
	language: {
		searchBuilder: {
			title: {
				0: 'Search Builder',
				_: 'Search Builder (%d)'
			}
		}
	},
	titles: ['SearchBuilder'],
	layout: {
		top1: 'searchBuilder'
	}
});

相關

以下選項是直接相關的,並且可能在您的應用程式開發中也很有用。