كيفية استخدام مربع القائمة في تطبيق NativeScript؟

مرحبًا يا من هناك! باعتباري أحد موردي مربعات القائمة، يسعدني جدًا أن أشارككم كيفية استخدام مربع قائمة في تطبيق NativeScript. NativeScript هو إطار عمل رائع يتيح لك إنشاء تطبيقات الهاتف المحمول عبر الأنظمة الأساسية باستخدام JavaScript أو TypeScript أو Angular. وتعد مربعات القائمة جزءًا أساسيًا من العديد من التطبيقات، حيث تساعد المستخدمين على تحديد العناصر من مجموعة من الخيارات. دعونا نتعمق في الأمر!

إعداد مشروع NativeScript الخاص بك

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

تثبيت npm -g أصلي

بمجرد تثبيته، قم بإنشاء مشروع NativeScript جديد. يمكنك استخدام الأمر التالي:

tns إنشاء MyListBoxApp - قالب tns-template-blank-ts cd MyListBoxApp

يؤدي هذا إلى إنشاء تطبيق NativeScript جديد يستند إلى TypeScript يسمىMyListBoxAppومن ثم ينتقل بك إلى دليل المشروع.

إضافة مربع قائمة إلى تطبيقك

الآن، دعونا نضيف مربع قائمة إلى التطبيق لدينا. في NativeScript، يمكنك استخدامعرض القائمةمكون يشبه إلى حد كبير مربع القائمة. افتحapp.component.htmlالملف في مشروعك. استبدل المحتوى الموجود بالكود التالي:

<Page xmlns="http://schemas.nativescript.org/tns.xsd"> <StackLayout> <ListView [items]="listItems"> <ng-template Let-item="item"> <Label [text]="item"></Label> </ng-template> </ListView> </StackLayout> </Page>

في هذا الكود أضفنا aعرض القائمةداخل أStackLayout. العرض القائمةمنضما إلى مجموعة تسمىlistItemsوالذي سنحدده في ملف TypeScript. المن - القالبيتم استخدامه لتحديد كيفية عرض كل عنصر في القائمة. في هذه الحالة، نحن فقط نعرض العنصر كنص في ملفملصق.

بعد ذلك، افتحapp.component.tsالملف وأضف الكود التالي:

استيراد {المكون} من "@angular/core"؛ @Component({ محدد: "ns - app"، templateUrl: "./app.component.html" }) تصدير فئة AppComponent { public listItems = ["Item 1"، "Item 2"، "Item 3"، "Item 4"]؛ }

هنا قمنا بتعريفlistItemsمجموعة مع بعض عناصر العينة. الآن، إذا قمت بتشغيل التطبيق الخاص بك باستخدامTns تشغيل أندرويدأوتشغيل Tns لنظام iOS، يجب أن تشاهد قائمة بهذه العناصر الأربعة على الشاشة.

التعامل مع اختيار العنصر

أحد أهم الأشياء المتعلقة بمربع القائمة هو القدرة على التعامل مع تحديد العناصر. في NativeScript، يمكنك القيام بذلك عن طريق إضافة مستمع للحدث إلى ملفعرض القائمة. تعديلapp.component.htmlالملف على النحو التالي:

<Page xmlns="http://schemas.nativescript.org/tns.xsd"> <StackLayout> <ListView [items]="listItems" (itemTap)="onItemTap($event)"> <ng-template Let-item="item"> <Label [text]="item"></Label> </ng-template> </ListView> </StackLayout> </الصفحة>

لقد أضفناitemTapالحدث إلىعرض القائمةوربطها بطريقة تسمىonItemTap. الآن، قم بتحديثapp.component.tsملف:

استيراد {المكون} من "@angular/core"؛ استيراد { ItemEventData } من "tns - core - Modules/ui/list - view"; @Component({ محدد: "ns - app"، templateUrl: "./app.component.html" }) تصدير فئة AppComponent { public listItems = ["Item 1"، "Item 2"، "Item 3"، "Item 4"]؛ onItemTap(args: ItemEventData) { const SelectedItem = this.listItems[args.index]; console.log("لقد حددت: ${selectedItem}`); } }

فيonItemTapالطريقة، نحن نحصل على فهرس العنصر الذي تم النقر عليه من ملفالحججكائن ثم استخدم هذا الفهرس للحصول على العنصر المحدد منlistItemsصفيف. نقوم أيضًا بتسجيل العنصر المحدد في وحدة التحكم.

تخصيص مربع القائمة

يمكنك تخصيص شكل ومظهر مربع القائمة الخاص بك بعدة طرق. على سبيل المثال، يمكنك تغيير لون الخلفية وحجم الخط والمزيد. دعونا نغير لون الخلفية لكل عنصر في القائمة. تحديثapp.component.htmlملف:

<Page xmlns="http://schemas.nativescript.org/tns.xsd"> <StackLayout> <ListView [items]="listItems" (itemTap)="onItemTap($event)"> <ng-template Let-item="item"> <Label [text]="item" backColor="lightblue"></Label> </ng-template> </ListView> </StackLayout> </Page>

الآن، سيكون لكل عنصر في القائمة خلفية زرقاء فاتحة. يمكنك أيضًا استخدام CSS لتصميم مربع القائمة الخاص بك. قم بإنشاء ملف جديد يسمىapp.component.cssفي نفس الدليل الخاص بكapp.component.htmlوapp.component.tsملفات. أضف الكود التالي:

ListView { حجم الخط: 20؛ } التسمية { الحشو: 10؛ }

ثم، فيapp.component.tsالملف، أضف السطر التالي داخل ملف@عنصرمصمم الديكور:

styleUrls: ["./app.component.css"]

سيؤدي هذا إلى تطبيق أنماط CSS على مربع القائمة الخاص بك.

استخدام البيانات العالمية الحقيقية

في سيناريو العالم الحقيقي، قد ترغب على الأرجح في ملء مربع القائمة الخاص بك ببيانات من واجهة برمجة التطبيقات (API) أو قاعدة بيانات. لنفترض أن لدينا واجهة برمجة التطبيقات (API) التي تُرجع مجموعة من العناصر. يمكننا استخدامhttpClientالوحدة النمطية في Angular لتقديم طلب HTTP. أولاً، قم باستيراد الوحدات الضرورية في ملفapp.component.tsملف:

استيراد {المكون} من "@angular/core"؛ استيراد { ItemEventData } من "tns - core - Modules/ui/list - view"; استيراد {HttpClient} من "@angular/common/http"; @Component({ محدد: "ns - app"، templateUrl: "./app.component.html"، styleUrls: ["./app.component.css"] }) فئة التصدير AppComponent { public listItems = []; منشئ (http خاص: HttpClient) { this.fetchData(); } fetchData() { this.http.get<any[]>("https://api.example.com/items").subscribe( (data) => { this.listItems = data; }, (error) => { console.error("خطأ في جلب البيانات:"، خطأ)؛ } ); } onItemTap(args: ItemEventData) { const SelectedItem = this.listItems[args.index]; console.log("لقد حددت: ${selectedItem}`); } }

في هذا الكود نستخدمhttpClientلتقديم طلب GET إلى واجهة برمجة التطبيقات (API). عندما يتم جلب البيانات بنجاح، نقوم بتعيينها إلىlistItemsصفيف.

إضافة روابط إلى المنتجات ذات الصلة

كمورد لمربع القائمة، أريد أيضًا أن أذكر بعض المنتجات التي تقدمها شركتي. يمكنك التحقق من موقعناالمكره 1,حالة المياه بالموجات فوق الصوتية، وجسم الأنبوبعلى موقعنا. هذه المنتجات عالية الجودة ويمكن أن تكون إضافة رائعة لمشاريعك.

الاستنتاج والدعوة إلى العمل

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

مراجع

• وثائق NativeScript
• التوثيق الزاوي
• وثائق تايب سكريبت