画像フォーム要素を追加/編集フォームに追加する

管理者リストとフォームのUIコンポーネントを使用してMagento 2のCRUDモジュールを構築しており、エンティティの1つに画像フィールドがあります。
しかし、私はそれを正常に機能させることはできません。
動作方法は次のとおりです。
アップロードされた画像のない追加モードまたは編集モードでは、単純なファイル入力のように見えるはずです。

ファイルがアップロードされると、画像プレビューとその下の削除ボックスが表示されます。

まさにこのデザインを探しているわけではありません。見た目は異なりますが、機能は同じです。

Magento 1では、独自のブロックレンダラーを作成するだけでこれを行うことができました

class {{Namespace}}_{{Module}}_Block_Adminhtml_{{Entity}}_Helper_Image extends Varien_Data_Form_Element_Image
{
    protected function _getUrl()
    {
        $url = false;
        if ($this->getValue()) {
            $url = Mage::helper('{{namespace}}_{{module}}/{{entity}}_image')->getImageBaseUrl().$this->getValue();
        }
        return $url;
    }
}

これをフォームブロックに追加します

    $fieldset->addType(
        'image',
        Mage::getConfig()->getBlockClassName('{{namespace}}_{{module}}/adminhtml_{{entity}}_helper_image')
    );

しかし、Magento 2
にはフォームブロックがありません。UIコンポーネントファイルのフォームフィールドにクラス名を使用できることは知っています。

    <field name="image" class="Class\Name\Here">
        <argument name="data" xsi:type="array">
            <item name="config" xsi:type="array">
                <item name="dataType" xsi:type="string">text</item>
                <item name="label" xsi:type="string" translate="true">Resume</item>
                <item name="formElement" xsi:type="string">image</item>
                <item name="source" xsi:type="string">[entity]</item>
                <item name="dataScope" xsi:type="string">image</item>
            </item>
        </argument>
    </field>

明らかにこのクラスを作成する必要がありますが、何を拡張する必要がありますか？
私が知っているのは、インターフェイスを実装する必要Magento\Framework\View\Element\UiComponentInterfaceがあるということだけですが、拡張できるものは何も見つかりませんでした。
したがって、私の本当の質問は、目的の動作を達成するためにクラスを拡張できますか？そうでない場合、この要素レンダラーの作成を開始するにはどうすればよいですか？

フィールドにアタッチされたクラスを必要とせずにそれを行う方法を見つけました。つまり、フォーム要素にはクラスがアタッチされていますが、レンダラーとしてはアタッチされていません。
列は次のように定義する必要があります。

<field name="image">
    <argument name="data" xsi:type="array">
        <item name="config" xsi:type="array">
            <item name="dataType" xsi:type="string">string</item>
            <item name="source" xsi:type="string">[entity]</item>
            <item name="label" xsi:type="string" translate="true">Image</item>
            <item name="visible" xsi:type="boolean">true</item>
            <item name="formElement" xsi:type="string">fileUploader</item>
            <item name="elementTmpl" xsi:type="string">ui/form/element/uploader/uploader</item>
            <item name="previewTmpl" xsi:type="string">[Namespace]_[Module]/image-preview</item>
            <item name="required" xsi:type="boolean">false</item>
            <item name="uploaderConfig" xsi:type="array">
                <item name="url" xsi:type="url" path="[namespace_module]/[entity]_image/upload"/>
            </item>
        </item>
    </argument>
</field>

また、で参照されるプレビューテンプレートファイルを作成する必要がありました[Namespace]_[Module]/image-preview。
これはapp/code/[Namespace]/[Module]/view/adminhtml/web/template/image-preview.html次のようになります。

<div class="file-uploader-summary">
    <div class="file-uploader-preview">
        <a attr="href: $parent.getFilePreview($file)" target="_blank">
            <img
                class="preview-image"
                tabindex="0"
                event="load: $parent.onPreviewLoad.bind($parent)"
                attr="
                    src: $parent.getFilePreview($file),
                    alt: $file.name">
        </a>

        <div class="actions">
            <button
                type="button"
                class="action-remove"
                data-role="delete-button"
                attr="title: $t('Delete image')"
                click="$parent.removeFile.bind($parent, $file)">
                <span translate="'Delete image'"/>
            </button>
        </div>
    </div>

    <div class="file-uploader-filename" text="$file.name"/>
    <div class="file-uploader-meta">
        <text args="$file.previewWidth"/>x<text args="$file.previewHeight"/>
    </div>
</div>

このコードは、次のようなフィールドを生成します。

画像を（リアルタイムで）アップロードすると、次のようになります。

url 内部のアイテムuploaderConfigは、アップロード時に画像が投稿されるURLです。だから私もこれを作成する必要がありました：

namespace [Namespace]\[Module]\Controller\Adminhtml\[Entity]\Image;

use Magento\Framework\Controller\ResultFactory;

/**
 * Class Upload
 */
class Upload extends \Magento\Backend\App\Action
{
    /**
     * Image uploader
     *
     * @var \[Namespace]\[Module]\Model\ImageUploader
     */
    protected $imageUploader;

    /**
     * @param \Magento\Backend\App\Action\Context $context
     * @param \[Namespace]\[Module]\Model\ImageUploader $imageUploader
     */
    public function __construct(
        \Magento\Backend\App\Action\Context $context,
        \[Namespace]\[Module]\Model\ImageUploader $imageUploader
    ) {
        parent::__construct($context);
        $this->imageUploader = $imageUploader;
    }

    /**
     * Check admin permissions for this controller
     *
     * @return boolean
     */
    protected function _isAllowed()
    {
        return $this->_authorization->isAllowed('[Namespace]_[Module]::[entity]');
    }

    /**
     * Upload file controller action
     *
     * @return \Magento\Framework\Controller\ResultInterface
     */
    public function execute()
    {
        try {
            $result = $this->imageUploader->saveFileToTmpDir('image');

            $result['cookie'] = [
                'name' => $this->_getSession()->getName(),
                'value' => $this->_getSession()->getSessionId(),
                'lifetime' => $this->_getSession()->getCookieLifetime(),
                'path' => $this->_getSession()->getCookiePath(),
                'domain' => $this->_getSession()->getCookieDomain(),
            ];
        } catch (\Exception $e) {
            $result = ['error' => $e->getMessage(), 'errorcode' => $e->getCode()];
        }
        return $this->resultFactory->create(ResultFactory::TYPE_JSON)->setData($result);
    }
}

このクラス[Namespace]\[Module]\Model\ImageUploaderはに似たインスタンスを使用します\Magento\Catalog\Model\ImageUploader。

これでうまくいく。私はまだデータベースに画像を保存するのに苦労していますが、それは全く異なる問題です。カテゴリエンティティのフィールドを
インスピレーションとして使用しimageました

はい、拡張する必要があるクラスは\Magento\Ui\Component\Form\Element\AbstractElementです。

このクラスは、ElementInterfaceそれ自体がUiComponentInterface参照しているものを拡張します。

さらに、宣言されたコンポーネントをチェックするMagento\Ui\Component\Form\Elementと、すべてがそのクラスを拡張していることがわかります。

このクラスを選択する理由は、renderメソッドが\Magento\Backend\Block\Widget\Form\Renderer\Elementそのようなクラスタイプのみを受け入れるためです。（これは実際にMagento\Framework\Data\Form\Element\AbstractElementは受け入れられるインスタンスであり、ではありません\Magento\Ui\Component\Form\Element\AbstractElement）