Fyne中扩展widget.Button添加ID方法出现ExtendBaseWidget未定义错误

报错原因说明 #

触发newButton.ExtendBaseWidget undefined (type *buttonWithID has no field or method ExtendBaseWidget)报错的核心原因有三个：

• 自定义结构体未按Fyne扩展规范嵌入原生widget.Button类型，仅嵌入了widget.ListItemID（本质是用于列表项ID存储的整型别名类型），该类型本身没有任何Widget基础方法，因此编译器找不到ExtendBaseWidget方法定义。
• 原实现的构造函数虽然传入了widget.Button类型的参数，但既没有将参数赋值给自定义结构体的字段，也没有基于参数配置实例属性，属于完全无效的参数引用。
• 现有实现完全没有复用原生Button的渲染、事件交互逻辑，即便绕过编译错误，最终生成的组件也无法实现按钮的正常显示和点击功能。

标准实现流程 #

• 自定义结构体必须匿名嵌入widget.Button类型，借此复用原生按钮的全部能力，同时自动继承基础Widget提供的方法集。
• 在自定义结构体上单独新增独立的ID字段，不要错用widget.ListItemID做嵌入字段。
• 初始化实例时，先完成嵌入的原生Button的参数配置，再调用ExtendBaseWidget绑定自定义组件实例的基础能力。

可直接运行的示例代码 #

package main

import "fyne.io/fyne/v2/widget"

// ButtonWithID 带自定义ID的扩展按钮组件
type ButtonWithID struct {
	widget.Button // 匿名嵌入原生按钮，自动继承所有原生能力
	id            string // 自定义ID存储字段
}

// NewButtonWithID 构造带ID的按钮实例
// 参数分别为：按钮显示文本、点击回调、绑定的ID值
func NewButtonWithID(label string, onTapped func(), id string) *ButtonWithID {
	btn := &ButtonWithID{
		Button: *widget.NewButton(label, onTapped),
		id:     id,
	}
	// 绑定自定义组件的基础Widget能力，必须传入自身指针
	btn.ExtendBaseWidget(btn)
	return btn
}

// GetID 新增的ID获取方法
func (b *ButtonWithID) GetID() string {
	return b.id
}

// SetID 新增的ID动态修改方法
func (b *ButtonWithID) SetID(newID string) {
	b.id = newID
}

实现注意事项 #

• 调用ExtendBaseWidget时必须传入自定义组件的指针本身，不能传入内部嵌入的原生Button实例，否则会导致自定义组件的尺寸测量、事件转发逻辑失效。
• 如果需要在按钮点击时触发自定义逻辑，可直接在自定义结构体上重写Tapped()方法，无需从零实现按钮的渲染、手势响应逻辑。
• 不要将widget.ListItemID作为嵌入字段使用：该类型仅用于列表组件内部的索引标记，不具备任何可渲染的Widget能力。

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