asfunction (TextEvent.LINK) Tutorial for AS3 | Flash HTML Link to call actionscript function | Tutorial


Earlier I wrote a tutorial article about asfunction in as2. Now that I’ m into as3, surprise surprise asfunction has been depreciated and now to replace it is the LINK TextEvent. Dispatched when a user clicks a hyperlink in an HTML-enabled text field, where the URL begins with “event:”. The remainder of the URL after “event:” will be placed in the text property of the LINK event.
This differs from the asfunction method in that we must add an event listener (addEventListener) to the textField object, the event listener specifies which function will be called in the event of a link click and there is no way to send arguments along with the event (AFAIK). But it’s easy enought to use one link event function for all your link events and put in a simple switch statement to coordinate the desired results…


  1. Use event in the href attribute. (href=”event:eventText”)
  2. Listen to the textField (theTextField.addEventListener(TextEvent.LINK, linkHandler);)
  3. Handle the link event (function linkHandler(linkEvent:TextEvent):void {…)


[kml_flashembed fversion=”9.0.0″ movie=”” publishmethod=”dynamic” width=”550″ height=”400″]

Get Adobe Flash player



[cc lang=”actionscript”]
var myHTMLText:String = “Sample text in an html enabled text box.\n”+
“Here’s a normal link to circlecube putting the link into the href attribute like normal!\n”+
Click this circlecube, to see the text event link in action! \n”+
“And some more links that don’t go anywhere, but they do call functions in actionscript. “+
“Click this to move UP, click me move back “+
“Also, one last example click for a trace test“;

//create and initialize css
var myCSS:StyleSheet = new StyleSheet();
myCSS.setStyle(“a:link”, {color:’#0000CC’,textDecoration:’none’});
myCSS.setStyle(“a:hover”, {color:’#0000FF’,textDecoration:’underline’});
myHTML.styleSheet = myCSS;
myHTML.htmlText = myHTMLText;

myHTML.addEventListener(TextEvent.LINK, linkHandler);

function linkHandler(linkEvent:TextEvent):void {
switch (linkEvent.text) {
case “clickLink”:
case “moveUp”:
case “moveDown”:
//function to be called from html text
function clickLink():void {
giveFeedback(“Hyperlink clicked!”);
var myURL:String = “”;
var myRequest:URLRequest = new URLRequest(myURL);
try {
catch (e:Error) {
// handle error here

//another function to be called from html text, recieves one argument
function moveUp():void {
feedback.y -= 10;

//a simple trick to allow passing of multiple arguments
function moveDown():void {
feedback.y += 10;

function giveFeedback(str):void {
feedback.appendText(str +”\n”);
feedback.scrollV = feedback.maxScrollV;


Download the fla here: textlinkevent_as3.fla

5 thoughts on “asfunction (TextEvent.LINK) Tutorial for AS3 | Flash HTML Link to call actionscript function | Tutorial

  1. Great article, I’ve been stressing over this for hours. Is there a way you can trigger a Mouse event through the TextEvent action like you do with the ones shown?

    I’m trying to get a similar example to navigate within the flash timeline and control actions in my movie but I can’t get it to work without errors…

    function myMouseEvent(event:MouseEvent = null) {
    trace(this.parent+”Action Sent”);

    I get this error and can’t work out why?

    Any help would be gratefully received as I have just about tried everything,

    Thanks in advance if possible,


Comments are closed.