Toast Bildirimleri, Gelen Kutusu ve Rozetler İçeren Bir Delphi Bildirim Bileşeni
sgcUI'nin parçası olan sgcNavigation, VCL ve FireMonkey uygulamalarına tek bir bildirim modeliyle yönetilen bir Delphi bildirim bileşen kümesi getirir.
sgcUI'nin parçası olan sgcNavigation, VCL ve FireMonkey uygulamalarına tek bir bildirim modeliyle yönetilen bir Delphi bildirim bileşen kümesi getirir.
Model hiçbir şey çizmez ve çatıdan bağımsızdır; böylece tek bir model aynı uygulamanın VCL ve FireMonkey görünümlerini besler.
Tek bir bildirim modeli toast bildirimlerini, güne göre gruplanmış bir bildirim gelen kutusunu, bir okunmamış rozetini ve kategori başına tercihleri yönetir; bir sunucu da yeni bildirimleri WebSocket, MQTT veya sunucu tarafından gönderilen olaylar üzerinden canlı olarak gönderebilir.
| Bileşen | Birim | Rol |
|---|---|---|
TsgcNotificationModel | sgcNavigation_Notification | Görsel değil. Bildirimleri tutar, okunmamışları sayar, okundu olarak işaretler, kapatır ve JSON olarak kaydeder. |
TsgcVCLToastManager, TsgcFMXToastManager | sgcNavigation_Toast_VCL, sgcNavigation_Toast_FMX | Görsel değil. Modelin her yeni okunmamış bildirimi için bir toast bildirimi gösterir ve koddan bağımsız toast bildirimleri gösterir. |
TsgcVCLNotificationInbox, TsgcFMXNotificationInbox | sgcNavigation_Inbox_VCL, sgcNavigation_Inbox_FMX | Bildirimleri güne göre listeleyen, All ve Unread sekmeleri ile Mark all as read düğmesi olan bir denetim. |
TsgcNotificationPreferences | sgcNavigation_NotifyPrefs | Görsel değil. Kullanıcının her kategori için istediği kanallar (uygulama içi, açılır pencere, e-posta, anlık bildirim). |
TsgcVCLNotificationPrefsEditor, TsgcFMXNotificationPrefsEditor | sgcNavigation_NotifyPrefs_VCL, sgcNavigation_NotifyPrefs_FMX | Tercihleri, kategori başına bir satır olacak şekilde bir onay kutusu tablosu olarak gösteren bir denetim. |
TsgcToolbarBadgeLink | sgcToolbar_BadgeLink | Görsel değil, sgcToolbar içinde. Modelin okunmamış sayısını bir araç çubuğu veya şerit öğesinin rozeti olarak gösterir, 99 üzerinde 99+. |
TsgcUILiveSource_WebSocket, TsgcUILiveSource_MQTT, TsgcUILiveSource_SSE | sgcUICoreWS köprüsü | Bir sunucunun bir sgcWebSockets bağlantısı üzerinden gönderdiği JSON iletilerini modele iletin (Registered sürümü). |
Toast bildirimi, formun veya ekranın bir köşesinde beliren, geri sayım yapan ve kendiliğinden kapanan kısa bir karttır.
Bir toast bildiriminde bir önem simgesi veya görsel, bir başlık, en fazla üç satırlık bir gövde, bir kapat düğmesi ve en fazla iki eylem düğmesi bulunur. Toast yöneticisi, formdaki görsel olmayan bir bileşendir: toast bildirimlerini üst üste dizer, geri sayımlarını yapar, işaretçinin altında duraklatır, soldurarak açar ve kapatır ve sığmayanları kuyruğa alır.
Position köşeyi veya kenarı seçer, varsayılan olarak tpsBottomRight, ve VCL yöneticisinin Anchor özelliği toast bildirimlerini formda ya da ekranın çalışma alanında dizer.Duration varsayılan olarak 5000 ms'dir ve StickySeverities, hataları kullanıcı kapatana kadar ekranda tutar.MaxVisible (3) ekrandaki toast bildirimlerini sınırlar; sonrakiler bir kuyrukta bekler.uses
Classes, SysUtils, Forms,
sgcNavigation_Notification, sgcNavigation_Toast, sgcNavigation_Toast_VCL;
procedure TMainForm.FormCreate(Sender: TObject);
begin
FToasts := TsgcVCLToastManager.Create(Self);
// the bottom right corner of the form, two toasts at a time
FToasts.Anchor := tanForm;
FToasts.Position := tpsBottomRight;
FToasts.MaxVisible := 2;
// warnings and errors stay until the user closes them
FToasts.StickySeverities := [nsvWarning, nsvError];
end;
procedure TMainForm.ExportFinished(aRows: Integer);
begin
FToasts.Show('Export finished', IntToStr(aRows) + ' rows written.',
nsvSuccess);
end;
FireMonkey'de TsgcFMXToastManager, Anchor dışında aynı özelliklere sahiptir. Toast bildirimleri formun içindeki bir kaplamada yaşar; bu, Windows, macOS, Linux, iOS ve Android'de çalışır.
Model bir kullanıcının bildirimlerini tutar; toast bildirimleri, gelen kutusu ve rozet başka kod olmadan onu izler.
Bir bildirimin bir Id'si, bir başlığı, düz metin bir gövdesi, bir önem düzeyi (info, success, warning veya error), bir UTC saati, bir okunma durumu, bir kategorisi, onu oluşturan kaynak ve eylem düğmeleri vardır. Add yeni bir okunmamış bildirim ekler. Post, Id'ye göre bir upsert işlemidir; böylece bir siparişin, bir derlemenin veya bir biletin anahtarı ikinci bir bildirim eklemek yerine tek bir bildirimi güncel tutar. MarkRead, MarkAllRead ve Dismiss durumu değiştirir, SaveToFile ve LoadFromFile ise bildirimleri oturumlar arasında JSON olarak saklar.
TsgcToolbarBadgeLink okunmamış sayısını bir araç çubuğu düğmesinde, Registered sürümünde ise bir şerit düğmesinde gösterir.OnAction olayını eylemin kimliğiyle tetikler.uses
Classes, SysUtils, Controls, Forms,
sgcNavigation_Notification, sgcNavigation_NotifyPrefs,
sgcNavigation_Toast_VCL, sgcNavigation_Inbox_VCL,
sgcToolbar_VCL, sgcToolbar_BadgeLink;
procedure TMainForm.SetupNotifications(aToolbar: TsgcVCLToolbar);
var
vFile: string;
begin
// the notifications of the user, kept between sessions
FModel := TsgcNotificationModel.Create(Self);
vFile := ExtractFilePath(Application.ExeName) + 'notifications.json';
if FileExists(vFile) then
FModel.LoadFromFile(vFile);
FModel.OnAction := ModelAction;
// orders pop up, news only go to the inbox
FPrefs := TsgcNotificationPreferences.Create(Self);
FPrefs.Categories.Add('orders', 'Orders');
FPrefs.Categories.Add('news', 'News').Defaults := [nchInApp];
// a toast for every new unread notification its category allows
FToasts := TsgcVCLToastManager.Create(Self);
FToasts.Preferences := FPrefs;
FToasts.Model := FModel;
// every notification, newest first, under a header per day
FInbox := TsgcVCLNotificationInbox.Create(Self);
FInbox.Parent := Self;
FInbox.Align := alRight;
FInbox.Width := 360;
FInbox.Model := FModel;
// the unread count as the badge of the first toolbar button
FBadge := TsgcToolbarBadgeLink.Create(Self);
FBadge.Source := FModel;
FBadge.Target := aToolbar;
FBadge.ItemIndex := 0;
end;
procedure TMainForm.OrderShipped(const aOrderId: string);
var
oItem: TsgcNotificationItem;
begin
FModel.BeginUpdate;
try
// an upsert: the same id updates the notification
oItem := FModel.Post('order-' + aOrderId, 'Order ' + aOrderId +
' shipped', 'The parcel left the warehouse.', nsvSuccess, 'orders');
if oItem.Actions.IndexOf('track') < 0 then
oItem.Actions.Add('track', 'Track');
finally
FModel.EndUpdate;
end;
end;
BeginUpdate ile EndUpdate arasında yapılan değişiklikler görünümlere bir kez ulaşır; böylece toast bildirimi bitmiş bildirimi düğmeleriyle gösterir. Model ana iş parçacığından kullanılır.
VCL, açık tema: tercihlerin üstünde gelen kutusu.
FireMonkey, açık tema.
Kenar çubuğunda Inbox, Tasks ve Alerts üzerinde sayı rozetleri.
Bir sunucu, bir kullanıcının bildirimlerini, ileti başına bir JSON nesnesi olacak şekilde canlı iletilerle güncel tutar.
ApplyMessage bir iletiyi modele uygular: add, update, remove, read, unread veya snapshot. Toast bildirimleri, gelen kutusu ve rozet modeli izler; böylece sunucudan gelen bir ileti başka kod olmadan ekranda görünür. ApplyMessage hiçbir zaman hata fırlatmaz; bir ileti kendisine ait değilse False döndürür ve modeli değiştirmeden bırakır.
{"type":"notification","op":"add","notification":{"id":"n2","title":"Build 812 passed","severity":"success","group":"ci"}}
{"type":"notification","op":"update","notification":{"id":"n2","body":"All 1,204 tests passed"}}
{"type":"notification","op":"read","ids":["n1","n2"]}
{"type":"notification","op":"remove","id":"n1"}
sgcUICoreWS köprüsünün canlı kaynakları bir sgcWebSockets istemcisinin iletilerini alıp modele iletir: bir TsgcWebSocketClient için TsgcUILiveSource_WebSocket, bir TsgcWSPClient_MQTT için TsgcUILiveSource_MQTT ve bir TsgcHTTP1Client'ın sunucu tarafından gönderilen olayları için TsgcUILiveSource_SSE. Bir soket iş parçacığında gelen iletiler kuyruğa alınır ve ana iş parçacığında uygulanır.
uses
Classes, SysUtils,
sgcWebSocket, sgcUICoreWS_Live, sgcUICoreWS_Live_WebSocket,
sgcNavigation_Notification;
function BindNotifications(aOwner: TComponent; aClient: TsgcWebSocketClient;
aModel: TsgcNotificationModel): TsgcUILiveSource_WebSocket;
var
oBinding: TsgcUILiveBinding;
begin
Result := TsgcUILiveSource_WebSocket.Create(aOwner);
Result.Client := aClient;
oBinding := Result.Bindings.Add;
oBinding.Target := aModel;
// only the frames of the alerts channel, the live message is in "data":
// {"channel":"alerts","data":{"type":"notification","op":"add",...}}
oBinding.FilterPath := 'channel';
oBinding.FilterValue := 'alerts';
oBinding.MessagePath := 'data';
end;
OnNotification ve OnAction olaylarını işleyin ve aynı istemci üzerinden kendi çerçevenizi gönderin.Canlı iletiler ve canlı kaynaklar Registered sürümünün parçasıdır ve canlı kaynaklar sgcWebSockets gerektirir. Sunucu yoksa uygulama, modelin Add ve Post metotlarını çağırır.
VCL ile Delphi 7'den Delphi 13'e, Delphi XE6'dan itibaren FireMonkey, C++Builder ve .NET WinForms, WPF ve Avalonia.
TsgcVCLToastManager, TsgcVCLNotificationInbox ve TsgcVCLNotificationPrefsEditorTsgcFMXToastManager, TsgcFMXNotificationInbox ve TsgcFMXNotificationPrefsEditorTsgcWinFormsToastManager, TsgcWpfToastManager ve TsgcAvaloniaToastManagersgcUI paketinin Realtime demosu; VCL, FireMonkey, C++Builder ve .NET'te, rozeti okunmamış sayısı olan bir zil ve tercihlerin üstünde bildirim gelen kutusu içeren bir operasyon konsolu oluşturur. Bkz. Realtime arayüz paketi.
Bildirim bileşenleri ürünlerinin, sgcNavigation'ın, sürümünü izler ve rozet bağlantısı sgcToolbar'ı izler.
| Parça | Ürün | .NET Community | Registered |
|---|---|---|---|
| Bildirim modeli, toast bildirimleri, gelen kutusu ve tercihler | sgcNavigation | Evet | Evet |
| Araç çubuğuyla rozet bağlantısı | sgcToolbar | Evet | Evet |
| Şeritle rozet bağlantısı | sgcToolbar | No | Evet |
| Canlı bildirim iletileri | sgcNavigation | No | Evet |
| WebSocket, MQTT ve SSE üzerinden canlı kaynaklar (sgcWebSockets gerektirir) | sgcUICore | No | Evet |
Delphi ve C++Builder'da bildirim bileşenleri sgcUI Standard, Professional, Enterprise, All-Access ve Trial ile, ayrıca tek başına satılan sgcNavigation ve sgcToolbar ile gelir. Ücretsiz .NET Community paketleri de bunları içerir. Delphi Community sürümü yalnızca sgcGrid sunar. Bkz. sgcUI fiyatlandırması.
Forma bir TsgcVCLToastManager ya da FireMonkey'de bir TsgcFMXToastManager koyun ve bir başlık, bir gövde ve bir önem düzeyiyle Show çağırın. Toast bildirimi seçtiğiniz köşede belirir, varsayılan olarak beş saniye geri sayar, işaretçi üzerindeyken duraklar ve hiçbir zaman odağı almaz. Model'i ayarlanmışsa yönetici, her yeni okunmamış bildirim için de bir toast bildirimi gösterir.
Bir TsgcNotificationModel oluşturun ve bildirimleri güne göre All ve Unread sekmeleri ve Mark all as read düğmesiyle listeleyen bir TsgcVCLNotificationInbox'ın Model'i olarak ayarlayın. Ardından modeli, Target'ı bir araç çubuğu olan bir TsgcToolbarBadgeLink'in Source'u olarak ayarlayın: okunmamış sayısı düğmede, 99 üzerinde 99+ olarak görünür.
Evet, Registered sürümünde. Sunucu her değişiklik için bir JSON iletisi gönderir ve ApplyMessage onu modele uygular. sgcUICoreWS köprüsünün canlı kaynakları bu iletileri sgcWebSockets'in bir WebSocket, MQTT veya sunucu tarafından gönderilen olaylar istemcisinden okur ve ana iş parçacığında uygular; böylece toast bildirimleri, gelen kutusu ve rozet başka kod olmadan güncellenir.
Evet. TsgcFMXToastManager, TsgcFMXNotificationInbox ve TsgcFMXNotificationPrefsEditor Delphi XE6'dan itibaren çalışır. FireMonkey toast bildirimleri formun içindeki bir kaplamada yaşar; Windows, macOS, Linux, iOS ve Android'de. Model çatıdan bağımsızdır, bu nedenle aynı TsgcNotificationModel VCL ve FireMonkey görünümlerini besler.
Evet. TsgcNotificationPreferences, kullanıcının her kategori için istediği kanalları tutar: uygulama içi, açılır pencere, e-posta ve anlık bildirim. Tercih düzenleyicisi bunları bir onay kutusu tablosu olarak gösterir. Preferences'ı ayarlanmış bir toast yöneticisi, açılır pencere kanalı kapalı bir kategori için toast bildirimi göstermez; gelen kutusu ise bu bildirimleri yine listeler.
Evet, onları kaydettiğinizde. Modelin SaveToFile ve LoadFromFile metotları bildirimleri oturumlar arasında bir JSON dosyası olarak saklar ve MaxCount (varsayılan 500) modeli sınırlar; önce en eski okunmuş bildirimleri bırakır.
Ücretsiz .NET Community paketleri modeli, toast bildirimlerini, gelen kutusunu ve tercihleri içerir. Delphi Community sürümü yalnızca sgcGrid sunar; bu nedenle Delphi ve C++Builder'da bildirim bileşenleri, tek başına ya da sgcUI Standard ve üzerinde satılan sgcNavigation ile gelir. All-Access deneme sürümü, değerlendirme için her sgcUI ürününü içerir.