react native search api تنزيل - react native search api تحميل كود المصدر

react native search api

شفرة المصدر الأخرى

1.0.0

تنزيل

رد فعل وحدة واجهة برمجة التطبيقات للبحث الأصلي

تمنحك وحدة SearchApi واجهة React Native عامة للتفاعل مع iOS Search API، Core Spotlight.

لمزيد من المعلومات حول واجهات برمجة تطبيقات بحث iOS، راجع https://developer.apple.com/ios/search/.

تثبيت

الجزء التلقائي

npm install react-native-search-api --save
react-native link

الجزء اليدوي

إلى الجزء العلوي من AppDelegate.m الخاص بك أضف السطر التالي:

# import " RCTSearchApiManager.h "

في تطبيق AppDelegate الخاص بك، قم بإضافة ما يلي:

- ( BOOL )application:(UIApplication *)application continueUserActivity:( NSUserActivity *)userActivity restorationHandler:( void (^)( NSArray * _Nullable))restorationHandler {
    return [RCTSearchApiManager application: application continueUserActivity: userActivity restorationHandler: restorationHandler];
}

الاستخدام

اشترك في الأحداث المفتوحة لعنصر البحث في مكوناتك مثل هذا:

 componentDidMount ( ) {
    < ... >
    SearchApi . addOnSpotlightItemOpenEventListener ( this . handleOnSpotlightItemOpenEventListener ) ;
    SearchApi . addOnAppHistoryItemOpenEventListener ( this . handleOnAppHistoryItemOpenEventListener ) ;
}

لمنع تسرب الذاكرة، لا تنس إلغاء الاشتراك:

 componentWillUnmount ( ) {
    < ... >
    SearchApi . removeOnSpotlightItemOpenEventListener ( this . handleOnSpotlightItemOpenEventListener ) ;
    SearchApi . removeOnAppHistoryItemOpenEventListener ( this . handleOnAppHistoryItemOpenEventListener )
}

بشكل عام، يجب أن تكون مهتمًا بما إذا كان التطبيق قد تم تشغيله باستخدام البحث، لذلك فكر في استخدام الطريقتين التاليتين:

 // For the spotlight item:
SearchApi . getInitialSpotlightItem ( ) . then ( result => {
    if ( result ) {
        console . log ( 'Started with a spotlight item!' )
    }
} )
// For the app history item:
SearchApi . getInitialAppHistoryItem ( ) . then ( result => {
    if ( result ) {
        console . log ( 'Started with an app history item!' )
    }
} )

لإنشاء عنصر تسليط الضوء جديد، استخدم indexSpotlightItem أو indexSpotlightItems :

 SearchApi . indexSpotlightItem ( item ) . then ( result => {
    console . log ( 'Success' ) ;
} ) . catch ( err => {
    console . log ( 'Error: ' + err ) ;
} ) ;

لإضافة عناصر جديدة إلى سجل التطبيق، استخدم createUserActivity :

 SearchApi . indexAppHistoryItem ( item ) . then ( result => {
    console . log ( 'Success' ) ;
    that . setState ( { labelText : 'Success' } ) ;
} ) . catch ( err => {
    console . log ( 'Error: ' + err ) ;
    that . setState ( { labelText : ( 'Error: ' + err ) } ) ;
} ) ;

المعلمات التي قد تحددها العناصر مذكورة أدناه:

البحث عن مفاتيح العناصر

تحتوي القواميس، التي تم تمريرها لإنشاء عناصر بارزة وسجل التطبيقات، على بعض المفاتيح الشائعة وبعض المفاتيح المحددة، إليك قائمة بجميع المفاتيح الممكنة.

المفاتيح المشتركة

`title` : سلسلة

عنوان السلعة. مطلوب لكلا النوعين من العناصر.

`contentDescription` : سلسلة

وصف السلعة. خياري.

`keywords` : مصفوفة

مجموعة من الكلمات الرئيسية المخصصة لعنصر البحث. خياري.

`thumbnail` : سلسلة|int|object

الصورة المصغرة التي سيتم عرضها في نتائج البحث. نفس تنسيق source في مكون Image . خياري.

أمثلة:

 var localItem = {
  < ... > ,
  thumbnail : require ( '/react-native/img/favicon.png' )
} ;
var remoteItem = {
  < ... > ,
  thumbnail : { uri : 'https://facebook.github.io/react-native/docs/assets/favicon.png' }
} ;