描述
Axismundi Dialogs provides an axismundi/dialogs collection with Sheet and Dialog
child blocks. The collection controls alignment, orientation, justification,
wrapping, and spacing. Each child has an editable open button and renders a
native <dialog> host.
Sheets support side and bottom geometry, modal or standard presentation,
docked or detached modal side sheets, start/end edges, and body-only or whole-
sheet scrolling. Standard side sheets resize the site on larger screens and
fall back to a modal presentation on compact screens. Dialogs support basic,
list, and full-screen layouts.
The native dialog supplies the top layer, scrim, focus containment, and focus
restoration. The plugin adds animated open/close, Escape and backdrop dismissal,
modal scroll locking, responsive presentation, smooth standard-sheet page push,
and a single-open-dialog policy.
The sheet content is a Sheet template part, so the theme owns the header,
close button, title, and body layout — the same theme//slug contract the core
Navigation overlay uses. An axismundi/dialog-close block lets a part place its
dismiss control anywhere.
WordPress core reserves the template-part area vocabulary. The plugin therefore
does not register custom sheet or dialog areas: Axismundi Theme 0.1.12 or
later supplies the default parts in the supported Uncategorized area, where
they remain editable in the Site Editor. The picker distinguishes them by their
sheet- and dialog- slugs. This preserves the standard theme//slug
template-part contract while keeping behavior with the plugin.
Blocks
This plugin provides 8 blocks.
- Sheets Arrange one or more Sheet triggers.
- Post Quick View A single per-page dialog that shows a selected post's quick view. Post Quick View Trigger blocks in a feed open it, and it fetches the post fragment on demand — so the page never renders one dialog per post. Place one per page (e.g. before the footer).
- Sheet Close Button A close button for use inside a Sheet template part. Dismisses the sheet it is placed in.
- Sheet Title Shows the current sheet's title. Placed in a Sheet template part header; the title is supplied by the Sheet block.
- Post Quick View Trigger A microblog-style comments action for a post — a Material Symbols icon plus the comment count. In v0.1 it links to the post's comments; a later phase will open a shared quick-view dialog. Place it inside a Post Template.
- Dialog Icon An optional leading icon for a basic dialog header. Placed in a Dialog template part.
- Sheet A trigger button that opens a Material Design 3 side or bottom sheet. The sheet content is a Sheet template part.
- Dialog An open button that opens a Material Design 3 basic or full-screen dialog. The content is a Dialog template part.
安裝
- Install and activate Axismundi Theme 0.1.10 or later (recommended; blocks work with
any block theme, styled by its own fallbacks). - Upload and activate this plugin.
- Insert the Sheets block, edit its trigger text, and choose each Sheet’s
template part, variant, and edge.
常見問題
-
Does this plugin require an external service?
-
No. Everything runs locally in WordPress with the native
<dialog>element and
the WordPress Interactivity API. -
Can it be used without the Axismundi theme?
-
Yes. The sheet renders with its own token fallbacks, but it needs at least one
template part to show as content. With Axismundi Theme, use a Sheet or Dialog
part from the Site Editor’s Uncategorized area.
評價
There are no reviews for this plugin.
貢獻者及開發者
修改日誌
0.2.3
- Match the Theme’s supported Uncategorized template-part area so Sheet and
Dialog pickers continue to list their default parts in the Site Editor.
0.2.2
- Keep the standard
theme//slugtemplate-part contract for Sheet and Dialog
content while using the core-supported General template-part area. - Remove the plugin-defined
sheetanddialogarea registrations so the
Theme Directory does not categorize the parts as unsupported.
0.2.1
- Expose the native basic-dialog surface to dynamic Axismundi interaction
blocks, so contextual UI can reuse the accessible dialog chrome without a
template-part indirection.
0.2.0
- Add a Post Quick View Trigger block: a microblog-style comments action (icon
plus count) for a Post Template that opens the shared quick view, falling back
to the post’s comments anchor when the hub or scripting is unavailable. - Add a singleton Post Quick View block: one per-page dialog that lazy-loads the
clicked post over the REST API — title, meta, featured image, content, and a
read-only comment thread with Reddit-style reply folding. - Let logged-in readers post comments and threaded replies from a fixed
composer without leaving the feed: a per-comment Reply puts the composer in
“replying to” mode, the thread refetches and expands on success, and
moderation is honoured. Anonymous commenting links out to the full post.
0.1.0
- Initial release of the Dialogs collection with Sheet and Dialog host blocks.
- Side and bottom sheets with modal/standard, docked/detached, edge, width, and
body/sheet scrolling controls. - Basic, list, and full-screen Material 3 dialogs.
- Native
<dialog>and Interactivity API runtime with animated dismissal,
backdrop and Escape handling, focus restoration, responsive modal fallback,
scroll lock, and smooth standard-sheet page push. - Editable Sheet and Dialog template-part areas with title, icon, and close
companion blocks. - Reduced-motion and RTL support via logical properties.