Google Add-on卡片动态添加Widget时OnChangeAction默认值重置及选值持久化问题

问题1：选择器触发OnChangeAction后重置为默认选项 #

• 核心原因是Gmail插件的卡片是无状态的，每次触发交互后都会全量重建卡片，未回填用户选择的状态就会回到默认值
• 解决方法：
  1. 定义交互Action时，通过setParameters()方法将当前页面所有用户已输入/选择的状态作为参数传递给处理函数
  2. 处理函数拿到参数后，合并本次交互产生的新状态，再传入卡片构建方法
  3. 构建选择器组件时，通过setSelectedItem()方法将对应状态回填到组件中
     示例代码：

  // 卡片构建函数，接收状态参数
  function buildCard(userState = {}) {
    const currentSelectVal = userState.userSelect || "default_opt";
    const select = CardService.newSelectionInput()
      .setType(CardService.SelectionInputType.DROPDOWN)
      .setFieldName("userSelect")
      .setTitle("选择选项")
      // 回填已选值
      .setSelectedItem(currentSelectVal)
      .setOnChangeAction(CardService.newAction()
        .setFunctionName("onSelectChange")
        // 传递当前所有状态到处理函数
        .setParameters(userState)
      );
    // 其他组件构建逻辑...
    return CardService.newCardBuilder().addSection(CardService.newCardSection().addWidget(select)).build();
  }
  
  // 选择器变更处理函数
  function onSelectChange(e) {
    // 合并原有状态和新的选择值
    const newState = {...e.parameters, userSelect: e.formInput.userSelect};
    // 用新状态重建卡片
    return CardService.newActionResponseBuilder().setNavigation(CardService.newNavigation().updateCard(buildCard(newState))).build();
  }
  

问题2：初始化加载时触发默认选中项的OnChangeAction同步值到UI #

• 不需要依赖组件的事件触发，直接在卡片初始化构建逻辑中主动处理即可
• 解决方法：
  1. 先定义好选择器的默认选中值
  2. 在构建卡片前，先执行该默认值对应的OnChangeAction逻辑，生成需要同步展示的关联组件/数值
  3. 将默认值和生成的关联内容一起整合到卡片配置中，初始化渲染时就可以直接展示对应的同步结果
     示例逻辑：

  // 初始化卡片入口函数
  function onHomepage() {
    // 定义默认选中值
    const defaultState = {userSelect: "default_opt"};
    // 直接传入默认状态构建卡片，对应默认值的关联逻辑会在buildCard里直接处理
    return buildCard(defaultState);
  }
  

以上两个需求均可以通过上述状态全量传递+回填的方案实现，是开发复杂Gmail插件UI的通用处理方式。

内容的提问来源于stack exchange，提问作者discoStew