شارك المقالة
نسخ النص في Flutter باستخدام Clipboard وSelectableText

نسخ النص في Flutter باستخدام Clipboard وSelectableText

نسخ النص في Flutter عبر Clipboard مع انتظار النتيجة ومعالجة الفشل، وإتاحة تحديد النص باستخدام SelectableText والتمييز بين النسخ والمشاركة.

نسخ النص في Flutter عبر Clipboard مع انتظار النتيجة ومعالجة الفشل، وإتاحة تحديد النص باستخدام SelectableText والتمييز بين النسخ والمشاركة.

النسخ يختلف عن المشاركة

Clipboard ينقل النص إلى حافظة النظام ليستخدمه المستخدم في موضع آخر. هذا لا يفتح قائمة مشاركة ولا يرسل النص إلى جهة اتصال ولا يمنح تطبيقك إذن قراءة محتوى تطبيقات أخرى. إذا كان المنتج يحتاج مشاركة إلى تطبيق آخر فذلك تدفق منفصل بواجهة مناسبة للمنصة. اجعل تسمية الزر تصف العملية التي ينفذها بالفعل، ولا تكتب مشاركة بينما ينفذ الكود setData ثم تعرض رسالة توحي أن رسالة وصلت إلى شخص.

النص المنسوخ يجب أن يطابق المتوقع

المثال القديم كان يعرض نصًا ثم ينسخ قيمة مختلفة عند الضغط المباشر وقيمة أخرى عند الضغط المطول. هذا سلوك مربك إذا لم يُشرح للمستخدم. استخدم مصدرًا واحدًا للنص في العرض والنسخ، وخاصة مع الأوامر البرمجية والأرقام. لا تضف مسافات أو علامات اتجاه خفية إلى القيمة المنسوخة لمجرد أنها تساعد العرض. لو كانت هناك صيغة منسقة وأخرى خام فوضّح ما الذي سيصل إلى الحافظة، واختبر النص العربي والمختلط والأسطر المتعددة.

انتظر العملية وتعامل مع الخطأ

Clipboard.setData يعيد Future؛ انتظره قبل إعلان نجاح الطلب، وتعامل مع خطأ المنصة برسالة مفهومة. افحص mounted بعد الانتظار قبل استخدام context أو setState، لأن الصفحة قد تكون غادرت الشجرة. المثال يمنع تكرار الطلب أثناء الانتظار ويعيد حالة الزر في finally. لا تختبر نجاح النسخ بطباعة النص كاملًا في السجل؛ قد يكون المستخدم ينسخ معلومات لا ترغب في نشرها ضمن سجلات التشخيص. صحة callback لا تغني عن اختبار المنصة الفعلية.

التحديد للمستخدم

SelectableText يتيح تحديد جزء من النص واستخدام إجراءات التحديد المتاحة، بينما زر النسخ ينسخ القيمة التي حددها المطور. اختر تجربة تناسب الحاجة، ويمكن توفير الاثنين للنص التعليمي. المثال يعتمد قائمة التحديد الافتراضية بدل نسخ خصائص قديمة مثل toolbarOptions دون مراجعة الإصدار. إذا احتجت قائمة مخصصة فراجع contextMenuBuilder وعقد الأدوات الحالية. إتاحة التحديد لا تجعل النص قابلًا للتحرير مثل TextField، ولا ينبغي إضافة controller إدخال لمجرد أن المستخدم يستطيع تحديد فقرة.

خصوصية الحافظة وحدود المنصات

الحافظة مساحة مشتركة تتبع سياسات النظام وقد تتأثر بأذونات المتصفح أو السياق الآمن أو إيماءة المستخدم في الويب. استدعِ النسخ من تفاعل واضح، ولا تنفذ قراءة مستمرة للحافظة عند كل build. لا تستخدمها مخزنًا دائمًا للأسرار أو tokens، ولا تمسحها لاحقًا بلا تنسيق فقد يكون المستخدم نسخ قيمة جديدة من تطبيق آخر. نجاح اختبار بقناة منصة وهمية يثبت طلبك البرمجي ومعالجة فشله، لكنه لا يثبت سلوك كل متصفح أو جهاز.

مراجعة المثال

اضغط Copy text وتأكد أن النص المتوقع يمكن لصقه في محرر على المنصة المستهدفة، ثم جرّب تحديد كلمة بدل الفقرة كلها. اختبر الضغط السريع ومغادرة الصفحة أثناء الطلب ومسار فشل القناة في اختبار آلي. مع نص كبير راجع سهولة القراءة والتمرير وحجم الخط والاتجاه. رسالة Copy request completed تصف اكتمال طلب النسخ في هذا المثال، ولا تثبت أن المستخدم لصق القيمة أو قرأها. إذا أضفت تحليلات فاحفظ حدثًا عامًا دون النص المنسوخ نفسه إلا وفق حاجة وسياسة واضحة.

مثال مستقل للتجربة

شغّل المثال داخل مشروع Flutter تجريبي. يعتمد على Material فقط ولا يحتاج assets أو أصنافًا من مشروع خاص. غيّر مساحة النافذة وجرّب تكبير النص أثناء الفحص، ثم انقل المكوّن إلى مشروعك بعد تحديد سياق قيوده الفعلي.

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
void main() => runApp(const MaterialApp(home: DemoPage()));
class DemoPage extends StatefulWidget {
  const DemoPage({super.key});
  @override
  State<DemoPage> createState() => _DemoPageState();
}
class _DemoPageState extends State<DemoPage> {
  static const text = 'Flutter example: مرحبًا بالمطور';
  bool _copying = false;
  String _status = 'Ready';
  Future<void> _copy() async {
    if (_copying) return;
    setState(() { _copying = true; });
    try {
      await Clipboard.setData(const ClipboardData(text: text));
      if (!mounted) return;
      setState(() { _status = 'Copy request completed'; });
    } catch (_) {
      if (!mounted) return;
      setState(() { _status = 'Could not copy; try selecting the text'; });
    } finally {
      if (mounted) setState(() { _copying = false; });
    }
  }
  @override
  Widget build(BuildContext context) => Scaffold(
    appBar: AppBar(title: const Text('Copy text')),
    body: ListView(padding: const EdgeInsets.all(16), children: [
      const SelectableText(text),
      const SizedBox(height: 16),
      ElevatedButton(onPressed: _copying ? null : _copy, child: const Text('Copy text')),
      Text(_status),
    ]),
  );
}

مرجع الواجهة البرمجية

راجع التوثيق الرسمي لمطابقة السلوك مع إصدار Flutter المستخدم. نجاح المثال في مساحة واحدة لا يثبت توافق التصميم مع جميع الشاشات؛ اختبر حدود الانتقال والاتجاه واللغة والنص الطويل.

الصور والفيديو من الشرح السابق

الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.

how to copy text from Flutter | شرح كيفية نسخ نص داخل فلاتر بطرق متنوعة
شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع