ska-blocks - TailwindCSS for Block Editor
| 开发者 | skadev |
|---|---|
| 更新时间 | 2026年5月21日 07:57 |
| 捐献地址: | 去捐款 |
| PHP版本: | 6.8 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
ska-blocks plugin provides a seamless Tailwind CSS integration with the WordPress Block Editor.
Manage Tailwind classes on blocks with an intuitive UI, making it possible to implement any Tailwind-based website design directly in the Block Editor with no build step, template files or third party page builders. The plugin comes with low level blocks that can represent any HTML element, which makes it possible to convert custom HTML to blocks and makes the Gutenberg editor incredibly flexible.
Live demo on WordPress playground
Website
Read the docs
Features
- Enter any Tailwind class - the plugin compiles the CSS for it and enqueues it in the block editor and front end.
- No bloat - any classes you don't use on the page don't get loaded, only Tailwind theme and properties are loaded globally, optionally Tailwind's preflight can be included as well.
- Responsive - easily target any breakpoint in the block editor.
- Flexible - full control to utilize all HTML elements with any HTML attributes and styles - tailor custom solutions with no need for page builder bloat.
- Convert HTML to blocks - have an existing TailwindCSS-based design? Convert it to blocks automatically, use UI to fine-tune it and have less-technical users easily modify text content in a simple WYSIWYG environment.
- Presets & Variations - create reusable sets of classes, or blocks.
- AI integration - generate Tailwind HTML using AI and convert it to blocks on the spot.
- Text - any HTML element that contains rich text.
- Element - any HTML element that contains other elements.
- Tailwind - convert Tailwind HTML to blocks - find HTML from the web or generate with AI.
- Image - render an image, placeholder, SVG, featured image, Lottie.
- Gallery - render multiple images with simple markup.
安装:
Install via admin dashboard
- Go to your WordPress admin dashboard -> Plugins.
- Click "Add New".
- Click "Upload Plugin".
- Select the plugin zip file.
- Click "Install Now".
- Activate the plugin from WordPress admin dashboard -> Plugins.
- Upload the folder "ska-blocks" from the plugin zip file to your WordPress installations'
../wp-content/pluginsfolder. - Activate the plugin from WordPress admin dashboard -> Plugins.
常见问题:
How to use AI
Get a free API key from OpenRouter.ai, enter it to plugin options at Settings -> ska-blocks -> Options -> AI and enter the model you wish to use (you can find free to use models on OpenRouter website). Insert the "Tailwind" block and press the "AI" button on the toolbar to enter your prompt. You can switch between HTML or Preview mode to see what the GPT generated and click on the AI button again to have the AI make adjustments. Once ready you can convert the HTML to blocks by hitting "Convert to blocks".
Browser support
ska-blocks uses Tailwind 4 which supports the following browsers:
- Chrome 111 (released March 2023)
- Safari 16.4 (released March 2023)
- Firefox 128 (released July 2024)
更新日志:
1.2.11
- WordPress 7.0 compatibility.
- Convert HTML to blocks change - keep
widthandheightattributes on<svg>elements - conversion will be more faithful to the original, butsize-nTailwind classes may not have an effect until you remove the size attributes manually. - Fix potential fatal error with Photoswipe image dimensions detection logic.
- Lightbox block - cache image dimensions for fast retrieval.
- Added helper function for retrieving dynamic shortcode value:
ska_blocks_field('phone').
- Requires WP 6.8 (for
array_anypolyfill). - Tested with WP 6.9.
- Added "Role" option to Gallery block - allows to specify assistive technologies behavior for the gallery.
- Added "Cover" option to Gallery block - allows to easily apply
object-fit: coverto gallery images. - Added "Responsive" option to Gallery block - allows to control whether
srcsetandsizesare added to gallery images. - Custom links for gallery images in Gallery block can now include an
aria-labelfor the link. - Fixed bug in Gallery block with "Gallery wrapper" option disabled (e.g. a gallery rendered in a slider) added its' Tailwind classes to the first gallery image instead.
- Breaking change - Gallery block images no longer have the default
attachment-{$size} size-{$size}classes, but you can use theska_blocks_gallery_image_attrfilter to add them back if needed. - Display Image block icon name in List view.
- Added live preview to SVG edit modal.
- Use more reliable method for applying
srcsetandsizesto background images. - Preloading images in head now works for images that have a
srcset. - Added new image loading mode - LCP - adds
fetchpriority="high"anddecoding="sync". - Fix sideloaded posts results missing in REST results due to insufficient permissions to "edit" non-existent posts.
- Add missing bare value support for
Top / right / bottom / leftutilities. - Removed OpenRouter fallback model option.
- Fix server-side registration of
ska/textblock. - The "Default" variant can now be renamed to transfer the current value(s) to another variant such as
smorhover. - Declared interactivity clientNavigation support for blocks.
- Clear Cache Enabler cache when updating options.
- Added admin dashboard widget for quick editing dynamic content.
- Update Query Filters to apply to all publicly queryable post types.
- Added option to target variables to root, body and parent, added option to duplicate variables.
- Fix search results offering presets in contexts they can't be inserted.
- Cache and load Tailwind preflight from a CSS file by default.
- Query filters can now apply to main query.
- Image block can now render a low-res placeholder background.
- Image block and Background block support can now pre-load images in head.
- Add Query ID to sideloader.
- Block option panels now remember whether they're collapsed or not.
- Added "Repeater" appender.
- Added
.htaccessfile for serving.wasmfile with properContent-TypeandCache-Control.
- Update Tailwind properties.
- Ensure all media queries are rendered later than other queries.
- Added fix for WPML translation replacing some characters with
wpml_curvedandencoded_tag_closed.
- Update packages.
- Update Tailwind to 4.1.4, better compatibility with Safari 15.
- Revert HEX colors to oklch colors with %.
- Moved Tailwind colors back to static theme (as CSS variables rather than inline reference) so they can utilize new polyfills.
- Use HEX colors by default for better browser support.
- Added error messages when LightningCSS fails to initialize.
- Enqueue inline styles using
wp_enqueue_styleandwp_add_inline_style. - Added info about External services to readme.
- Changes to build system.
- Update to Tailwind 4.0.9.
- Remove legacy migrations, Tailwind 3.
- Dynamic link values, such as
#ska-link--front-pagecan now be used as blocks' custom attribute values. - Try: experimental variant modifiers (
>and^) that can be used within selectors. In a selector[&>.a]:[&>.b]adding a classhover:text-redwould produce[&>.a]:[&>.b]:hover:text-redmeaning that red text would be applied when hovering.b, but prepending the variant with<(<hover:text-red) moves it to the left, producing[&>.a]:hover:[&>.b]:text-red. Prepending^moves the variant to the top. - Added
ska_blocks_user_dynamic_linkfilter for modifying dynamic link output server-side. - Added AI support to Tailwind block via OpenRouter.
- Use Tailwind 4.
- Use LightningCSS instead of PostCSS.
- Presets and variations now use plugin options rather than custom post types.
- Added support for inset-ring, inset-shadow, font-stretch.
- Added support for rotate/scale/translate in 3D space.
- Added support for perspective, perspective origin, backface visibility, transition behavior.
- Added support for transition behavior.
- Added support for container queries.
- Added missing support for margin/padding/inset/etc inline-start/end.
- Added experimental support for linear/conic/radial gradients.
- Functionality moved to theme: formats, template select, toolbar, device preview, grouping with element block.
- Move important modifier
!to the end, not the beginning. - Gallery block images now have a simpler
imageclass alongside thewp-block-ska-gallery__imageclass. - Experimental: use native CSS nesting for sandboxing blocks' CSS, with a toggle in Advanced Inspector Controls.
- Primary/secondary/plain colors light and dark variants now use values derived with color-mix by default.
- Menu block now supports anchor, custom class name and attributes.
- Menu block can now render WC Layered Nav widget and active filters.
- Classes can be now moved to the parent block directly, without specifying a selector.
- Image block now has role options.
- Added Query filters for WC product categories, Sample blog posts and Sample testimonials.
- Slider block with "Controls outside" option now renders wrapper in the block editor not just front end.
- Added utility function
ska_blocks_preset($slug)which loads preset's CSS and returns its' class name.
- Permissions and capabilities management.
- Condition block now uses a whitelist for callable PHP functions.
- Fix variations not persisting for server-side registered blocks.
- Increase
editor:variant specificity. - Added "Cover" option for Image block which effectively applies
w-full h-full object-cover rounded-[inherit] aspect-[inherit]to a wrapped image. - Menu block can now render Taxonomies.
- Menu block can now render as an Accordion.
- Gallery block with lazyloading enabled can specify how many images from the start to load eagerly.
- Language switcher block uses available languages in the editor.
- Transforming Post title block to Post data block now retains the HTML heading tag.
- Updated device preview button styles to be more subtle and have a larger hitbox.
- Added "Cut selector" menu item for selectors.
- Added
editor-selectedvariant which should be used in combination witheditorvariant, e.g.hidden editor:editor-selected:block. - Try default
grid place-items-center size-6for Icon block instead ofw-6 h-auto. - Fix updating Font size arbitrary value when no line height is selected.
- Added a select for selecting a page template quickly.
- Automatically order screen variants from smallest to largest when adding them.
- Lightbox block now works with core Gallery and Image blocks.
- Added option to lazyload images in Gallery block.
- Updated available Google fonts.
- Fixed bug with wrong class names generated for variables in nested selectors.
- Code block now supports displaying a header, language label and copy button.
- Compatible core blocks now retain Tailwind attributes when transforming from one block to another.
- Added ability to wrap blocks in a Lightbox block by using a transform.
- Adding a selector now navigates to it automatically.
- Render custom class names in block label for Element and Text blocks.
- Transforming Heading block to Text block now retains the tag name.
- Added option to disable block appender for Element, Conditions, Condition, Slider, Slide and Lightbox blocks.
- Fix Post data block not rendering in template editor.
- Make front page active in the menu block in the editor.
- Featured image block can now optionally override image ID from post meta.
- Deprecated QueryOverrides in favor of QueryFilters.
- Added style caching.
- Remove ska-blocks related attributes from WC blocks HTML markup.
- Added "Placeholder" setting to "ska/text" block.
- Added generic block setting to not render the block on the front end.
- Added generic block setting to hide the block in the editor when it's not selected.
- Defer Google fonts by default with an option to not defer.
- Added option to swap Google Fonts URLs with Bunny Fonts.
- Fix warning when displaying an image with a lightbox when the media file has been deleted.