Options
All
  • Public
  • Public/Protected
  • All
Menu

Interface CCSetupOptions

客户端初始化配置信息

Hierarchy

Index

Properties

appRoot

appRoot: string

答题程序所在的根据路由位置, 一般用location.origin即可 但是如果程序是深层路由中,则一定要指定具体的位置, 核心包需要依赖此进行路由跳转时避免跑到上层路径中

Optional dynamic

dynamic: boolean

指定该客户端是不是动态加载模板的 对支持动态加载的客户端,核心会尝试去动态模板服务器上加载动态的模板。 当前只有web版客户端有可能支持动态模板功能,小程序和本地应用不支持该功能,所以无需配置。 默认:false

Optional hostConfig

hostConfig: CCHostConfig

资源访问地址配置 默认情况下都指向正式环境服务器的资源地址,如果想访问其他服务器的资源 则需要重写该配置,详情请看每个具体的属性说明 默认:正式环境服务的资源地址

Optional key

key: string

os-client的开发者凭证,这是个保留属性,暂时可以不设置 默认:空字符串

Optional langSrcMap

langSrcMap: object

如果觉得核心包中逻辑相关的提示文字多语言翻译不满足你的要求,或者支持的语言不够多 你可以配置该属性指定使用自己准备的翻译文本,这个配置的每个属性的属性名是语言代号, 其属性值是该语言翻译文本对象 比如,核心模块当前仅提供了中文(zh_cn)和英文(en_us)的多语言 现在你对核心模块的中文翻译是满意的但是对核心模块的英文的翻译内容不满意, 这样你就可以配置该属性如下内容

{
 en_us: {...}
}

以上配置会覆盖掉默认的英文翻译,当进行英文翻译时,会只用你提供的这个对象作为翻译依据, 核心模块提供的英文翻译会被丢弃

如果在此基础上,同时你希望有日文版的多语言翻译,这时你可以添加配置日文翻译文本

{
 en_us: {...}
 ja_jp: {...}
}

以上的配置覆盖了英文翻译,同时新增了日文翻译。

每个json对象要准备的数据格式在LANG_ZH_CN中做出了示范.

各种语言的代号可参照百科全书

我们统一使用xx_xx小写字母加下划线形式的代号

默认值:空

Type declaration

  • [key: string]: any

Optional templatePath

templatePath: string

动态加载的模板文件夹所在路径 如果是动态加载的,则一定要准备好该属性, 核心会去这个路径寻找动态模板文件, 如果dynamic属性指定为true,而不提供这个路径,初始化时会报错。 当前只有web版客户端有可能支持动态模板功能,小程序和本地应用不支持该功能,所以无需配置。 默认:空字符串

Optional treeUrl

treeUrl: string

模板树所在地址,如果指定一定要指定根目录开始的绝对路径。 如果是动态加载的,则一定要准备好该属性 核心会去获取这个文件来了解动态模板的依赖情况, 如果dynamic属性指定为true,而不提供这个路径,初始化时会报错。 当前只有web版客户端有可能支持动态模板功能,小程序和本地应用不支持该功能,所以无需配置。 默认:/tree.json

Optional useWxSdk

useWxSdk: boolean

是否要使用wx sdk 当前只有web版可能支持,小程序和本地应用不支持该功能,所以无需配置。 默认:false

Methods

alert

  • alert(message: string): void
  • 弹框方式提示消息,比提示消息更重要一些,需要弹框,并且用户点击后才消失

    Parameters

    • message: string

    Returns void

Optional customAbort

  • customAbort(): void
  • 自定义中断回调方法 当核心包中运行发生异常,或者需要去往外部程序时,会中断答题流程,同时触发调用这个方法 客户端中可以配置该方法来在此时机做一些自定义的事情。 默认行为:总是会在方法被调用的一秒内压制系统消息

    Returns void

error

  • error(message: string): void
  • 严重错误消息提示方法 如尝试下载某份问卷进行作答,但这份问卷已经下线,则不会得到问卷内容 而是会发出一个类似”问卷已下线“的错误消息 通过配置该方法来决定如何在UI中展示这些错误消息。 发生任何错误后,不允许继续操作。

    Parameters

    • message: string

      错误内容

    Returns void

Optional locateError

  • 如果在单页模式中有很多题目,进行作答后点击下一题,其中某道题目的答案不满足要求, 这时候可能这道题目不再滚动条所在的可见范围内, 通过配置该方法,可以自定义定位错误的方式。 第一个参数中有一个[[CFValidateResult.dueToNode]]属性,找到该题目,定位其位置。 比如:可以移动滚动条到有错误的题目位置。 注意这个方法只需用来定位有错误的题目,至于题目中有什么错误,不归这里管,那个归题目渲染模板管。 默认行为:什么都不做

    Parameters

    Returns void

markLoadRetry

  • 加载因失败次数挂起的提示

    Parameters

    • data: CCLoadRetry

      消息,如果有内容说明加载失败,等待用户手动重试,如果没有内容,则说明重试后加载成功

    Returns void

notify

  • notify(message: string): void
  • 常规消息提示方法,如果一道必答题还没有进行作答就点击下一题按钮 这时候不会进入下一题,而是会发出类似”必须作答“这样的提示消息, 通过配置该方法来决定如何在UI中展示这些提示消息。

    Parameters

    • message: string

      消息内容

    Returns void

Optional setLocale

  • setLocale(key: string): void
  • 设置该方法来监听核心包的多语言变化,当核心包多语言切换时,会调用该方法 UI程序中监听到这个变化后也要切换多语言 才能做到核心包提示的信息和UI组件中自己的显示内容使用了同一种语言 不支持多语言的客户端可以不配置这个方法 默认行为:什么都不做

    Parameters

    • key: string

      变化后的语言代号,如zh_cn,

    Returns void

Optional setTheme

  • 如果有配置该方法,问卷主题发生变化时,该方法会被调用。 然后可以做一些自定义的事情。 不支持系统主题的客户端不需要配置这个方法 默认行为:什么也不做

    Parameters

    Returns void

Optional switchRoute

  • 自定义的去往开始页面方法,只有使用web核心包是需要关注这个方法

    非web核心包使用者无需配置该方法。

    web定制核心包中配置的页面切换方法是使用的浏览器原始location.replace方法实现的 当使用了单页引用页面的框架实现web客户端时,原生的跳转方法可能会导致页面刷新,使得单页应用的状态丢失。 而不同的框架在单页面内控制路由控制的方式是不一样的,所以需要用该方法提供。

    默认行为:浏览器原生location.replace跳转

    Parameters

    Returns void

Optional uploadLog

  • uploadLog(message: string, level?: "log" | "error"): void
  • 上传日志的方法,核心包运行时会生成一些有利于追踪已知错误的日志,希望能通过这个方法上传。 如果不设置则不会上传错误。而是在控制台打印出来

    Parameters

    • message: string
    • Optional level: "log" | "error"

    Returns void

Generated using TypeDoc