HTMLEditorKit (Java Platform SE 8 )

java.lang.Object
- javax.swing.text.EditorKit
- - javax.swing.text.DefaultEditorKit
  - - javax.swing.text.StyledEditorKit
    - - javax.swing.text.html.HTMLEditorKit

All Implemented Interfaces:

Serializable， Cloneable， Accessible
```
public class HTMLEditorKit
extends StyledEditorKit
implements Accessible
```
摆jeditorpane文本组件支持不同种类的内容通过插件机制称为editorkit。因为HTML是一种非常流行的格式的内容，一些支持设置默认。默认支持是由这类提供，它支持HTML 3.2版本（有一些扩展），并逐渐向4版。不支持“小程序”标签，但为“对象”标签提供了一些支持。
有几个目标editorkit提供HTML，HTML，在建模方式的影响。这些都影响了它的设计在一个实质性的方式。
支持编辑

这似乎是相当明显的，一个插件jeditorpane应该提供编辑支持，但实际上有几个设计考虑。有大量的HTML文件，不符合HTML规范。这些必须被归一化成一个正确的形式，如果一个是编辑它们。此外，用户不喜欢被提出与结构编辑过多，所以采用传统的文本编辑手势优于使用HTML结构完全一样，在HTML文档中定义的。
HTML的造型是由类HTMLDocument提供。它的文档描述了如何HTML模型。编辑支持充分利用了文本包的关闭功能。

扩展/扩展
该试剂盒的效用最大化，大量的努力已经使它扩展。这些都是一些功能。
1. 解析器是可替换的。缺省解析器是热java解析器是基于DTD。不同的DTD可以使用，或一个完全不同的解析器可以使用。改变分析器，执行getparser方法。当第一次请求时，默认的解析器是动态加载的，所以如果使用了另一个解析器，类文件将永远不会被加载。默认的解析器是在这个包下面的一个单独的包中调用的。
2. 解析器驱动parsercallback，这是由这。改变回调，这类和执行createdefaultdocument方法返回的文件，产生不同的读者。读者控制文档的结构。虽然文档提供了支持HTML的默认情况下，没有什么预防非HTML标签，替代元素结构的结果支持。
3. 该模型的默认视图提供了视图实现的层次结构，因此可以轻松地自定义特定元素是如何显示或添加新的元素的功能，通过提供新的视图实现。设置视图的默认的HTMLFactory类提供。这可以很容易地通过继承或更换htmlfactory和重载返回：视图工厂方法返回的替代工厂。
4. 视图实现工作主要从CSS属性，它保存在视图。这使得有可能有多个视图映射到相同的模型，出现基本上不同的。这可能是特别有用的印刷。对于大多数的HTML属性，HTML属性转换为显示的CSS属性。这有助于使视图实现更通用
异步加载

较大的文档涉及大量的解析，并需要一些时间来加载。默认情况下，此试剂盒产生的文件，将异步加载如果加载使用 JEditorPane.setPage。这是通过对文件的属性控制。该方法可以被重写为改变这 createDefaultDocument。工作的 HTMLDocument.HTMLReader类做配料。实际的工作是由文本中的包和类 DefaultStyledDocument AbstractDocument做。

从目前的LAF定制

HTML提供了一个众所周知的特征不完全指定的显示特性。摇摆有一个主题机制，它的外观和感觉的实现。它是理想的外观和感觉的饲料在HTML视图显示特性。以视力差为例的用户将需要高对比度和更大的比典型的字体。
这是由StyleSheet类提供支持。HTML的表现可以在editorkit样式表中的属性值的影响很大。

不损

一个editorkit有能力来读取和保存文档。它通常是最令人愉快的用户，如果没有损失的两个操作之间的数据。的HTMLEditorKit执行政策将存放的东西不认可或不可见，他们随后可以写出来。HTML文档的模型应包含所有的信息在阅读文献发现。这是在某些方面的限制，需要支持编辑（即不正确的文件有时必须进行规范化）。指导原则是，信息不应该丢失，但有些可能会被合成，以产生一个更正确的模型，或者它可能被重新安排。

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`HTMLEditorKit.HTMLFactory` 工厂建立视图的HTML。
`static class`	`HTMLEditorKit.HTMLTextAction` 一个抽象的行动提供一些方便的方法，可以插入HTML到现有的文件是有用的。
`static class`	`HTMLEditorKit.InsertHTMLTextAction` inserthtmltextaction可以插入HTML任意字符串到一个现有的HTML文档。
`static class`	`HTMLEditorKit.LinkController` 在适当时，要监视相关组件和消防超链接事件。
`static class`	`HTMLEditorKit.Parser` 由解析器支持的接口。
`static class`	`HTMLEditorKit.ParserCallback` 解析的结果驱动这些回调方法。

Nested classes/interfaces inherited from class javax.swing.text.StyledEditorKit
StyledEditorKit.AlignmentAction, StyledEditorKit.BoldAction, StyledEditorKit.FontFamilyAction, StyledEditorKit.FontSizeAction, StyledEditorKit.ForegroundAction, StyledEditorKit.ItalicAction, StyledEditorKit.StyledTextAction, StyledEditorKit.UnderlineAction

Nested classes/interfaces inherited from class javax.swing.text.DefaultEditorKit
DefaultEditorKit.BeepAction, DefaultEditorKit.CopyAction, DefaultEditorKit.CutAction, DefaultEditorKit.DefaultKeyTypedAction, DefaultEditorKit.InsertBreakAction, DefaultEditorKit.InsertContentAction, DefaultEditorKit.InsertTabAction, DefaultEditorKit.PasteAction

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`BOLD_ACTION` 大胆动作标识符
`static String`	`COLOR_ACTION` 颜色选择动作标识符的颜色作为一个参数传递
`static String`	`DEFAULT_CSS` 设置标记视图的默认级联样式表文件。
`static String`	`FONT_CHANGE_BIGGER` 字体大小增加到下一个值动作标识符
`static String`	`FONT_CHANGE_SMALLER` 字体大小减少到下一个值动作标识符
`static String`	`IMG_ALIGN_BOTTOM` 在底部对齐图像。
`static String`	`IMG_ALIGN_MIDDLE` 对齐图像在中间。
`static String`	`IMG_ALIGN_TOP` 在顶部对齐图像。
`static String`	`IMG_BORDER` 对齐边界上的图像。
`static String`	`ITALIC_ACTION` 斜体动作标识符
`static String`	`LOGICAL_STYLE_ACTION` 逻辑样式选择动作标识符，逻辑样式作为一个参数传递
`static String`	`PARA_INDENT_LEFT` 段落左缩进动作标识符
`static String`	`PARA_INDENT_RIGHT` 段落的右缩进动作标识符

Fields inherited from class javax.swing.text.DefaultEditorKit
backwardAction, beepAction, beginAction, beginLineAction, beginParagraphAction, beginWordAction, copyAction, cutAction, defaultKeyTypedAction, deleteNextCharAction, deleteNextWordAction, deletePrevCharAction, deletePrevWordAction, downAction, endAction, endLineAction, EndOfLineStringProperty, endParagraphAction, endWordAction, forwardAction, insertBreakAction, insertContentAction, insertTabAction, nextWordAction, pageDownAction, pageUpAction, pasteAction, previousWordAction, readOnlyAction, selectAllAction, selectionBackwardAction, selectionBeginAction, selectionBeginLineAction, selectionBeginParagraphAction, selectionBeginWordAction, selectionDownAction, selectionEndAction, selectionEndLineAction, selectionEndParagraphAction, selectionEndWordAction, selectionForwardAction, selectionNextWordAction, selectionPreviousWordAction, selectionUpAction, selectLineAction, selectParagraphAction, selectWordAction, upAction, writableAction

构造方法摘要

构造方法
Constructor and Description
`HTMLEditorKit()` 构建了一个创建一个stylecontext HTMLEditorKit执行，，并加载样式表。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`Object`	`clone()` 创建编辑器组件的副本。
`Document`	`createDefaultDocument()` 创建一个未初始化的文本存储模式，这种类型的编辑器是合适的。
`protected void`	`createInputAttributes(Element element, MutableAttributeSet set)` 副本 `element`s attributeset键/值为 `set`。
`void`	`deinstall(JEditorPane c)` 当包被从jeditorpane删除。
`AccessibleContext`	`getAccessibleContext()` 返回与此相关的accessiblecontext编辑工具
`Action[]`	`getActions()` 获取编辑命令列表。
`String`	`getContentType()` 得到这盒代表支持数据的MIME类型。
`Cursor`	`getDefaultCursor()` 返回默认光标。
`MutableAttributeSet`	`getInputAttributes()` 获取用于样式编辑操作的输入属性。
`Cursor`	`getLinkCursor()` 返回使用超链接的光标。
`protected HTMLEditorKit.Parser`	`getParser()` 取解析器使用阅读HTML流。
`StyleSheet`	`getStyleSheet()` 获得方式目前被用来渲染的HTML元素的集合。
`ViewFactory`	`getViewFactory()` 取一个适合于生产任何型号的视图的工厂生产的这个套件。
`void`	`insertHTML(HTMLDocument doc, int offset, String html, int popDepth, int pushDepth, HTML.Tag insertTag)` 插入HTML到一个已经存在的文件。
`void`	`install(JEditorPane c)` 当包被安装到一个jeditorpane。
`boolean`	`isAutoFormSubmission()` 指示是否一个HTML表单提交的自动处理或只 `FormSubmitEvent`开火。
`void`	`read(Reader in, Document doc, int pos)` 从给定流中插入内容。
`void`	`setAutoFormSubmission(boolean isAuto)` 指定HTML表单提交的自动处理或只 `FormSubmitEvent`开火。
`void`	`setDefaultCursor(Cursor cursor)` 设置默认光标。
`void`	`setLinkCursor(Cursor cursor)` 设置光标在链接上使用。
`void`	`setStyleSheet(StyleSheet s)` 设置样式来呈现不同的HTML元素的集合。
`void`	`write(Writer out, Document doc, int pos, int len)` 用适当的格式将文档中的内容写入该类内容处理程序的格式中的内容。

Methods inherited from class javax.swing.text.StyledEditorKit
getCharacterAttributeRun

Methods inherited from class javax.swing.text.DefaultEditorKit
createCaret, read, write

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - DEFAULT_CSS
```
public static final String DEFAULT_CSS
```
    设置标记视图的默认级联样式表文件。
    
    另请参见：
    
    Constant Field Values
  - BOLD_ACTION
```
public static final String BOLD_ACTION
```
    大胆动作标识符
    
    另请参见：
    
    Constant Field Values
  - ITALIC_ACTION
```
public static final String ITALIC_ACTION
```
    斜体动作标识符
    
    另请参见：
    
    Constant Field Values
  - PARA_INDENT_LEFT
```
public static final String PARA_INDENT_LEFT
```
    段落左缩进动作标识符
    
    另请参见：
    
    Constant Field Values
  - PARA_INDENT_RIGHT
```
public static final String PARA_INDENT_RIGHT
```
    段落的右缩进动作标识符
    
    另请参见：
    
    Constant Field Values
  - FONT_CHANGE_BIGGER
```
public static final String FONT_CHANGE_BIGGER
```
    字体大小增加到下一个值动作标识符
    
    另请参见：
    
    Constant Field Values
  - FONT_CHANGE_SMALLER
```
public static final String FONT_CHANGE_SMALLER
```
    字体大小减少到下一个值动作标识符
    
    另请参见：
    
    Constant Field Values
  - COLOR_ACTION
```
public static final String COLOR_ACTION
```
    颜色选择动作标识符的颜色作为一个参数传递
    
    另请参见：
    
    Constant Field Values
  - LOGICAL_STYLE_ACTION
```
public static final String LOGICAL_STYLE_ACTION
```
    逻辑样式选择动作标识符，逻辑样式作为一个参数传递
    
    另请参见：
    
    Constant Field Values
  - IMG_ALIGN_TOP
```
public static final String IMG_ALIGN_TOP
```
    在顶部对齐图像。
    
    另请参见：
    
    Constant Field Values
  - IMG_ALIGN_MIDDLE
```
public static final String IMG_ALIGN_MIDDLE
```
    对齐图像在中间。
    
    另请参见：
    
    Constant Field Values
  - IMG_ALIGN_BOTTOM
```
public static final String IMG_ALIGN_BOTTOM
```
    在底部对齐图像。
    
    另请参见：
    
    Constant Field Values
  - IMG_BORDER
```
public static final String IMG_BORDER
```
    对齐边界上的图像。
    
    另请参见：
    
    Constant Field Values
- Constructor Detail
  - HTMLEditorKit
```
public HTMLEditorKit()
```
    构建了一个创建一个stylecontext HTMLEditorKit执行，，并加载样式表。
- 方法详细信息
  - getContentType
```
public String getContentType()
```
    得到这盒代表支持数据的MIME类型。该套件支持的类型 text/html。
    
    重写：
    
    getContentType 方法重写，继承类 DefaultEditorKit
    
    结果
    
    类型
  - getViewFactory
```
public ViewFactory getViewFactory()
```
    取一个适合于生产任何型号的视图的工厂生产的这个套件。
    
    重写：
    
    getViewFactory 方法重写，继承类 StyledEditorKit
    
    结果
    
    本厂
  - createDefaultDocument
```
public Document createDefaultDocument()
```
    创建一个未初始化的文本存储模式，这种类型的编辑器是合适的。
    
    重写：
    
    createDefaultDocument 方法重写，继承类 StyledEditorKit
    
    结果
    
    模型
  - read
```
public void read(Reader in,
                 Document doc,
                 int pos)
          throws IOException,
                 BadLocationException
```
    从给定流中插入内容。如果 doc是HTML文档的一个实例，这将读取HTML文本的3.2。插入HTML到一个非空的文件必须在体元，如果你不插入体将抛出一个异常。当插入到一个非空的文档中的所有标签以外的身体（头，标题）将被删除。
    
    重写：
    
    read 方法重写，继承类 DefaultEditorKit
    
    参数
    
    in流--读
    
    doc -插入目的地
    
    pos -在文档中的位置处的内容
    
    异常
    
    IOException -任何I/O错误
    
    BadLocationException如果POS代表文档中的一个无效的位置
    
    RuntimeException -（最终会是一个badlocationexception）如果POS是无效的
  - insertHTML
```
public void insertHTML(HTMLDocument doc,
                       int offset,
                       String html,
                       int popDepth,
                       int pushDepth,
                       HTML.Tag insertTag)
                throws BadLocationException,
                       IOException
```
    插入HTML到一个已经存在的文件。
    
    参数
    
    doc -文档插入
    
    offset -偏移插入HTML
    
    popDepth - elementspec.endtagtypes数产生之前插入
    
    pushDepth具有方向elementspec.joinnextdirection应生成之前插入elementspec.starttagtypes数量，但结束后的标签已生成
    
    insertTag开始插入文档的第一个标签
    
    异常
    
    RuntimeException -（最终会是一个badlocationexception）如果POS是无效的
    
    BadLocationException
    
    IOException
  - write
```
public void write(Writer out,
                  Document doc,
                  int pos,
                  int len)
           throws IOException,
                  BadLocationException
```
    用适当的格式将文档中的内容写入该类内容处理程序的格式中的内容。
    
    重写：
    
    write 方法重写，继承类 DefaultEditorKit
    
    参数
    
    out流-写
    
    doc为写源
    
    pos -在文档中的位置获取内容
    
    len量-写出来
    
    异常
    
    IOException -任何I/O错误
    
    BadLocationException如果POS代表文档中的一个无效的位置
  - install
```
public void install(JEditorPane c)
```
    当包被安装到一个jeditorpane。
    
    重写：
    
    install 方法重写，继承类 StyledEditorKit
    
    参数
    
    c - JEditorPane
  - deinstall
```
public void deinstall(JEditorPane c)
```
    当包被从jeditorpane删除。这是用来注销，附加任何听众。
    
    重写：
    
    deinstall 方法重写，继承类 StyledEditorKit
    
    参数
    
    c - JEditorPane
  - setStyleSheet
```
public void setStyleSheet(StyleSheet s)
```
    设置样式来呈现不同的HTML元素的集合。这些样式都在CSS规范规定。由该工具包产生的每个文档将有一个表的副本，它可以添加文档的特定样式。默认情况下，指定的样式表的HTMLEditorKit执行实例共享。这应该是重新实现，如果需要提供一个更细的粒度。
  - getStyleSheet
```
public StyleSheet getStyleSheet()
```
    获得方式目前被用来渲染的HTML元素的集合。默认情况下，指定的default_css资源被加载，并通过所有的HTMLEditorKit执行实例共享。
  - getActions
```
public Action[] getActions()
```
    获取编辑命令列表。这是由父类定义的命令，增强由本地风格的操作集合支持的命令列表。
    
    重写：
    
    getActions 方法重写，继承类 StyledEditorKit
    
    结果
    
    命令列表
  - createInputAttributes
```
protected void createInputAttributes(Element element,
                                     MutableAttributeSet set)
```
    副本 elements attributeset键/值为 set。这不复制组件、图标或元素名称属性。子类可能希望细化哪些是什么，哪些不是复制在这里。但一定要先删除所有的属性，在 set。
    这就是所谓的随时插入移动到不同的位置。
    
    重写：
    
    createInputAttributes 方法重写，继承类 StyledEditorKit
  - getInputAttributes
```
public MutableAttributeSet getInputAttributes()
```
    获取用于样式编辑操作的输入属性。
    
    重写：
    
    getInputAttributes 方法重写，继承类 StyledEditorKit
    
    结果
    
    属性集
  - setDefaultCursor
```
public void setDefaultCursor(Cursor cursor)
```
    设置默认光标。
    
    从以下版本开始：
    
    一点三
  - getDefaultCursor
```
public Cursor getDefaultCursor()
```
    返回默认光标。
    
    从以下版本开始：
    
    一点三
  - setLinkCursor
```
public void setLinkCursor(Cursor cursor)
```
    设置光标在链接上使用。
    
    从以下版本开始：
    
    一点三
  - getLinkCursor
```
public Cursor getLinkCursor()
```
    返回使用超链接的光标。
    
    从以下版本开始：
    
    一点三
  - isAutoFormSubmission
```
public boolean isAutoFormSubmission()
```
    指示是否一个HTML表单提交的自动处理或只 FormSubmitEvent开火。
    
    结果
    
    如果HTML表单提交的自动处理真，否则为假。
    
    从以下版本开始：
    
    一点五
    
    另请参见：
    
    setAutoFormSubmission(boolean)
  - setAutoFormSubmission
```
public void setAutoFormSubmission(boolean isAuto)
```
    指定HTML表单提交的自动处理或只 FormSubmitEvent开火。默认情况下，它设置为。
    
    从以下版本开始：
    
    一点五
    
    另请参见：
    
    isAutoFormSubmission()， FormSubmitEvent
  - clone
```
public Object clone()
```
    创建编辑器组件的副本。
    
    重写：
    
    clone 方法重写，继承类 StyledEditorKit
    
    结果
    
    复制
    
    另请参见：
    
    Cloneable
  - getParser
```
protected HTMLEditorKit.Parser getParser()
```
    取解析器使用阅读HTML流。这可以重新实现提供不同的解析器。默认实现是动态加载的，以避免加载默认的解析器的开销，如果它不使用。缺省解析器是使用HTML 3.2 DTD①分析器。
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    返回与此相关的accessiblecontext编辑工具
    
    Specified by:
    
    getAccessibleContext 接口 Accessible
    
    结果
    
    与此相关的accessiblecontext编辑工具
    
    从以下版本开始：
    
    一点四

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class HTMLEditorKit

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.text.StyledEditorKit

Nested classes/interfaces inherited from class javax.swing.text.DefaultEditorKit

Field Summary

Fields inherited from class javax.swing.text.DefaultEditorKit

构造方法摘要

方法摘要

Methods inherited from class javax.swing.text.StyledEditorKit

Methods inherited from class javax.swing.text.DefaultEditorKit

Methods inherited from class java.lang.Object

Field Detail

DEFAULT_CSS

BOLD_ACTION

ITALIC_ACTION

PARA_INDENT_LEFT

PARA_INDENT_RIGHT

FONT_CHANGE_BIGGER

FONT_CHANGE_SMALLER

COLOR_ACTION

LOGICAL_STYLE_ACTION

IMG_ALIGN_TOP

IMG_ALIGN_MIDDLE

IMG_ALIGN_BOTTOM

IMG_BORDER

Constructor Detail

HTMLEditorKit

方法详细信息

getContentType

getViewFactory

createDefaultDocument

read

insertHTML

write

install

deinstall

setStyleSheet

getStyleSheet

getActions

createInputAttributes

getInputAttributes

setDefaultCursor

getDefaultCursor

setLinkCursor

getLinkCursor

isAutoFormSubmission

setAutoFormSubmission

clone

getParser

getAccessibleContext