Titanium SDK 中的 Clipboard 模块详解：跨应用数据共享利器-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00626/article/details/148782626

Titanium SDK 中的 Clipboard 模块详解：跨应用数据共享利器

titanium-sdk 🚀 Native iOS and Android Apps with JavaScript 项目地址: https://gitcode.com/gh_mirrors/ti/titanium-sdk

概述

在移动应用开发中，剪贴板(Clipboard)是实现数据共享的重要机制。Titanium SDK 提供的 Titanium.UI.Clipboard 模块为开发者提供了跨平台的剪贴板操作能力，允许应用间或应用内进行数据交换。本文将深入解析这一模块的功能特性和使用方法。

核心功能

剪贴板本质上是一个临时数据存储区，用于保存单个数据项，用户可以通过复制粘贴操作在不同应用或同一应用的不同部分间共享数据。

平台差异说明

iOS/macOS：支持多种数据类型（文本、图片、URL、颜色等），并能存储同一数据项的多种表示形式
Android：目前仅支持文本数据的存储和读取

数据类型支持

Titanium.UI.Clipboard 模块支持以下数据类型：

文本数据：使用 'text' 或 'text/plain' 类型标识
图片数据：使用 'image' 或具体图片 MIME 类型（如 'image/jpg'）
URL 数据：使用 'url' 或 'text/uri-list' 类型标识
颜色数据：iOS/macOS 平台特有支持

常用方法详解

基础操作方法

文本操作
- setText(text)：存储文本到剪贴板
- getText()：从剪贴板获取文本
- hasText()：检查剪贴板是否有文本内容
- clearText()：清除剪贴板中的文本
通用数据操作
- setData(type, data)：存储指定类型的数据
- getData(type)：获取指定类型的数据
- hasData(type)：检查是否存在指定类型的数据
- clearData([type])：清除指定类型或所有数据

高级功能（iOS/macOS 特有）

多项目操作
- setItems(items, options)：批量设置多个剪贴板项目
- getItems()：获取所有剪贴板项目
类型检查
- hasURLs()：检查是否有 URL 数据
- hasImages()：检查是否有图片数据
- hasColors()：检查是否有颜色数据

实际应用示例

基础文本操作

// 清空剪贴板
Ti.UI.Clipboard.clearText();

// 设置文本
Ti.UI.Clipboard.setText('你好，世界！');

// 检查并获取文本
if (Ti.UI.Clipboard.hasText()) {
    const text = Ti.UI.Clipboard.getText();
    Ti.API.info('剪贴板内容：' + text);
}

多数据类型操作（iOS/macOS）

// 存储多种数据格式
Ti.UI.Clipboard.setData('text/plain', '普通文本');
Ti.UI.Clipboard.setData('text/html', '<b>HTML文本</b>');

// 检查并获取特定类型数据
if (Ti.UI.Clipboard.hasData('text/html')) {
    const html = Ti.UI.Clipboard.getData('text/html');
    // 处理HTML内容
}

高级批量操作（iOS/macOS）

// 设置多个剪贴板项目并添加隐私选项
const options = {};
options[Ti.UI.CLIPBOARD_OPTION_LOCAL_ONLY] = true; // 仅限本应用使用
options[Ti.UI.CLIPBOARD_OPTION_EXPIRATION_DATE] = new Date(2025, 0, 1); // 设置过期时间

Ti.UI.Clipboard.setItems({
    items: [
        {'text/plain': '普通文本'},
        {'public.url': 'https://example.com'}
    ],
    options: options
});

// 获取所有项目
const items = Ti.UI.Clipboard.getItems();
Ti.API.info(JSON.stringify(items));

命名剪贴板（iOS/macOS 特有）

从 SDK 6.1.0 开始，iOS/macOS 平台支持创建命名剪贴板，实现更精细的剪贴板管理：

// 创建或获取命名剪贴板
const myClipboard = Ti.UI.createClipboard({
    name: 'myAppClipboard',
    allowCreation: true
});

// 使用命名剪贴板
myClipboard.setText('私有数据');