Rumah > hujung hadapan web > tutorial js > Membina ActivityRenderer

Membina ActivityRenderer

王林
Lepaskan: 2024-07-16 21:19:14
asal
1004 orang telah melayarinya

Penyampai aktiviti Gantt ialah pemapar utama Pemapar JadualJS. Artikel ini akan membincangkan cara ia dibina dan apakah kekhususan pemapar aktiviti ini.

Cara membina kelas pemapar tersuai

Langkah pertama untuk membina kelas pemapar ialah mewarisi atribut dan kaedah dengan melanjutkan kelas rangka kerja tertib lebih tinggi.

Kami mahu mewakili tugasan hanya melalui dimensi masa mula dan tamatnya. Kelas pemapar asas ScheduleJS untuk melakukan ini ialah kelas ActivityBarRenderer.

Kami perlu menyediakan argumen jenis tersuai kepada kelas ActivityBarRenderer supaya atribut dan kaedah yang disediakan oleh kelas Row dan Activity tersuai kami akan dapat diakses menggunakan API kelas asas.

Mari kita cipta kelas ScheduleJsViewerTaskActivityRenderer untuk melukis setiap ScheduleJsViewerTaskActivity dalam ScheduleJsViewerTaskRow masing-masing.

// Import the base ActivityBarRenderer class from ScheduleJS
import {ActivityBarRenderer} from "schedule";

// Import our custom Activity and Row types
import {ScheduleJsViewerTaskActivity} from "...";
import {ScheduleJsViewerTaskRow} from "...";

// Create our custom renderer by extending the ActivityBarRenderer class
export class ScheduleJsViewerTaskActivityRenderer extends ActivityBarRenderer<ScheduleJsViewerTaskActivity, ScheduleJsViewerTaskRow> { }
Salin selepas log masuk
Sebenarnya, pemapar sudah boleh didaftarkan untuk melukis aktiviti kami menggunakan gelagat lalai

ActivityBarRenderer. Sekarang mari kita mendalami cara menyesuaikannya.

Seni bina asas

Dalam ScheduleJS,

ActivityRenderer ialah kelas yang kami daftarkan secara pengaturcaraan menggunakan API Grafik untuk melukis Aktiviti tertentu pada Barisnya. Untuk menyusun ScheduleJsViewerTaskActivityRenderer kami, kami akan memisahkan kodnya kepada tiga bahagian:

    Atribut akan menyimpan pembolehubah yang membolehkan kami mengubah tingkah laku untuk prosedur lukisan tertentu.
  • Pembina akan membenarkan kami menentukan keadaan lalai untuk pemapar.
  • Kaedah lukisan akan menyimpan semua arahan untuk melukis aktiviti kami pada kanvas.
Atribut

Atribut ialah pemalar yang akan digunakan semula sepanjang pemapar. Seperti sedia ada, sifat ini hanya akan diedit terus dalam kod pemapar. Kita boleh bayangkan skrin tertentu di mana pengguna boleh mengubah suai tetapan ini terus dalam UI.


// Attributes

// Pixels sizings
private readonly _parentActivityTrianglesWidthPx: number = 5;
private readonly _parentActivityTrianglesHeightPx: number = 8;
private readonly _defaultLineWidthPx: number = 0.5;

// Colors palette
private readonly _parentActivityColor: string = Color.GRAY.toCssString();
private readonly _strokeColor: string = Color.BLACK.toCssString();
private readonly _defaultActivityGreen: Color = Color.rgb(28, 187, 158);
private readonly _defaultActivityBlue: Color = Color.rgb(53, 152, 214);
private readonly _onHoverFillColor: string = Color.ORANGE.toCssString();

// Opacity ratio for baseline activities
private readonly _baselineOpacityRatio: number = 0.6;
Salin selepas log masuk
Pembina

Pembina digandingkan rapat dengan kaedah kitaran hayat pemapar kami. Dalam JadualJS Viewer, kami memutuskan untuk membuat instantiate pemapar apabila pengguna menukar skrin untuk menentukan kekhususan dan menggunakan semula kod kami dalam setiap tab yang melaksanakan pemapar ini. Ini bermakna fungsi pembina dijalankan setiap kali pengguna memilih skrin yang memaparkan pemapar ini.


// Constructor

// The renderer requires the graphics and the current tab variable
constructor(graphics: GraphicsBase<ScheduleJsViewerTaskRow>,
            private _currentRibbonMenuTab: ScheduleJsViewerRibbonMenuTabsEnum) {

  // The ActivityBarRenderer class requires the graphics and a name for the renderer
  super(graphics, ScheduleJsViewerRenderingConstants.taskActivityRendererName);

  // Default fill color when hovering an activity
  this.setFillHover(Color.web(this._onHoverFillColor));

  // Default stroke color when hovering an activity
  this.setStrokeHover(Color.BLACK);

  // Default stroke color
  this.setStroke(Color.BLACK);

  // Default thickness
  this.setLineWidth(this._defaultLineWidthPx);

  // Default bar height
  this.setBarHeight(8);

  // Default fill color based on current tab 
  switch (_currentRibbonMenuTab) {
    // Change color for the WBS tab
    case ScheduleJsViewerRibbonMenuTabsEnum.WBS:
      this._parentActivityColor = ScheduleJsViewerColors.brown;
      this.setFill(this._defaultActivityBlue);
      break;
    default:
      this._parentActivityColor = Color.GRAY.toCssString();
      this.setFill(this._defaultActivityGreen);
      break;
  }

}
Salin selepas log masuk
SetFill, setStroke, setFillHover, setStrokeHover, setLineWidth dan setBarHeight diwarisi dan digunakan untuk mengubah ciri pemaparan lalai kelas ActivityBarRenderer.

Ciri lalai pemapar ini adalah yang berikut:

    Warna tersuai semasa melayang aktiviti
  • Sapuan garis hitam (untuk sempadan aktiviti)
  • Ketebalan garis lejang 0.5 piksel
  • Ketinggian bar aktiviti 8 piksel
  • Warna isian bersyarat: Biru untuk kanak-kanak dan coklat untuk ibu bapa dalam tab WBS Hijau untuk kanak-kanak dan kelabu untuk ibu bapa dalam tab lain
Melukis

Rangka kerja akan memanggil kaedah drawActivity secara automatik untuk memaparkan aktiviti kami pada kanvas. Semua parameternya diisi secara dinamik, membolehkan anda bertindak balas dalam masa nyata kepada keadaan semasa aktiviti anda.


// Main drawing method

drawActivity(activityRef: ActivityRef<ScheduleJsViewerTaskActivity>,
             position: ViewPosition,
             ctx: CanvasRenderingContext2D,
             x: number,
             y: number,
             w: number,
             h: number,
             selected: boolean,    
             hover: boolean,
             highlighted: boolean,
             pressed: boolean     
            ): ActivityBounds {    // This method has to return ActivityBounds

    // True if current activity includes a comparison task
    const hasModifications = !!activityRef.getActivity().diffTask;

    // True if current row has children
    const isParent = activityRef.getRow().getChildren().length;

    // Set colors dynamically
    this._setActivityColor(activityRef, hasModifications);

    // Draw text
    this._drawActivityText(activityRef, ctx, x, y, w, h, hasModifications);

    // Run a custom method to draw parent activities or delegate to the default method
    return isParent
      ? this._drawParentActivity(activityRef, ctx, x, y, w, h, hover, hasModifications)
      : super.drawActivity(activityRef, position, ctx, x, y, w, h, selected, hover, highlighted, pressed);
  }
Salin selepas log masuk
Lukisan akan berlaku seperti ini:

    Dapatkan maklumat tentang
  • Aktiviti dan Baris semasa menggunakan ActivityRef API
  • Tetapkan warna secara dinamik menggunakan kaedah _setActivityColor kami
  • Lukis teks aktiviti menggunakan kaedah _drawActivityText kami
  • Lukis aktiviti itu sendiri berdasarkan menggunakan dua kaedah: Kaedah _drawParentActivity untuk melukis ibu bapa Kaedah lalai super.drawActivity ActivityBarRenderer untuk melukis kanak-kanak
Kaedah lukisan aktiviti tersuai

Mari kita lihat dengan lebih dekat cara melukis aktiviti anda secara bebas dengan mereka bentuk kaedah anda sendiri menggunakan kaedah _drawParentActivity.


// Draw the parent activity

private _drawParentActivity(activityRef: ActivityRef<ScheduleJsViewerTaskActivity>,
                            ctx: CanvasRenderingContext2D,
                            x: number,
                            y: number,
                            w: number,
                            h: number,
                            hover: boolean,
                            hasModifications: boolean
                           ): ActivityBounds {

    // Set padding
    const topPadding = h / 3.5;
    const leftPadding = 1;

    // Set CanvasRenderingContext2D
    ctx.lineWidth = this._defaultLineWidthPx;
    if (hover) {
      ctx.fillStyle = this._onHoverFillColor;
      ctx.strokeStyle = ScheduleJsViewerColors.brown;
    } else if (hasModifications) {
      ctx.fillStyle = Color.web(this._parentActivityColor).withOpacity(this._baselineOpacityRatio).toCssString();
      ctx.strokeStyle = `rgba(0,0,0,${this._baselineOpacityRatio})`;
    } else {
      ctx.fillStyle = this._parentActivityColor;
      ctx.strokeStyle = this._strokeColor;
    }

    // Draw elements
    ScheduleJsViewerTaskActivityRenderer._drawParentActivityStartTriangle(ctx, x + leftPadding, y + topPadding, this._parentActivityTrianglesWidthPx, this._parentActivityTrianglesHeightPx);
    ScheduleJsViewerTaskActivityRenderer._drawParentActivityBody(ctx, x + leftPadding, y + topPadding, w, this._parentActivityTrianglesWidthPx, this._parentActivityTrianglesHeightPx);
    ScheduleJsViewerTaskActivityRenderer._drawParentActivityEndTriangle(ctx, x + leftPadding, y + topPadding, w, this._parentActivityTrianglesWidthPx, this._parentActivityTrianglesHeightPx);

    // Return positions to update where your activity should be responsive
    return new ActivityBounds(activityRef, x, y, w, h);
  }
Salin selepas log masuk
Di sini kami terus menggunakan

HTMLCanvas API untuk menentukan strategi lukisan kami dengan menyediakan CanvasRenderingContex2D. Satu-satunya operasi berkaitan rangka kerja yang dilakukan dalam kaedah ini ialah mencipta beberapa ActivityBounds baharu untuk induk semasa Aktiviti.

Rangka kerja mencipta peta menggunakan

ActivityBounds di bawah hud untuk mendaftarkan semua aktiviti pada skrin. Peta ini membantu pembangun dengan menyediakan logik seperti elemen untuk membina pengalaman pengguna lanjutan berdasarkan maklumat yang tepat sambil memanfaatkan prestasi HTMLCanvas API.

The draw elements methods like _drawParentActivityStartTriangle rely on the CanvasRenderingContext2D API to draw at the pixel level.

// Draw the start triangle element of the parent activity

private static _drawParentActivityStartTriangle(ctx: CanvasRenderingContext2D,
                                                x: number,
                                                y: number,
                                                triangleWidth: number,
                                                triangleHeight: number): void {
    ctx.beginPath();
    ctx.moveTo(x, y);
    ctx.lineTo(x , y + triangleHeight);
    ctx.lineTo(x + triangleWidth, y);
    ctx.lineTo(x, y);
    ctx.fill();
    ctx.stroke();
    ctx.closePath();
}
Salin selepas log masuk

Final result

To register your brand-new renderer, use the graphics.setActivityRenderer method:

// Register the renderer

graphics.setActivityRenderer(ScheduleJsViewerTaskActivity, GanttLayout, new ScheduleJsViewerTaskActivityRenderer(graphics, currentRibbonMenuTab));

Salin selepas log masuk

brand-new renderer

To see the video of the final result you can go to see: Building an ActivityRenderer

Atas ialah kandungan terperinci Membina ActivityRenderer. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!

sumber:dev.to
Kenyataan Laman Web ini
Kandungan artikel ini disumbangkan secara sukarela oleh netizen, dan hak cipta adalah milik pengarang asal. Laman web ini tidak memikul tanggungjawab undang-undang yang sepadan. Jika anda menemui sebarang kandungan yang disyaki plagiarisme atau pelanggaran, sila hubungi admin@php.cn
Tutorial Popular
Lagi>
Muat turun terkini
Lagi>
kesan web
Kod sumber laman web
Bahan laman web
Templat hujung hadapan