可执行HTML：一种动态评估生态瞬时评估协议的自定义HTML元素的集合

软件X 14（2021）100691原始软件出版物可执行HTMLNikolaosBatalas，Vassilis-Javed Khan，Panos Markopoulos埃因霍温理工大学，Den Dolech 2，5600MB，埃因霍温，荷兰ar t i cl e i nf o文章历史记录：收到2020年2021年4月1日接受保留字：经验抽样方法动态评估生态瞬时评估自定义HTML元素可执行HMTLa b st ra ct可执行HTML是自定义HTML元素的集合，为文档作者提供了在HTML5中编写和执行过程逻辑的能力。我们讨论了这种方法的动机，这在于临床心理学研究的正式门诊评估协议的组成，并提供了一个概述的软件的内部工作原理。对于该领域的研究人员来说，该提议允许单个HTML文档作为人类可读和计算机可执行的数据收集协议表示，可以使传播和复制更容易的研究。版权所有2021作者。由爱思唯尔公司出版这是CC BY许可下的开放获取文章（http://creativecommons.org/licenses/by/4.0/）中找到。代码元数据当前代码版本v0.0.1用于此代码版本的代码/存储库的永久链接https://github.com/ElsevierSoftwareX/SOFTX_2020_59代码海洋计算舱无法律代码许可BSD-3-Clause使用git的代码版本控制系统使用HTML、CSS、JavaScript的编译要求、操作环境依赖性支持Web组件的浏览器技术支持电子邮件nikolaos. gmail.com1. 动机和意义1.1. 门诊评估研究的复制是困难的临床心理学采用一类称为动态评估（AA）方法的研究方法，其目的是在日常生活中捕捉生物心理社会过程[1]。这些方法现在大多通过移动设备（例如智能手机和相关外围设备）进行。对回答者进行采样，有时每天多次，既用于作为对问卷的回答的自我报告（例如，关于感觉和想法），也用于来自其设备上的传感器的数据流（例如，GPS位置、光强度读数、步数、心率测量）。为了进行数据收集，研究人员使用软件应用程序，其中他们准备的材料，*通讯作者。电子邮件地址：nikolaos. gmail.com（Nikolaos Batalas）.https://doi.org/10.1016/j.softx.2021.100691研究（例如，问题），并具体说明向答复者提供这些材料的方式（例如，根据所作答复将调查表分成不同的部分，或规定作出答复的时间用于收集数据的材料的组合以及向参与者提供这些材料的方式（在AA研究中主要由程序逻辑组成）形成了研究方案[2]。AA研究面临的一个重要问题是研究方案难以详细公布和重新实施[3，4]。在出版物中，研究人员用自然语言描述了他们的协议。将数字协议详细地转录成自然语言，并在软件系统中从自然语言源重建它们可能是费力且容易出错的任务。当描述计算机程序时，自然语言可能会导致歧义[5]。这损害了AA研究的可复制性。1.2. 通用平台上的单一表示可以帮助Web浏览器是一个无处不在的平台，具有丰富的功能。它为Web的构建提供了肥沃的土壤2352-7110/©2021作者。 由Elsevier B.V.出版。这是一篇开放获取的文章，使用CC BY许可证（http://creativecommons.org/licenses/by/4.0/）。可在ScienceDirect上获得目录列表SoftwareX期刊主页：www.elsevier.com/locate/softxNikolaos Batalas、Vassilis-Javed Khan和Panos Markopoulos软件X 14（2021）1006912表1用于过程执行的自定义元素。元素名称描述aa-session要注入的内容的根容器，以及数据收集会话aa-sequence一次实例化一个其子元素，作为有序序列的成员。也响应于接收到的具有阻塞行为的元素的信号（例如，等待用户按下按钮）。aa-选择条件语句的容器。aa-when在满足其条件时实例化其内容AA-否则在不满足任何条件时实例化其内容。aa-variable显式设置变量值aa-jump告诉序列下一个实例化它的哪个直接子级。表2AA材料的自定义元素。元素名称aa-text-answer用于自由文本输入的文本字段。aa-multiple-choice以单选按钮形式显示的一组选项从中选择一个。aa-checkboxes以复选框形式显示的一组选项，可从中进行选择。aa-choice-item在aa-多项选择或aa-复选框中的选择。aa-李克特尺度李克特尺度容器，本质上是一种特定的aa-多项选择的配置aa-geolocation检索用户aa-screen将内容组合在一起，并为用户提供一个应用或混合移动应用（即，还在本地主机平台中调用定制功能的Web应用程序），供研究人员进行AA研究。在之前的工作中[6]，我们试图利用可能的优势，专门或主要在浏览器中运行AA研究，同时允许将协议作为程序组成。结果表明，该方法可以适当地服务于研究的实际用例[7]，并提出了整个协议是否可以表示为HTML的问题。虽然用HTML编写AA研究的材料通常很简单，但HTML脚本中不支持过程逻辑。因此，我们贡献了一组自定义HTML元素，帮助将HTML文档的某些部分视为可执行程序。此外，提供额外的自定义元素，更容易声明常用的材料，有助于提高抽象层次的语法元素的网页，语义的AA研究。其结果是AA方案在材料和程序方面的正式、明确的表示，该表示是人类可读和计算机可执行的，并作为AA研究描述和实施的单一来源，可用于AA研究方案的准确传播和复制[8]。2. 软件描述这个软件是一个自定义HTML元素的集合，这些元素是由Web组件[9]实现的，Web组件是一组技术，在HTML5规范中。Web组件允许用户定义自己的HTML标记，当浏览器解析时，这些标记将被实例化为相应的自定义元素。自定义元素JavaScript，用于在元素生命周期的不同阶段执行浏览器编写本自定义元素集是为了实现3个目标：能够在文档被初始解析后将HTML节点的子树注入部分或渐进地呈现信息的典型方法是，在允许浏览器实例化所有可能的节点之后，隐藏一些节点，以便稍后响应用户交互时使它们可见。在我们的例子中，内容实例化和附加到文档必须只在适当的时候发生，因为自定义元素可以是各种任务的代理（例如，向服务器发送HTTP请求，或者启动硬件的功能，例如GPS位置检索）。规定注射如何发生，例如同步顺序、有条件等。作者应该能够定义执行流程。为了允许一般情况下，软件需要提供vide顺序执行，条件分支，读/写内存操作，并能够跳转到程序序列中的不同点。表1中列出的自定义元素可以实现这些目的。提供使用域活动语义的HTML标记，并减少布局语法元素的使用为了使领域专家更容易理解HTML文档，它使用与应用程序领域的语言相匹配的术语。表2列出了内容和面向用户界面的元素的指示性子集，这些元素封装HTML语法，并使用标记名描述其在AA协议中的实用性。2.1. 软件构架图1给出了组成软件发布的自定义元素的概述以及它们之间的关系。所有元素都继承自aa-base-element，后者为它们提供了一组公共函数。一般来说，执行过程如下：1. 附加时，aa-session将查看其直接子级的标记名称。如果它们中的任何一个属于元素集，它将删除它们的内部HTML并将其放置在作为该元素的成员的文档片段对象中。这可以防止它们的内容被实例化，因此每个人都可以决定如何单独处理它。2. 大多数其他元素在附加到DOM时，将扫描它们给定的文档片段，并使用它们自己的直接子元素执行相同的替换。然后，每一个都将根据其功能采取适当的操作来选择和附加内容。例如，aa-session将在每个执行周期中附加一个子节点的副本（图1）。 2a），而aa-choose只会附加其aa-的副本，当孩子的测试条件评估为真（图。2b）。将节点复制到DOM中，而不是将节点从文档片段中移到DOM中，允许这些元素多次执行，并在必要时在文档中生成新内容。3. 像aa-choose、aa-jump或aa-variable这样的元素也会调度和在接收时，它将附加下一个子节点的副本，然后顺序执行。诸如aa-sequence之类的元素不会分派这样的事件，但允许用户界面决定何时应该完成，例如一旦用户已经按下···Nikolaos Batalas、Vassilis-Javed Khan和Panos Markopoulos软件X 14（2021）1006913Fig. 1. 自定义元素派生自HTMLElement的一个子类aa-base-element，它为这些元素提供了一组处理其内容的通用方法。4. 生成数据（从用户输入或其他来源捕获）的元素将其包含在分派的“end "事件中反过来，它可以向URI发送HTTP POST请求，通过“post-to”属性分配给它3. 说明性实例3.1. 10打印机$（205.5+ RND（1））;：转到10这个著名的Commodore 64 BASIC oneliner [10]随机生成\或/并以无限循环的方式打印字符，产生迷宫般的图像。再现它让我们演示变量的写入和读取，顺序和条件表达式，以及可执行HTML中的跳转清单1中显示了一个等效的程序，图3显示了结果输出。3.2. 问卷的随机部分在某些情况下，问卷上的不同项目鼓励参与者在之前的一项研究[11]要求参与者报告其社会互动的不同方面，其中有不同的组成部分。清单2显示了用于问卷调查的示例的构造，其中选择了三个可能的aa屏幕元素之一4. 影响HTML通常用作结构化信息的语言在设计它时，Tim Berners-Lee提倡最小功率规则[12]，根据该规则，选择用于解决方案的语言越不强大，就越容易分析和重用该语言中表示的数据。因此，HTML被故意设计成不是一种完整的编程语言，而是为了声明信息材料及其语法特征，以便解析HTML的软件可以对其执行不同的操作，例如以不同的方式呈现它，或者从中提取特定类型的信息。然而，促进用户与Web文档中的信息的交互也很重要。在现代Web浏览器中，虽然文档内容是用HTML表示的，但交互和过程任务是用JavaScript编程语言指定的。最终，Web文档作者需要同时使用HTML和JavaScript，这对于那些没有JavaScript程序员思维的人来说可能很困难在临床心理学领域，到目前为止，该软件正在解决的用例中，用于构建计算机化协议材料的最终用户友好的方式总是可取的[13]。此外，正在努力对协议组件进行编目和形式化[14]。HTML是一种表示这类信息的方式，既可读又形式上易于处理[15]。这里提供的自定义Nikolaos Batalas、Vassilis-Javed Khan和Panos Markopoulos软件X 14（2021）1006914图二、 aa-sequence和aa-choose的执行流程。图三. 清单1的输出。允许方案作者在描述材料的同时，也向研究参与者描述在AA领域，所提出的方法可以通过以下方式产生影响：它可以减少，或在常见的情况下，消除需要编写的编程语言，并使数据收集协议的分发和复制更容易获得的研究人员。此外，有大量的工具支持HTML的合成和发布，非常广泛的用户专业知识，并且可以用来支持自定义HTML元素的合成。同样的文档也可以像数据一样轻松处理而不是输入到浏览器。不同专业之间的比较可以通过自动化的方式进行，并与他们帮助收集的数据相匹配例如，不同版本的协议文件可以与每个版本鼓励的参与者的依从性进行对比。··Nikolaos Batalas、Vassilis-Javed Khan和Panos Markopoulos软件X 14（2021）1006915它是独立于平台的，不特定于任何特定的应用程序框架或软件产品，专有或其他。它的采用可以通过作为软件组件来减轻生产AA工具的负担，并鼓励来自不同供应商的软件之间的互操作性作为协议导入/导出格式。5. 结论本文提出了一种在命令式程序中将HTML内容作为状态处理的方法，即通过自定义HTML元素实例化并在HTML文档中附加其子节点。这项工作的动机源于开发一个软件系统，用于定义心理学中的动态评估协议（例如，在一段持续的时间内，对现场参与者进行反复在这一领域，有机会通过以正式、明确的表示详细描述过程和材料，而不是当前文献中占主导地位的自然语言，来服务于研究的可重复性。虽然这项工作起源于AA研究的背景下，它可能是在其他应用程序中使用的最终用户，可以使用HTML来指定编程行为，而不必用JavaScript编写代码，或者减少他们必须这样做的程度。竞合利益作者声明，他们没有已知的竞争性财务利益或个人关系，可能会影响本文报告的工作引用[1]Conner TS，Mehl MR.动态评估：研究日常生活的方法。社会和行为科学的新兴 趋 势 ： 一 个 跨 学 科 的 ， 可 搜 索 的 ， 可 链 接 的 资 源 。 Wiley OnlineLibrary;2015.[2]Vogt WP，Johnson RB.统计学方法词典&：社会科学非技术指南。Sage;2011.[3]Stone AA，Shiffman S.捕捉瞬间的自我报告数据：报告指南提案。行为医学年鉴2002;24（3）：236-43。得双曲正切值.doi.org/10.1207/S15324796ABM2403_09网站。[4]斯 通 河 实 时 数 据 采 集 领 域 仍 然 存 在 挑 战 。 2017 年 ，URLhttps://cesr.usc.edu/documents/SAA。[5]Ince DC ， Hatton L ， Graham-Cumming J. 开 放 计 算 机 程 序 的 案 例 。Nature2012;482（7386）：485.[6]Batalas N，Markopoulos P.计算机化现场数据收集平台的考虑因素。第四届ACM SIGCHI工程交互计算系统研讨会论文集。EICS '12，New York，NY，USA ： ACM; 2012 ， p. 231-6.http://dx.doi.org/10.1145/2305484.2305522 ，URLhttp://doi.acm.org/10.1145/2305484.2305522。[7]Batalas N，aan het Rot M，Khan VJ，Markopoulos P.使用TEMPEST：基于网 络 的 生 态 瞬 时 评 估 协 议 的 最 终 用 户 编 程 。 Proc ACM Comput Interact2018;2（EICS）. http://dx.doi.org/10.1145/3179428.·Nikolaos Batalas、Vassilis-Javed Khan和Panos Markopoulos软件X 14（2021）1006916[8] Batalas N ， Khan V-J ， Franzen M ， Markopoulos P ， aan het Rot M. 在HTML5中正式表示动态评估协议，以便于人类阅读和计算机执行。Behav ResMethods 2019;51（6）：2761-76。http://dx.doi.org/10.3758/s13428-018-1148-y网站。[9] W3C。Web组件。2016年，访问：2020-01-28，https://github.com/w3c/webcomponents/。[10]Montfort N，Baudoin P，Bell J，Bogost I，Douglass J，Marino MC，MateasM，Reas C，Sample M，Vawter N. 10 PRINT $（205.5+ RND（1））;：GOTO 10.MIT Press;2012.[11]Bosman RC，Albers CJ，de Jong J，Batalas N，aan het Rot M. 9名自我报告的经前综合征妇女的情绪和人际行为没有月经周期性。精神病理学2018;51（4）：290[12]放大图片作者：Berners-Lee T.最小功率法则2006年，URLhttps：//www.w3.org/2001/tag/doc/leastPower.html网站。[13]作者声明：John E.超卡在心理学研究和教学中的潜力：一般性讨论和描述两个研究应用。Behav Res Methods Instrumum Comput1989;21（2）：307-11.[14]吴文辉，陈文辉.经验抽样方法（ESM）项目库。Open Sci Framework 2019.http://dx.doi.org/10.17605/OSF.IO/KG376，网址https：//osf.io/kg376/网站。[15]Khare R，Rifkin A.物种的起源（文件）。计算机网络综合业务数字网系统1998;30（1）：389-97.