토스트, 받은 편지함, 배지를 갖춘 Delphi 알림 컴포넌트
sgcUI의 일부인 sgcNavigation은 VCL과 FireMonkey 애플리케이션용 Delphi 알림 컴포넌트 세트를 제공하며, 모두 하나의 알림 모델로 구동돼요.
sgcUI의 일부인 sgcNavigation은 VCL과 FireMonkey 애플리케이션용 Delphi 알림 컴포넌트 세트를 제공하며, 모두 하나의 알림 모델로 구동돼요.
모델은 아무것도 그리지 않고 프레임워크 중립이라서, 하나의 모델이 같은 애플리케이션의 VCL 뷰와 FireMonkey 뷰에 모두 데이터를 공급해요.
하나의 알림 모델이 토스트 알림, 날짜별로 묶인 알림 받은 편지함, 읽지 않음 배지, 카테고리별 환경설정을 구동하고, 서버는 WebSocket, MQTT, 서버 전송 이벤트로 새 알림을 실시간으로 푸시할 수 있어요.
| 컴포넌트 | 유닛 | 역할 |
|---|---|---|
TsgcNotificationModel | sgcNavigation_Notification | 논비주얼. 알림을 보관하고, 읽지 않은 알림을 세고, 읽음으로 표시하고, 닫고, JSON으로 저장해요. |
TsgcVCLToastManager, TsgcFMXToastManager | sgcNavigation_Toast_VCL, sgcNavigation_Toast_FMX | 논비주얼. 모델의 새 읽지 않은 알림마다 토스트를 표시하고, 코드에서 독립형 토스트도 표시해요. |
TsgcVCLNotificationInbox, TsgcFMXNotificationInbox | sgcNavigation_Inbox_VCL, sgcNavigation_Inbox_FMX | 알림을 날짜별로 나열하는 컨트롤로, 전체와 읽지 않음 탭, 모두 읽음으로 표시 버튼이 있어요. |
TsgcNotificationPreferences | sgcNavigation_NotifyPrefs | 논비주얼. 사용자가 카테고리마다 원하는 채널(앱 내, 팝업, 이메일, 푸시)이에요. |
TsgcVCLNotificationPrefsEditor, TsgcFMXNotificationPrefsEditor | sgcNavigation_NotifyPrefs_VCL, sgcNavigation_NotifyPrefs_FMX | 환경설정을 카테고리당 한 행인 체크 박스 표로 보여 주는 컨트롤이에요. |
TsgcToolbarBadgeLink | sgcToolbar_BadgeLink | sgcToolbar의 논비주얼 컴포넌트. 모델의 읽지 않은 개수를 도구 모음이나 리본 항목의 배지로 표시하며, 99를 넘으면 99+로 표시해요. |
TsgcUILiveSource_WebSocket, TsgcUILiveSource_MQTT, TsgcUILiveSource_SSE | sgcUICoreWS 브리지 | 서버가 sgcWebSockets 연결로 보내는 JSON 메시지를 모델에 전달해요(Registered 에디션). |
토스트는 폼이나 화면의 모서리에 나타나 카운트다운한 뒤 스스로 닫히는 짧은 카드예요.
토스트에는 심각도 아이콘이나 이미지, 제목, 최대 세 줄의 본문, 닫기 버튼, 최대 두 개의 동작 버튼이 있어요. 토스트 관리자는 폼에 놓는 논비주얼 컴포넌트로, 토스트를 쌓고, 카운트다운하고, 포인터가 위에 있으면 일시 정지하고, 페이드 인과 아웃을 하며, 들어가지 않는 토스트는 대기열에 넣어요.
Position은 모서리나 가장자리를 고르며 기본값은 tpsBottomRight예요. VCL 관리자의 Anchor는 토스트를 폼 또는 화면의 작업 영역에 쌓아요.Duration의 기본값은 5000 ms이고, StickySeverities는 사용자가 닫을 때까지 오류를 화면에 유지해요.MaxVisible(3)은 화면에 표시되는 토스트 수를 제한해요. 다음 토스트는 대기열에서 기다려요.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에서 TsgcFMXToastManager는 Anchor를 제외한 같은 속성을 가져요. 토스트는 폼 안의 오버레이에 표시되며 Windows, macOS, Linux, iOS, Android에서 동작해요.
모델은 한 사용자의 알림을 보관하고, 토스트, 받은 편지함, 배지는 별도의 코드 없이 모델을 따라가요.
알림에는 Id, 제목, 일반 텍스트 본문, 심각도(info, success, warning, error), UTC 시간, 읽음 상태, 카테고리, 발생시킨 소스, 동작 버튼이 있어요. Add는 읽지 않은 새 알림을 추가해요. Post는 Id 기준 upsert이므로 주문, 빌드, 티켓의 키가 두 번째 알림을 추가하는 대신 알림 하나를 최신 상태로 유지해요. MarkRead, MarkAllRead, Dismiss는 상태를 바꾸고, SaveToFile과 LoadFromFile은 세션 사이에 알림을 JSON으로 보관해요.
TsgcToolbarBadgeLink는 도구 모음 버튼에 읽지 않은 개수를 표시하고, Registered 에디션에서는 리본 버튼에도 표시해요.OnAction이 동작의 id와 함께 발생해요.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와 EndUpdate 사이에서 이루어진 변경은 뷰에 한 번만 전달되므로 토스트가 버튼과 함께 완성된 알림을 보여 줘요. 모델은 메인 스레드에서 사용해요.
VCL, 라이트 테마: 환경설정 위의 받은 편지함.
FireMonkey, 라이트 테마.
사이드바의 Inbox, Tasks, Alerts에 있는 개수 배지.
서버는 메시지마다 JSON 객체 하나를 보내는 실시간 메시지로 사용자의 알림을 최신 상태로 유지해요.
ApplyMessage는 메시지를 모델에 적용해요. add, update, remove, read, unread, snapshot이 있어요. 토스트, 받은 편지함, 배지가 모델을 따라가므로 서버의 메시지가 별도의 코드 없이 화면에 표시돼요. ApplyMessage는 예외를 발생시키지 않아요. 메시지가 해당하지 않으면 False를 반환하고 모델을 그대로 둬요.
{"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 브리지의 라이브 소스는 sgcWebSockets 클라이언트의 메시지를 받아 모델에 전달해요. TsgcWebSocketClient용 TsgcUILiveSource_WebSocket, TsgcWSPClient_MQTT용 TsgcUILiveSource_MQTT, TsgcHTTP1Client의 서버 전송 이벤트용 TsgcUILiveSource_SSE가 있어요. 소켓 스레드에 도착한 메시지는 대기열에 넣었다가 메인 스레드에서 적용돼요.
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과 OnAction을 처리하고 같은 클라이언트로 직접 만든 프레임을 보내세요.실시간 메시지와 라이브 소스는 Registered 에디션에 포함되며, 라이브 소스에는 sgcWebSockets가 필요해요. 서버가 없으면 애플리케이션이 모델의 Add와 Post를 호출해요.
VCL은 Delphi 7~Delphi 13, FireMonkey는 Delphi XE6부터, C++Builder, 그리고 .NET WinForms, WPF, Avalonia를 지원해요.
TsgcVCLToastManager, TsgcVCLNotificationInbox, TsgcVCLNotificationPrefsEditorTsgcFMXToastManager, TsgcFMXNotificationInbox, TsgcFMXNotificationPrefsEditorTsgcWinFormsToastManager, TsgcWpfToastManager, TsgcAvaloniaToastManager와 받은 편지함, 환경설정 에디터sgcUI 제품군의 Realtime 데모는 배지가 읽지 않은 개수를 보여 주는 종 아이콘과 환경설정 위의 알림 받은 편지함이 있는 운영 콘솔을 VCL, FireMonkey, C++Builder, .NET으로 만들어요. Realtime UI 팩을 참고하세요.
알림 컴포넌트는 해당 제품인 sgcNavigation의 에디션을 따르고, 배지 링크는 sgcToolbar를 따라요.
| 구성 요소 | 제품 | .NET Community | Registered |
|---|---|---|---|
| 알림 모델, 토스트, 받은 편지함, 환경설정 | sgcNavigation | 예 | 예 |
| 도구 모음과 함께 쓰는 배지 링크 | sgcToolbar | 예 | 예 |
| 리본과 함께 쓰는 배지 링크 | sgcToolbar | No | 예 |
| 실시간 알림 메시지 | sgcNavigation | No | 예 |
| WebSocket, MQTT, SSE 기반 라이브 소스(sgcWebSockets 필요) | sgcUICore | No | 예 |
Delphi와 C++Builder에서 알림 컴포넌트는 sgcUI Standard, Professional, Enterprise, All-Access, 체험판과 함께, 그리고 단독 판매되는 sgcNavigation과 sgcToolbar와 함께 제공돼요. 무료 .NET Community 패키지에도 포함돼요. Delphi Community 에디션은 sgcGrid만 제공해요. sgcUI 가격을 참고하세요.
폼에 TsgcVCLToastManager를, FireMonkey에서는 TsgcFMXToastManager를 놓고 제목, 본문, 심각도와 함께 Show를 호출하세요. 토스트는 선택한 모서리에 나타나 기본적으로 5초 동안 카운트다운하고, 포인터가 위에 있는 동안 일시 정지하며, 포커스를 가져가지 않아요. Model을 설정하면 관리자가 새 읽지 않은 알림마다 토스트도 표시해요.
TsgcNotificationModel을 만들어 TsgcVCLNotificationInbox의 Model로 설정하세요. 받은 편지함은 알림을 날짜별로 나열하며 전체와 읽지 않음 탭, 모두 읽음으로 표시 버튼이 있어요. 그런 다음 모델을 TsgcToolbarBadgeLink의 Source로, 도구 모음을 Target으로 설정하면 버튼에 읽지 않은 개수가 표시되고 99를 넘으면 99+로 표시돼요.
네, Registered 에디션에서 가능해요. 서버가 변경마다 JSON 메시지 하나를 보내면 ApplyMessage가 모델에 적용해요. sgcUICoreWS 브리지의 라이브 소스는 sgcWebSockets의 WebSocket, MQTT, 서버 전송 이벤트 클라이언트에서 그 메시지를 읽어 메인 스레드에서 적용하므로 토스트, 받은 편지함, 배지가 별도의 코드 없이 업데이트돼요.
네. TsgcFMXToastManager, TsgcFMXNotificationInbox, TsgcFMXNotificationPrefsEditor는 Delphi XE6부터 동작해요. FireMonkey 토스트는 폼 안의 오버레이에 표시되며 Windows, macOS, Linux, iOS, Android에서 동작해요. 모델은 프레임워크 중립이므로 같은 TsgcNotificationModel이 VCL 뷰와 FireMonkey 뷰에 데이터를 공급해요.
네. TsgcNotificationPreferences는 사용자가 카테고리마다 원하는 채널을 보관해요. 앱 내, 팝업, 이메일, 푸시예요. 환경설정 에디터는 이를 체크 박스 표로 보여 줘요. Preferences가 설정된 토스트 관리자는 팝업 채널이 꺼진 카테고리에 대해 토스트를 표시하지 않으며, 받은 편지함에는 그 알림이 계속 나열돼요.
네, 저장하면 유지돼요. 모델의 SaveToFile과 LoadFromFile이 세션 사이에 알림을 JSON 파일로 보관하고, MaxCount(기본값 500)가 모델의 크기를 제한하며 가장 오래된 읽은 알림부터 삭제해요.
무료 .NET Community 패키지에는 모델, 토스트, 받은 편지함, 환경설정이 포함돼요. Delphi Community 에디션은 sgcGrid만 제공하므로 Delphi와 C++Builder에서 알림 컴포넌트는 단독 판매되는 sgcNavigation 또는 sgcUI Standard 이상과 함께 제공돼요. All-Access 체험판에는 평가를 위해 모든 sgcUI 제품이 포함돼요.