Elementor 开发者文档

title: "Rendering Media" post_status: publish comment_status: open taxonomy: category: - elementor-developers-docs post_tag: - Widgets - Src - Repos


Rendering Media

Elementor lets you select an image using the media control defined in the \Elementor\Control_Media class. There are two ways to render media files.

Simple Image Rendering

The simplest media rendering method is to print the image URL in a custom <img> tag. You can also use the wp_get_attachment_image() function to generate the image markup.

```php {14-23,33,36,41}

start_controls_section( 'section_content', [ 'label' => esc_html__( 'Content', 'textdomain' ), 'tab' => \Elementor\Controls_Manager::TAB_CONTENT, ] ); $this->add_control( 'image', [ 'label' => esc_html__( 'Choose Image', 'textdomain' ), 'type' => \Elementor\Controls_Manager::MEDIA, 'default' => [ 'url' => \Elementor\Utils::get_placeholder_image_src(), ], ] ); $this->end_controls_section(); } protected function render(): void { $settings = $this->get_settings_for_display(); // Get image url echo ''; // Get image by id echo wp_get_attachment_image( $settings['image']['id'], 'thumbnail' ); } protected function content_template(): void { ?>
    <img src="{{{ settings.image.url }}}">
    <?php
}

}

## 高级图像渲染

处理图像的更高级方法是结合使用 `\Elementor\Control_Media` 与 `\Elementor\Group_Control_Image_Size`:

```php {14-23,25-32,40,45-60}
<?php
class Elementor_Test_Widget extends \Elementor\Widget_Base {

    protected function register_controls(): void {

        $this->start_controls_section(
            'section_content',
            [
                'label' => esc_html__( 'Content', 'textdomain' ),
                'tab' => \Elementor\Controls_Manager::TAB_CONTENT,
            ]
        );

        $this->add_control(
            'image',
            [
                'label' => esc_html__( 'Choose Image', 'textdomain' ),
                'type' => \Elementor\Controls_Manager::MEDIA,
                'default' => [
                    'url' => \Elementor\Utils::get_placeholder_image_src(),
                ],
            ]
        );

        $this->add_group_control(
            \Elementor\Group_Control_Image_Size::get_type(),
            [
                'name' => 'image',
                'default' => 'large',
            ]
        );

        $this->end_controls_section();

    }

    protected function render(): void {
        $settings = $this->get_settings_for_display();
        echo \Elementor\Group_Control_Image_Size::get_attachment_image_html( $settings );
    }

    protected function content_template(): void {
        ?>
        <#
        const image = {
            id: settings.image.id,
            url: settings.image.url,
            size: settings.image_size,
            dimension: settings.image_custom_dimension,
            model: view.getEditModel()
        };

        const image_url = elementor.imagesManager.getImageUrl( image );

        if ( '' === image_url ) {
            return;
        }
        #>
        <img src="{{{ image_url }}}">
        <?php
    }

}