Merge branch 'documentation/JAL-3766_relnotes' into releases/Release_2_11_1_Branch
[jalview.git] / examples / jalviewLiteJs.html
index 434d1a7..78054d7 100644 (file)
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<html><!-- InstanceBegin template="/Templates/jtemplate.dwt" codeOutsideHTMLIsLocked="false" -->
-<head>
-<!-- InstanceBeginEditable name="doctitle" -->
-<TITLE>JalviewLite API documentation</TITLE>
-<!-- InstanceEndEditable --> 
-<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><meta http-equiv="keywords" content="jalview,multiple,sequence,alignment,editor,viewer,java,download,barton group,protein,dna,das,distributed annotation system">
-<!-- InstanceBeginEditable name="head" -->
-<!-- InstanceEndEditable --> 
-<style type="text/css">
 <!--
-td {
-       font-family: Geneva, Arial, Helvetica, sans-serif;
-       font-size: 12px;
-}
-.plain {
-       font-family: Verdana, Arial, Helvetica, sans-serif;
-       font-size: 14px;
-       text-decoration: none;
-}
-.plain:hover{
-       background-color:#000000; color: #F2F2FF;
-}
+ * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
+ * Copyright (C) $$Year-Rel$$ The Jalview Authors
+ * 
+ * This file is part of Jalview.
+ * 
+ * Jalview is free software: you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License 
+ * as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
+ *  
+ * Jalview is distributed in the hope that it will be useful, but 
+ * WITHOUT ANY WARRANTY; without even the implied warranty 
+ * of MERCHANTABILITY or FITNESS FOR A PARTICULAR 
+ * PURPOSE.  See the GNU General Public License for more details.
+ * 
+ * You should have received a copy of the GNU General Public License along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
+ * The Jalview Authors are detailed in the 'AUTHORS' file.
 -->
-</style>
-<script language="JavaScript">
-function genHref()
-{
-var s1 = "ml:ljvwr", s2 = "athpai.g", s3 = "ioe@leo ", href="";
-for(i=0; i<8; i++)
-{href = href + s1.charAt(i) + s2.charAt(i) + s3.charAt(i);     }
-window.location=href;
-}
-function getEventTarget(e)
-{
-if(!e)
-e = window.event;
-if(e.target)
-return e.target;
-return e.srcElement;
-}
-</script>
-</head>
-<body alink="#000000" vlink="#000000" link="#000000">
-<script type="text/javascript">
-var gaJsHost = (("https:" == document.location.protocol) ? 
-"https://ssl." : "http://www.");
-document.write(unescape("%3Cscript src='" + gaJsHost + 
-"google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
-try{
-var pageTracker = _gat._getTracker("UA-9060947-1");
-pageTracker._trackPageview();
-} catch(err) {}
-</script>
-<div align="left"> 
-  <table width="805" height="100" cellpadding="5">
-    <tr>
-      <td background="../jalview.gif">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="http://www.compbio.dundee.ac.uk" target="NEW"><img src="../uodc_r1_c1.gif" width="143" height="101" border="1"></a></td>
-    </tr>
-  </table>
-  <table width="805" border="0" cellpadding="5" cellspacing="5">
-    <tr> 
-      <td width="183" valign="top" bgcolor="#F2F2FF" border="5"> 
-         
-         <div align="center">
-          <table width="182" height="386" border="0" cellpadding="0" cellspacing="0">
-            <tr> 
-              <td align="left" valign="middle"><a href="../index.html" class="plain">Home</a></td>
-            </tr>
-            <tr> 
-              <td align="left" valign="middle"><a href="../overview.html" class="plain">Overview</a></td>
-            </tr>
-            <tr> 
-              <td align="left" valign="middle"><a href="../download.html" class="plain">Download</a></td>
-            </tr>
-            <tr> 
-              <td align="left" valign="middle"><a href="applets.html" class="plain">Applet 
-                Version</a></td>
-            </tr>
-            <tr> 
-              <td align="left" valign="middle"><a href="examples.html" class="plain">Screenshots</a></td>
-            </tr>
-            <tr> 
-              <td align="left" valign="middle"><a href="../faq.html" class="plain">FAQ</a></td>
-            </tr>
-            <tr> 
-              <td align="left" valign="middle"><a href="../documentList.html" class="plain">Documentation</a></td>
-            </tr>
-            <tr>
-              <td align="left" valign="middle" ><a href="../releaseHistory.html" class="plain">Release 
-                history</a></td>
-            </tr>
-            <tr> 
-              <td align="left" valign="middle"><a href="../source/source.html" class="plain">Source 
-                Code</a></td>
-            </tr>
-                       <tr> 
-              <td align="left" valign="middle"><a href="../versions.html" class="plain">Development Version</a></td>
-            </tr>
-                       <tr> 
-              <td align="left" valign="middle"><a href="../links.html" class="plain">Links</a></td>
-            </tr>
-            <tr> 
-              <td align="left" valign="middle"><a href="http://www.jalview.org/mailman/listinfo/jalview-announce" class="plain" target="NEW">News 
-                Mailing List</a></td>
-            </tr>
-            <tr>
-              <td align="left" valign="middle"><a
-            href="http://www.jalview.org/mailman/listinfo/jalview-discuss"
-            class="plain" target="NEW">Discussion Mailing List</a><br><br><em>Please send problems<br>and
-            bug reports to the discussion list.</em></td>
-            </tr>
-            <tr></tr>
-            <tr>
-              <!--<td align="left" valign="middle"><br>
-                Please send problems<br>and
-            bug reports to:<br><a href="#" onClick="javascript:genHref();"><img src="../help.gif" width="123" height="19" border="0"></a></td>-->
-            </tr>
-          </table>
-        </div>
-        <div align="center"> <a href="http://www.bbsrc.ac.uk/" target="NEW"><br>
-          <img src="../bbsrc-new.gif" width="179" height="64" border="1"></a> 
-        </div>
-        </td>
-      <td valign="top" width="587" bgcolor="#F2F2FF"><!-- InstanceBeginEditable name="Contents" -->
-               <p>&nbsp;</p>
-               <strong>JalviewLite Javascript API<br></strong>
-               <p>The jalviewLite applet's application programming interface (API) includes two components. A <a href="javascript/jalview.js">JalviewLite Javascript Library</a> and the <a href="#api">public methods on the JalviewLite applet</a>.
-               <p>The best way to learn how to use the API is to see it in action on the demonstration pages below:</p>
-               <ul>
-          <li><a href="formComplete.html">use Javascript to control and get data from JalviewLite</a></li>
-          <li><a href="linkedapplets_ng.html">use Javascript to make two jalviewLite instances talk to each other.</a></li>
-          <li><a href="embeddedWJmol.html">configure JalviewLite to talk to a Jmol applet on the page (EXPERIMENTAL! please provide feedback!).</a></li>
-          <li><a href="javascriptLaunch.html">launch JalviewLite from a javascript button</a></li>
-          
-               </ul>
-               <h4>Notes</h4>
+
+
+
+<div id="view_decorated" name="view_decorated"  style="margin:8px; padding:10px; border: 2px solid red; text-align:center; display:none;"><b>Click <a href="index.html#jalviewLiteJs"> here</a> to view decorated page</b></div>
+
+<!-- content start -->
+<p>The jalviewLite applet's application programming interface (API) includes two components. A <a href="javascript/jalview.js">JalviewLite Javascript Library</a> and the <a href="#api">public methods on the JalviewLite applet</a>.
+</p>
+               <h3>Notes</h3>
                <ul>
                <li>Unfortunately Javascript - Java communication is not possible
                using Internet Explorer or Opera on Macs. Please use Safari or
@@ -153,7 +40,7 @@ pageTracker._trackPageview();
                </li>
                </ul>
                <a name="api">
-               <h4>JalviewLite's Java API</h4></a>
+               <h1>JalviewLite's Javascript API</h1></a>
                <p>The following public methods on the jalviewLite applet are available to be called from javascript:</p>
                <pre>//get list of IDs of selected sequences
 public String getSelectedSequences()
@@ -215,11 +102,21 @@ public String getAlignmentFrom(AlignFrame alf, String format)
 public String getAlignmentFrom(AlignFrame alf, String format, String suffix)
 
 // add the given features or annotation to the current alignment
+// if features are loaded, feature display is automatically enabled
 public void loadAnnotation(String annotation)
 
 // add the given features or annotation to the given alignment view
+// if features are loaded, feature display is automatically enabled
 public void loadAnnotationFrom(AlignFrame alf, String annotation)
 
+// parse the given string as a jalview or GFF features file and optionally enable feature display on the current alignment
+// (v2.8)
+public abstract void loadFeatures(String features, boolean autoenabledisplay)
+
+// parse the given string as a jalview or GFF features file and optionally enable feature display on the given alignment
+// (v2.8)
+public abstract void loadFeaturesFrom(AlignFrame alf, String features, boolean autoenabledisplay)
+
 // get the sequence features in the given format (Jalview or GFF)
 public String getFeatures(String format)
 
@@ -246,6 +143,8 @@ public AlignFrame newViewFrom(AlignFrame alf)
 public AlignFrame newViewFrom(AlignFrame alf, String name)
 
 // load a new alignment 
+// remember to store the AlignFrame object reference 
+// if you want to manipulate the new alignment view.
 public AlignFrame loadAlignment(String text, String title)
 
 
@@ -304,6 +203,14 @@ public boolean addPdbFile(AlignFrame alFrame,
 // the given location the top left hand corner for given current view (v2.7)
 public void scrollViewToIn(AlignFrame alf, String topRow, String leftHandColumn)
 
+// adjust horizontal scroll in alf to the make 
+// the given location the left hand corner for given current view (v2.7)
+public void scrollViewToColumnIn(AlignFrame alf, String leftHandColumn)
+
+// adjust horizontal/vertical scroll in alf to the make 
+// the given location the top row for given current view (v2.7)
+public void scrollViewToRowIn(AlignFrame alf, String topRow)
+
 
 // return separator separated list of feature groups 
 // on the current alignment
@@ -363,9 +270,5 @@ public static String getVersion()
 // debug flag - controls output to standard out
 public static boolean debug
 
-</pre> <!-- InstanceEndEditable --></td>
-    </tr>
-  </table>
-</div>
-</body>
-<!-- InstanceEnd --></html>
+</pre>
+<!-- content end -->
\ No newline at end of file