最后同步日期：2026-04-15 | Godot 官方原文 — LinkButton

LinkButton

节点继承关系

继承链：Node → CanvasItem → Control → BaseButton → LinkButton

定义

看起来像网页上的超链接——蓝色的、带下划线的文字，点一下就触发动作。就像你在浏览器里看到的那些可以点击的蓝色文字链接。

使用频率：★ 基本用不到（特定场景使用）

节点用途

• 在游戏中打开外部链接（官网、论坛）
• 显示可点击的文本提示

使用场景

• "关于"页面中的官网链接
• 游戏内帮助文档的超链接

常用节点搭配

• 搭配 VBoxContainer 排列多个链接
• 搭配 RichTextLabel 的 [url] 标签实现行内超链接

生效必备素材/资源

无需特殊资源。

节点属性与信号

自有属性

属性	类型	默认值	继承自	说明
text	string	""	—	链接文字
uri	string	""	—	点击后打开的网址（可选）
underline	枚举	OnHover	—	下划线模式：Always（总是显示）、OnHover（悬停时显示）、Never（不显示）

继承自 BaseButton

属性	类型	默认值	继承自	说明
disabled	bool	false	BaseButton	是否禁用

信号

信号	触发时机	参数
pressed	链接被点击时	无

常用方法

继承自 BaseButton 的所有方法。

代码示例

C

using Godot;

public partial class LinkButtonDemo : Control
{
    public override void _Ready()
    {
        var link = new LinkButton();
        link.Text = "访问官方网站";
        link.Uri = "https://godotengine.org";
        link.Underline = LinkButton.UnderlineModeEnum.Always;
        link.Position = new Vector2(100, 100);

        link.Pressed += () =>
        {
            GD.Print($"打开链接: {link.Uri}");
            OS.ShellOpen(link.Uri);
        };

        AddChild(link);
    }
}

GDScript

extends Control

func _ready():
    var link = LinkButton.new()
    link.text = "访问官方网站"
    link.uri = "https://godotengine.org"
    link.underline = LinkButton.UnderlineMode.UNDERLINE_ALWAYS
    link.position = Vector2(100, 100)

    link.pressed.connect(func():
        print("打开链接: " + link.uri)
        OS.shell_open(str(link.uri))
    )

    add_child(link)