عرض مصدر ReactNative/text

<noinclude>{{DISPLAYTITLE:المكون Text في React Native}}</noinclude>
مكوّن [[React]] لعرض النصوص.

يدعم المكوّن ‎‎<code>Text</code>‎‎ النصوص المتداخلة والتنسيق ومعالجة اللمسات.

في المثال التالي، يرث العنوان المتداخل والنص الأساسي خاصيّة <code>fontFamily</code> من ‎‎<code>styles.baseText</code>‎‎، لكن العنوان يوفّر أنماطا إضافية خاصة به. سيتم تكديس العنوان والنص الأساسي فوق بعضهما البعض عند الوصول إلى محارف الأسطر الجديدة (literal newlines):

* [https://snack.expo.dev/@hsoubwiki/text-functional-component-example مثال لمكون دالة (Function Component):]
<syntaxhighlight lang="javascript">
import React, { useState } from "react";
import { Text, StyleSheet } from "react-native";

const TextInANest = () => {
  const [titleText, setTitleText] = useState("Bird's Nest");
  const bodyText = "This is not really a bird nest.";

  const onPressTitle = () => {
    setTitleText("Bird's Nest [pressed]");
  };

  return (
    <Text style={styles.baseText}>
      <Text style={styles.titleText} onPress={onPressTitle}>
        {titleText}
        {"\n"}
        {"\n"}
      </Text>
      <Text numberOfLines={5}>{bodyText}</Text>
    </Text>
  );
};

const styles = StyleSheet.create({
  baseText: {
    fontFamily: "Cochin"
  },
  titleText: {
    fontSize: 20,
    fontWeight: "bold"
  }
});

export default TextInANest;
</syntaxhighlight>

* [https://snack.expo.dev/@hsoubwiki/text-class-component-example مثال لمكون صنف (Class Component):]
<syntaxhighlight lang="javascript">
import React, { Component } from "react";
import { Text, StyleSheet } from "react-native";

class TextInANest extends Component {
  constructor(props) {
    super(props);
    this.state = {
      titleText: "Bird's Nest",
      bodyText: "This is not really a bird nest."
    };
  }

  onPressTitle = () => {
    this.setState({ titleText: "Bird's Nest [pressed]" });
  };

  render() {
    return (
      <Text style={styles.baseText}>
        <Text
          style={styles.titleText}
          onPress={this.onPressTitle}
        >
          {this.state.titleText}
          {"\n"}
          {"\n"}
        </Text>
        <Text numberOfLines={5}>{this.state.bodyText}</Text>
      </Text>
    );
  }
}

const styles = StyleSheet.create({
  baseText: {
    fontFamily: "Cochin"
  },
  titleText: {
    fontSize: 20,
    fontWeight: "bold"
  }
});

export default TextInANest;
</syntaxhighlight>
==النصوص المتداخلة==
يتيح كل من نظامي iOS وAndroid عرض نص منسق عن طريق التعليق (annotating) على نطاقاتِ سلسلةٍ نصيّة بتنسيقات محددة لجعله نصًّا غامقًا أو ملونًا مثلًا (‎‎<code>NSAttributedString</code>‎‎ على iOS و‎‎<code>SpannableString</code>‎‎ على Android). عمليًّا، هذا شاق للغاية. في React Native، يُمكن استخدام صيغة الويب لهذا الغرض، حيث يمكنك تدخيل النص لتحقيق التأثير نفسه.

إليك المثال التالي ([https://snack.expo.dev/@hsoubwiki/nested-text-example تجربة حية]):
<syntaxhighlight lang="javascript">
import React from 'react';
import { Text, StyleSheet } from 'react-native';

const BoldAndBeautiful = () => {
  return (
    <Text style={styles.baseText}>
      I am bold
      <Text style={styles.innerText}> and red</Text>
    </Text>
  );
};

const styles = StyleSheet.create({
  baseText: {
    fontWeight: 'bold'
  },
  innerText: {
    color: 'red'
  }
});

export default BoldAndBeautiful;
</syntaxhighlight>
وراء الكواليس، يُحوِّل React Native هذا إلى سلسلة <code>NSAttributedString</code> نصيّة مسطحة أو سلسلة <code>SpannableString</code> نصيّة تحتوي على المعلومات التالية:

<syntaxhighlight lang="javascript">
"I am bold and red"
0-9: bold
9-17: bold, red
</syntaxhighlight>

==الحاويات==
عنصرُ ‎‎<code><Text></code>‎‎ فريدٌ (unique) بالنسبة إلى التخطيط (relative to layout): لم يعد كل شيء بداخله يستخدم تخطيط [[CSS/flex|flexbox]] بل يستخدم تخطيط النص. هذا يعني أن العناصر الموجودة داخل عنصر ‎‎<code><Text></code>‎‎ لم تعد مستطيلة الشكل، ولكنها تلتف (wrap) عندما تصل إلى نهاية السطر.

<syntaxhighlight lang="javascript">
<Text>
  <Text>First part and </Text>
  <Text>second part</Text>
</Text>
// Text حاوية
// سيكون النص في نفس السطر إن سمحت المساحة بذلك
// |First part and second part|

// إن نفِدَت المساحة، فسيتصرف النص وكأنه كتلة واحدة
// |First part |
// |and second |
// |part       |

<View>
  <Text>First part and </Text>
  <Text>second part</Text>
</View>

// View حاوية
// كل نصّ يُعدّ كتلة منفصلة

// |First part and|
// |second part   |

// إن نفِدَت المساحة، سيجري النص داخل كتلته الخاصة
// |First part |
// |and        |
// |second part|
</syntaxhighlight>
==وراثة أنماط محدودة==
على الويب، الطريقة المعتادة لتعيين خطٍّ وحجم خطٍّ للمستند بأكمله هي الاستفادة من خصائص [[CSS]] الموروثة كما يلي:
<syntaxhighlight lang="css">
html {
  font-family: 'lucida grande', tahoma, verdana, arial, sans-serif;
  font-size: 11px;
  color: #141823;
}
</syntaxhighlight>

سوف ترث جميع العناصر الموجودة في المستند هذا الخط ما لم تُحدِّد هي (أي العناصر) أو أحد عناصرها الأجداد قاعدةً جديدة.

في React Native، الأمر أشدّ صرامة، إذ عليك تغليف جميع العقد النصية (text nodes) داخل مكوّن ‎‎<code><Text></code>‎‎. لا يمكن وضع عقدة نصية مباشرة أسفل مكوّن ‎‎<code><View></code>‎‎.
<syntaxhighlight lang="javascript">
// سيرمي هذا خطأً، لا يمكن وضع عقدة نصية داخل المكون
// <View>
<View>
  Some text
</View>

// هذا هو الصواب
<View>
  <Text>
    Some text
  </Text>
</View>
</syntaxhighlight>
ستفقد أيضًا القدرة على تعيين خطٍّ افتراضيّ لشجرة فرعية بالكامل. و الخاصيّة <code>fontFamily</code> لا تقبل سوى اسم خط واحد، وهذا مختلف عن الخاصية ‎‎<nowiki/>[[CSS/font-family|<code>font-family</code>‎‎]] في [[CSS]]. الطريقة الموصى بها لاستخدام خطوطٍ وأحجامٍ موحّدة عبر تطبيقك هي إنشاء مكوّن باسم ‎‎<code>MyAppText</code>‎‎ مثلًا يتضمن هذه الخاصيات واستخدام هذا المكون في تطبيقك. يمكنك أيضًا استخدام هذا المكون لإنشاء مكونات أكثر تحديدًا مثل مكوّنِ <code>MyAppHeaderText</code> لأنواع أخرى من النصوص.
<syntaxhighlight lang="javascript">
<View>
  <MyAppText>
    Text styled with the default font for the entire application
  </MyAppText>
  <MyAppHeaderText>Text styled as a header</MyAppHeaderText>
</View>
</syntaxhighlight>

بافتراض أن <code>MyAppText</code> مكونٌ لا يعرض سوى مكوناته الأبناء داخل مُكون <code>Text</code> مع تنسيق محدّد، فيمكن تعريف المكوّن <code>MyAppHeaderText</code> على النحو التالي:
<syntaxhighlight lang="javascript">
class MyAppHeaderText extends Component {
  render() {
    return (
      <MyAppText>
        <Text style={{ fontSize: 20 }}>
          {this.props.children}
        </Text>
      </MyAppText>
    );
  }
}
</syntaxhighlight>

تركيب المكوّن <code>MyAppText</code> بهذه الطريقة يضمن الحصول على الأنماط من أحد مكوّنات المستوى الأعلى، مع إمكانية تعديلها أو إضافة أنماط جديدة في حالات استخدامٍ محددة.

مفهوم وراثة الأنماط ما زال موجودًا في React Native، ولكنّه يقتصر على أشجار النصوص الفرعيّة (text subtrees). في هذه الحالة، سيكون الجزء الثاني غامقًا وأحمرًا:
<syntaxhighlight lang="javascript">
<Text style={{fontWeight: 'bold'}}>
  I am bold
  <Text style={{color: 'red'}}>and red</Text>
</Text>
</syntaxhighlight>
نعتقد أن هذه الطريقة الأكثر تقييدًا لتنسيق النصوص ستوفر تطبيقاتٍ أفضل:
* (المطور) صُمِّمَت مكوّنات React مع أخذ العزل التام بعين الاعتبار: يجب أن تكون قادرًا على إسقاط مكون في أي مكان في تطبيقك، واثقًا من أنه طالما أن الخاصيّات متشابهة، فستبدو وتتصرف بنفس الطريقة. خصائص النصوص القادرة على الوراثة من خارج الخاصيات ستكسر هذا العزل.

* (المُطبِّق [Implementor]) تطبيق شيفرة React Native تُبسَّط كذلك: لا نحتاج إلى حقلِ <code>fontFamily</code> في كل عنصرٍ، ولا نحتاج إلى عبور الشجرة إلى الجذر في كل مرة تُعرَض فيها عقدة نصية. لا تُشفَّر وراثة النمط إلا داخل مكون النص الأصيل ولا يُسرَّبُ إلى مُكوِّنات أخرى أو إلى النظام نفسه.

==الخاصيات==
===‎‎<code>accessible</code>‎‎===
عندما تكون قيمتُها القيمةَ ‎‎<code>true</code>‎‎ (القيمة الافتراضية)، فهذا يُشير إلى أنّ العرضَ هو عنصرُ سهل الوصول (accessibility element) لمن يملك أي إعاقة (سواءً دائمة أو مؤقتة). افتراضيًّا، جميع العناصر القابلة للمس هي عناصر مهيأة لتكون سهلة الوصول.

انظر دليل [[ReactNative/accessibility|إمكانية الوصول]] لمزيد من المعلومات.

{| class="wikitable"
!النوع
!مطلوب
|-
|قيمة منطقيّة
|لا
|}
===‎‎<code>accessibilityLabel</code>‎‎===
يستبدِل النص الذي يقرأه قارئ الشاشة عندما يتفاعل المستخدم مع العنصر. افتراضيًا، يُنشأ الملصق (label) عن طريق العبور عبر جميع المكوّنات الأبناء وتجميع كافة العقد النصية مفصولةً بمسافة.

{| class="wikitable"
!النوع
!مطلوب
|-
|سلسلة نصيّة
|لا
|}

===‎‎<code>accessibilityHint</code>‎‎===

يُساعد تلميح سهولة الوصول (accessibility hint) المستخدمينَ على فهم ما سيحدث عندما يقومون بإجراءٍ على عنصر مهيئأة ليكون سهل الوصول عندما لا تكون النتيجة واضحةً من العنوان المساعد لسهولة الوصول <code>accessibilityLabel</code>.
{| class="wikitable"
!النوع
!مطلوب
|-
|سلسلة نصيّة
|لا
|}
===‎‎<code>accessibilityRole</code>‎‎===
تقوم الخاصيّة <code>accessibilityRole</code> بتوصيل الغرض من المكون (أي دَوره) إلى المستخدم عبر تقنيةٍ مساعدة (assistive technology) مثل قارئات الشاشة.

تترجم هذه الأدوار إلى تقنية Accessibility Traits المقابلة على نظام iOS. الزر Image يملك الوظيفة نفسها كما لو أن صفته (دوره) حُدِّد إلى 'image' أو 'button'. انظر دليل [[ReactNative/accessibility|سهولة الوصول]] لمزيد من التفاصيل.

أما على نظام Android، فلهذه الأدوار قيمة مقابلة على تقنية TalkBack بالمثل كما في نظام iOS الذي تحدثنا عنه آنفًا.

{| class="wikitable"
!النوع
!مطلوب
|-
|النوع [[ReactNative/accessibility#accessibilityRole|accessibilityRole]]
|لا
|}

===‎‎<code>accessibilityState</code>‎‎===
تحدد قيمة هذه الخاصية التقنيةٍ المساعدة مثل قارئ الشاشة بحالة العنصر المحدد (المركز) عليه آنذاك، ويمكنك أن لا تحدد أي حالة أو تحدد حالة واحدة أو عدة حالات بتمريرها عبر كائن مثل <code>{selected: true, disabled: true}</code>.

{| class="wikitable"
!النوع
!مطلوب
|-
|[[ReactNative/accessibility#accessibilityState|AccessibilityState]]
|لا
|}
===‎‎<code>adjustsFontSizeToFit</code>‎‎===
تُحدِّد ما إذا كان يجب تصغير الخطوط تلقائيًا لتناسب قيود النمط المُعطاة. القيمة الافتراضية <code>false</code>.
{| class="wikitable"
!النوع
!مطلوب
!المنصة
|-
|قيمة منطقيّة
|لا
|iOS
|}
===‎‎<code>allowFontScaling</code>‎‎===
لتحديد ما إذا كان يجب تغيير حجم الخطوط لاحترام إعدادات حجم النص الخاصة بإمكانية الوصول. القيمة الافتراضية هي ‎‎<code>true</code>‎‎.

{| class="wikitable"
!النوع
!مطلوب
|-
|قيمة منطقيّة
|لا
|}

=== <code>android_hyphenationFrequency</code> ===
تحدد تكرار عملية فصل الكلمات الأجنبية بفاصلة (شرطة - ) التلقائية لتُستخدَم متى ما سُمِح بفصل الكلمات الواحدة بفاصل على واجهة Android API المستوى 23 وما بعد. القيمة الافتراضية 'none'.
{| class="wikitable"
!النوع
!مطلوب
!المنصة
|-
|('none', 'full', 'balanced', 'high')
|لا
|Android API Level 23+‎
|}
===‎‎<code>dataDetectorType</code>‎‎===
يُحدِّد أنواع البيانات المحوَّلَة إلى عناوين URL قابلةٍ للنقر في عنصر النص. افتراضيًا، لا يتم اكتشاف أي أنواع بيانات.

يمكنك تحديد نوع واحد فقط.

القيم المحتملة للخاصيّة ‎‎<code>dataDetectorType</code>‎‎ موضحة بالجدول. القيمة الافتراضية 'none'.
{| class="wikitable"
!النوع
!مطلوب
!المنصة
|-
|‎‎('phoneNumber', 'link', 'email', 'none', 'all')‎‎
|لا
|Android
|}
===‎‎<code>disabled</code>‎‎===
يُحدّد الحالة المعطلة لعرض النص لأغراض الاختبار. القيمة الافتراضية <code>false</code>.

{| class="wikitable"
!النوع
!مطلوب
!المنصة
|-
|قيمة منطقيّة
|لا
|Android
|}

===‎‎<code>ellipsizeMode</code>‎‎===
عندما تُعيَّن قيمة للخاصيّة ‎‎<code>numberOfLines</code>‎‎، فإنّ هذه الخاصيَّة تُحدِّد كيفية اقتطاع النص. يجب تعيين قيمة للخاصيّة <code>numberOfLines</code> بالتزامن مع هذه الخاصيّة.

يمكن أن تحمل أحد القيم التالية:

* ‎‎<code>head</code>‎‎: يُعرَض السطر بحيث توضع النهاية في الحاوية ويتم الإشارة إلى النص المفقود في بداية السطر بواسطة علامة إضمار. أي ‎‎<code>...wxyz</code>‎‎ مثلا.
* ‎‎<code>middle</code>‎‎: يُعرض السطر بحيث يتم احتواء البداية والنهاية في الحاوية ويتم الإشارة إلى النص المفقود في المنتصف بواسطة علامة إضمار. أي ‎‎<code>ab...yz</code>‎‎ مثلا.
* ‎‎<code>tail</code>‎‎: (القيمة الافتراضية) يتم عرض السطر بحيث يتم احتواء البداية في الحاوية ويتم الإشارة إلى النص المفقود في نهاية السطر بواسطة علامة إضمار. أي ‎‎<code>abcd...</code>‎‎ مثلا.
* ‎‎<code>clip</code>‎‎: لا يتم رسم الأسطر بعد حافة حاوية النص.

القيمة الافتراضيّة هي ‎‎<code>tail</code>‎‎.

إن ضبط قيمة الخاصة numberOfLines في نظام Android إلى قيمة أعلى من 1، فلن تعمل سوى القيمة <code>'tail'</code> مع هذه الخاصية.

{| class="wikitable"
!النوع
!مطلوب
|-
|‎‎('head', 'middle', 'tail', 'clip')‎‎
|لا
|}

===‎‎<code>maxFontSizeMultiplier</code>‎‎===

يُحدد أكبر مقياس ممكن يمكن أن يصل إليه الخط عند تمكين الخاصيّة ‎‎<code>allowFontScaling</code>‎‎. القيم الممكنة:

* ‎‎<code>null/undefined</code>‎‎: (القيمة الافتراضية): ترث من العقدة الأب أو القيمة الافتراضيّة العامّة (‎‎<code>0</code>‎‎).

* ‎‎<code>0</code>‎: لا حدَّ أقصى، وتَجاهَل قيمة الأب أو القيمة الافتراضية العامّة.

* ‎‎<code>>= 1</code>‎: تُعيِّن قيمةَ الخاصيّةِ ‎‎<code>maxFontSizeMultiplier</code>‎‎ الخاصة بهذه العقدة إلى هذه القيمة.
{| class="wikitable"
!النوع
!مطلوب
|-
|عدد
|لا
|}

===‎‎<code>minimumFontScale</code>‎‎===
يُحدِّد أصغر مقياس ممكن يمكن أن يصل إليه الخط عند تمكين الخاصية ‎‎<code>adjustsFontSizeToFit</code>‎‎. (القيم من ‎‎<code>0.01</code>‎‎ إلى ‎‎<code>1.0</code>‎‎).

{| class="wikitable"
!النوع
!مطلوب
!المنصة
|-
|عدد
|لا
|iOS
|}

===‎‎<code>nativeID</code>‎‎===
تُستخدَم لتحديد موقع هذا العرض من الشيفرة الأصيلة.

{| class="wikitable"
!النوع
!مطلوب
|-
|سلسلة نصيّة
|لا
|}

===‎‎<code>numberOfLines</code>‎‎===

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

تُستخدم هذه الخاصيّة بشكل شائع مع الخاصية ‎‎<code>ellipsizeMode</code>‎‎. القيمة الافتراضية 0.
{| class="wikitable"
!النوع
!مطلوب
|-
|عدد
|لا
|}
===‎‎<code>onLayout</code>‎‎===
دالةٌ تُستدعى عند وصل العنصر (تصييره أول مرة) أو حدوث تغيّرات في التخطيط‎‎.
{| class="wikitable"
!النوع
!مطلوب
|-
|دالة
‎({ nativeEvent: [[ReactNative/layoutevent|LayoutEvent]] }) => void
|لا
|}
===‎‎<code>onLongPress</code>‎‎===
تُستدعى هذه الدالة عند الضغط لفترة طويلة.

{| class="wikitable"
!النوع
!مطلوب
|-
|دالة
‎({ nativeEvent: [[ReactNative/pressevent|PressEvent]] }) => void
|لا
|}
===‎‎<code>onMoveShouldSetResponder</code>‎‎===
هل هذا العرض "يتطلّب" الاستجابة للّمس (touch responsiveness)؟ تُستدعى هذه الدالة في كل حركة لمسٍ على المكوّن ‎‎<code>View</code>‎‎ عندما لا يكون المستجيب (the responder).
{| class="wikitable"
!النوع
!مطلوب
|-
|دالة
‎({ nativeEvent: [[ReactNative/pressevent|PressEvent]] }) => void
|لا
|}

===‎‎<code>onPress</code>‎‎===
تُستدعى هذه الدالة عند الضغط على العرض.
{| class="wikitable"
!النوع
!مطلوب
|-
|دالة
‎({ nativeEvent: [[ReactNative/pressevent|PressEvent]] }) => void
|لا
|}

===‎‎<code>onResponderGrant</code>‎‎===
يستجيب العرض الآن لأحداث اللمس. هذا هو الوقت المناسب لإبراز وإظهار ما يحدث للمستخدم.

{| class="wikitable"
!النوع
!مطلوب
|-
|دالة
‎({ nativeEvent: [[ReactNative/pressevent|PressEvent]] }) => void
|لا
|}

===‎‎<code>onResponderMove</code>‎‎===
عندما يُحرِّك المستخدمُ إصبعه.

{| class="wikitable"
!النوع
!مطلوب
|-
|دالة
‎({ nativeEvent: [[ReactNative/pressevent|PressEvent]] }) => void
|لا
|}

===‎‎<code>onResponderRelease</code>‎‎===
دالةٌ تُستدعى عند نهاية اللمس.

{| class="wikitable"
!النوع
!مطلوب
|-
|دالة
‎({ nativeEvent: [[ReactNative/pressevent|PressEvent]] }) => void
|لا
|}

===‎‎<code>onResponderTerminate</code>‎‎===
دالةٌ تُستدعى عندما يُأخَذ المستجيب من العرض. قد تأخذه عروض أخرى بعد استدعاء ‎‎<code>onResponderTerminationRequest</code>‎‎، أو قد يأخذه نظام التشغيل دون طلب (يحدث هذا مع مركز التحكم أو مركز التنبيهات على iOS مثلًا).
{| class="wikitable"
!النوع
!مطلوب
|-
|دالة
‎({ nativeEvent: [[ReactNative/pressevent|PressEvent]] }) => void
|لا
|}

===‎‎<code>onResponderTerminationRequest</code>‎‎===
دالة تُستدعى عندما يريد عرضٌ آخر أن يصبح مستجيبًا ويطلب من هذا العرض تحرير المستجيب الخاص به. إعادة القيمة ‎‎<code>true</code>‎‎ يسمح بإطلاقه.

{| class="wikitable"
!النوع
!مطلوب
|-
|دالة
‎({ nativeEvent: [[ReactNative/pressevent|PressEvent]] }) => void
|لا
|}

===‎‎<code>onStartShouldSetResponderCapture</code>‎‎===
إذا أراد مُكوِّن ‎‎<code>View</code>‎‎ منع مُكوِّنِ ‎‎<code>View</code>‎‎ ابنٍ من أن يصبح مستجيبًا عند بداية اللمس، فيجب أن يحتويَ على هذا المعالج مُعيدًا القيمة ‎‎<code>true</code>‎‎.

{| class="wikitable"
!النوع
!مطلوب
|-
|دالة
‎({ nativeEvent: [[ReactNative/pressevent|PressEvent]] }) => void
|لا
|}

===‎‎<code>onTextLayout</code>‎‎===
تُستدعى عندما حدوث أي تغيير في تخطيط النص Text.
===‎‎<code>pressRetentionOffset</code>‎‎===

عند تعطيل [[ReactNative/scrollview|واجهة التمرير]] (scroll view)، تُحدِّد هذه الخاصيّة مدى المسافة التي يمكن أن تتحرك بها اللمسة بعيدًا عن الزر قبل إلغاء تنشيطه. بمجرد إلغاء تنشيط الزر، حاول تحريك لمستك للخلف وسترى أن الزر قد نُشِّطَ مرة أخرى! حركه للخلف وللأمام عدة مرات أثناء تعطيل عرض التمرير. تأكد من تمرير ثابتٍ لتقليل تخصيصات الذاكرة.
{| class="wikitable"
!النوع
!مطلوب
|-
|كائن [[ReactNative/rect|Rect]]، عدد number
|لا
|}
===‎‎<code>selectable</code>‎‎===
يتيح للمستخدم تحديد النص لاستخدام وظيفة النسخ واللصق الأصيلتين. القيمة الافتراضية <code>false</code>.
{| class="wikitable"
!النوع
!مطلوب
|-
|قيمة منطقيّة
|لا
|}

===‎‎<code>selectionColor</code>‎‎===
لون إبراز (highlight color) النص.

{| class="wikitable"
!النوع
!مطلوب
!المنصة
|-
|[[ReactNative/colors|لون]]
|لا
|Android
|}
===‎‎<code>style</code>‎‎===
تنسيق النص.
{| class="wikitable"
!النوع
!مطلوب
|-
|خاصيات تنسيق النص [[ReactNative/text style props|Text Style]], خاصيات تنسيق الواجهة [[ReactNative/view style props|View Style Props]]
|لا
|}
===‎‎<code>suppressHighlighting</code>‎‎===
عندما تكون قيمتها القيمةَ ‎‎<code>true</code>‎‎، لا يُجرى أي تغيير مرئي عند الضغط على النص. افتراضيًا، يُبرِز شكلٌ بيضاوي رمادي النصَّ عند الضغط لأسفل. القيمة الافتراضية <code>false</code>.

{| class="wikitable"
!النوع
!مطلوب
!المنصة
|-
|قيمة منطقيّة
|لا
|iOS
|}
===‎‎<code>testID</code>‎‎===
يُستخدَم لتحديد موقع هذا العرض في الاختبارات الشاملة (end-to-end tests).
{| class="wikitable"
!النوع
!مطلوب
|-
|سلسلة نصيّة
|لا
|}
===‎‎<code>textBreakStrategy</code>‎‎===
تضبط استراتيجية فاصل النص (text break) على المستوى 23 من واجهة برمجة تطبيقات Android أو أحدث، القيم المحتملة هي: ‎‎<code>highQuality</code>‎‎، ‎‎<code>simple</code>‎‎ (القيمة الافتراضية)، ‎‎<code>balanced</code>‎‎.

{| class="wikitable"
!النوع
!مطلوب
!المنصة
|-
|‎‎('simple', 'highQuality', 'balanced')‎‎
|لا
|Android
|}

== تعريفات النوع ==

=== <code>TextLayout</code> ===
الكائن <code>TextLayout</code> هو جزء من رد النداء <code>TextLayoutEvent</code> (مشروح تاليًا) ويحوي بيانات القياس لسطر النص <code>Text</code>.

إليك مثال:<syntaxhighlight lang="js">
{
    capHeight: 10.496,
    ascender: 14.624,
    descender: 4,
    width: 28.224,
    height: 18.624,
    xHeight: 6.048,
    x: 0,
    y: 0
}
</syntaxhighlight>الخاصيات:
{| class="wikitable"
!الاسم
!النوع
!مطلوب
!الوصف
|-
|ascender
|عدد
|لا
|ارتفاع السطر الصاعد / المرتفع (line ascender height) بعد تغيير تخطيط النص. 
|-
|capHeight
|عدد
|لا
|ارتفاع الحرف الكبير عن خط الأساس (baseline).
|-
|descender
|عدد
|لا
|ارتفاع النازل / المنخفض  (line ascender height) بعد تغيير تخطيط النص. 
|-
|height
|عدد
|لا
|ارتفاع السطر بعد تغيير تخطيط النص.
|-
|width
|عدد
|لا
|عرض السطر بعد تغيير تخطيط النص.
|-
|x
|عدد
|لا
|إحداثيات X للسطر ضمن مكون النص Text.
|-
|xHeight
|عدد
|لا
|المسافية بين الخط الأساس ومتوسط السطر (حجم الجزء الأساسي corpus size).
|-
|y
|عدد
|لا
|إحداثيات Y للسطر ضمن مكون النص Text.
|}

=== <code>TextLayoutEvent</code> ===
يُعاد الكائن <code>TextLayoutEvent</code> من دالة رد نداء نتيجة حدوثٍ تغيير في تخطيط المكون، وتحوي مفتاحًا يدعى <code>lines</code> قيمته مصفوفة من كائنات <code>TextLayout</code> مقابلة لكل سطر جرى تصييره.

إليك مثال:<syntaxhighlight lang="js">
{
  lines: [
    TextLayout,
    TextLayout
    // ...
  ];
  target: 1127;
}
</syntaxhighlight>الخاصيات:
{| class="wikitable"
!الاسم
!النوع
!مطلوب
!الوصف
|-
|lines
|مصفوفة من كائنات <code>TextLayout</code>
|لا
|يوفر معلومات عن تخطيط النص <code>TextLayout</code> لكل سطر جرى تصييره.
|-
|target
|عدد
|لا
|مُعرِّف العقدة للعنصر.
|}

== مصادر ==
* [https://facebook.github.io/react-native/docs/text#containers صفحة Text في توثيق React Native الرسمي.]
[[تصنيف:ReactNative]]
[[تصنيف:React Native Component]]