設定欄位的樣式

目錄

設定欄位的樣式

為目前開啟的記錄的欄位設定樣式。

此API為非同步API。 若需同步處理,請參閱以下頁面。

函式

PC

kintone.app.record.setFieldStyle(fieldCode, config)

行動裝置

kintone.mobile.app.record.setFieldStyle(fieldCode, config)

引數

參數名稱 類型 必填 說明
fieldCode 字串 必填 要設定樣式的欄位的欄位代碼
config 物件/字串 必填 樣式設定
  • 指定物件時,依該設定套用樣式至欄位。
  • 指定 DEFAULT 時,解除所有樣式的套用。
config.content 物件/字串 可省略 套用至欄位內容的樣式設定
  • 指定物件時,依該設定套用樣式。
  • 指定 DEFAULT 時,解除樣式套用。
config.content.backgroundColor 字串 可省略 欄位內容的背景色
#ffffff 等 16 進制 6 位數的色碼指定。
config.content.color 字串 可省略 欄位內容的文字色
#ffffff 等 16 進制 6 位數的色碼指定。
config.content.fontWeight 字串 可省略 欄位內容的字體粗細
可指定以下值。
  • normal
  • bold
config.content.textDecoration 字串 可省略 欄位內容的底線或刪除線等裝飾
可指定以下值。
  • none
  • underline
  • line-through
config.content.borderColor 字串 可省略 欄位內容的框線顏色
#ffffff 等 16 進制 6 位數的色碼指定。
config.background 物件/字串 可省略 套用至欄位背景的樣式設定
  • 指定物件時,依該設定套用樣式。
  • 指定 DEFAULT 時,解除樣式套用。
config.background.backgroundColor 字串 可省略 欄位背景的背景色
#ffffff 等 16 進制 6 位數的色碼指定。
config.label 物件/字串 可省略 套用至欄位名稱的樣式設定
  • 指定物件時,依該設定套用樣式。
  • 指定 DEFAULT 時,解除樣式套用。
config.label.color 字串 可省略 欄位名稱的文字色
#ffffff 等 16 進制 6 位數的色碼指定。
config.label.fontWeight 字串 可省略 欄位名稱的字體粗細
可指定以下值。
  • normal
  • bold
config.label.textDecoration 字串 可省略 欄位名稱的底線或刪除線等裝飾
可指定以下值。
  • none
  • underline
  • line-through

透過對各屬性設定 DEFAULT 字串,可個別解除樣式套用。

返回值

返回值為 Promise 物件。
Promise 物件解析時不返回值。

範例程式碼

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
// 設定
const config = {
  content: { // 欄位內容(輸入元素等)的樣式
    backgroundColor: '#95d542',
    color: 'DEFAULT', // 解除樣式
    fontWeight: 'bold',
    textDecoration: 'none',
    borderColor: '#ff8f00'
  },
  background: { // 欄位背景的樣式
    backgroundColor: '#ffbf00'
  },
  label: { // 欄位名稱的樣式
    color: '#ff4949',
    fontWeight: 'bold',
    textDecoration: 'underline'
  }
};

// 套用樣式
await kintone.app.record.setFieldStyle('單行文字方塊_', config);

// 解除樣式
await kintone.app.record.setFieldStyle('單行文字方塊_', 'DEFAULT');

可使用的畫面

PC
  • 新增記錄畫面
  • 編輯記錄畫面
  • 記錄詳情畫面
  • 記錄列印畫面
行動裝置
  • 新增記錄畫面
  • 編輯記錄畫面
  • 記錄詳情畫面

注意事項

裝飾設定的組合可能導致輕微的顯示異常。
今後產品更新後,各屬性對應的細部裝飾範圍等可能會有所變更。

限制事項

以下欄位不支援。

  • 狀態
  • 執行者
  • 表格
  • 表格內的欄位
  • 關聯記錄清單
  • 群組
  • 分隔線
  • 標籤
  • 空白

以下欄位不支援 content 的設定。

  • 新增記錄/編輯記錄畫面
    • 文字編輯方塊
    • 計算
    • 記錄號碼
    • 建立人
    • 建立時間
    • 更新人
    • 更新時間
    • 已啟用「自動計算」的單行文字方塊
  • 記錄詳細/列印畫面
    • 文字編輯方塊