用途:为 Elementor 小工具的编辑器面板添加控件、创建自定义控件,并作为控件类型参数的速查参考。控件是面板中供用户配置小工具的字段,必须放在 section 内。
主要能力:通过 add_control('id', [...]) 添加控件,用 start_controls_section / end_controls_section 划分区块,支持内容与样式等选项卡。控件涵盖文本类(TEXT、TEXTAREA、WYSIWYG、CODE、NUMBER、HIDDEN)、选择类(SELECT、SELECT2、CHOOSE、VISUAL_CHOICE、SWITCHER)、单位尺寸类(SLIDER、DIMENSIONS、IMAGE_DIMENSIONS)、媒体资源类(COLOR、MEDIA、GALLERY、ICONS、URL、DATE_TIME)、REPEATER 与 POPOVER_TOGGLE;另有不存储数据的 UI 控件(HEADING、DIVIDER、ALERT、NOTICE、RAW_HTML、BUTTON、DEPRECATED_NOTICE)。分组控件通过 add_group_control 使用 Typography、Background、Border、Box Shadow、Text Shadow、Text Stroke、CSS Filter、Image Size 等。
使用方式:用 add_responsive_control 生成各设备控件;用 condition / conditions 控制显示;用 selectors 与 {{WRAPPER}}、{{VALUE}}、{{SIZE}}{{UNIT}}、{{URL}} 等占位符绑定 CSS;用 dynamic 启用动态标签,用 frontend_available 在前端 JavaScript 中通过 getElementSettings 访问。可用 global 参数继承全局颜色与排版。
限制与注意:控件必须置于 section 内,section 不可嵌套;非分组控件用复数 selectors,分组控件用单数 selector;SLIDER、DIMENSIONS、URL/MEDIA 不可直接用 {{VALUE}};selectors_dictionary 仅适用于返回字符串的控件;Repeater 内层字段不能依赖外层控件;SWITCHER 默认值应为 'yes' 或空字符串。资料未提供安装方式、收费与价格信息。