首页
/ jsPsych项目发布:survey-html-form插件2.1.0版本解析

jsPsych项目发布:survey-html-form插件2.1.0版本解析

2025-07-05 23:23:34作者:温玫谨Lighthearted

jsPsych是一个基于JavaScript的开源心理学实验框架,它允许研究者通过编写简单的JavaScript代码来创建复杂的实验流程。该框架提供了丰富的插件系统,其中survey-html-form插件是用于创建自定义HTML表单式调查问卷的重要组件。

2.1.0版本核心更新

本次2.1.0版本的更新主要围绕学术引用功能的增强展开。开发团队为所有插件和扩展添加了标准化的引用信息字段,这一改进体现了对学术规范的重视,也方便研究者在使用这些工具时能够正确引用。

新增功能详解

  1. 标准化引用信息字段:每个插件/扩展现在都包含一个citations属性,该属性存储了两种常见引用格式的信息:

    • APA格式:适合心理学领域论文的引用格式
    • BibTeX格式:适合LaTeX文档的引用格式
  2. 新增getCitations()方法:jsPsych主包中新增了这个实用函数,研究者可以通过以下方式使用:

    • 第一个参数:插件/扩展名称数组
    • 第二个参数:字符串,指定引用格式("apa"或"bibtex") 该方法会返回格式化后的引用字符串,多个引用之间用换行符分隔,并且总是首先输出jsPsych库本身的引用。
  3. 自动化引用生成:构建过程中,系统会自动从每个插件/扩展根目录下的.cff文件(如果有)生成引用信息,这一自动化流程确保了引用信息的准确性和一致性。

技术实现分析

这一更新的技术实现体现了良好的工程实践:

  1. 模块化设计:引用信息作为插件元数据的一部分,与功能代码分离,保持了代码的整洁性。

  2. 自动化构建流程:通过构建脚本自动处理.cff文件生成引用信息,减少了人工维护成本。

  3. API设计:getCitations()函数提供了简单直观的接口,研究者无需关心底层实现细节。

  4. 标准化支持:同时支持心理学领域常用的APA格式和学术写作常用的BibTeX格式,满足了不同用户的需求。

对研究实践的影响

这一更新对心理学实验研究具有重要意义:

  1. 促进学术规范:简化了正确引用实验工具的流程,有助于提高研究的可重复性和透明度。

  2. 提高工作效率:研究者不再需要手动查找和格式化引用信息,节省了宝贵的研究时间。

  3. 增强专业性:标准化的引用信息提升了实验工具的专业形象,也方便其他研究者追溯和验证实验方法。

使用建议

对于使用survey-html-form插件的研究者,建议:

  1. 在实验代码中适当位置调用getCitations()函数,将生成的引用信息包含在实验数据或实验报告中。

  2. 定期更新插件版本以确保引用信息的准确性。

  3. 对于自己开发的定制插件,可以考虑添加.cff文件以便自动生成引用信息。

这一更新虽然看似简单,但体现了jsPsych项目对学术严谨性的追求,也为心理学实验研究的标准化和规范化做出了贡献。

登录后查看全文
热门项目推荐