新风格版 条件格式插件

cybozu发表于:2017年01月06日 11:46:20更新于:2019年02月03日 10:46:13

Index

概要

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

更新信息

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

设置页面

0015bc6e64490885e018e58ce0606b8

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

0015bc6e9638680bbf6469ff3a71ed6

记录列表页面

0015bc6e9a6ef095e4791c89360cab3

记录详情页面

0015bc6eac7521f5bf06eea782a6818

使用插件

STEP1:设置表单

设置应用的格式。部署下列字段。

  • 条件格式字段
    部署用来比较条件的字段。可以设置以下项目:当比较文字和数值的条件的时候,使用 “文字条件格式”;当比较日期的条件的时候,使用 “日期条件格式” 。可以选择下面的字段。

  • <文字条件格式>

    • 单行文本框

    • 数值

    • 计算

    • 单选框

    • 下拉菜单

    • 记录编号

    • 多行文本框

    • 复选框

    • 多选

    • 状态(流程管理)(※只在记录列表页面反映)

  • <日期条件格式>

    • 日期

    • 日期和时间

    • 创建时间

    • 更新时间

  • 格式变更字段
    部署可变更格式的字段。可以选择“条件格式字段”所记载的全部的字段。

STEP2:在应用中添加插件

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

STEP3:设置插件

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

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

    项目名必须说明
    格式条件字段必须

    选择比较条件的字段。可设定STEP1的 “格式条件字段” 项目里记载的字段。
    复选框、多选里的任一个项目满足条件的话即可变更格式。

    条件式必须

    在比较条件式里可在下拉框选择下面的值。对象字段为数字的情形,可比较数字的大小。
    <文字条件格式>

    ○ 包含条件值

    ○ 不包含条件值

    ○ =(等于)

    ○ ≠(不等于)

    ○ ≦(以下)

    ○ <(更小)

    ○ ≧(以上)

    ○ >(更大)

    <日期条件格式>

    ○ =(等于)

    ○ ≠(不等于)

    ○ ≦(以前)

    ○ <(之前)

    ○ ≧(以后)

    ○ >(之后)

    条件値

    输入与格式条件字段的值做比较的值。
    <文字条件格式>

    ○ 两边都是半角数字的情形,作为数值数据进行条件比较。

    <日期条件格式>

    ○ 输入今天开始的整数天数、下拉框可选择“前・後”

    ○ 如果是设置今天,输入 0 (零)。

    格式变更字段必须

    选择要变更格式的字段。可选择STEP1的 “格式变更字段” 项目里记载的字段。

    文字颜色

    输入格式变更字段的文字颜色的颜色代码。
    点击毛笔图标显示颜色选择框,被选中颜色的颜色值将以“文字颜色”显示在输入框中。

    背景颜色

    输入格式变更字段的背景色的颜色代码。
    点击毛笔图标显示颜色选择框,被选中颜色的颜色值将以“文字颜色”显示在输入框中。

    大小

    选择格式变更字段的文字大小。可设定以下选项。

    ○ 不变更

    ○ 小

    ○ 稍小

    ○ 稍大

    ○ 大

    文字装饰


    在字体装饰列可以选择以下选项

    ○ 不更改

    ○  粗体

    ○ 下划线

    ○ 删除线

    【+】


    点击新增一行

    【-】


    点击删除该行
  3. 点击 “保存” 。
     ※必填项(格式条件字段、条件式、格式变更字段)未选择的行将被视为无效行,在点击保存时将被删除。

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

STEP4:使用插件

  1. 添加记录。

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

范例插件

访问plugin-sdk,并下载各个文件夹。这些文件夹的里面有一个叫 “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”。

打包后的范例

conditionformat2_plugin_v3.2.2.zip

更新履历

于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:修正了插件说明部分(中文部分)。

限制事项

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

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

  • 编辑记录,会解除格式。编辑后想反映变更的格式的话,请更新页面。

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

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

注意事项

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

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

  • 在本插件里,包含了一部分的DOM操作。kintone更新时,可能会受到影响,大家在参考的时候请留意这点。

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

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


    您需要登录后才可以回复