lukechilds
/
react.dev
mirror of https://github.com/lukechilds/react.dev.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Browse Source

Merge pull request #6428 from zpao/15-docs-attrs 

[docs] Update supported attrs, clarified what supported elements actually means
main
Paul O’Shannessy 9 years ago
parent
ceec4829b7 5cda4a63c2
commit
a06287b8f3
4 changed files with 184 additions and 71 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Unified View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 65
      docs/ref-04-tags-and-attributes.it-IT.md
  2. 65
      docs/ref-04-tags-and-attributes.ko-KR.md
  3. 73
      docs/ref-04-tags-and-attributes.md
  4. 52
      docs/ref-04-tags-and-attributes.zh-CN.md

65
docs/ref-04-tags-and-attributes.it-IT.md
View File

@ -53,17 +53,18 @@ Questi attributi standard sono supportati:
``` ```
accept acceptCharset accessKey action allowFullScreen allowTransparency alt accept acceptCharset accessKey action allowFullScreen allowTransparency alt
async autoComplete autoFocus autoPlay capture cellPadding cellSpacing charSet async autoComplete autoFocus autoPlay capture cellPadding cellSpacing challenge
challenge checked classID className cols colSpan content contentEditable contextMenu charSet checked cite classID className colSpan cols content contentEditable
controls coords crossOrigin data dateTime defer dir disabled download draggable contextMenu controls coords crossOrigin data dateTime default defer dir
encType form formAction formEncType formMethod formNoValidate formTarget frameBorder disabled download draggable encType form formAction formEncType formMethod
headers height hidden high href hrefLang htmlFor httpEquiv icon id inputMode formNoValidate formTarget frameBorder headers height hidden high href hrefLang
keyParams keyType label lang list loop low manifest marginHeight marginWidth max htmlFor httpEquiv icon id inputMode integrity is keyParams keyType kind label
maxLength media mediaGroup method min minLength multiple muted name noValidate open lang list loop low manifest marginHeight marginWidth max maxLength media
optimum pattern placeholder poster preload radioGroup readOnly rel required role mediaGroup method min minLength multiple muted name noValidate nonce open
rows rowSpan sandbox scope scoped scrolling seamless selected shape size sizes optimum pattern placeholder poster preload profile radioGroup readOnly rel
span spellCheck src srcDoc srcSet start step style summary tabIndex target title required reversed role rowSpan rows sandbox scope scoped scrolling seamless
type useMap value width wmode wrap selected shape size sizes span spellCheck src srcDoc srcLang srcSet start step
style summary tabIndex target title type useMap value width wmode wrap
``` ```
In aggiunta, i seguenti attributi non-standard sono supportati: In aggiunta, i seguenti attributi non-standard sono supportati:
@ -79,12 +80,38 @@ Esiste anche l'attributo specifico di React `dangerouslySetInnerHTML` ([maggiori
### Attributi SVG ### Attributi SVG
``` ```
clipPath cx cy d dx dy fill fillOpacity fontFamily accentHeight accumulate additive alignmentBaseline allowReorder alphabetic
fontSize fx fy gradientTransform gradientUnits markerEnd amplitude arabicForm ascent attributeName attributeType autoReverse azimuth
markerMid markerStart offset opacity patternContentUnits baseFrequency baseProfile baselineShift bbox begin bias by calcMode capHeight
patternUnits points preserveAspectRatio r rx ry spreadMethod clip clipPath clipPathUnits clipRule colorInterpolation
stopColor stopOpacity stroke strokeDasharray strokeLinecap colorInterpolationFilters colorProfile colorRendering contentScriptType
strokeOpacity strokeWidth textAnchor transform version contentStyleType cursor cx cy d decelerate descent diffuseConstant direction
viewBox x1 x2 x xlinkActuate xlinkArcrole xlinkHref xlinkRole display divisor dominantBaseline dur dx dy edgeMode elevation enableBackground
xlinkShow xlinkTitle xlinkType xmlBase xmlLang xmlSpace y1 y2 y end exponent externalResourcesRequired fill fillOpacity fillRule filter
filterRes filterUnits floodColor floodOpacity focusable fontFamily fontSize
fontSizeAdjust fontStretch fontStyle fontVariant fontWeight format from fx fy
g1 g2 glyphName glyphOrientationHorizontal glyphOrientationVertical glyphRef
gradientTransform gradientUnits hanging horizAdvX horizOriginX ideographic
imageRendering in in2 intercept k k1 k2 k3 k4 kernelMatrix kernelUnitLength
kerning keyPoints keySplines keyTimes lengthAdjust letterSpacing lightingColor
limitingConeAngle local markerEnd markerHeight markerMid markerStart
markerUnits markerWidth mask maskContentUnits maskUnits mathematical mode
numOctaves offset opacity operator order orient orientation origin overflow
overlinePosition overlineThickness paintOrder panose1 pathLength
patternContentUnits patternTransform patternUnits pointerEvents points
pointsAtX pointsAtY pointsAtZ preserveAlpha preserveAspectRatio primitiveUnits
r radius refX refY renderingIntent repeatCount repeatDur requiredExtensions
requiredFeatures restart result rotate rx ry scale seed shapeRendering slope
spacing specularConstant specularExponent speed spreadMethod startOffset
stdDeviation stemh stemv stitchTiles stopColor stopOpacity
strikethroughPosition strikethroughThickness string stroke strokeDasharray
strokeDashoffset strokeLinecap strokeLinejoin strokeMiterlimit strokeOpacity
strokeWidth surfaceScale systemLanguage tableValues targetX targetY textAnchor
textDecoration textLength textRendering to transform u1 u2 underlinePosition
underlineThickness unicode unicodeBidi unicodeRange unitsPerEm vAlphabetic
vHanging vIdeographic vMathematical values vectorEffect version vertAdvY
vertOriginX vertOriginY viewBox viewTarget visibility widths wordSpacing
writingMode x x1 x2 xChannelSelector xHeight xlinkActuate xlinkArcrole
xlinkHref xlinkRole xlinkShow xlinkTitle xlinkType xmlBase xmlLang xmlSpace
y y1 y2 yChannelSelector z zoomAndPan
``` ```

65
docs/ref-04-tags-and-attributes.ko-KR.md
View File

@ -53,17 +53,18 @@ React는 모든 `data-*`, `aria-*` 어트리뷰트와 밑에 있는 모든 어
``` ```
accept acceptCharset accessKey action allowFullScreen allowTransparency alt accept acceptCharset accessKey action allowFullScreen allowTransparency alt
async autoComplete autoFocus autoPlay capture cellPadding cellSpacing charSet async autoComplete autoFocus autoPlay capture cellPadding cellSpacing challenge
challenge checked classID className cols colSpan content contentEditable contextMenu charSet checked cite classID className colSpan cols content contentEditable
controls coords crossOrigin data dateTime defer dir disabled download draggable contextMenu controls coords crossOrigin data dateTime default defer dir
encType form formAction formEncType formMethod formNoValidate formTarget frameBorder disabled download draggable encType form formAction formEncType formMethod
headers height hidden high href hrefLang htmlFor httpEquiv icon id inputMode formNoValidate formTarget frameBorder headers height hidden high href hrefLang
keyParams keyType label lang list loop low manifest marginHeight marginWidth max htmlFor httpEquiv icon id inputMode integrity is keyParams keyType kind label
maxLength media mediaGroup method min minLength multiple muted name noValidate open lang list loop low manifest marginHeight marginWidth max maxLength media
optimum pattern placeholder poster preload radioGroup readOnly rel required role mediaGroup method min minLength multiple muted name noValidate nonce open
rows rowSpan sandbox scope scoped scrolling seamless selected shape size sizes optimum pattern placeholder poster preload profile radioGroup readOnly rel
span spellCheck src srcDoc srcSet start step style summary tabIndex target title required reversed role rowSpan rows sandbox scope scoped scrolling seamless
type useMap value width wmode wrap selected shape size sizes span spellCheck src srcDoc srcLang srcSet start step
style summary tabIndex target title type useMap value width wmode wrap
``` ```
덧붙여, 이런 비표준 어트리뷰트도 지원됩니다. 덧붙여, 이런 비표준 어트리뷰트도 지원됩니다.
@ -79,12 +80,38 @@ type useMap value width wmode wrap
### SVG 어트리뷰트 ### SVG 어트리뷰트
``` ```
clipPath cx cy d dx dy fill fillOpacity fontFamily accentHeight accumulate additive alignmentBaseline allowReorder alphabetic
fontSize fx fy gradientTransform gradientUnits markerEnd amplitude arabicForm ascent attributeName attributeType autoReverse azimuth
markerMid markerStart offset opacity patternContentUnits baseFrequency baseProfile baselineShift bbox begin bias by calcMode capHeight
patternUnits points preserveAspectRatio r rx ry spreadMethod clip clipPath clipPathUnits clipRule colorInterpolation
stopColor stopOpacity stroke strokeDasharray strokeLinecap colorInterpolationFilters colorProfile colorRendering contentScriptType
strokeOpacity strokeWidth textAnchor transform version contentStyleType cursor cx cy d decelerate descent diffuseConstant direction
viewBox x1 x2 x xlinkActuate xlinkArcrole xlinkHref xlinkRole display divisor dominantBaseline dur dx dy edgeMode elevation enableBackground
xlinkShow xlinkTitle xlinkType xmlBase xmlLang xmlSpace y1 y2 y end exponent externalResourcesRequired fill fillOpacity fillRule filter
filterRes filterUnits floodColor floodOpacity focusable fontFamily fontSize
fontSizeAdjust fontStretch fontStyle fontVariant fontWeight format from fx fy
g1 g2 glyphName glyphOrientationHorizontal glyphOrientationVertical glyphRef
gradientTransform gradientUnits hanging horizAdvX horizOriginX ideographic
imageRendering in in2 intercept k k1 k2 k3 k4 kernelMatrix kernelUnitLength
kerning keyPoints keySplines keyTimes lengthAdjust letterSpacing lightingColor
limitingConeAngle local markerEnd markerHeight markerMid markerStart
markerUnits markerWidth mask maskContentUnits maskUnits mathematical mode
numOctaves offset opacity operator order orient orientation origin overflow
overlinePosition overlineThickness paintOrder panose1 pathLength
patternContentUnits patternTransform patternUnits pointerEvents points
pointsAtX pointsAtY pointsAtZ preserveAlpha preserveAspectRatio primitiveUnits
r radius refX refY renderingIntent repeatCount repeatDur requiredExtensions
requiredFeatures restart result rotate rx ry scale seed shapeRendering slope
spacing specularConstant specularExponent speed spreadMethod startOffset
stdDeviation stemh stemv stitchTiles stopColor stopOpacity
strikethroughPosition strikethroughThickness string stroke strokeDasharray
strokeDashoffset strokeLinecap strokeLinejoin strokeMiterlimit strokeOpacity
strokeWidth surfaceScale systemLanguage tableValues targetX targetY textAnchor
textDecoration textLength textRendering to transform u1 u2 underlinePosition
underlineThickness unicode unicodeBidi unicodeRange unitsPerEm vAlphabetic
vHanging vIdeographic vMathematical values vectorEffect version vertAdvY
vertOriginX vertOriginY viewBox viewTarget visibility widths wordSpacing
writingMode x x1 x2 xChannelSelector xHeight xlinkActuate xlinkArcrole
xlinkHref xlinkRole xlinkShow xlinkTitle xlinkType xmlBase xmlLang xmlSpace
y y1 y2 yChannelSelector z zoomAndPan
``` ```

73
docs/ref-04-tags-and-attributes.md
View File

@ -6,13 +6,17 @@ prev: component-specs.html
next: events.html next: events.html
--- ---
## Supported Tags ## Supported Elements
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). 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.
### HTML Elements ### Using `React.DOM` Factory methods
The following HTML elements are supported: 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.
#### HTML Elements
The following HTML elements are supported in `React.DOM.*`:
``` ```
a abbr address area article aside audio b base bdi bdo big blockquote body br 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
tfoot th thead time title tr track u ul var video wbr tfoot th thead time title tr track u ul var video wbr
``` ```
### SVG elements #### SVG elements
The following SVG elements are supported: The following SVG elements are supported in `React.DOM.*`:
``` ```
circle clipPath defs ellipse g image line linearGradient mask path pattern circle clipPath defs ellipse g image line linearGradient mask path pattern
@ -54,17 +58,17 @@ These standard attributes are supported:
``` ```
accept acceptCharset accessKey action allowFullScreen allowTransparency alt accept acceptCharset accessKey action allowFullScreen allowTransparency alt
async autoComplete autoFocus autoPlay capture cellPadding cellSpacing challenge async autoComplete autoFocus autoPlay capture cellPadding cellSpacing challenge
charSet checked classID className colSpan cols content contentEditable charSet checked cite classID className colSpan cols content contentEditable
contextMenu controls coords crossOrigin data dateTime default defer dir contextMenu controls coords crossOrigin data dateTime default defer dir
disabled download draggable encType form formAction formEncType formMethod disabled download draggable encType form formAction formEncType formMethod
formNoValidate formTarget frameBorder headers height hidden high href hrefLang formNoValidate formTarget frameBorder headers height hidden high href hrefLang
htmlFor httpEquiv icon id inputMode integrity is keyParams keyType kind label htmlFor httpEquiv icon id inputMode integrity is keyParams keyType kind label
lang list loop low manifest marginHeight marginWidth max maxLength media lang list loop low manifest marginHeight marginWidth max maxLength media
mediaGroup method min minLength multiple muted name noValidate nonce open mediaGroup method min minLength multiple muted name noValidate nonce open
optimum pattern placeholder poster preload radioGroup readOnly rel required optimum pattern placeholder poster preload profile radioGroup readOnly rel
reversed role rowSpan rows sandbox scope scoped scrolling seamless selected required reversed role rowSpan rows sandbox scope scoped scrolling seamless
shape size sizes span spellCheck src srcDoc srcLang srcSet start step style selected shape size sizes span spellCheck src srcDoc srcLang srcSet start step
summary tabIndex target title type useMap value width wmode wrap style summary tabIndex target title type useMap value width wmode wrap
``` ```
These RDFa attributes are supported (several RDFa attributes overlap with standard HTML attributes and thus are excluded from this list): 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:
- `unselectable` for Internet Explorer. - `unselectable` for Internet Explorer.
- `results autoSave` for WebKit/Blink input fields of type `search`. - `results autoSave` for WebKit/Blink input fields of type `search`.
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. There is also 2 React-specific attributes:
- `dangerouslySetInnerHTML` ([more here](/react/docs/special-non-dom-attributes.html)), used for directly inserting HTML strings into a component.
- `suppressContentEditableWarning`, used to suppress the warning when using `contentEditable` and `children`.
### SVG Attributes ### SVG Attributes
``` ```
clipPath cx cy d dx dy fill fillOpacity fontFamily accentHeight accumulate additive alignmentBaseline allowReorder alphabetic
fontSize fx fy gradientTransform gradientUnits markerEnd amplitude arabicForm ascent attributeName attributeType autoReverse azimuth
markerMid markerStart offset opacity patternContentUnits baseFrequency baseProfile baselineShift bbox begin bias by calcMode capHeight
patternUnits points preserveAspectRatio r rx ry spreadMethod clip clipPath clipPathUnits clipRule colorInterpolation
stopColor stopOpacity stroke strokeDasharray strokeLinecap colorInterpolationFilters colorProfile colorRendering contentScriptType
strokeOpacity strokeWidth textAnchor transform version contentStyleType cursor cx cy d decelerate descent diffuseConstant direction
viewBox x1 x2 x xlinkActuate xlinkArcrole xlinkHref xlinkRole display divisor dominantBaseline dur dx dy edgeMode elevation enableBackground
xlinkShow xlinkTitle xlinkType xmlBase xmlLang xmlSpace y1 y2 y end exponent externalResourcesRequired fill fillOpacity fillRule filter
filterRes filterUnits floodColor floodOpacity focusable fontFamily fontSize
fontSizeAdjust fontStretch fontStyle fontVariant fontWeight format from fx fy
g1 g2 glyphName glyphOrientationHorizontal glyphOrientationVertical glyphRef
gradientTransform gradientUnits hanging horizAdvX horizOriginX ideographic
imageRendering in in2 intercept k k1 k2 k3 k4 kernelMatrix kernelUnitLength
kerning keyPoints keySplines keyTimes lengthAdjust letterSpacing lightingColor
limitingConeAngle local markerEnd markerHeight markerMid markerStart
markerUnits markerWidth mask maskContentUnits maskUnits mathematical mode
numOctaves offset opacity operator order orient orientation origin overflow
overlinePosition overlineThickness paintOrder panose1 pathLength
patternContentUnits patternTransform patternUnits pointerEvents points
pointsAtX pointsAtY pointsAtZ preserveAlpha preserveAspectRatio primitiveUnits
r radius refX refY renderingIntent repeatCount repeatDur requiredExtensions
requiredFeatures restart result rotate rx ry scale seed shapeRendering slope
spacing specularConstant specularExponent speed spreadMethod startOffset
stdDeviation stemh stemv stitchTiles stopColor stopOpacity
strikethroughPosition strikethroughThickness string stroke strokeDasharray
strokeDashoffset strokeLinecap strokeLinejoin strokeMiterlimit strokeOpacity
strokeWidth surfaceScale systemLanguage tableValues targetX targetY textAnchor
textDecoration textLength textRendering to transform u1 u2 underlinePosition
underlineThickness unicode unicodeBidi unicodeRange unitsPerEm vAlphabetic
vHanging vIdeographic vMathematical values vectorEffect version vertAdvY
vertOriginX vertOriginY viewBox viewTarget visibility widths wordSpacing
writingMode x x1 x2 xChannelSelector xHeight xlinkActuate xlinkArcrole
xlinkHref xlinkRole xlinkShow xlinkTitle xlinkType xmlBase xmlLang xmlSpace
y y1 y2 yChannelSelector z zoomAndPan
``` ```

52
docs/ref-04-tags-and-attributes.zh-CN.md
View File

@ -54,17 +54,17 @@ React支持所有的 `data-*` 和 `aria-*` 以及下列的属性.
``` ```
accept acceptCharset accessKey action allowFullScreen allowTransparency alt accept acceptCharset accessKey action allowFullScreen allowTransparency alt
async autoComplete autoFocus autoPlay capture cellPadding cellSpacing challenge async autoComplete autoFocus autoPlay capture cellPadding cellSpacing challenge
charSet checked classID className colSpan cols content contentEditable charSet checked cite classID className colSpan cols content contentEditable
contextMenu controls coords crossOrigin data dateTime default defer dir contextMenu controls coords crossOrigin data dateTime default defer dir
disabled download draggable encType form formAction formEncType formMethod disabled download draggable encType form formAction formEncType formMethod
formNoValidate formTarget frameBorder headers height hidden high href hrefLang formNoValidate formTarget frameBorder headers height hidden high href hrefLang
htmlFor httpEquiv icon id inputMode integrity is keyParams keyType kind label htmlFor httpEquiv icon id inputMode integrity is keyParams keyType kind label
lang list loop low manifest marginHeight marginWidth max maxLength media lang list loop low manifest marginHeight marginWidth max maxLength media
mediaGroup method min minLength multiple muted name noValidate nonce open mediaGroup method min minLength multiple muted name noValidate nonce open
optimum pattern placeholder poster preload radioGroup readOnly rel required optimum pattern placeholder poster preload profile radioGroup readOnly rel
reversed role rowSpan rows sandbox scope scoped scrolling seamless selected required reversed role rowSpan rows sandbox scope scoped scrolling seamless
shape size sizes span spellCheck src srcDoc srcLang srcSet start step style selected shape size sizes span spellCheck src srcDoc srcLang srcSet start step
summary tabIndex target title type useMap value width wmode wrap style summary tabIndex target title type useMap value width wmode wrap
``` ```
这些RDFa属性是被支持的 （许多RDFa属性和标准的HTML属性重叠，因此被从这个列表里去除）： 这些RDFa属性是被支持的 （许多RDFa属性和标准的HTML属性重叠，因此被从这个列表里去除）：
@ -87,12 +87,38 @@ about datatype inlist prefix property resource typeof vocab
### SVG 属性 ### SVG 属性
``` ```
clipPath cx cy d dx dy fill fillOpacity fontFamily accentHeight accumulate additive alignmentBaseline allowReorder alphabetic
fontSize fx fy gradientTransform gradientUnits markerEnd amplitude arabicForm ascent attributeName attributeType autoReverse azimuth
markerMid markerStart offset opacity patternContentUnits baseFrequency baseProfile baselineShift bbox begin bias by calcMode capHeight
patternUnits points preserveAspectRatio r rx ry spreadMethod clip clipPath clipPathUnits clipRule colorInterpolation
stopColor stopOpacity stroke strokeDasharray strokeLinecap colorInterpolationFilters colorProfile colorRendering contentScriptType
strokeOpacity strokeWidth textAnchor transform version contentStyleType cursor cx cy d decelerate descent diffuseConstant direction
viewBox x1 x2 x xlinkActuate xlinkArcrole xlinkHref xlinkRole display divisor dominantBaseline dur dx dy edgeMode elevation enableBackground
xlinkShow xlinkTitle xlinkType xmlBase xmlLang xmlSpace y1 y2 y end exponent externalResourcesRequired fill fillOpacity fillRule filter
filterRes filterUnits floodColor floodOpacity focusable fontFamily fontSize
fontSizeAdjust fontStretch fontStyle fontVariant fontWeight format from fx fy
g1 g2 glyphName glyphOrientationHorizontal glyphOrientationVertical glyphRef
gradientTransform gradientUnits hanging horizAdvX horizOriginX ideographic
imageRendering in in2 intercept k k1 k2 k3 k4 kernelMatrix kernelUnitLength
kerning keyPoints keySplines keyTimes lengthAdjust letterSpacing lightingColor
limitingConeAngle local markerEnd markerHeight markerMid markerStart
markerUnits markerWidth mask maskContentUnits maskUnits mathematical mode
numOctaves offset opacity operator order orient orientation origin overflow
overlinePosition overlineThickness paintOrder panose1 pathLength
patternContentUnits patternTransform patternUnits pointerEvents points
pointsAtX pointsAtY pointsAtZ preserveAlpha preserveAspectRatio primitiveUnits
r radius refX refY renderingIntent repeatCount repeatDur requiredExtensions
requiredFeatures restart result rotate rx ry scale seed shapeRendering slope
spacing specularConstant specularExponent speed spreadMethod startOffset
stdDeviation stemh stemv stitchTiles stopColor stopOpacity
strikethroughPosition strikethroughThickness string stroke strokeDasharray
strokeDashoffset strokeLinecap strokeLinejoin strokeMiterlimit strokeOpacity
strokeWidth surfaceScale systemLanguage tableValues targetX targetY textAnchor
textDecoration textLength textRendering to transform u1 u2 underlinePosition
underlineThickness unicode unicodeBidi unicodeRange unitsPerEm vAlphabetic
vHanging vIdeographic vMathematical values vectorEffect version vertAdvY
vertOriginX vertOriginY viewBox viewTarget visibility widths wordSpacing
writingMode x x1 x2 xChannelSelector xHeight xlinkActuate xlinkArcrole
xlinkHref xlinkRole xlinkShow xlinkTitle xlinkType xmlBase xmlLang xmlSpace
y y1 y2 yChannelSelector z zoomAndPan
``` ```

Write Preview
Loading…
Cancel
Save