@samitouri / QOS-React / commits / a7af9c6ce4

[docs] Update supported attrs, clarified what supported elements actually means

Paul O’Shannessy committed Apr 6, 2016 at 15:41 UTC a7af9c6ce453229504fa00b2360b5af9f896eb46
4 files changed +184 -71
docs/docs/ref-04-tags-and-attributes.it-IT.md
+46 -19
@@ -53,17 +53,18 @@ Questi attributi standard sono supportati:
53
54 ```
55 accept acceptCharset accessKey action allowFullScreen allowTransparency alt
56 -async autoComplete autoFocus autoPlay capture cellPadding cellSpacing charSet
57 -challenge checked classID className cols colSpan content contentEditable contextMenu
58 -controls coords crossOrigin data dateTime defer dir disabled download draggable
59 -encType form formAction formEncType formMethod formNoValidate formTarget frameBorder
60 -headers height hidden high href hrefLang htmlFor httpEquiv icon id inputMode
61 -keyParams keyType label lang list loop low manifest marginHeight marginWidth max
62 -maxLength media mediaGroup method min minLength multiple muted name noValidate open
63 -optimum pattern placeholder poster preload radioGroup readOnly rel required role
64 -rows rowSpan sandbox scope scoped scrolling seamless selected shape size sizes
65 -span spellCheck src srcDoc srcSet start step style summary tabIndex target title
66 -type useMap value width wmode wrap
56 +async autoComplete autoFocus autoPlay capture cellPadding cellSpacing challenge
57 +charSet checked cite classID className colSpan cols content contentEditable
58 +contextMenu controls coords crossOrigin data dateTime default defer dir
59 +disabled download draggable encType form formAction formEncType formMethod
60 +formNoValidate formTarget frameBorder headers height hidden high href hrefLang
61 +htmlFor httpEquiv icon id inputMode integrity is keyParams keyType kind label
62 +lang list loop low manifest marginHeight marginWidth max maxLength media
63 +mediaGroup method min minLength multiple muted name noValidate nonce open
64 +optimum pattern placeholder poster preload profile radioGroup readOnly rel
65 +required reversed role rowSpan rows sandbox scope scoped scrolling seamless
66 +selected shape size sizes span spellCheck src srcDoc srcLang srcSet start step
67 +style summary tabIndex target title type useMap value width wmode wrap
68 ```
69
70 In aggiunta, i seguenti attributi non-standard sono supportati:
@@ -79,12 +80,38 @@ Esiste anche l'attributo specifico di React `dangerouslySetInnerHTML` ([maggiori
80 ### Attributi SVG
81
82 ```
82 -clipPath cx cy d dx dy fill fillOpacity fontFamily
83 -fontSize fx fy gradientTransform gradientUnits markerEnd
84 -markerMid markerStart offset opacity patternContentUnits
85 -patternUnits points preserveAspectRatio r rx ry spreadMethod
86 -stopColor stopOpacity stroke strokeDasharray strokeLinecap
87 -strokeOpacity strokeWidth textAnchor transform version
88 -viewBox x1 x2 x xlinkActuate xlinkArcrole xlinkHref xlinkRole
89 -xlinkShow xlinkTitle xlinkType xmlBase xmlLang xmlSpace y1 y2 y
83 +accentHeight accumulate additive alignmentBaseline allowReorder alphabetic
84 +amplitude arabicForm ascent attributeName attributeType autoReverse azimuth
85 +baseFrequency baseProfile baselineShift bbox begin bias by calcMode capHeight
86 +clip clipPath clipPathUnits clipRule colorInterpolation
87 +colorInterpolationFilters colorProfile colorRendering contentScriptType
88 +contentStyleType cursor cx cy d decelerate descent diffuseConstant direction
89 +display divisor dominantBaseline dur dx dy edgeMode elevation enableBackground
90 +end exponent externalResourcesRequired fill fillOpacity fillRule filter
91 +filterRes filterUnits floodColor floodOpacity focusable fontFamily fontSize
92 +fontSizeAdjust fontStretch fontStyle fontVariant fontWeight format from fx fy
93 +g1 g2 glyphName glyphOrientationHorizontal glyphOrientationVertical glyphRef
94 +gradientTransform gradientUnits hanging horizAdvX horizOriginX ideographic
95 +imageRendering in in2 intercept k k1 k2 k3 k4 kernelMatrix kernelUnitLength
96 +kerning keyPoints keySplines keyTimes lengthAdjust letterSpacing lightingColor
97 +limitingConeAngle local markerEnd markerHeight markerMid markerStart
98 +markerUnits markerWidth mask maskContentUnits maskUnits mathematical mode
99 +numOctaves offset opacity operator order orient orientation origin overflow
100 +overlinePosition overlineThickness paintOrder panose1 pathLength
101 +patternContentUnits patternTransform patternUnits pointerEvents points
102 +pointsAtX pointsAtY pointsAtZ preserveAlpha preserveAspectRatio primitiveUnits
103 +r radius refX refY renderingIntent repeatCount repeatDur requiredExtensions
104 +requiredFeatures restart result rotate rx ry scale seed shapeRendering slope
105 +spacing specularConstant specularExponent speed spreadMethod startOffset
106 +stdDeviation stemh stemv stitchTiles stopColor stopOpacity
107 +strikethroughPosition strikethroughThickness string stroke strokeDasharray
108 +strokeDashoffset strokeLinecap strokeLinejoin strokeMiterlimit strokeOpacity
109 +strokeWidth surfaceScale systemLanguage tableValues targetX targetY textAnchor
110 +textDecoration textLength textRendering to transform u1 u2 underlinePosition
111 +underlineThickness unicode unicodeBidi unicodeRange unitsPerEm vAlphabetic
112 +vHanging vIdeographic vMathematical values vectorEffect version vertAdvY
113 +vertOriginX vertOriginY viewBox viewTarget visibility widths wordSpacing
114 +writingMode x x1 x2 xChannelSelector xHeight xlinkActuate xlinkArcrole
115 +xlinkHref xlinkRole xlinkShow xlinkTitle xlinkType xmlBase xmlLang xmlSpace
116 +y y1 y2 yChannelSelector z zoomAndPan
117 ```
docs/docs/ref-04-tags-and-attributes.ko-KR.md
+46 -19
@@ -53,17 +53,18 @@ React는 모든 `data-*`, `aria-*` 어트리뷰트와 밑에 있는 모든 어
53
54 ```
55 accept acceptCharset accessKey action allowFullScreen allowTransparency alt
56 -async autoComplete autoFocus autoPlay capture cellPadding cellSpacing charSet
57 -challenge checked classID className cols colSpan content contentEditable contextMenu
58 -controls coords crossOrigin data dateTime defer dir disabled download draggable
59 -encType form formAction formEncType formMethod formNoValidate formTarget frameBorder
60 -headers height hidden high href hrefLang htmlFor httpEquiv icon id inputMode
61 -keyParams keyType label lang list loop low manifest marginHeight marginWidth max
62 -maxLength media mediaGroup method min minLength multiple muted name noValidate open
63 -optimum pattern placeholder poster preload radioGroup readOnly rel required role
64 -rows rowSpan sandbox scope scoped scrolling seamless selected shape size sizes
65 -span spellCheck src srcDoc srcSet start step style summary tabIndex target title
66 -type useMap value width wmode wrap
56 +async autoComplete autoFocus autoPlay capture cellPadding cellSpacing challenge
57 +charSet checked cite classID className colSpan cols content contentEditable
58 +contextMenu controls coords crossOrigin data dateTime default defer dir
59 +disabled download draggable encType form formAction formEncType formMethod
60 +formNoValidate formTarget frameBorder headers height hidden high href hrefLang
61 +htmlFor httpEquiv icon id inputMode integrity is keyParams keyType kind label
62 +lang list loop low manifest marginHeight marginWidth max maxLength media
63 +mediaGroup method min minLength multiple muted name noValidate nonce open
64 +optimum pattern placeholder poster preload profile radioGroup readOnly rel
65 +required reversed role rowSpan rows sandbox scope scoped scrolling seamless
66 +selected shape size sizes span spellCheck src srcDoc srcLang srcSet start step
67 +style summary tabIndex target title type useMap value width wmode wrap
68 ```
69
70 덧붙여, 이런 비표준 어트리뷰트도 지원됩니다.
@@ -79,12 +80,38 @@ type useMap value width wmode wrap
80 ### SVG 어트리뷰트
81
82 ```
82 -clipPath cx cy d dx dy fill fillOpacity fontFamily
83 -fontSize fx fy gradientTransform gradientUnits markerEnd
84 -markerMid markerStart offset opacity patternContentUnits
85 -patternUnits points preserveAspectRatio r rx ry spreadMethod
86 -stopColor stopOpacity stroke strokeDasharray strokeLinecap
87 -strokeOpacity strokeWidth textAnchor transform version
88 -viewBox x1 x2 x xlinkActuate xlinkArcrole xlinkHref xlinkRole
89 -xlinkShow xlinkTitle xlinkType xmlBase xmlLang xmlSpace y1 y2 y
83 +accentHeight accumulate additive alignmentBaseline allowReorder alphabetic
84 +amplitude arabicForm ascent attributeName attributeType autoReverse azimuth
85 +baseFrequency baseProfile baselineShift bbox begin bias by calcMode capHeight
86 +clip clipPath clipPathUnits clipRule colorInterpolation
87 +colorInterpolationFilters colorProfile colorRendering contentScriptType
88 +contentStyleType cursor cx cy d decelerate descent diffuseConstant direction
89 +display divisor dominantBaseline dur dx dy edgeMode elevation enableBackground
90 +end exponent externalResourcesRequired fill fillOpacity fillRule filter
91 +filterRes filterUnits floodColor floodOpacity focusable fontFamily fontSize
92 +fontSizeAdjust fontStretch fontStyle fontVariant fontWeight format from fx fy
93 +g1 g2 glyphName glyphOrientationHorizontal glyphOrientationVertical glyphRef
94 +gradientTransform gradientUnits hanging horizAdvX horizOriginX ideographic
95 +imageRendering in in2 intercept k k1 k2 k3 k4 kernelMatrix kernelUnitLength
96 +kerning keyPoints keySplines keyTimes lengthAdjust letterSpacing lightingColor
97 +limitingConeAngle local markerEnd markerHeight markerMid markerStart
98 +markerUnits markerWidth mask maskContentUnits maskUnits mathematical mode
99 +numOctaves offset opacity operator order orient orientation origin overflow
100 +overlinePosition overlineThickness paintOrder panose1 pathLength
101 +patternContentUnits patternTransform patternUnits pointerEvents points
102 +pointsAtX pointsAtY pointsAtZ preserveAlpha preserveAspectRatio primitiveUnits
103 +r radius refX refY renderingIntent repeatCount repeatDur requiredExtensions
104 +requiredFeatures restart result rotate rx ry scale seed shapeRendering slope
105 +spacing specularConstant specularExponent speed spreadMethod startOffset
106 +stdDeviation stemh stemv stitchTiles stopColor stopOpacity
107 +strikethroughPosition strikethroughThickness string stroke strokeDasharray
108 +strokeDashoffset strokeLinecap strokeLinejoin strokeMiterlimit strokeOpacity
109 +strokeWidth surfaceScale systemLanguage tableValues targetX targetY textAnchor
110 +textDecoration textLength textRendering to transform u1 u2 underlinePosition
111 +underlineThickness unicode unicodeBidi unicodeRange unitsPerEm vAlphabetic
112 +vHanging vIdeographic vMathematical values vectorEffect version vertAdvY
113 +vertOriginX vertOriginY viewBox viewTarget visibility widths wordSpacing
114 +writingMode x x1 x2 xChannelSelector xHeight xlinkActuate xlinkArcrole
115 +xlinkHref xlinkRole xlinkShow xlinkTitle xlinkType xmlBase xmlLang xmlSpace
116 +y y1 y2 yChannelSelector z zoomAndPan
117 ```
docs/docs/ref-04-tags-and-attributes.md
+53 -20
@@ -6,13 +6,17 @@ prev: component-specs.html
6 next: events.html
7 ---
8
9 -## Supported Tags
9 +## Supported Elements
10
11 -React attempts to support all common elements. If you need an element that isn't listed here, please [file an issue](https://github.com/facebook/react/issues/new).
11 +React attempts to support all common elements in both HTML and SVG. Any lower case tag in JSX will be rendered to an element with that tag. SVG elements must be contained within an `<svg>` element to work properly.
12
13 -### HTML Elements
13 +### Using `React.DOM` Factory methods
14
15 -The following HTML elements are supported:
15 +If you aren't using JSX and are using the `React.DOM.*` API to create elements, then you are slightly more limited and there is list of supported elements that will be available on that API.
16 +
17 +#### HTML Elements
18 +
19 +The following HTML elements are supported in `React.DOM.*`:
20
21 ```
22 a abbr address area article aside audio b base bdi bdo big blockquote body br
@@ -25,9 +29,9 @@ select small source span strong style sub summary sup table tbody td textarea
29 tfoot th thead time title tr track u ul var video wbr
30 ```
31
28 -### SVG elements
32 +#### SVG elements
33
30 -The following SVG elements are supported:
34 +The following SVG elements are supported in `React.DOM.*`:
35
36 ```
37 circle clipPath defs ellipse g image line linearGradient mask path pattern
@@ -54,17 +58,17 @@ These standard attributes are supported:
58 ```
59 accept acceptCharset accessKey action allowFullScreen allowTransparency alt
60 async autoComplete autoFocus autoPlay capture cellPadding cellSpacing challenge
57 -charSet checked classID className colSpan cols content contentEditable
61 +charSet checked cite classID className colSpan cols content contentEditable
62 contextMenu controls coords crossOrigin data dateTime default defer dir
63 disabled download draggable encType form formAction formEncType formMethod
64 formNoValidate formTarget frameBorder headers height hidden high href hrefLang
65 htmlFor httpEquiv icon id inputMode integrity is keyParams keyType kind label
66 lang list loop low manifest marginHeight marginWidth max maxLength media
67 mediaGroup method min minLength multiple muted name noValidate nonce open
64 -optimum pattern placeholder poster preload radioGroup readOnly rel required
65 -reversed role rowSpan rows sandbox scope scoped scrolling seamless selected
66 -shape size sizes span spellCheck src srcDoc srcLang srcSet start step style
67 -summary tabIndex target title type useMap value width wmode wrap
68 +optimum pattern placeholder poster preload profile radioGroup readOnly rel
69 +required reversed role rowSpan rows sandbox scope scoped scrolling seamless
70 +selected shape size sizes span spellCheck src srcDoc srcLang srcSet start step
71 +style summary tabIndex target title type useMap value width wmode wrap
72 ```
73
74 These RDFa attributes are supported (several RDFa attributes overlap with standard HTML attributes and thus are excluded from this list):
@@ -82,17 +86,46 @@ In addition, the following non-standard attributes are supported:
86 - `unselectable` for Internet Explorer.
87 - `results autoSave` for WebKit/Blink input fields of type `search`.
88
85 -There is also the React-specific attribute `dangerouslySetInnerHTML` ([more here](/react/docs/special-non-dom-attributes.html)), used for directly inserting HTML strings into a component.
89 +There is also 2 React-specific attributes:
90 +- `dangerouslySetInnerHTML` ([more here](/react/docs/special-non-dom-attributes.html)), used for directly inserting HTML strings into a component.
91 +- `suppressContentEditableWarning`, used to suppress the warning when using `contentEditable` and `children`.
92
93 ### SVG Attributes
94
95 ```
90 -clipPath cx cy d dx dy fill fillOpacity fontFamily
91 -fontSize fx fy gradientTransform gradientUnits markerEnd
92 -markerMid markerStart offset opacity patternContentUnits
93 -patternUnits points preserveAspectRatio r rx ry spreadMethod
94 -stopColor stopOpacity stroke strokeDasharray strokeLinecap
95 -strokeOpacity strokeWidth textAnchor transform version
96 -viewBox x1 x2 x xlinkActuate xlinkArcrole xlinkHref xlinkRole
97 -xlinkShow xlinkTitle xlinkType xmlBase xmlLang xmlSpace y1 y2 y
96 +accentHeight accumulate additive alignmentBaseline allowReorder alphabetic
97 +amplitude arabicForm ascent attributeName attributeType autoReverse azimuth
98 +baseFrequency baseProfile baselineShift bbox begin bias by calcMode capHeight
99 +clip clipPath clipPathUnits clipRule colorInterpolation
100 +colorInterpolationFilters colorProfile colorRendering contentScriptType
101 +contentStyleType cursor cx cy d decelerate descent diffuseConstant direction
102 +display divisor dominantBaseline dur dx dy edgeMode elevation enableBackground
103 +end exponent externalResourcesRequired fill fillOpacity fillRule filter
104 +filterRes filterUnits floodColor floodOpacity focusable fontFamily fontSize
105 +fontSizeAdjust fontStretch fontStyle fontVariant fontWeight format from fx fy
106 +g1 g2 glyphName glyphOrientationHorizontal glyphOrientationVertical glyphRef
107 +gradientTransform gradientUnits hanging horizAdvX horizOriginX ideographic
108 +imageRendering in in2 intercept k k1 k2 k3 k4 kernelMatrix kernelUnitLength
109 +kerning keyPoints keySplines keyTimes lengthAdjust letterSpacing lightingColor
110 +limitingConeAngle local markerEnd markerHeight markerMid markerStart
111 +markerUnits markerWidth mask maskContentUnits maskUnits mathematical mode
112 +numOctaves offset opacity operator order orient orientation origin overflow
113 +overlinePosition overlineThickness paintOrder panose1 pathLength
114 +patternContentUnits patternTransform patternUnits pointerEvents points
115 +pointsAtX pointsAtY pointsAtZ preserveAlpha preserveAspectRatio primitiveUnits
116 +r radius refX refY renderingIntent repeatCount repeatDur requiredExtensions
117 +requiredFeatures restart result rotate rx ry scale seed shapeRendering slope
118 +spacing specularConstant specularExponent speed spreadMethod startOffset
119 +stdDeviation stemh stemv stitchTiles stopColor stopOpacity
120 +strikethroughPosition strikethroughThickness string stroke strokeDasharray
121 +strokeDashoffset strokeLinecap strokeLinejoin strokeMiterlimit strokeOpacity
122 +strokeWidth surfaceScale systemLanguage tableValues targetX targetY textAnchor
123 +textDecoration textLength textRendering to transform u1 u2 underlinePosition
124 +underlineThickness unicode unicodeBidi unicodeRange unitsPerEm vAlphabetic
125 +vHanging vIdeographic vMathematical values vectorEffect version vertAdvY
126 +vertOriginX vertOriginY viewBox viewTarget visibility widths wordSpacing
127 +writingMode x x1 x2 xChannelSelector xHeight xlinkActuate xlinkArcrole
128 +xlinkHref xlinkRole xlinkShow xlinkTitle xlinkType xmlBase xmlLang xmlSpace
129 +y y1 y2 yChannelSelector z zoomAndPan
130 +
131 ```
docs/docs/ref-04-tags-and-attributes.zh-CN.md
+39 -13
@@ -54,17 +54,17 @@ React支持所有的 `data-*` 和 `aria-*` 以及下列的属性.
54 ```
55 accept acceptCharset accessKey action allowFullScreen allowTransparency alt
56 async autoComplete autoFocus autoPlay capture cellPadding cellSpacing challenge
57 -charSet checked classID className colSpan cols content contentEditable
57 +charSet checked cite classID className colSpan cols content contentEditable
58 contextMenu controls coords crossOrigin data dateTime default defer dir
59 disabled download draggable encType form formAction formEncType formMethod
60 formNoValidate formTarget frameBorder headers height hidden high href hrefLang
61 htmlFor httpEquiv icon id inputMode integrity is keyParams keyType kind label
62 lang list loop low manifest marginHeight marginWidth max maxLength media
63 mediaGroup method min minLength multiple muted name noValidate nonce open
64 -optimum pattern placeholder poster preload radioGroup readOnly rel required
65 -reversed role rowSpan rows sandbox scope scoped scrolling seamless selected
66 -shape size sizes span spellCheck src srcDoc srcLang srcSet start step style
67 -summary tabIndex target title type useMap value width wmode wrap
64 +optimum pattern placeholder poster preload profile radioGroup readOnly rel
65 +required reversed role rowSpan rows sandbox scope scoped scrolling seamless
66 +selected shape size sizes span spellCheck src srcDoc srcLang srcSet start step
67 +style summary tabIndex target title type useMap value width wmode wrap
68 ```
69
70 这些RDFa属性是被支持的 (许多RDFa属性和标准的HTML属性重叠,因此被从这个列表里去除):
@@ -87,12 +87,38 @@ about datatype inlist prefix property resource typeof vocab
87 ### SVG 属性
88
89 ```
90 -clipPath cx cy d dx dy fill fillOpacity fontFamily
91 -fontSize fx fy gradientTransform gradientUnits markerEnd
92 -markerMid markerStart offset opacity patternContentUnits
93 -patternUnits points preserveAspectRatio r rx ry spreadMethod
94 -stopColor stopOpacity stroke strokeDasharray strokeLinecap
95 -strokeOpacity strokeWidth textAnchor transform version
96 -viewBox x1 x2 x xlinkActuate xlinkArcrole xlinkHref xlinkRole
97 -xlinkShow xlinkTitle xlinkType xmlBase xmlLang xmlSpace y1 y2 y
90 +accentHeight accumulate additive alignmentBaseline allowReorder alphabetic
91 +amplitude arabicForm ascent attributeName attributeType autoReverse azimuth
92 +baseFrequency baseProfile baselineShift bbox begin bias by calcMode capHeight
93 +clip clipPath clipPathUnits clipRule colorInterpolation
94 +colorInterpolationFilters colorProfile colorRendering contentScriptType
95 +contentStyleType cursor cx cy d decelerate descent diffuseConstant direction
96 +display divisor dominantBaseline dur dx dy edgeMode elevation enableBackground
97 +end exponent externalResourcesRequired fill fillOpacity fillRule filter
98 +filterRes filterUnits floodColor floodOpacity focusable fontFamily fontSize
99 +fontSizeAdjust fontStretch fontStyle fontVariant fontWeight format from fx fy
100 +g1 g2 glyphName glyphOrientationHorizontal glyphOrientationVertical glyphRef
101 +gradientTransform gradientUnits hanging horizAdvX horizOriginX ideographic
102 +imageRendering in in2 intercept k k1 k2 k3 k4 kernelMatrix kernelUnitLength
103 +kerning keyPoints keySplines keyTimes lengthAdjust letterSpacing lightingColor
104 +limitingConeAngle local markerEnd markerHeight markerMid markerStart
105 +markerUnits markerWidth mask maskContentUnits maskUnits mathematical mode
106 +numOctaves offset opacity operator order orient orientation origin overflow
107 +overlinePosition overlineThickness paintOrder panose1 pathLength
108 +patternContentUnits patternTransform patternUnits pointerEvents points
109 +pointsAtX pointsAtY pointsAtZ preserveAlpha preserveAspectRatio primitiveUnits
110 +r radius refX refY renderingIntent repeatCount repeatDur requiredExtensions
111 +requiredFeatures restart result rotate rx ry scale seed shapeRendering slope
112 +spacing specularConstant specularExponent speed spreadMethod startOffset
113 +stdDeviation stemh stemv stitchTiles stopColor stopOpacity
114 +strikethroughPosition strikethroughThickness string stroke strokeDasharray
115 +strokeDashoffset strokeLinecap strokeLinejoin strokeMiterlimit strokeOpacity
116 +strokeWidth surfaceScale systemLanguage tableValues targetX targetY textAnchor
117 +textDecoration textLength textRendering to transform u1 u2 underlinePosition
118 +underlineThickness unicode unicodeBidi unicodeRange unitsPerEm vAlphabetic
119 +vHanging vIdeographic vMathematical values vectorEffect version vertAdvY
120 +vertOriginX vertOriginY viewBox viewTarget visibility widths wordSpacing
121 +writingMode x x1 x2 xChannelSelector xHeight xlinkActuate xlinkArcrole
122 +xlinkHref xlinkRole xlinkShow xlinkTitle xlinkType xmlBase xmlLang xmlSpace
123 +y y1 y2 yChannelSelector z zoomAndPan
124 ```