يمكنك السماح بظهور روابط متعددة في سلسلة نصية واحدة لتنفيذ إجراءات مختلفة عند النقر على قسم فرعي من النص.
توافق الإصدار
يتطلّب هذا التنفيذ ضبط الحد الأدنى من إصدار حزمة تطوير البرامج (SDK) لمشروعك على المستوى 21 من واجهة برمجة التطبيقات أو مستوى أعلى.
التبعيات
عرض روابط متعددة في سلسلة واحدة
تضمِّن هذه المقتطفات روابط متعددة يمكن النقر عليها في سلسلة نصية واحدة:
@Composable fun AnnotatedStringWithLinkSample() { // Display multiple links in the text Text( buildAnnotatedString { append("Go to the ") withLink( LinkAnnotation.Url( "https://developer.android.com/", TextLinkStyles(style = SpanStyle(color = Color.Blue)) ) ) { append("Android Developers ") } append("website, and check out the") withLink( LinkAnnotation.Url( "https://developer.android.com/jetpack/compose", TextLinkStyles(style = SpanStyle(color = Color.Green)) ) ) { append("Compose guidance") } append(".") } ) }
النقاط الرئيسية حول الرمز
- يستخدم الدالة
buildAnnotatedString
لإنشاء سلسلة مُشارَك فيها ملاحظات نصية. - تحدِّد هذه الدالة تنسيق الرابط والنص من خلال تمريرها كوسيطات لدالة
LinkAnnotation.Url()
(التي يتم تمريرها كوسيطة لدالةwithLink()
). تم تضمين مستمع النقرات فيLinkAnnotation.Url()
. - تضيف نصًا باستخدام
append()
في نص الدالةwithLink
. - تكرار هذه العملية لإضافة مقطع نصي مرتبط آخر
النتائج
![سلسلة نصية واحدة تحتوي على رابطَين مختلفَين](https://developer.android.google.cn/static/quick-guides/content/multiple-links.png?hl=ar)
المجموعات التي تتضمّن هذا الدليل
هذا الدليل هو جزء من مجموعات الأدلة السريعة المنظَّمة التي تتناول أهداف تطوير Android الأوسع نطاقًا:
![](https://developer.android.google.cn/static/images/quick-guides/collection-illustration.png?hl=ar)
النص الذي يظهر للمستخدم
يشكّل النص جزءًا مركزيًا من أي واجهة مستخدم. تعرَّف على الطرق المختلفة
التي يمكنك من خلالها عرض النص في تطبيقك لتوفير تجربة رائعة للمستخدم.
إذا كانت لديك أسئلة أو ملاحظات
يمكنك الانتقال إلى صفحة الأسئلة الشائعة والاطّلاع على الأدلة السريعة أو التواصل معنا وإعلامنا برأيك.