#תוסף

ב-NocoBase, תוסף צד-לקוח (Client Plugin) הוא הדרך העיקרית להרחבה והתאמה אישית של פונקציונליות צד-לקוח (frontend). על ידי הרחבת מחלקת הבסיס Plugin המסופקת על ידי @nocobase/client, מפתחים יכולים לרשום לוגיקה, להוסיף רכיבי עמוד, להרחיב תפריטים או לשלב פונקציונליות של צד שלישי בשלבי מחזור חיים שונים.

#מבנה מחלקת תוסף

מבנה תוסף צד-לקוח בסיסי נראה כך:

import { Plugin } from '@nocobase/client';

export class PluginHelloClient extends Plugin {
  async afterAdd() {
    // מבוצע לאחר הוספת התוסף
    console.log('Plugin added');
  }

  async beforeLoad() {
    // מבוצע לפני טעינת התוסף
    console.log('Before plugin load');
  }

  async load() {
    // מבוצע בעת טעינת התוסף, רושם נתיבים (routes), רכיבי ממשק משתמש (UI components) ועוד.
    console.log('Plugin loaded');
  }
}

export default PluginHelloClient;

#תיאור מחזור החיים

כל תוסף עובר את מחזור החיים הבא ברצף כאשר הדפדפן מתרענן או היישום מאותחל:

#סדר ביצוע

בכל פעם שהדפדפן מתרענן, יבוצעו afterAdd() → beforeLoad() → load() ברצף.

#הקשר התוסף (Plugin Context) ו-FlowEngine

החל מ-NocoBase 2.0, ממשקי ה-API להרחבת צד-לקוח מרוכזים בעיקר ב-FlowEngine. במחלקת התוסף, תוכלו לקבל את מופע המנוע דרך this.engine.

// גישה להקשר המנוע בשיטת load()
async load() {
  const { app, router, apiClient } = this.engine.context;
  console.log('Current app:', app);
}

למידע נוסף, ראו:

• FlowEngine
• Context