| [scout-dev] Release Notes Eclipse Scout 2011-Jun (Indigo, SR1 3.7.1) |
|
Hi You are receiving this e-Mail because you are subscribed to
Eclipse Scout 2011-Jun. If you are not using AbstractHtmlField or AbstractMailField you can ignore this e-Mail. 22.08.2011
dwi BSI ticket #105'026, #104'976 Problem: - Failed to display corrupt HTML pages (e.g. if missing closing quote in style definition) - In HTML editor, no cleanup (auto-correction) should be applied to the given HTML. That is because if the user did some modifications in
the HTML source and reloads the HTML in the editor anew, unwanted auto-corrections would be applied. Solution: - Accomplish consistency concerning HTML styling (cleanup) in between of Swing and SWT in regard of ScoutHtmlField and ScoutHmtEditor. In more detail, this entails the following: - Before passing the HTML to the respective widget (ScoutHtmlEditor, ScoutHtmlField), Abstract[Swing|Swt]Environment#styleHtmlText()
is called to cleanup the given HTML. - In case of HTML editor mode, no modifications are applied to the given HTML in both, Swing and SWT, respectively. - However, in non-editor mode, some intelligence is applied to the HTML to ensure proper display of the HTML document. - In Swing, cleanup of HTML structure and CSS definitions is done. That is crucial as Swing HTML viewer has some problems with some CSS
constructs. - In SWT, OS default browser is used. That is why cleanup of CSS is not necessary as done by browser itself. But, because the HTML is provided as file to the browser, proper encoding and
charset must be set. -
Failsafe: if HTML text cannot be parsed for cleanup, the raw HTML text is used instead of an exception thrown. - Consolidation of HTML cleanup functionality in HTMLUtility for plain and simple use that is applicable for both, SWT and Swing, respectively.
That is why various methods in HtmlUtility are marked deprecated and will be removed in next Scout release. Plug-Ins affected: - org.eclipse.scout.commons (HTMLUtility - org.eclipse.scout.rt.client (AbstractHtmlField) - org.eclipse.scout.rt.ui.swing (AbstractSwingEnvironment, SwingScoutHtmlField, SwingScoutMailField) - org.eclipse.scout.rt.ui.swing.bsi.fragment (SwingScoutHtmlEditor) - org.eclipse.scout.rt.ui.swt (AbstractSwtEnvironment, SwtScoutHtmlField) - org.eclipse.scout.rt.ui.swt.bsi.fragment (SwtScoutHtmlEditor) Migration Swing: None Migration SWT: - In AbstractSwtEnvironment, the following methods are removed as not required anymore because logic is encapsulated in HTMLUtility. - AbstractSwtEnvironment#styleHtmlText(Control, String) - AbstractSwtEnvironment#createCSS(Control) - AbstractSwtEnvironment#createHtmlDocument(String, String) Migration Swing / SWT (optional): - In HTMLUtility, the following methods are marked
deprecated. They will be removed in next Scout release. - HTMLUtility#parseDocument(String) to be replaced by HTMLUtility.toHtmlDocument(String) - HTMLUtility#formatDocument(String) to be replaced by HTMLUtility.toHtmlText(String) - HTMLUtility#cleanupDocument(HTMLDocument, String,
int) to be replaced by HTMLUtility.cleanupHtml(String, boolean,boolean, DefaultFont) - HTMLUtility#wellformDocument(HTMLDocument, String,
int) to be replaced by HTMLUtility.cleanupHtml(String, boolean,boolean, DefaultFont) -- Release: Indigo, SR1 3.7.1 SVN: https://dev.eclipse.org/svnroot/technology/org.eclipse.scout/scout.rt/branches/2011-Jun/ Bugzilla:
https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;target_milestone=3.7.1;product=Scout --
-- |
Attachment:
smime.p7s
Description: S/MIME cryptographic signature