Index

• 注意事项

• 概要

• 使用插件

• 范例插件

• 限制事项

• 所使用的OSS许可证信息

注意事项

• 直接使用此处提供的程序范例的情况，才望子不予以保证程序的正常运行。

• 才望子不提供对程序范例的技术支持。

• v2.1.3以前的插件更新到此版本时，请到插件的设置页面再保存一次设置。

• kintone的插件功能只可在标准版使用，简易版不可使用这点请大家注意一下。

概要

此篇是介绍如何将示例中 “在记录列表中设置条件格式 ” 的JavaScript程序做成插件。
在kintone应用添加这个插件后，打开记录列表、记录详情页面的时候，可以根据字段的条件来显示不同的文字颜色、背景颜色和字体大小。

更新信息

• 2017/03/31 新增行的添加/删除按钮。其他更新信息请参考更新履历。
  

设置页面

设置页面（点击画笔图标时出来的颜色选取面板 ※下图为Chrome浏览器显示效果）

记录列表页面

记录详情页面

使用插件

STEP1:在应用中添加插件

在应用中添加新的条件格式插件。添加插件的方法请参考kintone帮助。
在应用中添加插件

STEP2:设置插件

1. 打开应用的设置页面的 “设置”＞“插件”，点击新条件格式插件的齿轮图标。

2. 设置以下各个项目。（加粗部分为2017/03/31更新后添加的项目）
   

   项目名	必须	说明
   条件字段	必须	选择比较条件的字段。 当比较文字和数值的条件时，使用 “文字条件格式”； 当比较日期的条件时，使用 “日期条件格式” 。 可以选择以下字段。 ＜文字条件格式＞ ○ 单行文本框 ○ 数值 ○ 计算 ○ 单选框 ○ 下拉菜单 ○ 记录编号 ○ 多行文本框 ○ 复选框 ○ 多选 ○ 日期 ○ 日期和时间 ○ 创建时间 ○ 更新时间 ○ 状态（流程管理）（※只在记录列表页面反映） ＜日期条件格式＞ ○ 日期 ○ 日期和时间 ○ 创建时间 ○ 更新时间 ※复选框、多选里的任一个项目满足条件的话即可变更格式。
   条件公式	必须	在比较条件式里可在下拉框选择下面的值。对象字段为数字的情形，可比较数字的大小。 ＜文字条件格式＞ ○ 包含条件值 ○ 不包含条件值 ○ =(等于) ○ ≠(不等于) ○ ≦(小于或等于) ○ <(小于) ○ ≧(大于或等于) ○ >(大于) ＜日期条件格式＞ ○ =(等于) ○ ≠(不等于) ○ ≦(以前) ○ <(早于) ○ ≧(以后) ○ >(晚于)
   条件值		输入与格式条件字段的值做比较的值。 ＜文字条件格式＞ ○ 两边都是半角数字的情形，作为数值数据进行条件比较。 ○ 如果格式条件字段中选择的字段类型为以下字段，则必须输入条件值。 ○ 日期 ○ 日期和时间 ○ 创建时间 ○ 更新时间 ＜日期条件格式＞ ○ 输入今天开始的整数天数、下拉框可选择“前/后”。 ○ 如果是设置今天，输入 0 (零)。
   要更改格式的字段	必须	选择要更改格式的字段。 您可以选择“条件字段”中列出的所有字段。
   字体颜色		输入要更改格式的字段的字体颜色的颜色值。 点击画笔图标显示颜色选择框，被选中颜色的颜色值将以“字体颜色”显示在输入框中。
   背景色		输入要更改格式的字段的背景色的颜色值。 点击画笔图标显示颜色选择框，被选中颜色的颜色值将以“背景色”显示在输入框中。
   文字大小		选择要更改格式的字段的文字大小。可设定以下选项。 ○ 不更改 ○ 小 ○ 稍小 ○ 稍大 ○ 大
   字体装饰		选择要更改格式的字段的字体装饰。可设定以下选项。 ○ 不更改 ○  粗体 ○ 下划线 ○ 删除线
   【+】		点击新增一行
   【-】		点击删除该行

点击 “保存” 。
 ※必填项（条件字段、条件公式、要更改格式的字段）未选择的行将被视为无效行，在点击保存时将被删除。

在 “应用的设置” 页面点击 “更新应用”，插件的设置就会反映到应用里。

STEP3:使用插件

1. 添加记录。

2. 在记录列表页面和记录详情页面，根据设置内容更改对象字段的格式。

范例插件

访问GitHub，并下载各个文件夹。这些文件夹的里面有一个叫“examples/conditionformat2”的，是这次使用的整个文件包。
以下是“conditionformat2”下的文件结构。

conditionformat2/ 
 css/
  -51-modern-default.css
  -config.css
 html/ 
  -config.html
 image/
  -icon.png
 js/
  -config.js
  -desktop.js
 manifest.json

参考插件开发流程的打包，打包成“conditionformat2”。

更新履历

于2016/02/26 发布v2.0
于2016/03/17 发布v2.1.0 ：可指定背景颜色
于2016/06/09 发布v2.1.1 ：更改了图标和名称。修正了来宾空间对应以及选择状态时的缺陷。
于2016/11/08 发布v2.1.2 ：修正后 “条件值” 项目可输入空文字。修正了判断数值的逻辑。
于2016/12/12 发布v2.1.3 ：修正了以下的缺陷。

• 在流程管理无效的应用里，选择 “条件字段”，“要更改格式的字段”的状态时会报错的缺陷。

• 打开记录为0条的列表时会出现错误的缺陷

2017/03/31 发布v3.0.0 ：添加了下面的功能。

• 添加了设置项目里行的添加/删除按钮

• 设置项目的本地化对应（英语、中文）

• 设置里添加粗体、删除线、下划线

• 颜色选择框对应(只适用Firefox, Chrome)

• 更改日期条件格式的条件值的设置方法

• 设置页面上流程管理的 “状态” 项目的设置值的名称更改成了 “状态(流程管理)”

• 流程管理无效的时候，修改成：无法选择 “状态(流程管理)” 项目

• 列表页面更改背景色时添加了border的框线

• 其他CSS、逻辑变更等轻微修正

2017/06/29 发布v3.1.0 ：添加了下面的功能。

• 针对文字条件格式 “条件字段” 的对象项目，添加了日期、日期与时间、创建时间、更改时间字段

• 日期条件格式 “要更改格式的字段” 的对象项目，添加了 “状态(流程管理)”

• 修复了要更改格式的字段里选择复选框、多选的时候的情形，没有设置条件也可以运行的情况

• 日期条件格式中没有输入条件值，就显示错误信息

• CSS文件替换成了51-modern-default.css

• 设置页面一部分文言修改（只限英语版）

• 其他逻辑变更等轻微修正

2017/08/02 发布v3.1.1 ：添加了下面的功能。

• 添加了从v2.1.3以前的版本升级到v3.1.1 时的互换性对应。详细如下。
  - v3.1.1 中打开插件的设置页面时，自动设置v2.1.3以前设定的初始值。
  - 根据v2.1.3以前设定的设置，应用条件格式。

• 其他轻微修正

2018/07/20 发布v3.2.0 ：修改了下面的地方。

• 文字颜色和背景色的设置，更改了颜色框的类型，更改后Chrome、Firefox之外的浏览器也可以正常运行。

• 设置页面一部分文言修改（只限英语版）

2018/10/11 发布v3.2.1：修改了下面的地方。

• 文字条件格式 “条件字段” 里设置日期字段的时候，
  修复了当记录里日期字段没有值的时候，之后的条件格式无效的缺陷。

2018/10/17 发布v3.2.2：修改了插件说明部分（只限中文版）。

2019/05/10 发布v3.2.3：修改了在列表页面中保存值后也能应用条件格式。

2021/08/24 发布v3.2.4：罗列了此插件使用的外部库的信息，并将此信息文件添加到插件中。

2022/09/06 发布了v3.2.5：

• 将JavaScript代码改写为ES6之后的写法。

• 插件的名称和说明的地方删除了“新风格版”的字样。

限制事项

• Internet Explorer 8上无法使用此插件。

• 智能手机无法使用此插件。

• 满足多个条件时，则下面的行优先；文字条件格式和日期条件格式，以日期条件格式为优先。
  关于背景色，设置了上面的行，且没有设置下面的行的情况下，上面的行的设置将被生效。

• 列表页面的表示形式只对应了表格形式的情况，无法适用在日历形式、自定义的情况下。

所使用的OSS许可证信息

此插件使用的OSS许可证如下：

• Moment.js - MIT License

• jQuery - MIT License

• JsRender - MIT License

• tinyColorPicker and colors - MIT License

• color-paint-brush in config.html
  @fontawesome - CC BY 4.0 License

• 51-modern-default - MIT License