WYSIWYG 控件
Elementor WYSIWYG 控件显示一个基于 TinyMCE 库的 WordPress 富文本编辑器。
该控件在继承 Base_Data_Control 类的 Control_Wysiwyg 类中定义。
使用此控件时,type 应设置为 \Elementor\Controls_Manager::WYSIWYG 常量。
参数
| 名称 | 类型 | 默认值 | 描述 |
|---|---|---|---|
type |
string |
wysiwyg | 控件的类型。 |
label |
string |
显示在字段上方的标签。 | |
description |
string |
显示在字段下方的描述。 | |
show_label |
bool |
true | 是否显示标签。 |
label_block |
bool |
true | 是否在单独一行显示标签。 |
separator |
string |
default | 设置控件分隔符的位置。可用值为 default、before 和 after。default 将隐藏分隔符,除非控件类型有特定的分隔符设置。before / after 会将分隔符定位在控件之前/之后。 |
default |
string |
字段的默认值。 |
Return Value
(string) The WYSIWYG field value.
Usage
<?php
class Elementor_Test_Widget extends \Elementor\Widget_Base {
protected function register_controls(): void {
$this->start_controls_section(
'content_section',
[
'label' => esc_html__( 'Content', 'textdomain' ),
'tab' => \Elementor\Controls_Manager::TAB_CONTENT,
]
);
$this->add_control(
'item_description',
[
'label' => esc_html__( 'Description', 'textdomain' ),
'type' => \Elementor\Controls_Manager::WYSIWYG,
'default' => esc_html__( 'Default description', 'textdomain' ),
'placeholder' => esc_html__( 'Type your description here', 'textdomain' ),
]
);
$this->end_controls_section();
}
protected function render(): void {
$settings = $this->get_settings_for_display();
if ( empty( $settings['item_description'] ) ) {
return;
}
?>
<div class="description">
<?php echo $settings['item_description']; ?>
</div>
<?php
}
protected function content_template(): void {
?>
<#
if ( '' === settings.item_description ) {
return;
}
#>
<div class="description">
{{{ settings.item_description }}}
</div>
<?php
}
}
这篇文档对你有帮助吗?
谢谢你的反馈!