Source note:This page rendered plugin-owned docs or generated metadata inside unified Astro docs shell.
Summary
As of this update, PlaceableView no longer has a custom content_padding property. Instead, it uses Godot's standard PanelContainer theme system for inner margins.
Migration Steps
Option 1: Theme Override in Scene (Recommended)
Add theme constant overrides directly to PlaceableView instances in your scene files:
[node name="PlaceableView" type="PanelContainer"]
theme_override_constants/margin_left = 4
theme_override_constants/margin_right = 4
theme_override_constants/margin_top = 4
theme_override_constants/margin_bottom = 4
Option 2: Global Theme Resource
Create or modify a Theme resource and set PanelContainer margins:
- Create a new Theme resource or open your existing one
- Navigate to: PanelContainer > Theme Constants
- Set the following properties:
margin_left: 4margin_right: 4margin_top: 4margin_bottom: 4
- Apply the theme to your UI root or individual controls
Option 3: Runtime Override
Set margins programmatically in your scripts:
func _ready():
var placeable_view = $PlaceableView
placeable_view.add_theme_constant_override("margin_left", 4)
placeable_view.add_theme_constant_override("margin_right", 4)
placeable_view.add_theme_constant_override("margin_top", 4)
placeable_view.add_theme_constant_override("margin_bottom", 4)
Why This Change?
- Follows Godot Best Practices: Uses built-in PanelContainer functionality instead of custom properties
- Better Integration: Works with Godot's theme system and style inheritance
- Simpler Code: Reduces custom code maintenance and complexity
- More Flexible: Can be configured per-instance, per-theme, or globally
Default Template
The plugin's PlaceableView template scene (placeable_view.tscn) has been updated with 4px margins on all sides as the default.
Affected Files
godot/addons/grid_placement/ui/placeable/single/placeable_view.gd- Removed custom padding property and methodgodot/templates/grid_placement_templates/ui/placement_selection/placeable_view.tscn- Updated with theme margin overrides
Source
docs/v5-0/guides/placeable-view-padding-migration.md
Plugin docs root:gdscript/plugins/grid_placement_dev/docs