# 剪贴板

## platform.clipboard.write(text)

由宿主将文本写入系统剪贴板。参数会转成字符串，成功返回 `{ ok: true }`，失败时拒绝 Promise。

建议从用户点击事件中调用。浏览器可能要求安全上下文、用户操作或额外权限；`platform.can("clipboard.write")` 返回 `true` 不代表写入一定成功。

```js preview height=260
export default function render(root, platform) {
  const ui = platform.ui;
  const button = ui.button("复制分享文字", async () => {
    if (!platform.can("clipboard.write")) {
      ui.toast("当前设备不支持复制，请手动选择文字。");
      return;
    }
    try {
      await platform.clipboard.write("今天完成了三件事。");
      ui.toast("已经复制");
    } catch (error) {
      ui.toast(error instanceof Error ? error.message : "复制失败，请手动选择文字。");
    }
  });
  root.replaceChildren(ui.page([ui.card([
    ui.title("分享今天"),
    ui.hint("今天完成了三件事。"),
    button,
  ])]));
}
```

文档预览不会写入系统剪贴板，而是展示演示环境的错误提示。安装后的应用通过真实宿主调用。

当前没有剪贴板读取、图片复制或富文本复制 API。应用内部不要直接访问 `navigator.clipboard`，以便在不同端使用统一宿主接口。