panel element

The panel element defines a modeless panel add-in.

It is required for panels.

Attributes

The panel element has the following attributes:

id

id="unique ID" [required]

The id attribute specifies a unique string used to identify this panel. It is used internally by Expression Web.

title

title="title text" [required]

The title attribute specifies the title text of the panel as displayed in its title bar.

activate

activate="expression" [optional]

The activate attribute specifies the function or expression that will be executed whenever the type of active document matches the file list specified in the filetype attribute. Use this function to make sure that the controls on your panel are active.

deactivate

deactivate="expression" [optional]

The deactivate attribute specifies the function or expression that will be executed whenever the type of active document does not match the file list specified in the filetype attribute. Use this function to hide or disable the controls on your panel.

filetype

filetype="list of comma-separated file types" [optional]

The filetype attribute is used in conjunction with the activate and deactivate attributes to control how your panel behaves for specific file types. The following is a list of valid file types:

  • HTML   An HTML file with the file name extension .htm or .html.

  • PHP   A PHP file with the file name extension .php, .php3, or .php4.

  • ASP   An ASP or ASPX file with the file name extension .asp, .aspx, .ascx, or .asmx.

  • CSS   A cascading styles sheet (CSS) file with the file name extension .css.

  • JS    A JavaScript file with the file name extension .js.

  • HTML-DOM   An HTML, PHP, ASP, or ASPX file that contains an HTML DOM.

  • TXT   A plain text file with the file name extension .txt.

  • XML   An XML file with the file name extension .xml.

ondocumentchanged

ondocumentchanged="expression" [optional]

The ondocumentchanged attribute specifies the function that will be executed whenever the active document in Expression Web (the visible Design, Code, or Split view) is changed either by the user or by programmatic interaction.

Note

User changes to the contents of the active document are not treated as DocumentChanged events, the scope of which is limited to replacing the current active document with another active document.

The ondocumentchanged attribute is typically set to supportedDocType( doc types, function).

ondocumentsaved

ondocumentsaved="expression" [optional]

The ondocumentsaved attribute specifies the function that will be executed whenever a document is saved to disk, regardless of content changes or whether the page is saved by clicking an icon, clicking a menu item, or using a keyboard shortcut.

onelementchanged

onelementchanged="expression" [optional]

The onelementchanged attribute specifies the function that will be executed whenever an element in the active document in Expression Web (the visible Design, Code, or Split view) is selected or changed by either user or programmatic interaction.

Note

User changes to an element are not treated as ElementChanged events, the scope of which is limited to changing the current active element to another active element.

  Copyright © 2011 by Microsoft Corporation. All rights reserved.