الرقاقات
مكونات Kirigami.Chip هي عناصر صغيرة موروثة من AbstractButton تُستخدم لعرض الخصائص الشائعة أو عوامل تصفية لشيء ما. هذه عادةً عناصر نصية، وهي قابلة للتفاعل وتأتي مع زر حذف اختياري.

بداية سريعة
يمكن إضافة الرقاقات بسهولة باستخدام مكون Kirigami.Chip. بتعيين سلسلة نصية لحقل AbstractButton.text الموروث، نعطي الرقاقات أسماءها.
import QtQuick
import QtQuick.Layouts
import QtQuick.Controls
import org.kde.kirigami as Kirigami
Kirigami.ApplicationWindow {
title: "Chips"
pageStack.initialPage: Kirigami.Page {
title: "Chips"
Kirigami.FormLayout {
anchors.fill: parent
Kirigami.Chip {
text: "Chip 1"
}
Kirigami.Chip {
text: "Chip 2"
}
Kirigami.Chip {
text: "Chip 3"
}
}
}
}
مع المكررات (موصى به)
نظرًا لأن الرقاقات مخصصة للاستخدام أكثر من مرة، فمن المحتمل أن ترغب في استخدام نوع من بنية بيانات القائمة والتكرار عليها لعرض الرقاقات. للقيام بذلك، نحتاج إلى ListModel ومكون Repeater.
يُستخدم ListModel كتخزين للرقاقات. لتعبئة ListModel (وبالتالي الرقاقات)، نعلن عن بضعة مكونات ListElement، والتي تحتوي على حقل يُعرف باسم text. يمكننا استخدام هذه السلسلة النصية المعينة من هنا لحقل text لكل رقاقة مكررة.
يُستخدم المكرر لعرض الرقاقات. أولاً، نحتاج إلى تعيين حقل model للمكرر إلى ListModel الخاص بنا، أو إنشاء ListModel داخل المكرر. ثم، نعلن عن مكون Kirigami.Chip داخل المكرر، ونعين حقل text الخاص به ببيانات العنصر باستخدام الخاصية modelData.
Kirigami.ApplicationWindow {
id: root
title: "Chips"
ListModel {
id: chips
ListElement { text: "Chip 1" }
ListElement { text: "Chip 2" }
ListElement { text: "Chip 3" }
}
pageStack.initialPage: Kirigami.Page {
title: "Chips"
Kirigami.FormLayout {
anchors.fill: parent
Repeater {
Layout.fillWidth: true
model: chips
Kirigami.Chip {
id: chip
text: modelData
}
}
}
}
}ملاحظة
يمكنك إلحاق البيانات وإزالتها ديناميكيًا من ListModel، وسيقوم المكرر تلقائيًا بإجراء تلك التغييرات. ومع ذلك، فإن مجرد تغيير عنصر معين من المكرر أو ListModel لا يؤثر على الآخر، ويتطلب تغيير كليهما، ما لم يُستخدم شيء مثل QAbstractListModel. راجع تطبيق مثال لمزيد من المعلومات.تطبيق مثال
يوضح تطبيق المثال أدناه كيف يمكن استخدام الرقاقات في برامج مثل قوائم المهام.
| |
