Appearance
Class: QysUKeySdk
SDK 类,通过 QysUKeySdk 进行 sdk 实例创建
Table of contents
Constructors
Properties
Methods
- addFile
- addStamper
- close
- doSwitchDocument
- downloadCurrentFile
- downloadFile
- execAfterUiReady
- getCurrentDocument
- getDocuments
- getUI
- getVerifyResult
- hideThirdBtnFn
- isNeedSave
- isNoAp
- removeDocument
- render
- setConfig
- showSeal
- showThirdBtnFn
- showVerifyContent
- signPdf
- unmount
- updateConfig
Constructors
constructor
• new QysUKeySdk(params?)
Parameters
| Name | Type |
|---|---|
params | Partial<QysUKeySdkConfig> |
Properties
bus
• bus: Emitter<QYS_SDK_INNER_EVENTS>
事件总线:一般在应用内部使用,参考 QYS_SDK_INNER_EVENTS 事件列表,标为内部调用的不建议通过 SDK 进行调用
config
• config: QysUKeySdkConfig
QysUKeySdk 配置项
container
• container: null | Element = null
签章页面所挂载的根元素:可以用来判断当前页面是否挂载
store
• Private store: null | RematchStore<RootModel, Record<string, never>> = null
签章页面 store, 内部使用
storeSnapShoot
• Private storeSnapShoot: null | RematchRootState<RootModel, Record<string, never>> = null
签章页面 store 快照, 用于一些数据对比,内部使用
uiReady
• Private uiReady: boolean = false
签章页面组件是否完成挂载
version
▪ Static version: string = version
当前版本号
Methods
addFile
▸ addFile(file): void
添加单个或多个文件
Parameters
| Name | Type |
|---|---|
file | undefined | CustomFileData | File | FileList | CustomFileData[] |
Returns
void
addStamper
▸ addStamper(type?): void
向当前PDF页面添加印章(仅H5生效)
Parameters
| Name | Type | Default value |
|---|---|---|
type | StamperType | 'SEAL_CORPORATE' |
Returns
void
close
▸ close(): void
卸载页面,unmount 的别名
Returns
void
doSwitchDocument
▸ doSwitchDocument(docId): void
根据文件 id 切换文件
Parameters
| Name | Type | Description |
|---|---|---|
docId | string | 文件 id,一般通过 getDocuments() 获取到文件列表,选择切换的文件传入其 id |
Returns
void
downloadCurrentFile
▸ downloadCurrentFile(): void
如果当前文件存在,则下载当前文件
Returns
void
downloadFile
▸ downloadFile(file): void
指定下载文件
Parameters
| Name | Type | Description |
|---|---|---|
file | FileDescriptor | 参数 file 可以通过 getDocuments 获取到的结果指定 |
Returns
void
execAfterUiReady
▸ Private execAfterUiReady(cb, args?): void
在页面 React 组件挂载完成后进行执行,内部调用
Parameters
| Name | Type | Default value |
|---|---|---|
cb | (...args: any) => any | undefined |
args | any[] | [] |
Returns
void
getCurrentDocument
▸ getCurrentDocument(): null | FileDescriptor
返回当前文件描述信息对象
Returns
null | FileDescriptor
getDocuments
▸ getDocuments(): FileDescriptor[]
返回已添加的文件描述信息列表
Returns
getUI
▸ getUI(style?): HTMLDivElement
渲染单体签章页面并返回应用挂载的 dom 容器
Parameters
| Name | Type | Description |
|---|---|---|
style | Partial<CSSStyleDeclaration> | 返回的 dom 容器的 css 样式 |
Returns
HTMLDivElement
getVerifyResult
▸ getVerifyResult(): Signature[]
获取当前文件的所有验签信息
Returns
hideThirdBtnFn
▸ hideThirdBtnFn(): void
Returns
void
isNeedSave
▸ isNeedSave(): boolean
当前是否需要进行保存签名
Returns
boolean
isNoAp
▸ isNoAp(): boolean
当前是否为无外观印章
Returns
boolean
removeDocument
▸ removeDocument(id): void
从当前文件列表中移除指定文件
Parameters
| Name | Type | Description |
|---|---|---|
id | string | id 为文件描述信息中的 id 字段 |
Returns
void
render
▸ render(container): void
将单体签章页面渲染到指定容器上
Parameters
| Name | Type |
|---|---|
container | Element |
Returns
void
setConfig
▸ Private setConfig(config): void
设置当前 sdk 配置项,内部调用
Parameters
| Name | Type |
|---|---|
config | QysUKeySdkConfig |
Returns
void
showSeal
▸ showSeal(): void
控制左侧签章工具面版的展示
Returns
void
showThirdBtnFn
▸ showThirdBtnFn(): void
Returns
void
showVerifyContent
▸ showVerifyContent(): void
控制左侧验签工具栏展示
Returns
void
signPdf
▸ signPdf(): void
签署需要保存的pdf文件
Returns
void
unmount
▸ unmount(): boolean
卸载单体签章页面
Returns
boolean
updateConfig
▸ updateConfig(config): void
更新当前配置信息
Parameters
| Name | Type |
|---|---|
config | Partial<QysUKeySdkConfig> |
Returns
void