Index

• 获取记录列表的查询字符串

• 获取记录列表的查询字符（带选项）

• 获取字段元素

• 获取记录列表菜单的右边空白部分的元素

• 获取记录列表菜单的下侧空白部分的元素

• 获取关联记录列表的参照对象的应用ID

• 获取Lookup字段的参照对象的应用ID

• 获取Header下侧的空白部分的元素

获取记录列表的查询字符串

用查询字符串获取现在打开着的记录列表的筛选信息。

• 可在PC专用版和移动端专用版上使用。

• 贴在空间里的应用无法使用。

• 要获取显示条数（limit）、显示开始位置（offset）及显示顺序（order by）请使用 kintone.app.getQuery() 这个API。

• 包含空间里的应用以及其应用的试用环境页面。

函数

参数

无

返回值

• 返回字符串或者 null 。

• 当记录列表页面没有筛选条件的时候，返回空字符串。

• 当页面为不可使用的页面时，返回 null 。

范例

var condition = kintone.app.getQueryCondition();
console.log(condition);
// 获取值的例子
// 'record_id <= "5" and creator in ("Administrator")'

可使用的页面

• 记录列表页面

• 图表页面

获取记录列表的查询字符（带选项）

用查询字符串（带选项 ）获取现在打开着的记录列表的筛选信息。

• 可在PC专用版和移动端专用版上使用。

• 贴在空间里的应用无法使用。

• 空间里的应用也包含应用的试用环境的页面。

函数

参数

无

返回值

• 返回字符串或者 null 。

• 当页面为不可使用的页面时，返回 null 。

• 没有筛选的情况下，返回排列顺序（order by）、显示条数（limit）、位置（offset）的查询字符串。※仅记录列表页面

• 没有排序条件的情况下，只返回显示条数（limit）、位置（offset）的查询字符串。 ※仅记录列表页面

• 对于移动端，如果在“更新选项”中选择‘禁用“在移动版中筛选记录的功能”’，将不会获取显示条数（limit）或位置（offset）。
  

范例

var query = kintone.app.getQuery();
console.log(query);
// 获取值的例子
// 'record_id <= "5" and creator in ("Administrator") order by record_id desc limit 5 offset 10'

可使用的页面

• 记录列表页面

• 图表页面

获取字段元素

指定字段代码，获取对应记录列表的字段元素的数组。

• 可在PC端和移动端上使用。

• 贴在空间里的应用无法使用。

• 包括空间里的应用以及应用的试用环境的页面。

• 可通过更改DOM的style属性，来改变字体颜色或则背景色。

• 如果改变了DOM内部构造，可能会导致标准功能无法正常运行，或在kintone版本升级后无法正常运行。

函数

参数

返回值

• 返回字段元素的数组或者 null。

• 当页面为不可使用的页面时，返回 null 。

• 如果一条记录都没有的情况下返回空数组。

• 当字段不存在的情况，或者指定了未显示的字段的情况下，返回 null。

范例

kintone.app.getFieldElements(fieldCode);

无法获取字段

指定以下字段的情况，返回 null。

• 表格

• 表格中的字段

可用的页面

• 记录列表页面

其他

行内编辑中的状态下使用函数的话，返回包含编辑UI的元素。

获取记录列表菜单的右边空白部分的元素

• 只可在PC端使用。

• 贴在空间里的应用无法使用。

函数

kintone.app.getHeaderMenuSpaceElement()

参数

无

返回值

• 返回菜单（添加・列表・筛选・图表）右侧的空白部分的元素。

• 当页面为不可使用的页面时，返回 null 。

范例

var el = kintone.app.getHeaderMenuSpaceElement();

可用的页面

• 记录列表页面

获取记录列表菜单的下侧空白部分的元素

• 只可在PC端使用。

• 贴在空间里的应用无法使用。

函数

kintone.app.getHeaderSpaceElement()

参数

无

返回值

• 返回菜单（添加・列表・筛选等）和记录列表之间的空白部分的元素。

• 当页面为不可使用的页面时，返回 null 。

范例

var el = kintone.app.getHeaderSpaceElement();

可用的页面

• 记录列表页面

获取关联记录列表的参照对象的应用ID

指定关联记录列表的字段代码，取得参照对象的应用ID。

• 只可在PC端使用。

• 贴在空间里的应用无法使用。

详细请阅读获取记录详细信息。

获取Lookup字段的参照对象的应用ID

指定Lookup字段的字段代码，获取参照对象的应用ID。

• 只可在PC端使用。

• 贴在空间里的应用无法使用。

详细请阅读获取记录详细信息。

获取Header下侧的空白部分的元素

• 只可在移动端使用。

• 贴在空间里的应用无法使用。

详情请参考取得Header下侧的空白部分的元素 。