Документация пока доступна только на английском языке. Остальная часть сайта соответствует вашему языку.
Core blocks
Every core block type plus the built-in Post List and Comments: text, lists, tables, disclosure and tabs, media, layout, site identity and navigation, content queries, and site chrome.
7 минута чтения
Registered in @justflows/blocks and exposed at GET /api/blocks. Type ids are stable (core.*).
| Type | Title | Category | Main props |
|---|---|---|---|
core.paragraph | Paragraph | content | richtext text |
core.heading | Heading | content | text, level 1–6 (default 2) |
core.quote | Quote | content | richtext text, attribution |
core.button | Button | content | label and href (typed URL or page/post picker; sanitized) |
core.link-list | Link List | content | optional heading and reorderable links |
core.html | HTML | content | sanitized HTML, wrapped in one <div class="jf-html"> so block styles and scoped CSS apply to every top-level node |
core.code | Code | content | code listing |
core.image | Image | media | src (media), alt, caption |
core.embed | Embed | media | embed URL |
core.list / core.list-item | List | content | bullets, numbering, or a checklist; start number, reversed order, marker, gap; nested lists |
core.table | Table | content | cell editor, caption, header and footer rows, stripes, borders, alignment; up to 100 rows and 20 columns |
core.details | Details | content | summary, initial open state, marker, child blocks |
core.accordion | Accordion | content | Details children; one open at a time or several |
core.tabs / core.tab | Tabs | content | panel titles and content, horizontal or vertical, initial tab, automatic or manual keyboard activation |
core.callout | Notice / Callout | content | info, success, warning, error, or neutral; title, icon, optional dismiss button |
core.icon | Icon | content | built-in icon, label or decorative, size, colour, stroke width (no arbitrary SVG) |
core.video | Video | media | URL, caption, controls, autoplay, muted, loop, preload, poster, size and fit |
core.audio | Audio | media | URL, caption, controls, autoplay, muted, loop, preload |
core.file | File | media | URL, link label (defaults to the file name), download toggle |
core.cover | Cover | media | image or video background with overlay, focal point, minimum height, and child blocks; videos get a pause control |
core.media-text | Media & Text | media | image or video beside child blocks; side, width, fit, gap, mobile stacking |
| Type | Title | Notes |
|---|---|---|
core.divider | Divider | Horizontal rule. |
core.spacer | Spacer | Vertical space. |
core.section | Section | Children wrapper. |
core.container | Container | Width-constrained children. |
core.group | Group | Generic children group. |
core.columns | Columns | Children should be core.column. |
core.column | Column | One column inside columns. |
core.grid | Grid | Responsive column grid; move and resize any child visually or enter its exact placement. |
core.reusable | Reusable block | Linked reference to a saved library block, resolved on the server. |
core.buttons | Buttons | Button children in a row or column, with alignment, gap, and wrapping. |
core.card | Card | Child blocks with padding, gap, border, corners, shadow, and alignment. |
| Type | Title | Use |
|---|---|---|
core.color-scheme | Light / dark | Light, dark, or Auto (follow the visitor's device). |
core.language-switcher | Language switcher | Full locale, short locale, flags, flag and locale, or flag and country-name styles, each an accessible dropdown. |
core.auth-links | Login / register | Account links; registration appears publicly only when enabled in Settings. |
justflows.blog.post-list | Post List | Paginated published posts in a grid or list, with optional images, dates, and excerpts. |
justflows.comments.thread | Comments | Threaded approved discussion plus a guarded submission form; see Comments. |
core.site-logo / core.site-title / core.site-tagline | Site identity | The live logo, title, and tagline, optionally linked home. |
core.navigation | Navigation | The header or footer menu, or any menu by slug, with layout, submenus, and mobile collapse. Uses the menu renderer and its visibility rules. |
core.breadcrumbs | Breadcrumbs | Home link and current page with editable labels and separator. |
core.social-links | Social Links | Profile links with icons, optional labels, and safe new-tab links. |
core.table-of-contents | Table of Contents | Links to the page's headings within a heading-level range, optionally numbered. |
core.content-query | Content Query | Published content by type and taxonomy term, sorted, as a grid or list, with pagination. |
core.search | Search | A site search field. |
core.account / core.auth-form | Account section / Account form | Parts of the account and sign-in pages. |
| Type | Title | Use |
|---|---|---|
core.hero | Hero | Page intro band. |
core.features | Features | Feature grid. |
core.cta | Call to Action | Closing conversion band. |
The core.color-scheme (light/dark) block ships several designs — a two/three-button segmented control, a single sun/moon toggle, a switch, a compact dropdown, plain text labels, or icon buttons with tooltips — each selectable per block with size, radius, overridable icons and labels, and an optional animated icon change that respects prefers-reduced-motion. All variants share one CSP-safe preference engine.
Templates add context blocks that render the current request's content: core.post-title, core.post-content, core.post-meta, core.post-excerpt, core.featured-image, and core.template-part. See Templates.
Lists, Details, Accordions, Tabs, and dismissible notices need no external library: their public behaviour ships in /js/block-interactions.js and works with the keyboard. Without JavaScript, Details still open and tab content stays readable. In the builder, Details and tab panels stay open for editing.
Site identity, menus, and query results are resolved on the server. Content Query returns only published, publicly listed content of the current site and locale. Its page parameter must end in -page (default content-page), so give each query on a page its own key; paginated requests bypass the shared page cache. Table of Contents opens an enclosing Details or tab panel when a link is followed.
Good to know
Images use loading="lazy" and safeMediaSrc. Buttons and embeds refuse unsafe URLs. Custom HTML is sanitized, not blindly echoed. Video, Audio, File, Cover, and Media & Text accept only site-relative or HTTPS media URLs.
Block settings
Each core block's sidebar shows only the settings that apply to it. Duplicate or ineffective generic controls are hidden, and fields that depend on another choice appear only when it is made: playback settings for a video Cover, numbering for a numbered list, checkbox state inside a checklist. Theme styling shows the variables the theme curated for that block instead of the whole catalog. Hiding a control never deletes a saved value; a stored value stays visible until you clear it. Plugin blocks keep the default controls and can switch them on or off with inspector in their block definition.