From 5cda4a63c251277990798ad8c605604a54aed5f2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Paul=20O=E2=80=99Shannessy?= Date: Wed, 6 Apr 2016 15:41:56 -0700 Subject: [PATCH] [docs] Update supported attrs, clarified what supported elements actually means --- docs/ref-04-tags-and-attributes.it-IT.md | 65 +++++++++++++++------ docs/ref-04-tags-and-attributes.ko-KR.md | 65 +++++++++++++++------ docs/ref-04-tags-and-attributes.md | 73 +++++++++++++++++------- docs/ref-04-tags-and-attributes.zh-CN.md | 52 ++++++++++++----- 4 files changed, 184 insertions(+), 71 deletions(-) diff --git a/docs/ref-04-tags-and-attributes.it-IT.md b/docs/ref-04-tags-and-attributes.it-IT.md index 087490c6..a8dc279f 100644 --- a/docs/ref-04-tags-and-attributes.it-IT.md +++ b/docs/ref-04-tags-and-attributes.it-IT.md @@ -53,17 +53,18 @@ Questi attributi standard sono supportati: ``` accept acceptCharset accessKey action allowFullScreen allowTransparency alt -async autoComplete autoFocus autoPlay capture cellPadding cellSpacing charSet -challenge checked classID className cols colSpan content contentEditable contextMenu -controls coords crossOrigin data dateTime defer dir disabled download draggable -encType form formAction formEncType formMethod formNoValidate formTarget frameBorder -headers height hidden high href hrefLang htmlFor httpEquiv icon id inputMode -keyParams keyType label lang list loop low manifest marginHeight marginWidth max -maxLength media mediaGroup method min minLength multiple muted name noValidate open -optimum pattern placeholder poster preload radioGroup readOnly rel required role -rows rowSpan sandbox scope scoped scrolling seamless selected shape size sizes -span spellCheck src srcDoc srcSet start step style summary tabIndex target title -type useMap value width wmode wrap +async autoComplete autoFocus autoPlay capture cellPadding cellSpacing challenge +charSet checked cite classID className colSpan cols content contentEditable +contextMenu controls coords crossOrigin data dateTime default defer dir +disabled download draggable encType form formAction formEncType formMethod +formNoValidate formTarget frameBorder headers height hidden high href hrefLang +htmlFor httpEquiv icon id inputMode integrity is keyParams keyType kind label +lang list loop low manifest marginHeight marginWidth max maxLength media +mediaGroup method min minLength multiple muted name noValidate nonce open +optimum pattern placeholder poster preload profile radioGroup readOnly rel +required reversed role rowSpan rows sandbox scope scoped scrolling seamless +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: @@ -79,12 +80,38 @@ Esiste anche l'attributo specifico di React `dangerouslySetInnerHTML` ([maggiori ### Attributi SVG ``` -clipPath cx cy d dx dy fill fillOpacity fontFamily -fontSize fx fy gradientTransform gradientUnits markerEnd -markerMid markerStart offset opacity patternContentUnits -patternUnits points preserveAspectRatio r rx ry spreadMethod -stopColor stopOpacity stroke strokeDasharray strokeLinecap -strokeOpacity strokeWidth textAnchor transform version -viewBox x1 x2 x xlinkActuate xlinkArcrole xlinkHref xlinkRole -xlinkShow xlinkTitle xlinkType xmlBase xmlLang xmlSpace y1 y2 y +accentHeight accumulate additive alignmentBaseline allowReorder alphabetic +amplitude arabicForm ascent attributeName attributeType autoReverse azimuth +baseFrequency baseProfile baselineShift bbox begin bias by calcMode capHeight +clip clipPath clipPathUnits clipRule colorInterpolation +colorInterpolationFilters colorProfile colorRendering contentScriptType +contentStyleType cursor cx cy d decelerate descent diffuseConstant direction +display divisor dominantBaseline dur dx dy edgeMode elevation enableBackground +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 ``` diff --git a/docs/ref-04-tags-and-attributes.ko-KR.md b/docs/ref-04-tags-and-attributes.ko-KR.md index a08d0cdb..4128af23 100644 --- a/docs/ref-04-tags-and-attributes.ko-KR.md +++ b/docs/ref-04-tags-and-attributes.ko-KR.md @@ -53,17 +53,18 @@ React는 모든 `data-*`, `aria-*` 어트리뷰트와 밑에 있는 모든 어 ``` accept acceptCharset accessKey action allowFullScreen allowTransparency alt -async autoComplete autoFocus autoPlay capture cellPadding cellSpacing charSet -challenge checked classID className cols colSpan content contentEditable contextMenu -controls coords crossOrigin data dateTime defer dir disabled download draggable -encType form formAction formEncType formMethod formNoValidate formTarget frameBorder -headers height hidden high href hrefLang htmlFor httpEquiv icon id inputMode -keyParams keyType label lang list loop low manifest marginHeight marginWidth max -maxLength media mediaGroup method min minLength multiple muted name noValidate open -optimum pattern placeholder poster preload radioGroup readOnly rel required role -rows rowSpan sandbox scope scoped scrolling seamless selected shape size sizes -span spellCheck src srcDoc srcSet start step style summary tabIndex target title -type useMap value width wmode wrap +async autoComplete autoFocus autoPlay capture cellPadding cellSpacing challenge +charSet checked cite classID className colSpan cols content contentEditable +contextMenu controls coords crossOrigin data dateTime default defer dir +disabled download draggable encType form formAction formEncType formMethod +formNoValidate formTarget frameBorder headers height hidden high href hrefLang +htmlFor httpEquiv icon id inputMode integrity is keyParams keyType kind label +lang list loop low manifest marginHeight marginWidth max maxLength media +mediaGroup method min minLength multiple muted name noValidate nonce open +optimum pattern placeholder poster preload profile radioGroup readOnly rel +required reversed role rowSpan rows sandbox scope scoped scrolling seamless +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 어트리뷰트 ``` -clipPath cx cy d dx dy fill fillOpacity fontFamily -fontSize fx fy gradientTransform gradientUnits markerEnd -markerMid markerStart offset opacity patternContentUnits -patternUnits points preserveAspectRatio r rx ry spreadMethod -stopColor stopOpacity stroke strokeDasharray strokeLinecap -strokeOpacity strokeWidth textAnchor transform version -viewBox x1 x2 x xlinkActuate xlinkArcrole xlinkHref xlinkRole -xlinkShow xlinkTitle xlinkType xmlBase xmlLang xmlSpace y1 y2 y +accentHeight accumulate additive alignmentBaseline allowReorder alphabetic +amplitude arabicForm ascent attributeName attributeType autoReverse azimuth +baseFrequency baseProfile baselineShift bbox begin bias by calcMode capHeight +clip clipPath clipPathUnits clipRule colorInterpolation +colorInterpolationFilters colorProfile colorRendering contentScriptType +contentStyleType cursor cx cy d decelerate descent diffuseConstant direction +display divisor dominantBaseline dur dx dy edgeMode elevation enableBackground +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 ``` diff --git a/docs/ref-04-tags-and-attributes.md b/docs/ref-04-tags-and-attributes.md index 6cb72072..8157582e 100644 --- a/docs/ref-04-tags-and-attributes.md +++ b/docs/ref-04-tags-and-attributes.md @@ -6,13 +6,17 @@ prev: component-specs.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 `` 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 @@ -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 ``` -### 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 @@ -54,17 +58,17 @@ These standard attributes are supported: ``` accept acceptCharset accessKey action allowFullScreen allowTransparency alt 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 disabled download draggable encType form formAction formEncType formMethod formNoValidate formTarget frameBorder headers height hidden high href hrefLang htmlFor httpEquiv icon id inputMode integrity is keyParams keyType kind label lang list loop low manifest marginHeight marginWidth max maxLength media mediaGroup method min minLength multiple muted name noValidate nonce open -optimum pattern placeholder poster preload radioGroup readOnly rel required -reversed role rowSpan rows sandbox scope scoped scrolling seamless selected -shape size sizes span spellCheck src srcDoc srcLang srcSet start step style -summary tabIndex target title type useMap value width wmode wrap +optimum pattern placeholder poster preload profile radioGroup readOnly rel +required reversed role rowSpan rows sandbox scope scoped scrolling seamless +selected shape size sizes span spellCheck src srcDoc srcLang srcSet start step +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): @@ -82,17 +86,46 @@ In addition, the following non-standard attributes are supported: - `unselectable` for Internet Explorer. - `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 ``` -clipPath cx cy d dx dy fill fillOpacity fontFamily -fontSize fx fy gradientTransform gradientUnits markerEnd -markerMid markerStart offset opacity patternContentUnits -patternUnits points preserveAspectRatio r rx ry spreadMethod -stopColor stopOpacity stroke strokeDasharray strokeLinecap -strokeOpacity strokeWidth textAnchor transform version -viewBox x1 x2 x xlinkActuate xlinkArcrole xlinkHref xlinkRole -xlinkShow xlinkTitle xlinkType xmlBase xmlLang xmlSpace y1 y2 y +accentHeight accumulate additive alignmentBaseline allowReorder alphabetic +amplitude arabicForm ascent attributeName attributeType autoReverse azimuth +baseFrequency baseProfile baselineShift bbox begin bias by calcMode capHeight +clip clipPath clipPathUnits clipRule colorInterpolation +colorInterpolationFilters colorProfile colorRendering contentScriptType +contentStyleType cursor cx cy d decelerate descent diffuseConstant direction +display divisor dominantBaseline dur dx dy edgeMode elevation enableBackground +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 + ``` diff --git a/docs/ref-04-tags-and-attributes.zh-CN.md b/docs/ref-04-tags-and-attributes.zh-CN.md index 42e79295..cccd97b7 100644 --- a/docs/ref-04-tags-and-attributes.zh-CN.md +++ b/docs/ref-04-tags-and-attributes.zh-CN.md @@ -54,17 +54,17 @@ React支持所有的 `data-*` 和 `aria-*` 以及下列的属性. ``` accept acceptCharset accessKey action allowFullScreen allowTransparency alt 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 disabled download draggable encType form formAction formEncType formMethod formNoValidate formTarget frameBorder headers height hidden high href hrefLang htmlFor httpEquiv icon id inputMode integrity is keyParams keyType kind label lang list loop low manifest marginHeight marginWidth max maxLength media mediaGroup method min minLength multiple muted name noValidate nonce open -optimum pattern placeholder poster preload radioGroup readOnly rel required -reversed role rowSpan rows sandbox scope scoped scrolling seamless selected -shape size sizes span spellCheck src srcDoc srcLang srcSet start step style -summary tabIndex target title type useMap value width wmode wrap +optimum pattern placeholder poster preload profile radioGroup readOnly rel +required reversed role rowSpan rows sandbox scope scoped scrolling seamless +selected shape size sizes span spellCheck src srcDoc srcLang srcSet start step +style summary tabIndex target title type useMap value width wmode wrap ``` 这些RDFa属性是被支持的 （许多RDFa属性和标准的HTML属性重叠，因此被从这个列表里去除）： @@ -87,12 +87,38 @@ about datatype inlist prefix property resource typeof vocab ### SVG 属性 ``` -clipPath cx cy d dx dy fill fillOpacity fontFamily -fontSize fx fy gradientTransform gradientUnits markerEnd -markerMid markerStart offset opacity patternContentUnits -patternUnits points preserveAspectRatio r rx ry spreadMethod -stopColor stopOpacity stroke strokeDasharray strokeLinecap -strokeOpacity strokeWidth textAnchor transform version -viewBox x1 x2 x xlinkActuate xlinkArcrole xlinkHref xlinkRole -xlinkShow xlinkTitle xlinkType xmlBase xmlLang xmlSpace y1 y2 y +accentHeight accumulate additive alignmentBaseline allowReorder alphabetic +amplitude arabicForm ascent attributeName attributeType autoReverse azimuth +baseFrequency baseProfile baselineShift bbox begin bias by calcMode capHeight +clip clipPath clipPathUnits clipRule colorInterpolation +colorInterpolationFilters colorProfile colorRendering contentScriptType +contentStyleType cursor cx cy d decelerate descent diffuseConstant direction +display divisor dominantBaseline dur dx dy edgeMode elevation enableBackground +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 ```