ReactNative/share

Share

مثال

• مثال لمكون دالة (Function Component Example):

import React from 'react';
import { Share, View, Button } from 'react-native';
​
const ShareExample = () => {
  const onShare = async () => {
    try {
      const result = await Share.share({
        message:
          'React Native | A framework for building native apps using React',
      });
      if (result.action === Share.sharedAction) {
        if (result.activityType) {
          // shared with activity type of result.activityType
        } else {
          // shared
        }
      } else if (result.action === Share.dismissedAction) {
        // dismissed
      }
    } catch (error) {
      alert(error.message);
    }
  };
  return (
    <View style={{ marginTop: 50 }}>
      <Button onPress={onShare} title="Share" />
    </View>
  );
};
​
export default ShareExample;
​

• مثال لمكون صنف (Class Component Example)

import React, { Component } from 'react';
import { Share, View, Button } from 'react-native';
​
class ShareExample extends Component {
  onShare = async () => {
    try {
      const result = await Share.share({
        message:
          'React Native | A framework for building native apps using React',
      });
​
      if (result.action === Share.sharedAction) {
        if (result.activityType) {
          // shared with activity type of result.activityType
        } else {
          // shared
        }
      } else if (result.action === Share.dismissedAction) {
        // dismissed
      }
    } catch (error) {
      alert(error.message);
    }
  };
​
  render() {
    return (
      <View style={{ marginTop: 50 }}>
        <Button onPress={this.onShare} title="Share" />
      </View>
    );
  }
}
​
export default ShareExample;

التّوابع

share()‎

static share(content, options)

يقوم بفتح مربّع حوارٍ لمشاركة محتوىً نصيٍّ.

عند استخدامه على المنصة iOS فإنّه يُعيد وعدًا (Promise) يقبَل بواسطة كائنٍ يحوي مفتاحين action و activityType، إذا رفض المستخدم مربّع الحوار فإن الوعد سيستدعى بجعل قيمة المفتاح action مساويةً Share.dismissedAction مع ترك بقية المفاتيح دون تعريفٍ. مع ملاحظة أن بعض خيارات المشاركة لن تظهر أو لن تعمل عند العمل على محاكي iOS.

أما عند استخدامه على منصّة Android فإنه يُعيد وعدًا يُقبل دائمًا بجعل قيمة المفتاح action مساويةً Share.sharedAction.

المحتوى (content)

• message : الرّسالة المُراد مشاركتها.

على منصّة iOS

• url : رابط (URL) المراد مشاركته.

يتطلّب رابطًا واحدًا ورسالةً واحدةً على الأقلّ.

على منصّة Android

• title: عنوان الرّسالة المُراد مشاركتها.

الخيارات (options)

على منصة iOS

• subject : الموضوع المُراد مشاركته عبر البريد الالكتروني
• excludedActivityTypes
• tintColor

على منصّة Android

• dialogTitle

sharedAction

static sharedAction

تمّت مشاركة المحتوى بنجاحٍ.

dismissedAction

static dismissedAction

تم رفض صندوق الحوار هذا، ويُستخدم على منصّة iOS فقط.

مصادر

• صفحة Share في توثيق React Native الرسميّ