更新记录

1.0（2026-05-29）

@smartwork/contract-sign-ui

uni-app 签署 UI 组件（P1–P3 逐步迁入）。

当前状态

安装（团队内）

将本目录复制到目标项目的 uni_modules/contract-sign-ui，或在 pages 中相对路径引用 packages/contract-sign-ui。

组件 API

• 使用手册（场景 + 示例 + API 大全）：docs/contract-sign-user-guide.md
• 抽取方案定稿：docs/contract-sign-component-library.md 第 3 节

PdfSignViewer 快速示例

<PdfSignViewer
  :pdf-url="contract.filePath"
  :sign-position="contract.signPosition"
  :signed-map="signedMap"
  view-only
  @load="({ pageCount, anchors }) => {}"
  @anchor-click="({ anchorId, anchor }) => {}"
/>

<SignPad
  :visible.sync="visible"
  title="请签名"
  :landscape="true"
  pen-color="#000"
  :pen-width="2"
  @export="({ base64, pngBytes, hasStroke }) => { /* ... */ }"
/>

// ref 调用
this.$refs.signPad.open()
this.$refs.signPad.clear()
const { base64, bytes } = await this.$refs.signPad.exportPng()
this.$refs.signPad.close()

renderjs 注意

• pdf.js worker 版本须与 pdfjs-dist 一致（当前 3.11.174）
• 画板继续用 renderjs + 指令，勿改回 Vue 层 canvas

平台兼容性

@smartwork/contract-sign-ui

uni-app 签署 UI 组件（P1–P3 逐步迁入）。

当前状态

安装（团队内）

将本目录复制到目标项目的 uni_modules/contract-sign-ui，或在 pages 中相对路径引用 packages/contract-sign-ui。

组件 API

• 使用手册（场景 + 示例 + API 大全）：docs/contract-sign-user-guide.md
• 抽取方案定稿：docs/contract-sign-component-library.md 第 3 节

PdfSignViewer 快速示例

<PdfSignViewer
  :pdf-url="contract.filePath"
  :sign-position="contract.signPosition"
  :signed-map="signedMap"
  view-only
  @load="({ pageCount, anchors }) => {}"
  @anchor-click="({ anchorId, anchor }) => {}"
/>

<SignPad
  :visible.sync="visible"
  title="请签名"
  :landscape="true"
  pen-color="#000"
  :pen-width="2"
  @export="({ base64, pngBytes, hasStroke }) => { /* ... */ }"
/>

// ref 调用
this.$refs.signPad.open()
this.$refs.signPad.clear()
const { base64, bytes } = await this.$refs.signPad.exportPng()
this.$refs.signPad.close()

renderjs 注意

• pdf.js worker 版本须与 pdfjs-dist 一致（当前 3.11.174）
• 画板继续用 renderjs + 指令，勿改回 Vue 层 canvas