odoo-addon-fs-image 17.0.1.0.1.2

用法

这种新的字段类型可以像Odoo的‘图片’字段类型一样使用。

from odoo import models
from odoo.addons.fs_image.fields import FSImage

class MyModel(models.Model):
    _name = 'my.model'

    image = FSImage('Image', max_width=1920, max_height=1920)

<record id="my_model_form" model="ir.ui.view">
    <field name="name">my.model.form</field>
    <field name="model">my.model</field>
    <field name="arch" type="xml">
        <form>
            <sheet>
                <group>
                    <field name="image" class="oe_avatar"/>
                </group>
            </sheet>
        </form>
    </field>
</record>

在上述示例中，如果图片大小超过1920x1920px，将会被调整到这个大小。表单视图中所使用的组件也会允许用户为图片设置‘alt’文本。

以下是一个高级且实用的示例：

from odoo import models
from odoo.addons.fs_image.fields import FSImage

class MyModel(models.Model):
    _name = 'my.model'

    image_1920 = FSImage('Image', max_width=1920, max_height=1920)
    image_128 = FSImage('Image', max_width=128, max_height=128, related='image_1920', store=True)

<record id="my_model_form" model="ir.ui.view">
    <field name="name">my.model.form</field>
    <field name="model">my.model</field>
    <field name="arch" type="xml">
        <form>
            <sheet>
                <group>
                    <field
                        name="image_1920"
                        class="oe_avatar"
                         options="{'preview_image': 'image_128', 'zoom': true}"
                     />
                </group>
            </sheet>
        </form>
    </field>
</record>

在上述示例中，我们有两个字段，一个用于原始图片，另一个用于缩略图。由于缩略图被定义为相关存储字段，它会自动从原始图片生成，调整到指定大小并在数据库中存储。缩略图随后被用作表单视图中原图片的预览图。这种方法的优点是原始图片不会在表单视图中加载，而是使用缩略图，其大小更小，加载更快。‘缩放’选项允许用户在点击缩略图时在弹出窗口中查看原始图片。

为了方便，‘fs_image’模块还提供了一个名为‘FSImageMixin’的混合类，可以将其用于向模型添加‘image’和‘image_medium’字段。它只将中等缩略图定义为128x128px的图片，因为它是最常见的使用案例。在使用模型中的图片字段时，建议使用此混合类以确保始终定义‘image_medium’字段。一个好的做法是将image_medium字段用作表单视图中图片字段的预览图，以避免在表单视图中加载大图片并消耗过多带宽。

from odoo import models

class MyModel(models.Model):
    _name = 'my.model'
    _inherit = ['fs_image.mixin']

<record id="my_model_form" model="ir.ui.view">
    <field name="name">my.model.form</field>
    <field name="model">my.model</field>
    <field name="arch" type="xml">
        <form>
            <sheet>
                <group>
                    <field
                        name="image"
                        class="oe_avatar"
                        options="{'preview_image': 'image_medium', 'zoom': true}"
                    />
                </group>
            </sheet>
        </form>
    </field>
</record>

变更日志

问题跟踪器

错误在GitHub Issues上追踪。如果遇到问题，请检查是否已报告您的问题。如果您首先发现，请提供详细且受欢迎的反馈以帮助我们解决问题。

请不要直接联系贡献者以获取支持或帮助解决技术问题。

致谢

维护者

此模块由OCA维护。

OCA，即Odoo社区协会，是一个非营利组织，其使命是支持Odoo功能的协作开发并推广其广泛应用。

当前维护者

此模块是GitHub上OCA/storage项目的一部分。

欢迎您贡献。要了解如何贡献，请访问https://odoo-community.org/page/Contribute。