Accessing External Resources
Widgets can open applications and web pages outside of their bundle. If your widget provides a subset of information found on the Internet, a link to the full data set that opens in Safari is appropriate. If your widget interfaces with an application, for example, iTunes, it should open it first. Dashboard can do this all for you.
Sometimes you may want your widget to open a webpage when certain information is clicked. For instance, clicking a stock symbol in a stock ticker widget would probably load a webpage in the default browser displaying information relevant to the stock.
To open a webpage, use the
widget.openURL(url) method. For example, you may use it inside of a function to dynamically assemble a URL using the contents of a variable you set elsewhere in your code:
Listing 7 Assembling a URL and passing it to
widget.openURL('http://www.apple.com/' + section);
In Listing 7, an arbitrary function is called when a user clicks within some text. A portion of a URL is passed to the
clicked function and then appended onto another string, which is then passed to the
openURL method. It then opens the user's default browser with the provided URL.
Alternatively, you can embed the method in any
In addition to being able to open a webpage, your widget can open applications. Calling
widget.openApplication() dismisses Dashboard and either opens the specified application or, if it was already open, brings it to the forefront.
The parameter passed into this method is the bundle ID for an application. For instance, to open iTunes, you pass in the string
Note that there is no facility for passing arguments to an application. For this level of interactivity between a widget and application, you could try one of these options:
© 2010 Apple Inc. All Rights Reserved. (Last updated: 2010-02-01)