DataGrid

هذه الصفحة مترجمة من الإنجليزية. اقرأ الصفحة الإنجليزية

تعرض DataGrid صفوفًا من إجراء يأخذ DataQuery ويعيد Page<E>. يجري الترقيم والفرز والمرشحات والمجاميع على الخادم، ولذلك فإن شبكة على مليون صف تكلّف المتصفح ما تكلّفه شبكة على مئة صف.

شبكة

DataGrid::of(search_samples)
    .paging(Paging::pages(8))
    .column(Sample::code).width(110).filter()
    .column(Sample::name).flex(1).filter()
    .column(Sample::unit).width(120).filter().badge(|u| match u {
        Unit::Piece => Tone::Neutral,
        Unit::Kg => Tone::Info,
        Unit::Liter => Tone::Brand,
    })
    .column(Sample::price).width(150).avg()
    .column(Sample::stock).width(150).sum().progress(120)
    .column(Sample::active).width(100).check_icon()
    .row_style(|s| match s.stock {
        0 => Some(RowStyle::Danger),
        1..=9 => Some(RowStyle::Warning),
        _ => None,
    })

افرز بالنقر على ترويسة، واكتب في خانة مرشح، واسحب ترويسة لنقل عمود أو حافتها لتغيير حجمه. تشمل المجاميع كل الصفوف المصفّاة، لا الصفحة وحدها.

الإجراء

#[action(permission = "stock.product.read")]
pub async fn search_samples(q: DataQuery, store: SampleStore) -> Result<Page<Sample>> {
    Ok(q.apply(store.all()?))
}

تقوم DataQuery::apply بالترشيح والفرز والتجميع والترقيم على Vec في الذاكرة، وهذا يناسب القوائم الصغيرة والاختبارات. أما المخزن المدعوم بقاعدة بيانات فيقرأ DataQuery نفسها (الصفحة والفرز والمرشحات والمجاميع) ويجيب بـ SQL؛ راجع البيانات وقواعد البيانات.

الترقيم

يضع الخادم حدًا أعلى لحجم الصفحة مهما طلب العميل.

الأعمدة

الصفوف

• .on_open(|row| effect): نقر مزدوج أو Enter على صف.
• .row_action(label, action, |row| input): زر على كل صف.
• .bulk_action(label, action, M::id): يعمل على الصفوف المحددة.
• .row_menu(|row| ContextMenu): قائمة النقر الأيمن للصف.
• .row_style(|row| Option<RowStyle>): صفوف الخطر أو التحذير أو النجاح.
• .exportable(): تصدير CSV للصفوف المصفّاة، يبثه الخادم (stream).

يغطي مرجع DataGrid العروض المحفوظة والرئيسي والتفصيلي (master detail) والتجميع وبيانات الشجرة والتحرير المضمن والتنقل بين الخلايا والنسخ واللصق وتحويل الأعمدة إلى افتراضية (virtualization) وإمكانية الوصول.