
tframestand
Agent Skill for TFrameStand and TFormStand (Delphi FMX): stands, dialogs with a result, Back/Esc, navigation stacks, the stand gallery, animations, Common Actions, injection and responsive frames.
- GitHub stars
- 280
Install
/plugin install tframestand@tframestandRun it inside Claude Code after adding the marketplace with /plugin marketplace add andrea-magni/TFrameStand.
Contents
Discovered from sourceSkills 1
Developing with TFrameStand / TFormStand
TFrameStand (https://github.com/andrea-magni/TFrameStand, docs https://andrea-magni.github.io/TFrameStand/) shows FMX frames (TFrameStand) or the content of forms (TFormStand) on a stand: a style item (from a TStyleBook) that wraps the subject with decorations and OnShow*/OnHide* animations. Minimum Delphi version: 10.4. All the calls run in the main thread.
Mental model
- Component:
TFrameStand/TFormStandon a form or data module. Key properties:StandBook(theTStyleBookwith the stands),DefaultStandName(framestand/formstand),DefaultParent,AnimationShow/AnimationHidemasks (OnShow*/OnHide*),CatchBackKey,PushMode,ResponsiveMode. - Subject: the frame or form shown. Stand: a clone of the style item named like the stand; the subject goes in its element with
StyleName = 'container'. A missing stand name gives a plain layout (no decoration). - Info:
TFrameInfo<T>/TFormInfo<T>(baseTSubjectInfo), the handle of one subject on its stand:Frame/Form,Stand,Container,Show,Hide,HideAndClose,Close,ShowModal,ModalResult. Keep the info, not the frame (the frame can be replaced byResponsiveMode = rmLive).
uses FrameStand, SubjectStand;
LInfo := FrameStand1.New<TDetailsFrame>(ContentLayout, 'lightbox'); // created and owned, not shown
LInfo.Frame.Customer := LCustomer;
LInfo.Show;
...
LInfo.HideAndClose; // hide animations, then free stand, frame and info
Choosing the API
| The user wants | Use |
|---|---|
| show a frame on a stand | New<T>(AParent, AStandName) + Show, or NewAndShow<T> |
| show a frame already on the form | Use<T>(AFrame, AParent, AStandName) (not owned) |
| a dialog that returns a result | ShowModal(procedure (AFrame: T; AResult: TModalResult) ...); the frame sets FInfo.ModalResult := mrOk |
| close/cancel from many places | a Common Action: CommonActions.Add('*_cancel', procedure (AInfo: TSubjectInfo) begin AInfo.ModalResult := mrCancel end) |
| Android Back / Esc | CatchBackKey := True; non-dialog subjects opt in with BackKeyAction |
| pages, wizards, master/detail | Push<T>, Pop, PopToRoot, PushMode |
| ready-made dialog, lightbox, bottom sheet, drawer, snackbar, page | load stands\Stands.Light.style / Stands.Dark.style in the StandBook |
| toast / snackbar that goes away | Show then HideAndCloseAfter(2500) |
| different frame per screen width | Responsive.Define(TBase, TWide, 'md'), ResponsiveMode := rmLive to follow resizes |
Rules that avoid the common bugs
- Dismiss with
HideAndClose, notClose, from inside the subject's own event handlers.Closefrees the frame (and the control being clicked) at once;HideAndCloseandModalResultclose afterDefaultHideAndCloseDeferTimeMS. - After
Close/HideAndClosethe info is freed: set fields that reference it to nil (or useShowModalwithAClose = Trueand keep no reference). - Register Common Actions before
New/Use: they are bound when the subject is created. A matching control'sOnClickis replaced. ModalResultonly dismisses subjects shown withShowModal; the FMXTButton.ModalResultproperty does not apply (it sets the host form's result): setFInfo.ModalResultinOnClickor in a Common Action.- Injection:
[FrameInfo] FInfo: TFrameInfo<TMyFrame>must use the frame's own class or a base class it descends from; with responsive substitution, type it on the base class requested toNew. - Responsive substitutes must descend from the base class passed to
New<T>. - Do not cache
Info.FramewithResponsiveMode = rmLive; copy state to the new frame inOnResponsiveChange. Useframes are not owned: closing detaches them; if their parent is destroyed while shown, FMX destroys them too.- Animations: names must match
AnimationShow/AnimationHide(OnShow*/OnHide*);Hidewaits for the longestOnHide*animation. In a style, put size-dependent values in aTStyleTagchild (TagString = 'StartValue=-ParentHeight'), not in the animation'sTagString(not stored in styles). - Background work: run tasks with
TTask.Runand touch the components only throughTThread.Synchronize/TThread.Queue; theShow(ABackgroundTask...)overload is deprecated.StyleBook/DefaultStyleNameare deprecated names ofStandBook/DefaultStandName. - Follow the style of the existing code (frames vs forms, Common Actions vs
OnClick, stands in the form's style book or in a separate file).
References
Read the reference matching the task:
references/api.md— exact declarations (types, enums, units, signatures, events) and behaviors the declarations don't tell: read it before writing code against an API you are not sure about.references/lifecycle.md— New/Use/Show/Hide/HideAndClose/Close, ownership, timing, events, lifecycle methods ([BeforeShow]...), context injection, Common Actions.references/stands.md— designing stands, the stand gallery, animations, values from the stand size (TStyleTag).references/dialogs-and-navigation.md—ShowModal/ModalResult, Back/Esc (CatchBackKey,BackKeyAction), navigation stack (Push/Pop,PushMode,StackOperation).references/responsive.md— breakpoints, definitions,OnGetSubjectClass,ResponsiveMode = rmLive,OnResponsiveChange.references/formstand.md— TFormStand: forms as subjects,[Align]/[ClipChildren], differences from frames.
Sponsors
Details
- Marketplace
- andrea-magni/TFrameStand
- Category
- Community