home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
CyberMycha Extra 2002 March
/
CMYCHA200203_EXTRA_broken.iso
/
Przegladarki
/
NetscapeSetupB.exe
/
bin
/
chrome
/
help.jar
/
content
/
help
/
help.js
< prev
next >
Wrap
Text File
|
2002-06-23
|
15KB
|
460 lines
/* -*- Mode: Java; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
* The contents of this file are subject to the Netscape Public
* License Version 1.1 (the "License"); you may not use this file
* except in compliance with the License. You may obtain a copy of
* the License at http://www.mozilla.org/NPL/
*
* Software distributed under the License is distributed on an "AS
* IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
* implied. See the License for the specific language governing
* rights and limitations under the License.
*
* The Original Code is Mozilla Communicator client code, released
* March 31, 1998.
*
* The Initial Developer of the Original Code is Netscape
* Communications Corporation. Portions created by Netscape are
* Copyright (C) 1998-1999 Netscape Communications Corporation. All
* Rights Reserved.
* Contributor(s):
* Original author: oeschger@netscape.com
* amended by: Peter Wilson (added sidebar tabs) */
//-------- global variables
var helpBrowser;
var helpWindow;
var helpSearchPanel;
var emptySearch;
var emptySearchText
var emptySearchLink
var helpTocPanel;
var helpIndexPanel;
var helpGlossaryPanel;
// Namespaces
const NC = "http://home.netscape.com/NC-rdf#";
const SN = "rdf:http://www.w3.org/1999/02/22-rdf-syntax-ns#";
const XML = "http://www.w3.org/XML/1998/namespace#"
const MAX_LEVEL = 40; // maximum depth of recursion in search datasources.
// Resources
var RDF = Components.classes["@mozilla.org/rdf/rdf-service;1"].getService(Components.interfaces.nsIRDFService);
var RDF_ROOT = RDF.GetResource("urn:root");
var NC_PANELLIST = RDF.GetResource(NC + "panellist");
var NC_PANELID = RDF.GetResource(NC + "panelid");
var NC_EMPTY_SEARCH_TEXT = RDF.GetResource(NC + "emptysearchtext");
var NC_EMPTY_SEARCH_LINK = RDF.GetResource(NC + "emptysearchlink");
var NC_DATASOURCES = RDF.GetResource(NC + "datasources");
var NC_SUBHEADINGS = RDF.GetResource(NC + "subheadings");
var NC_NAME = RDF.GetResource(NC + "name");
var NC_CHILD = RDF.GetResource(NC + "child");
var NC_LINK = RDF.GetResource(NC + "link");
var NC_TITLE = RDF.GetResource(NC + "title");
var NC_BASE = RDF.GetResource(NC + "base");
var NC_DEFAULTTOPIC = RDF.GetResource(NC + "defaulttopic");
var RDFCUtils = Components.classes["@mozilla.org/rdf/container-utils;1"].getService().
QueryInterface(Components.interfaces.nsIRDFContainerUtils);
var RDFContainer = Components.classes["@mozilla.org/rdf/container;1"].getService(Components.interfaces.nsIRDFContainer);
var CONSOLE_SERVICE = Components.classes['@mozilla.org/consoleservice;1'].getService(Components.interfaces.nsIConsoleService);
var urnID = 0;
var RE;
var helpFileURI;
var helpFileDS;
// Set from nc:base attribute on help rdf file. It may be used for prefix reduction on all links within
// the current help set.
var helpBaseURI;
const defaultHelpFile = "chrome://help/locale/mozillahelp.rdf";
// Set from nc:defaulttopic. It is used when the requested uri has no topic specified.
var defaultTopic = "welcome";
var searchDatasources = "rdf:null";
var searchDS = null;
const NSRESULT_RDF_SYNTAX_ERROR = 0x804e03f7;
// This function is called by dialogs/windows that want to display context-sensitive help
// These dialogs/windows should include the script chrome://help/content/contextHelp.js
function displayTopic(topic) {
if (!topic)
topic = defaultTopic;
var uri = getLink(topic);
if (!uri) // Topic not found - revert to default.
uri = getLink(defaultTopic);
loadURI(uri);
}
// Initialize the Help window
function init() {
//cache panel references.
helpWindow = document.getElementById("help");
helpSearchPanel = document.getElementById("help-search-panel");
helpTocPanel = document.getElementById("help-toc-tree");
helpIndexPanel = document.getElementById("help-index-tree");
helpGlossaryPanel = document.getElementById("help-glossary-tree");
helpBrowser = document.getElementById("help-content");
var URI = normalizeURI(decodeURIComponent(window.location.search));
helpFileURI = URI.helpFileURI;
var helpTopic = URI.topic;
helpBaseURI = helpFileURI.substring(0, helpFileURI.lastIndexOf("/")+1); // trailing "/" included.
loadHelpRDF();
displayTopic(helpTopic);
// move to right end of screen
var width = document.documentElement.getAttribute("width");
var height = document.documentElement.getAttribute("height");
window.moveTo(screen.availWidth-width, (screen.availHeight-height)/2);
var sessionHistory = Components.classes["@mozilla.org/browser/shistory;1"]
.createInstance(Components.interfaces.nsISHistory);
getWebNavigation().sessionHistory = sessionHistory;
window.XULBrowserWindow = new nsHelpStatusHandler();
// hook up UI through progress listener
var interfaceRequestor = helpBrowser.docShell.QueryInterface(Components.interfaces.nsIInterfaceRequestor);
var webProgress = interfaceRequestor.getInterface(Components.interfaces.nsIWebProgress);
webProgress.addProgressListener(window.XULBrowserWindow, Components.interfaces.nsIWebProgress.NOTIFY_ALL);
}
function normalizeURI(uri) {
// uri in format [uri of help rdf file][?initial topic]
// if the whole uri or help file uri is omitted then the default help is assumed.
// unpack uri
var URI = {};
URI.helpFileURI = defaultHelpFile;
URI.topic = null;
// Case: No help uri at all.
if (uri) {
// remove leading ?
if (uri.substr(0,1) == "?")
uri = uri.substr(1);
var i = uri.indexOf("?");
// Case: Full uri with topic.
if ( i != -1) {
URI.helpFileURI = uri.substr(0,i);
URI.topic = uri.substr(i+1);
}
else {
// Case: uri with no topic.
if (uri.substr(0,7) == "chrome:")
URI.helpFileURI = uri;
else {
// Case: uri with topic only.
URI.topic = uri;
}
}
}
URI.uri = URI.helpFileURI + ((URI.topic)? "?" + URI.topic : "");
return URI;
}
function loadHelpRDF() {
if (!helpFileDS) {
try {
helpFileDS = RDF.GetDataSourceBlocking(helpFileURI);
}
catch (e if (e.result == NSRESULT_RDF_SYNTAX_ERROR)) {
log("Help file: " + helpFileURI + " contains a syntax error.");
}
catch (e) {
log("Help file: " + helpFileURI + " was not found.");
}
try {
helpWindow.setAttribute("title", getAttribute(helpFileDS, RDF_ROOT, NC_TITLE, ""));
helpBaseURI = getAttribute(helpFileDS, RDF_ROOT, NC_BASE, helpBaseURI);
defaultTopic = getAttribute(helpFileDS, RDF_ROOT, NC_DEFAULTTOPIC, "welcome");
var panelDefs = helpFileDS.GetTarget(RDF_ROOT, NC_PANELLIST, true);
RDFContainer.Init(helpFileDS, panelDefs);
var iterator = RDFContainer.GetElements();
while (iterator.hasMoreElements()) {
var panelDef = iterator.getNext();
var panelID = getAttribute(helpFileDS, panelDef, NC_PANELID, null);
var datasources = getAttribute(helpFileDS, panelDef, NC_DATASOURCES, "rdf:none");
datasources = normalizeLinks(helpBaseURI, datasources);
// cache additional datsources to augment search datasources.
if (panelID == "search") {
emptySearchText = getAttribute(helpFileDS, panelDef, NC_EMPTY_SEARCH_TEXT, null) || "No search items found." ;
emptySearchLink = getAttribute(helpFileDS, panelDef, NC_EMPTY_SEARCH_LINK, null) || "about:blank";
searchDatasources = datasources;
datasources = "rdf:null"; // but don't try to display them yet!
}
// cache toc datasources for use by ID lookup.
var tree = document.getElementById("help-" + panelID + "-tree");
tree.setAttribute("datasources", datasources);
//if (panelID == "toc") {
if (tree.database) {
loadDatabases(tree.database, datasources);
tree.builder.rebuild();
}
//}
}
}
catch (e) {
log(e + "");
}
}
}
function loadDatabases(compositeDatabase, datasources) {
var ds = datasources.split(/\s+/);
for (var i=0; i < ds.length; ++i) {
if (ds[i] == "rdf:null" || ds[i] == "")
continue;
try {
// we need blocking here to ensure the database is loaded so getLink(topic) works.
var datasource = RDF.GetDataSourceBlocking(ds[i]);
if (datasource)
compositeDatabase.AddDataSource(datasource);
}
catch (e) {
log("Datasource: " + ds[i] + " was not found.");
}
}
}
// prepend helpBaseURI to list of space separated links if the don't start with "chrome:"
function normalizeLinks(helpBaseURI, links) {
if (!helpBaseURI)
return links;
var ls = links.split(/\s+/);
if (ls.length == 0)
return links;
for (var i=0; i < ls.length; ++i) {
if (ls[i] == "")
continue;
if (ls[i].substr(0,7) != "chrome:" && ls[i].substr(0,4) != "rdf:")
ls[i] = helpBaseURI + ls[i];
}
return ls.join(" ");
}
function getLink(ID) {
if (!ID)
return null;
// Note resources are stored in fileURL#ID format.
// We have one possible source for an ID for each datasource in the composite datasource.
// The first ID which matches is returned.
var tocTree = document.getElementById("help-toc-tree");
tocDS = tocTree.database;
if (tocDS == null)
return null;
var tocDatasources = tocTree.getAttribute("datasources");
var ds = tocDatasources.split(/\s+/);
for (var i=0; i < ds.length; ++i) {
if (ds[i] == "rdf:null" || ds[i] == "")
continue;
try {
var rdfID = ds[i] + "#" + ID;
var resource = RDF.GetResource(rdfID);
if (resource) {
var link = tocDS.GetTarget(resource, NC_LINK, true);
if (link) {
link = link.QueryInterface(Components.interfaces.nsIRDFLiteral);
if (link)
return link.Value;
else
return null;
}
}
}
catch (e) { log(rdfID + " " + e);}
}
return null;
}
// Called by contextHelp.js to determine if this window is displaying the requested help file.
function getHelpFileURI() {
return helpFileURI;
}
function getWebNavigation()
{
return helpBrowser.webNavigation;
}
function loadURI(uri)
{
if (uri.substr(0,7) != "chrome:")
uri = helpBaseURI + uri;
const nsIWebNavigation = Components.interfaces.nsIWebNavigation;
getWebNavigation().loadURI(uri, nsIWebNavigation.LOAD_FLAGS_NONE, null, null, null);
}
function goBack()
{
var webNavigation = getWebNavigation();
if (webNavigation.canGoBack)
webNavigation.goBack();
}
function goForward()
{
var webNavigation = getWebNavigation();
if (webNavigation.canGoForward)
webNavigation.goForward();
}
function goHome() {
// load "Welcome" page
displayTopic(defaultTopic);
}
function print()
{
try {
_content.print();
} catch (e) {
}
}
function createBackMenu(event)
{
return FillHistoryMenu(event.target, "back");
}
function createForwardMenu(event)
{
return FillHistoryMenu(event.target, "forward");
}
function gotoHistoryIndex(aEvent)
{
var index = aEvent.target.getAttribute("index");
if (!index)
return false;
try {
getWebNavigation().gotoIndex(index);
}
catch(ex) {
return false;
}
return true;
}
function BrowserBack()
{
try {
getWebNavigation().goBack();
}
catch(ex) {
}
UpdateBackForwardButtons();
}
function BrowserForward()
{
try {
getWebNavigation().goForward();
}
catch(ex) {
}
UpdateBackForwardButtons();
}
function nsHelpStatusHandler()
{
}
nsHelpStatusHandler.prototype =
{
onStateChange : function(aWebProgress, aRequest, aStateFlags, aStatus) {},
onProgressChange : function(aWebProgress, aRequest, aCurSelfProgress,
aMaxSelfProgress, aCurTotalProgress, aMaxTotalProgress) {},
onSecurityChange : function(aWebProgress, aRequest, state) {},
onLocationChange : function(aWebProgress, aRequest, aLocation)
{
UpdateBackForwardButtons();
},
QueryInterface : function(aIID)
{
if (aIID.equals(Components.interfaces.nsIWebProgressListener) ||
aIID.equals(Components.interfaces.nsISupportsWeakReference) ||
aIID.equals(Components.interfaces.nsIXULBrowserWindow) ||
aIID.equals(Components.interfaces.nsISupports))
return this;
throw Components.results.NS_NOINTERFACE;
},
setJSStatus : function(status) {},
setJSDefaultStatus : function(status) {},
setOverLink : function(link) {}
}
function UpdateBackForwardButtons()
{
var backBroadcaster = document.getElementById("canGoBack");
var forwardBroadcaster = document.getElementById("canGoForward");
var webNavigation = getWebNavigation();
// Avoid setting attributes on broadcasters if the value hasn't changed!
// Remember, guys, setting attributes on elements is expensive! They
// get inherited into anonymous content, broadcast to other widgets, etc.!
// Don't do it if the value hasn't changed! - dwh
var backDisabled = (backBroadcaster.getAttribute("disabled") == "true");
var forwardDisabled = (forwardBroadcaster.getAttribute("disabled") == "true");
if (backDisabled == webNavigation.canGoBack)
backBroadcaster.setAttribute("disabled", !backDisabled);
if (forwardDisabled == webNavigation.canGoForward)
forwardBroadcaster.setAttribute("disabled", !forwardDisabled);
}
function find(again)
{
var focusedWindow = document.commandDispatcher.focusedWindow;
if (!focusedWindow || focusedWindow == window)
focusedWindow = window._content;
if (again)
findAgainInPage(helpBrowser, window._content, focusedWindow);
else
findInPage(helpBrowser, window._content, focusedWindow)
}
function getMarkupDocumentViewer()
{
return helpBrowser.markupDocumentViewer;
}
function BrowserReload()
{
const reloadFlags = Components.interfaces.nsIWebNavigation.LOAD_FLAGS_NONE;
return BrowserReloadWithFlags(reloadFlags);
}
function BrowserReloadWithFlags(reloadFlags)
{
try {
/* Need to get SessionHistory from docshell so that
* reload on framed pages will work right. This
* method should not be used for the context menu item "Reload frame".
* "Reload frame" should directly call into docshell as it does right now
*/
var sh = getWebNavigation().sessionHistory;
var webNav = sh.QueryInterface(Components.interfaces.nsIWebNavigation);
webNav.reload(reloadFlags);
}
catch(ex) {
}
}
// doc=null for regular page info, doc=owner document for frame info
function BrowsemfS) {
,
{
return helpBrowsoad(y-Cv-Id("helpP" should direc.Boemen4
*/Uyrn helpBrorm() sh = getWebNaviga_
function finCs}
should directly call into docshell ashouw..ctly cal .cal .cal .ieNcindex-tree")(wocswsemMee")(wocswioytARowner documeeturtons();
ptySearchTexurn@t(fnntloadner gnd(again)
{
var focusedWindow = document.commandDi_pemehould dirs=}.ner doc.AtonsFs.ieloakndDi_pemeho