Products.MasterSelectWidget 0.4.9

概述

这是一个 Archetypes 小部件，用于控制编辑页面上其他字段的词汇或显示。需要向它提供有关控制哪些字段以及如何控制它们的信息。

要安装它，只需将其解压缩到您的产品目录中，重新启动 zope，然后使用 QuickInstaller 安装它。

用法

要使用它，只需创建一个字段，如：

StringField(
    name='master_field',
    default='',
    vocabulary=DisplayList(
        (('week', 'Week'),
          ('wedding','Wedding'),
          ('winona','Winona'),
          ('winter', 'Winter'),
          ('weather','Weather'),
          ('cow', 'Cow'),
        ),
    ),
    widget=MasterSelectWidget(
        label='Test Widget',
        description='Test this',
        slave_fields=(
            {'name': 'slave_field_name',
              'action': 'vocabulary',
              'vocab_method': 'mySlaveVocabularyMethod',
              'control_param': 'my_method_parameter',
            },
        ),
    ),
),

您可以使用与普通 SelectWidget 兼容的任何字段类型。您可以使用任何普通的 SelectWidget 参数（“格式”除外，它必须设置为“选择”）。它的外观和行为类似于普通的 SelectWidget，但此小部件的更改将影响 slave_fields 参数中描述的小部件。

参数

所有的魔法都发生在 slave_fields 参数中，它应该是一个映射序列。每个映射都是对该主字段控制的字段的描述：

姓名

选择更改时要控制的字段的名称。除非使用“词汇”或“值”操作，否则受控字段/小部件可以是任何类型。当操作为“词汇表”时，该字段必须使用 MultiSelectionWidget、SelectionWidget 或 MasterSelectWidget，其中任何一个都必须将“格式”参数设置为“选择”（这仅是 MasterSelectWidget 的默认设置）。对于“值”，小部件必须足够简单，以便使用 element.value 或 elem.selectedIndex（StringWidget、SelectionWidget、AutoCompleteWidget 等）更改当前值。

行动

要在从属字段上执行的操作类型。这可以是“词汇表”，它使用 XMLHttpRequest 调用改变从属字段的词汇表；'hide' 或 'show' 设置从属字段的可见性样式属性；“启用”或“禁用”将目标小部件标记为启用或禁用；或“值”，它使用 XMLHttpRequest 调用在选择更改时更改另一个简单小部件 (StringWidget) 的值。要使用“词汇”操作，从属字段必须满足上述小部件要求。要使用“启用”/“禁用”操作，该字段必须使用可以启用/禁用的 HTML 小部件。

词汇方法

调用以检索从属字段的动态词汇表的方法的名称，或使用“值”时从属字段的值。对于“词汇表”，这必须返回一个 DisplayList。对于'value，它必须返回一个字符串或msg_id。该方法必须接受一个参数，该参数将用于传递在主窗口小部件中选择的新值。此参数的名称默认为“master_value”，但可以使用任何名称，只要使用 control_param 元素指定即可。仅与 'action':'vocabulary' 或 'action':'value' 一起使用。当与 archetypes.schemaextender 一起使用时，词汇方法可以在模式扩展类上定义。

切换方法

当满足切换从属字段的激活或可见性的条件时调用返回 True 的方法的名称。该方法必须接受一个参数，该参数将用于传递在主窗口小部件中选择的新值。此参数的名称默认为“master_value”，但可以使用任何名称，只要使用 control_param 元素指定即可。仅与 'action':'hide'、'action':'show'、'action':'enable'、'action':'disable' 一起使用。当与 archetypes.schemaextender 一起使用时，可以在模式扩展类上定义切换方法。

控制参数

如上所述，这是调用 vocab_method 时使用的参数名称。仅与 'action':'vocabulary' 或 'action':'value' 一起使用。

隐藏值

一系列值，当在主小部件中选择时，会导致从属字段/小部件被隐藏、显示或禁用。使用的方法由“action”元素决定。仅与 'action':'hide'、'action':'enable'、'action':'disable' 或 'action':'show' 一起使用。

单个 MasterSelectWidget 可以控制任意数量的从属字段，通过向 slave_fields 列表/元组添加新映射来控制新字段。作为 MasterSelectWidget 操作目标的字段本身可以使用 MasterSelectWidget 来控制其他字段。

这个包还提供了一个 MasterMultiSelectWidget，为多选小部件提供相同的功能。

MasterSelectDemo 类型包括许多不同配置的主从小部件。

要启用演示类型，请转到 portal_setup，点击Import选项卡，选择 MasterSelectWidget 演示配置文件，然后单击底部的Import all steps按钮。

享受！

学分

作者

亚历克米切尔：apm13 @哥伦比亚。教育

贡献者

Dorneles Tremea：deo @ plonesolutions 。com

变更日志