diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-canvasrenderingcontext2d.md b/zh-cn/application-dev/reference/arkui-ts/ts-canvasrenderingcontext2d.md index 1e4a0f358d76a285de40d13f7ee59bbcc366b28f..cf4a76859576bab80b452fc8d8b1958f59f291b0 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-canvasrenderingcontext2d.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-canvasrenderingcontext2d.md @@ -16,9 +16,9 @@ CanvasRenderingContext2D(settings?: RenderingContextSettings) **å‚数:** -| å‚æ•°å | å‚数类型 | å¿…å¡« | å‚æ•°æè¿° | -| ------- | ---------------------------------------- | ---- | ---------------------------------------- | -| setting | [RenderingContextSettings](#renderingcontextsettings) | å¦ | è§[RenderingContextSettings](#renderingcontextsettings)。 | +| å‚æ•°å | å‚数类型 | å¿…å¡« | å‚æ•°æè¿° | +| -------- | ---------------------------------------- | ---- | ---------------------------------------- | +| settings | [RenderingContextSettings](#renderingcontextsettings) | å¦ | è§[RenderingContextSettings](#renderingcontextsettings)。 | ### RenderingContextSettings @@ -38,30 +38,30 @@ RenderingContextSettings(antialias?: boolean) ## 属性 -| å称 | 类型 | æè¿° | -| ----------------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | -| [fillStyle](#fillstyle) | string \|number<sup>10+</sup> \|[CanvasGradient](ts-components-canvas-canvasgradient.md) \| [CanvasPattern](ts-components-canvas-canvaspattern.md#canvaspattern) | 指定绘制的填充色。<br/>- 类型为string时,表示设置填充区域的颜色。<br/>- 类型为number时,表示设置填充区域的颜色。<br/>- 类型为CanvasGradient时,表示æ¸å˜å¯¹è±¡ï¼Œä½¿ç”¨[createLinearGradient](#createlineargradient)方法创建。<br/>- 类型为CanvasPattern时,使用[createPattern](#createpattern)方法创建。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [lineWidth](#linewidth) | number | 设置绘制线æ¡çš„宽度。 | -| [strokeStyle](#strokestyle) | string \|number<sup>10+</sup> \|[CanvasGradient](ts-components-canvas-canvasgradient.md) \| [CanvasPattern](ts-components-canvas-canvaspattern.md#canvaspattern) | 设置æ边的颜色。<br/>- 类型为string时,表示设置æ边使用的颜色。<br/>- 类型为number时,表示设置æ边使用的颜色。<br/>- 类型为CanvasGradient时,表示æ¸å˜å¯¹è±¡ï¼Œä½¿ç”¨[createLinearGradient](#createlineargradient)方法创建。<br/>- 类型为CanvasPattern时,使用[createPattern](#createpattern)方法创建。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [lineCap](#linecap) | CanvasLineCap | æŒ‡å®šçº¿ç«¯ç‚¹çš„æ ·å¼ï¼Œå¯é€‰å€¼ä¸ºï¼š<br/>- 'butt':线端点以方形结æŸã€‚<br/>- 'round':线端点以圆形结æŸã€‚<br/>- 'square':线端点以方形结æŸï¼Œè¯¥æ ·å¼ä¸‹ä¼šå¢žåŠ 一个长度和线段厚度相åŒï¼Œå®½åº¦æ˜¯çº¿æ®µåŽšåº¦ä¸€åŠçš„矩形。<br/>默认值:'butt'<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [lineJoin](#linejoin) | CanvasLineJoin | æŒ‡å®šçº¿æ®µé—´ç›¸äº¤çš„äº¤ç‚¹æ ·å¼ï¼Œå¯é€‰å€¼ä¸ºï¼š<br/>- 'round':在线段相连处绘制一个扇形,扇形的圆角åŠå¾„是线段的宽度。<br/>- 'bevel':在线段相连处使用三角形为底填充, æ¯ä¸ªéƒ¨åˆ†çŸ©å½¢æ‹è§’独立。<br/>- 'miter':在相连部分的外边缘处进行延伸,使其相交于一点,形æˆä¸€ä¸ªè±å½¢åŒºåŸŸï¼Œè¯¥å±žæ€§å¯ä»¥é€šè¿‡è®¾ç½®miterLimit属性展现效果。<br/>默认值:'miter'<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [miterLimit](#miterlimit) | number | 设置斜接é¢é™åˆ¶å€¼ï¼Œè¯¥å€¼æŒ‡å®šäº†çº¿æ¡ç›¸äº¤å¤„内角和外角的è·ç¦»ã€‚ <br/>默认值:10<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [font](#font) | string | 设置文本绘制ä¸çš„å—ä½“æ ·å¼ã€‚<br/>è¯æ³•ï¼šctx.font='font-size font-family'<br/>- font-size(å¯é€‰),指定å—å·å’Œè¡Œé«˜ï¼Œå•ä½åªæ”¯æŒpx。<br/>- font-family(å¯é€‰),指定å—体系列。<br/>è¯æ³•ï¼šctx.font='font-style font-weight font-size font-family'<br/>- font-style(å¯é€‰),用于指定å—ä½“æ ·å¼ï¼Œæ”¯æŒå¦‚ä¸‹å‡ ç§æ ·å¼ï¼š'normal','italic'。<br/>- font-weight(å¯é€‰),用于指定å—体的粗细,支æŒå¦‚ä¸‹å‡ ç§ç±»åž‹ï¼š'normal', 'bold', 'bolder', 'lighter', 100, 200, 300, 400, 500, 600, 700, 800, 900。<br/>- font-size(å¯é€‰),指定å—å·å’Œè¡Œé«˜ï¼Œå•ä½æ”¯æŒpxã€vp。使用时需è¦æ·»åŠ å•ä½ã€‚<br/>- font-family(å¯é€‰),指定å—体系列,支æŒå¦‚ä¸‹å‡ ç§ç±»åž‹ï¼š'sans-serif', 'serif', 'monospace'。<br/>默认值:'normal normal 14px sans-serif'<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [textAlign](#textalign) | CanvasTextAlign | 设置文本绘制ä¸çš„文本对é½æ–¹å¼ï¼Œå¯é€‰å€¼ä¸ºï¼š<br/>- 'left':文本左对é½ã€‚<br/>- 'right':文本å³å¯¹é½ã€‚<br/>- 'center':文本居ä¸å¯¹é½ã€‚<br/>- 'start':文本对é½ç•Œçº¿å¼€å§‹çš„地方。<br/>- 'end':文本对é½ç•Œçº¿ç»“æŸçš„地方。<br/>ltr布局模å¼ä¸‹'start'å’Œ'left'一致,rtl布局模å¼ä¸‹'start'å’Œ'right'一致·。<br/>默认值:'left'<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [textBaseline](#textbaseline) | CanvasTextBaseline | 设置文本绘制ä¸çš„水平对é½æ–¹å¼ï¼Œå¯é€‰å€¼ä¸ºï¼š<br/>- 'alphabetic'ï¼šæ–‡æœ¬åŸºçº¿æ˜¯æ ‡å‡†çš„å—æ¯åŸºçº¿ã€‚<br/>- 'top':文本基线在文本å—的顶部。<br/>- 'hanging':文本基线是悬挂基线。<br/>- 'middle':文本基线在文本å—çš„ä¸é—´ã€‚<br/>- 'ideographic':文å—基线是表æ„å—基线;如果å—符本身超出了alphabetic基线,那么ideograhpic基线ä½ç½®åœ¨å—符本身的底部。<br/>- 'bottom':文本基线在文本å—的底部。 与ideographic基线的区别在于ideographic基线ä¸éœ€è¦è€ƒè™‘下行å—æ¯ã€‚<br/>默认值:'alphabetic'<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [globalAlpha](#globalalpha) | number | 设置é€æ˜Žåº¦ï¼Œ0.0为完全é€æ˜Žï¼Œ1.0为完全ä¸é€æ˜Žã€‚<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [lineDashOffset](#linedashoffset) | number | 设置画布的虚线å移é‡ï¼Œç²¾åº¦ä¸ºfloat。 <br/>默认值:0.0<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [globalCompositeOperation](#globalcompositeoperation) | string | 设置åˆæˆæ“作的方å¼ã€‚类型å—段å¯é€‰å€¼æœ‰'source-over','source-atop','source-in','source-out','destination-over','destination-atop','destination-in','destination-out','lighter','copy','xor'。<br/>默认值:'source-over'<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [shadowBlur](#shadowblur) | number | 设置绘制阴影时的模糊级别,值越大越模糊,精度为float。 <br/>默认值:0.0<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [shadowColor](#shadowcolor) | string | 设置绘制阴影时的阴影颜色。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [shadowOffsetX](#shadowoffsetx) | number | 设置绘制阴影时和原有对象的水平å移值。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [shadowOffsetY](#shadowoffsety) | number | 设置绘制阴影时和原有对象的垂直å移值。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [imageSmoothingEnabled](#imagesmoothingenabled) | boolean | 用于设置绘制图片时是å¦è¿›è¡Œå›¾åƒå¹³æ»‘度调整,true为å¯ç”¨ï¼Œfalse为ä¸å¯ç”¨ã€‚ <br/>默认值:true<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [height](#height) | number | 组件高度。 <br/>å•ä½ï¼švp<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [width](#width) | number | 组件宽度。 <br/>å•ä½ï¼švp<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [imageSmoothingQuality](#imagesmoothingquality) |ImageSmoothingQuality | imageSmoothingEnabled为true时,用于设置图åƒå¹³æ»‘度。å¯é€‰å€¼ä¸ºï¼š<br/>- 'low':低画质<br/>- 'medium':ä¸ç”»è´¨<br/>- 'high':高画质。<br/>默认值:low<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [direction](#direction) |CanvasDirection | 用于设置绘制文å—时使用的文å—æ–¹å‘。å¯é€‰å€¼ä¸ºï¼š<br/>- 'inherit':继承canvas组件已设定的文本方å‘<br/>- 'ltr':从左往å³<br/>- 'rtl':从å³å¾€å·¦ã€‚<br/>默认值:inherit<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [filter](#filter) |string | 用于设置图åƒçš„滤镜。支æŒçš„滤镜效果如下:<br/>- 'none': æ— æ»¤é•œæ•ˆæžœ<br/>- 'blur':给图åƒè®¾ç½®é«˜æ–¯æ¨¡ç³Š<br/>- 'brightness':给图片应用一ç§çº¿æ€§ä¹˜æ³•ï¼Œä½¿å…¶çœ‹èµ·æ¥æ›´äº®æˆ–æ›´æš—<br/>- 'contrast':调整图åƒçš„对比度<br/>- 'grayscale':将图åƒè½¬æ¢ä¸ºç°åº¦å›¾åƒ<br/>- 'hue-rotate':给图åƒåº”用色相旋转<br/>- 'invert':å转输入图åƒ<br/>- 'opacity':转化图åƒçš„é€æ˜Žç¨‹åº¦<br/>- 'saturate':转æ¢å›¾åƒé¥±å’Œåº¦<br/>- 'sepia':将图åƒè½¬æ¢ä¸ºæ·±è¤è‰²<br/>默认值:'none'<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| å称 | 类型 | æè¿° | +| ---------------------------------------- | ---------------------------------------- | ---------------------------------------- | +| [fillStyle](#fillstyle) | string \|number<sup>10+</sup> \|[CanvasGradient](ts-components-canvas-canvasgradient.md) \| [CanvasPattern](ts-components-canvas-canvaspattern.md#canvaspattern) | 指定绘制的填充色。<br/>- 类型为string时,表示设置填充区域的颜色。<br/>- 类型为number时,表示设置填充区域的颜色。<br/>- 类型为CanvasGradient时,表示æ¸å˜å¯¹è±¡ï¼Œä½¿ç”¨[createLinearGradient](#createlineargradient)方法创建。<br/>- 类型为CanvasPattern时,使用[createPattern](#createpattern)方法创建。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [lineWidth](#linewidth) | number | 设置绘制线æ¡çš„宽度。 | +| [strokeStyle](#strokestyle) | string \|number<sup>10+</sup> \|[CanvasGradient](ts-components-canvas-canvasgradient.md) \| [CanvasPattern](ts-components-canvas-canvaspattern.md#canvaspattern) | 设置æ边的颜色。<br/>- 类型为string时,表示设置æ边使用的颜色。<br/>- 类型为number时,表示设置æ边使用的颜色。<br/>- 类型为CanvasGradient时,表示æ¸å˜å¯¹è±¡ï¼Œä½¿ç”¨[createLinearGradient](#createlineargradient)方法创建。<br/>- 类型为CanvasPattern时,使用[createPattern](#createpattern)方法创建。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [lineCap](#linecap) | CanvasLineCap | æŒ‡å®šçº¿ç«¯ç‚¹çš„æ ·å¼ï¼Œå¯é€‰å€¼ä¸ºï¼š<br/>- 'butt':线端点以方形结æŸã€‚<br/>- 'round':线端点以圆形结æŸã€‚<br/>- 'square':线端点以方形结æŸï¼Œè¯¥æ ·å¼ä¸‹ä¼šå¢žåŠ 一个长度和线段厚度相åŒï¼Œå®½åº¦æ˜¯çº¿æ®µåŽšåº¦ä¸€åŠçš„矩形。<br/>默认值:'butt'<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [lineJoin](#linejoin) | CanvasLineJoin | æŒ‡å®šçº¿æ®µé—´ç›¸äº¤çš„äº¤ç‚¹æ ·å¼ï¼Œå¯é€‰å€¼ä¸ºï¼š<br/>- 'round':在线段相连处绘制一个扇形,扇形的圆角åŠå¾„是线段的宽度。<br/>- 'bevel':在线段相连处使用三角形为底填充, æ¯ä¸ªéƒ¨åˆ†çŸ©å½¢æ‹è§’独立。<br/>- 'miter':在相连部分的外边缘处进行延伸,使其相交于一点,形æˆä¸€ä¸ªè±å½¢åŒºåŸŸï¼Œè¯¥å±žæ€§å¯ä»¥é€šè¿‡è®¾ç½®miterLimit属性展现效果。<br/>默认值:'miter'<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [miterLimit](#miterlimit) | number | 设置斜接é¢é™åˆ¶å€¼ï¼Œè¯¥å€¼æŒ‡å®šäº†çº¿æ¡ç›¸äº¤å¤„内角和外角的è·ç¦»ã€‚ <br/>默认值:10<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [font](#font) | string | 设置文本绘制ä¸çš„å—ä½“æ ·å¼ã€‚<br/>è¯æ³•ï¼šctx.font='font-size font-family'<br/>- font-size(å¯é€‰),指定å—å·å’Œè¡Œé«˜ï¼Œå•ä½åªæ”¯æŒpx。<br/>- font-family(å¯é€‰),指定å—体系列。<br/>è¯æ³•ï¼šctx.font='font-style font-weight font-size font-family'<br/>- font-style(å¯é€‰),用于指定å—ä½“æ ·å¼ï¼Œæ”¯æŒå¦‚ä¸‹å‡ ç§æ ·å¼ï¼š'normal','italic'。<br/>- font-weight(å¯é€‰),用于指定å—体的粗细,支æŒå¦‚ä¸‹å‡ ç§ç±»åž‹ï¼š'normal', 'bold', 'bolder', 'lighter', 100, 200, 300, 400, 500, 600, 700, 800, 900。<br/>- font-size(å¯é€‰),指定å—å·å’Œè¡Œé«˜ï¼Œå•ä½æ”¯æŒpxã€vp。使用时需è¦æ·»åŠ å•ä½ã€‚<br/>- font-family(å¯é€‰),指定å—体系列,支æŒå¦‚ä¸‹å‡ ç§ç±»åž‹ï¼š'sans-serif', 'serif', 'monospace'。<br/>默认值:'normal normal 14px sans-serif'<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [textAlign](#textalign) | CanvasTextAlign | 设置文本绘制ä¸çš„文本对é½æ–¹å¼ï¼Œå¯é€‰å€¼ä¸ºï¼š<br/>- 'left':文本左对é½ã€‚<br/>- 'right':文本å³å¯¹é½ã€‚<br/>- 'center':文本居ä¸å¯¹é½ã€‚<br/>- 'start':文本对é½ç•Œçº¿å¼€å§‹çš„地方。<br/>- 'end':文本对é½ç•Œçº¿ç»“æŸçš„地方。<br/>ltr布局模å¼ä¸‹'start'å’Œ'left'一致,rtl布局模å¼ä¸‹'start'å’Œ'right'一致·。<br/>默认值:'left'<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [textBaseline](#textbaseline) | CanvasTextBaseline | 设置文本绘制ä¸çš„水平对é½æ–¹å¼ï¼Œå¯é€‰å€¼ä¸ºï¼š<br/>- 'alphabetic'ï¼šæ–‡æœ¬åŸºçº¿æ˜¯æ ‡å‡†çš„å—æ¯åŸºçº¿ã€‚<br/>- 'top':文本基线在文本å—的顶部。<br/>- 'hanging':文本基线是悬挂基线。<br/>- 'middle':文本基线在文本å—çš„ä¸é—´ã€‚<br/>- 'ideographic':文å—基线是表æ„å—基线;如果å—符本身超出了alphabetic基线,那么ideograhpic基线ä½ç½®åœ¨å—符本身的底部。<br/>- 'bottom':文本基线在文本å—的底部。 与ideographic基线的区别在于ideographic基线ä¸éœ€è¦è€ƒè™‘下行å—æ¯ã€‚<br/>默认值:'alphabetic'<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [globalAlpha](#globalalpha) | number | 设置é€æ˜Žåº¦ï¼Œ0.0为完全é€æ˜Žï¼Œ1.0为完全ä¸é€æ˜Žã€‚<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [lineDashOffset](#linedashoffset) | number | 设置画布的虚线å移é‡ï¼Œç²¾åº¦ä¸ºfloat。 <br/>默认值:0.0<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [globalCompositeOperation](#globalcompositeoperation) | string | 设置åˆæˆæ“作的方å¼ã€‚类型å—段å¯é€‰å€¼æœ‰'source-over','source-atop','source-in','source-out','destination-over','destination-atop','destination-in','destination-out','lighter','copy','xor'。<br/>默认值:'source-over'<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [shadowBlur](#shadowblur) | number | 设置绘制阴影时的模糊级别,值越大越模糊,精度为float。 <br/>默认值:0.0<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [shadowColor](#shadowcolor) | string | 设置绘制阴影时的阴影颜色。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [shadowOffsetX](#shadowoffsetx) | number | 设置绘制阴影时和原有对象的水平å移值。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [shadowOffsetY](#shadowoffsety) | number | 设置绘制阴影时和原有对象的垂直å移值。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [imageSmoothingEnabled](#imagesmoothingenabled) | boolean | 用于设置绘制图片时是å¦è¿›è¡Œå›¾åƒå¹³æ»‘度调整,true为å¯ç”¨ï¼Œfalse为ä¸å¯ç”¨ã€‚ <br/>默认值:true<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [height](#height) | number | 组件高度。 <br/>å•ä½ï¼švp<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [width](#width) | number | 组件宽度。 <br/>å•ä½ï¼švp<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [imageSmoothingQuality](#imagesmoothingquality) | ImageSmoothingQuality | imageSmoothingEnabled为true时,用于设置图åƒå¹³æ»‘度。å¯é€‰å€¼ä¸ºï¼š<br/>- 'low':低画质<br/>- 'medium':ä¸ç”»è´¨<br/>- 'high':高画质。<br/>默认值:low<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [direction](#direction) | CanvasDirection | 用于设置绘制文å—时使用的文å—æ–¹å‘。å¯é€‰å€¼ä¸ºï¼š<br/>- 'inherit':继承canvas组件已设定的文本方å‘<br/>- 'ltr':从左往å³<br/>- 'rtl':从å³å¾€å·¦ã€‚<br/>默认值:inherit<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [filter](#filter) | string | 用于设置图åƒçš„滤镜。支æŒçš„滤镜效果如下:<br/>- 'none': æ— æ»¤é•œæ•ˆæžœ<br/>- 'blur':给图åƒè®¾ç½®é«˜æ–¯æ¨¡ç³Š<br/>- 'brightness':给图片应用一ç§çº¿æ€§ä¹˜æ³•ï¼Œä½¿å…¶çœ‹èµ·æ¥æ›´äº®æˆ–æ›´æš—<br/>- 'contrast':调整图åƒçš„对比度<br/>- 'grayscale':将图åƒè½¬æ¢ä¸ºç°åº¦å›¾åƒ<br/>- 'hue-rotate':给图åƒåº”用色相旋转<br/>- 'invert':å转输入图åƒ<br/>- 'opacity':转化图åƒçš„é€æ˜Žç¨‹åº¦<br/>- 'saturate':转æ¢å›¾åƒé¥±å’Œåº¦<br/>- 'sepia':将图åƒè½¬æ¢ä¸ºæ·±è¤è‰²<br/>默认值:'none'<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | > **说明:** > @@ -872,12 +872,12 @@ fillText(text: string, x: number, y: number, maxWidth?: number): void **å‚数:** -| å‚æ•° | 类型 | å¿…å¡« | 默认值 | 说明 | -| -------- | ------ | ---- | ------ | ----------------------------- | -| text | string | 是 | '' | 需è¦ç»˜åˆ¶çš„文本内容。 | -| x | number | 是 | 0 | 需è¦ç»˜åˆ¶çš„文本的左下角xåæ ‡ã€‚ | -| y | number | 是 | 0 | 需è¦ç»˜åˆ¶çš„文本的左下角yåæ ‡ã€‚ | -| maxWidth | number | å¦ | - | 指定文本å…许的最大宽度。 | +| å‚æ•° | 类型 | å¿…å¡« | 默认值 | 说明 | +| -------- | ------ | ---- | ---- | --------------- | +| text | string | 是 | '' | 需è¦ç»˜åˆ¶çš„文本内容。 | +| x | number | 是 | 0 | 需è¦ç»˜åˆ¶çš„文本的左下角xåæ ‡ã€‚ | +| y | number | 是 | 0 | 需è¦ç»˜åˆ¶çš„文本的左下角yåæ ‡ã€‚ | +| maxWidth | number | å¦ | - | 指定文本å…许的最大宽度。 | **示例:** @@ -919,12 +919,12 @@ strokeText(text: string, x: number, y: number, maxWidth?:number): void **å‚数:** -| å‚æ•° | 类型 | å¿…å¡« | 默认值 | æè¿° | -| -------- | ------ | ---- | ------ | ----------------------------- | -| text | string | 是 | '' | 需è¦ç»˜åˆ¶çš„文本内容。 | -| x | number | 是 | 0 | 需è¦ç»˜åˆ¶çš„文本的左下角xåæ ‡ã€‚ | -| y | number | 是 | 0 | 需è¦ç»˜åˆ¶çš„文本的左下角yåæ ‡ã€‚ | -| maxWidth | number | å¦ | - | 需è¦ç»˜åˆ¶çš„文本的最大宽度 。 | +| å‚æ•° | 类型 | å¿…å¡« | 默认值 | æè¿° | +| -------- | ------ | ---- | ---- | --------------- | +| text | string | 是 | '' | 需è¦ç»˜åˆ¶çš„文本内容。 | +| x | number | 是 | 0 | 需è¦ç»˜åˆ¶çš„文本的左下角xåæ ‡ã€‚ | +| y | number | 是 | 0 | 需è¦ç»˜åˆ¶çš„文本的左下角yåæ ‡ã€‚ | +| maxWidth | number | å¦ | - | 需è¦ç»˜åˆ¶çš„文本的最大宽度 。 | **示例:** @@ -966,14 +966,14 @@ measureText(text: string): TextMetrics **å‚数:** -| å‚æ•° | 类型 | å¿…å¡« | 默认值 | 说明 | -| ---- | ------ | ---- | ------ | -------------------- | -| text | string | 是 | '' | 需è¦è¿›è¡Œæµ‹é‡çš„文本。 | +| å‚æ•° | 类型 | å¿…å¡« | 默认值 | 说明 | +| ---- | ------ | ---- | ---- | ---------- | +| text | string | 是 | '' | 需è¦è¿›è¡Œæµ‹é‡çš„文本。 | **返回值:** -| 类型 | 说明 | -| ----------- | ------------------------------------------------------------ | +| 类型 | 说明 | +| ----------- | ---------------------------------------- | | TextMetrics | 文本的尺寸信æ¯ã€‚<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | **TextMetrics类型æè¿°:** @@ -1264,15 +1264,15 @@ createPattern(image: ImageBitmap, repetition: string | null): CanvasPattern | nu **å‚数:** -| å‚æ•° | 类型 | å¿…å¡« | æè¿° | -| ---------- | -------------------------------------------------- | ---- | ------------------------------------------------------------ | -| image | [ImageBitmap](ts-components-canvas-imagebitmap.md) | 是 | 图æºå¯¹è±¡ï¼Œå…·ä½“å‚考ImageBitmap对象。 | -| repetition | string | 是 | 设置图åƒé‡å¤çš„æ–¹å¼ï¼Œå–值为:'repeat'ã€'repeat-x'〠'repeat-y'ã€'no-repeat'ã€'clamp'ã€'mirror'。<br/>默认值:'' | +| å‚æ•° | 类型 | å¿…å¡« | æè¿° | +| ---------- | ---------------------------------------- | ---- | ---------------------------------------- | +| image | [ImageBitmap](ts-components-canvas-imagebitmap.md) | 是 | 图æºå¯¹è±¡ï¼Œå…·ä½“å‚考ImageBitmap对象。 | +| repetition | string | 是 | 设置图åƒé‡å¤çš„æ–¹å¼ï¼Œå–值为:'repeat'ã€'repeat-x'〠'repeat-y'ã€'no-repeat'ã€'clamp'ã€'mirror'。<br/>默认值:'' | **返回值:** -| 类型 | 说明 | -| ------------------------------- | ----------------------- | +| 类型 | 说明 | +| ---------------------------------------- | ----------------------- | | [CanvasPattern](ts-components-canvas-canvaspattern.md#canvaspattern) | 通过指定图åƒå’Œé‡å¤æ–¹å¼åˆ›å»ºå›¾ç‰‡å¡«å……的模æ¿å¯¹è±¡ã€‚ | **示例:** @@ -1516,16 +1516,16 @@ ellipse(x: number, y: number, radiusX: number, radiusY: number, rotation: number **å‚数:** -| å‚æ•° | 类型 | å¿…å¡« | 默认值 | 说明 | -| ---------------- | ------- | ---- | ----- | ----------------- | -| x | number | 是 | 0 | æ¤åœ†åœ†å¿ƒçš„xè½´åæ ‡ã€‚ | -| y | number | 是 | 0 | æ¤åœ†åœ†å¿ƒçš„yè½´åæ ‡ã€‚ | -| radiusX | number | 是 | 0 | æ¤åœ†xè½´çš„åŠå¾„长度。 | -| radiusY | number | 是 | 0 | æ¤åœ†yè½´çš„åŠå¾„长度。 | -| rotation | number | 是 | 0 | æ¤åœ†çš„旋转角度,å•ä½ä¸ºå¼§åº¦ã€‚ | -| startAngle | number | 是 | 0 | æ¤åœ†ç»˜åˆ¶çš„起始点角度,以弧度表示。 | -| endAngle | number | 是 | 0 | æ¤åœ†ç»˜åˆ¶çš„结æŸç‚¹è§’度,以弧度表示。 | -| counterclockwise | boolean | å¦ | false | 是å¦ä»¥é€†æ—¶é’ˆæ–¹å‘绘制æ¤åœ†ã€‚<br>true:逆时针方å‘绘制æ¤åœ†ã€‚<br>false:顺时针方å‘绘制æ¤åœ†ã€‚ | +| å‚æ•° | 类型 | å¿…å¡« | 默认值 | 说明 | +| ---------------- | ------- | ---- | ----- | ---------------------------------------- | +| x | number | 是 | 0 | æ¤åœ†åœ†å¿ƒçš„xè½´åæ ‡ã€‚ | +| y | number | 是 | 0 | æ¤åœ†åœ†å¿ƒçš„yè½´åæ ‡ã€‚ | +| radiusX | number | 是 | 0 | æ¤åœ†xè½´çš„åŠå¾„长度。 | +| radiusY | number | 是 | 0 | æ¤åœ†yè½´çš„åŠå¾„长度。 | +| rotation | number | 是 | 0 | æ¤åœ†çš„旋转角度,å•ä½ä¸ºå¼§åº¦ã€‚ | +| startAngle | number | 是 | 0 | æ¤åœ†ç»˜åˆ¶çš„起始点角度,以弧度表示。 | +| endAngle | number | 是 | 0 | æ¤åœ†ç»˜åˆ¶çš„结æŸç‚¹è§’度,以弧度表示。 | +| counterclockwise | boolean | å¦ | false | 是å¦ä»¥é€†æ—¶é’ˆæ–¹å‘绘制æ¤åœ†ã€‚<br>true:逆时针方å‘绘制æ¤åœ†ã€‚<br>false:顺时针方å‘绘制æ¤åœ†ã€‚ | **示例:** @@ -1812,8 +1812,8 @@ filter(filter: string): void **å‚æ•°:** -| å‚æ•° | 类型 | å¿…å¡« | 默认值 | 说明 | -| ------ | ------ | ---- | ---- | ------------ | +| å‚æ•° | 类型 | å¿…å¡« | 默认值 | 说明 | +| ------ | ------ | ---- | ---- | ---------------------------------------- | | filter | string | 是 | - | 接å—å„类滤镜效果的函数。支æŒçš„滤镜效果如下:<br/>- 'none': æ— æ»¤é•œæ•ˆæžœ<br/>- 'blur':给图åƒè®¾ç½®é«˜æ–¯æ¨¡ç³Š<br/>- 'brightness':给图片应用一ç§çº¿æ€§ä¹˜æ³•ï¼Œä½¿å…¶çœ‹èµ·æ¥æ›´äº®æˆ–æ›´æš—<br/>- 'contrast':调整图åƒçš„对比度<br/>- 'grayscale':将图åƒè½¬æ¢ä¸ºç°åº¦å›¾åƒ<br/>- 'hue-rotate':给图åƒåº”用色相旋转<br/>- 'invert':å转输入图åƒ<br/>- 'opacity':转化图åƒçš„é€æ˜Žç¨‹åº¦<br/>- 'saturate':转æ¢å›¾åƒé¥±å’Œåº¦<br/>- 'sepia':将图åƒè½¬æ¢ä¸ºæ·±è¤è‰²<br/>默认值:'none' | **示例:** @@ -1888,8 +1888,8 @@ getTransform(): Matrix2D **返回值:** -| 类型 | 说明 | -| ----------------------------------------------------- | ---------- | +| 类型 | 说明 | +| ---------------------------------------- | ----- | | [Matrix2D](ts-components-canvas-matrix2d.md#Matrix2D) | 矩阵对象。 | @@ -2157,9 +2157,9 @@ setTransform(transform?: Matrix2D): void **å‚数:** -| å‚æ•° | 类型 | å¿…å¡« | 默认值 | æè¿° | -| --------- | ----------------------------------------------------- | ---- | ------ | ---------- | -| transform | [Matrix2D](ts-components-canvas-matrix2d.md#Matrix2D) | å¦ | null | å˜æ¢çŸ©é˜µã€‚ | +| å‚æ•° | 类型 | å¿…å¡« | 默认值 | æè¿° | +| --------- | ---------------------------------------- | ---- | ---- | ----- | +| transform | [Matrix2D](ts-components-canvas-matrix2d.md#Matrix2D) | å¦ | null | å˜æ¢çŸ©é˜µã€‚ | ### translate @@ -2388,15 +2388,15 @@ putImageData(imageData: ImageData, dx: number | string, dy: number | string, dir **å‚数:** -| å‚æ•° | 类型 | å¿…å¡« | 默认值 | æè¿° | -| ----------- | ---------------------------------------------- | ---- | --------------- | --------------------------------------------------------- | -| imagedata | [ImageData](ts-components-canvas-imagedata.md) | 是 | null | 包å«åƒç´ 值的ImageData对象。 | -| dx | number \| string<sup>10+</sup> | 是 | 0 | 填充区域在xè½´æ–¹å‘çš„å移é‡ã€‚ | -| dy | number \| string<sup>10+</sup> | 是 | 0 | 填充区域在yè½´æ–¹å‘çš„å移é‡ã€‚ | -| dirtyX | number \| string<sup>10+</sup> | å¦ | 0 | æºå›¾åƒæ•°æ®çŸ©å½¢è£åˆ‡èŒƒå›´å·¦ä¸Šè§’è·ç¦»æºå›¾åƒå·¦ä¸Šè§’çš„xè½´å移é‡ã€‚ | -| dirtyY | number \| string<sup>10+</sup> | å¦ | 0 | æºå›¾åƒæ•°æ®çŸ©å½¢è£åˆ‡èŒƒå›´å·¦ä¸Šè§’è·ç¦»æºå›¾åƒå·¦ä¸Šè§’çš„yè½´å移é‡ã€‚ | -| dirtyWidth | number \| string<sup>10+</sup> | å¦ | imagedata的宽度 | æºå›¾åƒæ•°æ®çŸ©å½¢è£åˆ‡èŒƒå›´çš„宽度。 | -| dirtyHeight | number \| string<sup>10+</sup> | å¦ | imagedata的高度 | æºå›¾åƒæ•°æ®çŸ©å½¢è£åˆ‡èŒƒå›´çš„高度。 | +| å‚æ•° | 类型 | å¿…å¡« | 默认值 | æè¿° | +| ----------- | ---------------------------------------- | ---- | ------------ | ----------------------------- | +| imagedata | [ImageData](ts-components-canvas-imagedata.md) | 是 | null | 包å«åƒç´ 值的ImageData对象。 | +| dx | number \| string<sup>10+</sup> | 是 | 0 | 填充区域在xè½´æ–¹å‘çš„å移é‡ã€‚ | +| dy | number \| string<sup>10+</sup> | 是 | 0 | 填充区域在yè½´æ–¹å‘çš„å移é‡ã€‚ | +| dirtyX | number \| string<sup>10+</sup> | å¦ | 0 | æºå›¾åƒæ•°æ®çŸ©å½¢è£åˆ‡èŒƒå›´å·¦ä¸Šè§’è·ç¦»æºå›¾åƒå·¦ä¸Šè§’çš„xè½´å移é‡ã€‚ | +| dirtyY | number \| string<sup>10+</sup> | å¦ | 0 | æºå›¾åƒæ•°æ®çŸ©å½¢è£åˆ‡èŒƒå›´å·¦ä¸Šè§’è·ç¦»æºå›¾åƒå·¦ä¸Šè§’çš„yè½´å移é‡ã€‚ | +| dirtyWidth | number \| string<sup>10+</sup> | å¦ | imagedata的宽度 | æºå›¾åƒæ•°æ®çŸ©å½¢è£åˆ‡èŒƒå›´çš„宽度。 | +| dirtyHeight | number \| string<sup>10+</sup> | å¦ | imagedata的高度 | æºå›¾åƒæ•°æ®çŸ©å½¢è£åˆ‡èŒƒå›´çš„高度。 | **示例:** @@ -2873,11 +2873,11 @@ createConicGradient(startAngle: number, x: number, y: number): CanvasGradient **å‚数:** -| å‚æ•° | 类型 | å¿…å¡« | 默认值 | æè¿° | -| ---------- | ------ | ---- | ------ | ------------------------------------------------------------ | -| startAngle | number | 是 | 0 | 开始æ¸å˜çš„角度,以弧度为å•ä½ã€‚角度测é‡ä»Žä¸å¿ƒå³ä¾§æ°´å¹³å¼€å§‹ï¼Œé¡ºæ—¶é’ˆç§»åŠ¨ã€‚ | -| x | number | 是 | 0 | 圆锥æ¸å˜çš„ä¸å¿ƒxè½´åæ ‡ã€‚å•ä½ï¼švp | -| y | number | 是 | 0 | 圆锥æ¸å˜çš„ä¸å¿ƒyè½´åæ ‡ã€‚å•ä½ï¼švp | +| å‚æ•° | 类型 | å¿…å¡« | 默认值 | æè¿° | +| ---------- | ------ | ---- | ---- | ----------------------------------- | +| startAngle | number | 是 | 0 | 开始æ¸å˜çš„角度,以弧度为å•ä½ã€‚角度测é‡ä»Žä¸å¿ƒå³ä¾§æ°´å¹³å¼€å§‹ï¼Œé¡ºæ—¶é’ˆç§»åŠ¨ã€‚ | +| x | number | 是 | 0 | 圆锥æ¸å˜çš„ä¸å¿ƒxè½´åæ ‡ã€‚å•ä½ï¼švp | +| y | number | 是 | 0 | 圆锥æ¸å˜çš„ä¸å¿ƒyè½´åæ ‡ã€‚å•ä½ï¼švp | **示例:** diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-list.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-list.md index b9472dbddf670c4afda46e732e57884a90be8b82..75c364211156355faf4b6344652971eff57168d4 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-container-list.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-list.md @@ -39,37 +39,37 @@ List(value?:{space?: number | string, initialIndex?: number, scroller? **å‚数:** -| å‚æ•°å | å‚数类型 | å¿…å¡« | å‚æ•°æè¿° | -| -------- | -------- | -------- | -------- | -| space | number \| string | å¦ | å组件主轴方å‘的间隔。<br/>默认值:0<br/>**说明:** <br/>设置为除-1外其他负数或百分比时,按默认值显示。<br/>spaceå‚数值å°äºŽList分割线宽度时,å组件主轴方å‘çš„é—´éš”å–分割线宽度。 | -| initialIndex | number | å¦ | 设置当å‰Liståˆæ¬¡åŠ 载时视å£èµ·å§‹ä½ç½®æ˜¾ç¤ºçš„item的索引值。<br/>默认值:0<br/>**说明:** <br/>设置为除-1外其他负数或超过了当å‰List最åŽä¸€ä¸ªitemçš„ç´¢å¼•å€¼æ—¶è§†ä¸ºæ— æ•ˆå–å€¼ï¼Œæ— æ•ˆå–值按默认值显示。 | -| scroller | [Scroller](ts-container-scroll.md#scroller) | å¦ | å¯æ»šåŠ¨ç»„件的控制器。用于与å¯æ»šåŠ¨ç»„件进行绑定。<br/>**说明:** <br/>ä¸å…许和其他滚动类组件绑定åŒä¸€ä¸ªæ»šåŠ¨æŽ§åˆ¶å¯¹è±¡ã€‚ | +| å‚æ•°å | å‚数类型 | å¿…å¡« | å‚æ•°æè¿° | +| ------------ | ---------------------------------------- | ---- | ---------------------------------------- | +| space | number \| string | å¦ | å组件主轴方å‘的间隔。<br/>默认值:0<br/>**说明:** <br/>设置为除-1外其他负数或百分比时,按默认值显示。<br/>spaceå‚数值å°äºŽList分割线宽度时,å组件主轴方å‘çš„é—´éš”å–分割线宽度。 | +| initialIndex | number | å¦ | 设置当å‰Liståˆæ¬¡åŠ 载时视å£èµ·å§‹ä½ç½®æ˜¾ç¤ºçš„item的索引值。<br/>默认值:0<br/>**说明:** <br/>设置为除-1外其他负数或超过了当å‰List最åŽä¸€ä¸ªitemçš„ç´¢å¼•å€¼æ—¶è§†ä¸ºæ— æ•ˆå–å€¼ï¼Œæ— æ•ˆå–值按默认值显示。 | +| scroller | [Scroller](ts-container-scroll.md#scroller) | å¦ | å¯æ»šåŠ¨ç»„件的控制器。用于与å¯æ»šåŠ¨ç»„件进行绑定。<br/>**说明:** <br/>ä¸å…许和其他滚动类组件绑定åŒä¸€ä¸ªæ»šåŠ¨æŽ§åˆ¶å¯¹è±¡ã€‚ | ## 属性 除支æŒ[通用属性](ts-universal-attributes-size.md)外,还支æŒä»¥ä¸‹å±žæ€§ï¼š -| å称 | å‚数类型 | æè¿° | -| -------- | -------- | -------- | -| listDirection | [Axis](ts-appendix-enums.md#axis) | 设置List组件排列方å‘。<br/>默认值:Axis.Vertical<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| divider | {<br/>strokeWidth: [Length](ts-types.md#length),<br/>color?:[ResourceColor](ts-types.md#resourcecolor),<br/>startMargin?: Length,<br/>endMargin?: Length<br/>} \| null | 设置ListItemåˆ†å‰²çº¿æ ·å¼ï¼Œé»˜è®¤æ— 分割线。<br/>- strokeWidth: 分割线的线宽。<br/>- color: 分割线的颜色。<br/>- startMargin: 分割线与列表侧边起始端的è·ç¦»ã€‚<br/>- endMargin: 分割线与列表侧边结æŸç«¯çš„è·ç¦»ã€‚<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚<br/>endMargin +startMargin ä¸èƒ½è¶…过列宽度。 <br/>startMarginå’ŒendMarginä¸æ”¯æŒè®¾ç½®ç™¾åˆ†æ¯”。<br/>List的分割线画在主轴方å‘两个å组件之间,第一个å组件上方和最åŽä¸€ä¸ªå组件下方ä¸ä¼šç»˜åˆ¶åˆ†å‰²çº¿ã€‚<br/>多列模å¼ä¸‹ï¼ŒListItem与ListItem之间的分割线起始边è·ä»Žæ¯ä¸€åˆ—的交å‰è½´æ–¹å‘起始边开始计算,其他情况从List交å‰è½´æ–¹å‘起始边开始计算。 | -| scrollBar | [BarState](ts-appendix-enums.md#barstate) | 设置滚动æ¡çŠ¶æ€ã€‚<br/>默认值:BarState.Off<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚<br/>**说明:** <br/>API version 9åŠä»¥ä¸‹ç‰ˆæœ¬é»˜è®¤å€¼ä¸ºBarState.Off,API version 10的默认值为BarState.Auto。 | -| cachedCount | number | 设置列表ä¸ListItem/ListItemGroupçš„é¢„åŠ è½½æ•°é‡ï¼Œåªåœ¨[LazyForEach](../../quick-start/arkts-rendering-control-lazyforeach.md)ä¸ç”Ÿæ•ˆï¼Œå…¶ä¸ListItemGroup将作为一个整体进行计算,ListItemGroupä¸çš„所有ListItemä¼šä¸€æ¬¡æ€§å…¨éƒ¨åŠ è½½å‡ºæ¥ã€‚具体使用å¯å‚考[å‡å°‘应用白å—说明](../../ui/arkts-performance-improvement-recommendation.md#å‡å°‘应用滑动白å—)。<br/>默认值:1<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚<br/>**说明:** <br/>å•åˆ—模å¼ä¸‹ï¼Œä¼šåœ¨List显示的ListItemå‰åŽå„缓å˜cachedCount个ListItem。<br/>多列模å¼ä¸‹ï¼Œ 会在List显示的ListItemå‰åŽå„缓å˜cachedCount*列数个ListItem。 | -| editMode<sup>(deprecated)</sup> | boolean | 声明当å‰List组件是å¦å¤„于å¯ç¼–辑模å¼ã€‚<br/>从API version9开始废弃。å¯å‚考[示例3](#示例3)å®žçŽ°åˆ é™¤é€‰ä¸çš„list项。<br/>默认值:false | -| edgeEffect | [EdgeEffect](ts-appendix-enums.md#edgeeffect) | 设置组件的滑动效果,支æŒå¼¹ç°§æ•ˆæžœå’Œé˜´å½±æ•ˆæžœã€‚<br/>默认值:EdgeEffect.Spring<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| chainAnimation | boolean | 设置当å‰List是å¦å¯ç”¨é“¾å¼è”动动效,开å¯åŽåˆ—表滑动以åŠé¡¶éƒ¨å’Œåº•éƒ¨æ‹–拽时会有链å¼è”动的效果。链å¼è”动效果:List内的list-item间隔一定è·ç¦»ï¼Œåœ¨åŸºæœ¬çš„滑动交互行为下,主动对象驱动从动对象进行è”动,驱动效果éµå¾ªå¼¹ç°§ç‰©ç†åŠ¨æ•ˆã€‚<br/>默认值:false<br/>- false:ä¸å¯ç”¨é“¾å¼è”动。<br/>- true:å¯ç”¨é“¾å¼è”动。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚<br/>**说明:**<br/>链å¼åŠ¨æ•ˆç”Ÿæ•ˆåŽï¼ŒList的分割线ä¸æ˜¾ç¤ºã€‚<br>链å¼åŠ¨æ•ˆç”Ÿæ•ˆéœ€è¦æ»¡è¶³ä»¥ä¸‹å‰ææ¡ä»¶ï¼š<br> - List边缘效果为Spring类型<br> - List没有å¯ç”¨å¤šåˆ—æ¨¡å¼ | -|chainAnimationOptions<sup>10+</sup>| [ChainAnimationOptions](#chainanimationoptions10对象说明) | 设置链å¼è”动动效å‚数。<br>**系统API:** æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ã€‚ | -| multiSelectable<sup>8+</sup> | boolean | 是å¦å¼€å¯é¼ æ ‡æ¡†é€‰ã€‚<br/>默认值:false<br/>- false:关é—框选。<br/>- true:开å¯æ¡†é€‰ã€‚<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| lanes<sup>9+</sup> | number \| [LengthConstrain](ts-types.md#lengthconstrain) | 以列模å¼ä¸ºä¾‹ï¼ˆlistDirection为Axis.Vertical):<br/>lanes用于决定List组件在交å‰è½´æ–¹å‘æŒ‰å‡ åˆ—å¸ƒå±€ã€‚<br/>默认值:1<br/>规则如下:<br/>- lanes为指定的数é‡æ—¶ï¼Œæ ¹æ®æŒ‡å®šçš„æ•°é‡ä¸ŽList组件的交å‰è½´å°ºå¯¸é™¤ä»¥åˆ—数作为列的宽度。<br/>- lanes设置了{minLength,maxLength}æ—¶ï¼Œæ ¹æ®List组件的宽度自适应决定lanesæ•°é‡ï¼ˆå³åˆ—数),ä¿è¯ç¼©æ”¾è¿‡ç¨‹ä¸lane的宽度符åˆ{minLength,maxLength}çš„é™åˆ¶ã€‚å…¶ä¸ï¼ŒminLengthæ¡ä»¶ä¼šè¢«ä¼˜å…ˆæ»¡è¶³ï¼Œå³ä¼˜å…ˆä¿è¯ç¬¦åˆListItem的交å‰è½´å°ºå¯¸ç¬¦åˆæœ€å°é™åˆ¶ã€‚<br/>- lanes设置了{minLength,maxLength},如果父组件交å‰è½´æ–¹å‘尺寸约æŸä¸ºæ— 穷大时,固定按一列排列,列宽度按显示区域内最大的ListItem计算<br/>- ListItemGroup在多列模å¼ä¸‹ä¹Ÿæ˜¯ç‹¬å 一行,ListItemGroupä¸çš„ListItem按照List组件的lanes属性设置值æ¥å¸ƒå±€ã€‚<br/>- lanes设置了{minLength,maxLength}时,计算列数会按照ListItemGroup的交å‰è½´å°ºå¯¸è®¡ç®—。当ListItemGroup交å‰è½´å°ºå¯¸ä¸ŽList交å‰è½´å°ºå¯¸ä¸ä¸€è‡´æ—¶ListItemGroupä¸çš„列数与Listä¸çš„列数å¯èƒ½ä¸ä¸€æ ·ã€‚<br/>该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| alignListItem<sup>9+</sup> | [ListItemAlign](#listitemalign9枚举说明) | List交å‰è½´æ–¹å‘宽度大于ListItem交å‰è½´å®½åº¦ * lanes时,ListItem在List交å‰è½´æ–¹å‘的布局方å¼ï¼Œé»˜è®¤ä¸ºé¦–部对é½ã€‚<br/>默认值:ListItemAlign.Start<br/>该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| sticky<sup>9+</sup> | [StickyStyle](#stickystyle9枚举说明) | é…åˆ[ListItemGroup](ts-container-listitemgroup.md)组件使用,设置ListItemGroupä¸headerå’Œfooter是å¦è¦å¸é¡¶æˆ–å¸åº•ã€‚<br/>默认值:StickyStyle.None<br/>该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚<br/>**说明:**<br/>sticky属性å¯ä»¥è®¾ç½®ä¸º StickyStyle.Header \| StickyStyle.Footer 以åŒæ—¶æ”¯æŒheaderå¸é¡¶å’Œfooterå¸åº•ã€‚ | +| å称 | å‚数类型 | æè¿° | +| ----------------------------------- | ---------------------------------------- | ---------------------------------------- | +| listDirection | [Axis](ts-appendix-enums.md#axis) | 设置List组件排列方å‘。<br/>默认值:Axis.Vertical<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| divider | {<br/>strokeWidth: [Length](ts-types.md#length),<br/>color?:[ResourceColor](ts-types.md#resourcecolor),<br/>startMargin?: Length,<br/>endMargin?: Length<br/>} \| null | 设置ListItemåˆ†å‰²çº¿æ ·å¼ï¼Œé»˜è®¤æ— 分割线。<br/>- strokeWidth: 分割线的线宽。<br/>- color: 分割线的颜色。<br/>- startMargin: 分割线与列表侧边起始端的è·ç¦»ã€‚<br/>- endMargin: 分割线与列表侧边结æŸç«¯çš„è·ç¦»ã€‚<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚<br/>endMargin +startMargin ä¸èƒ½è¶…过列宽度。 <br/>startMarginå’ŒendMarginä¸æ”¯æŒè®¾ç½®ç™¾åˆ†æ¯”。<br/>List的分割线画在主轴方å‘两个å组件之间,第一个å组件上方和最åŽä¸€ä¸ªå组件下方ä¸ä¼šç»˜åˆ¶åˆ†å‰²çº¿ã€‚<br/>多列模å¼ä¸‹ï¼ŒListItem与ListItem之间的分割线起始边è·ä»Žæ¯ä¸€åˆ—的交å‰è½´æ–¹å‘起始边开始计算,其他情况从List交å‰è½´æ–¹å‘起始边开始计算。 | +| scrollBar | [BarState](ts-appendix-enums.md#barstate) | 设置滚动æ¡çŠ¶æ€ã€‚<br/>默认值:BarState.Off<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚<br/>**说明:** <br/>API version 9åŠä»¥ä¸‹ç‰ˆæœ¬é»˜è®¤å€¼ä¸ºBarState.Off,API version 10的默认值为BarState.Auto。 | +| cachedCount | number | 设置列表ä¸ListItem/ListItemGroupçš„é¢„åŠ è½½æ•°é‡ï¼Œåªåœ¨[LazyForEach](../../quick-start/arkts-rendering-control-lazyforeach.md)ä¸ç”Ÿæ•ˆï¼Œå…¶ä¸ListItemGroup将作为一个整体进行计算,ListItemGroupä¸çš„所有ListItemä¼šä¸€æ¬¡æ€§å…¨éƒ¨åŠ è½½å‡ºæ¥ã€‚具体使用å¯å‚考[å‡å°‘应用白å—说明](../../ui/arkts-performance-improvement-recommendation.md#å‡å°‘应用滑动白å—)。<br/>默认值:1<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚<br/>**说明:** <br/>å•åˆ—模å¼ä¸‹ï¼Œä¼šåœ¨List显示的ListItemå‰åŽå„缓å˜cachedCount个ListItem。<br/>多列模å¼ä¸‹ï¼Œ 会在List显示的ListItemå‰åŽå„缓å˜cachedCount*列数个ListItem。 | +| editMode<sup>(deprecated)</sup> | boolean | 声明当å‰List组件是å¦å¤„于å¯ç¼–辑模å¼ã€‚<br/>从API version9开始废弃。å¯å‚考[示例3](#示例3)å®žçŽ°åˆ é™¤é€‰ä¸çš„list项。<br/>默认值:false | +| edgeEffect | [EdgeEffect](ts-appendix-enums.md#edgeeffect) | 设置组件的滑动效果,支æŒå¼¹ç°§æ•ˆæžœå’Œé˜´å½±æ•ˆæžœã€‚<br/>默认值:EdgeEffect.Spring<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| chainAnimation | boolean | 设置当å‰List是å¦å¯ç”¨é“¾å¼è”动动效,开å¯åŽåˆ—表滑动以åŠé¡¶éƒ¨å’Œåº•éƒ¨æ‹–拽时会有链å¼è”动的效果。链å¼è”动效果:List内的list-item间隔一定è·ç¦»ï¼Œåœ¨åŸºæœ¬çš„滑动交互行为下,主动对象驱动从动对象进行è”动,驱动效果éµå¾ªå¼¹ç°§ç‰©ç†åŠ¨æ•ˆã€‚<br/>默认值:false<br/>- false:ä¸å¯ç”¨é“¾å¼è”动。<br/>- true:å¯ç”¨é“¾å¼è”动。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚<br/>**说明:**<br/>链å¼åŠ¨æ•ˆç”Ÿæ•ˆåŽï¼ŒList的分割线ä¸æ˜¾ç¤ºã€‚<br>链å¼åŠ¨æ•ˆç”Ÿæ•ˆéœ€è¦æ»¡è¶³ä»¥ä¸‹å‰ææ¡ä»¶ï¼š<br> - List边缘效果为Spring类型<br> - List没有å¯ç”¨å¤šåˆ—æ¨¡å¼ | +| chainAnimationOptions<sup>10+</sup> | [ChainAnimationOptions](#chainanimationoptions10对象说明) | 设置链å¼è”动动效å‚数。<br>**系统API:** æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ã€‚ | +| multiSelectable<sup>8+</sup> | boolean | 是å¦å¼€å¯é¼ æ ‡æ¡†é€‰ã€‚<br/>默认值:false<br/>- false:关é—框选。<br/>- true:开å¯æ¡†é€‰ã€‚<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| lanes<sup>9+</sup> | number \| [LengthConstrain](ts-types.md#lengthconstrain) | 以列模å¼ä¸ºä¾‹ï¼ˆlistDirection为Axis.Vertical):<br/>lanes用于决定List组件在交å‰è½´æ–¹å‘æŒ‰å‡ åˆ—å¸ƒå±€ã€‚<br/>默认值:1<br/>规则如下:<br/>- lanes为指定的数é‡æ—¶ï¼Œæ ¹æ®æŒ‡å®šçš„æ•°é‡ä¸ŽList组件的交å‰è½´å°ºå¯¸é™¤ä»¥åˆ—数作为列的宽度。<br/>- lanes设置了{minLength,maxLength}æ—¶ï¼Œæ ¹æ®List组件的宽度自适应决定lanesæ•°é‡ï¼ˆå³åˆ—数),ä¿è¯ç¼©æ”¾è¿‡ç¨‹ä¸lane的宽度符åˆ{minLength,maxLength}çš„é™åˆ¶ã€‚å…¶ä¸ï¼ŒminLengthæ¡ä»¶ä¼šè¢«ä¼˜å…ˆæ»¡è¶³ï¼Œå³ä¼˜å…ˆä¿è¯ç¬¦åˆListItem的交å‰è½´å°ºå¯¸ç¬¦åˆæœ€å°é™åˆ¶ã€‚<br/>- lanes设置了{minLength,maxLength},如果父组件交å‰è½´æ–¹å‘尺寸约æŸä¸ºæ— 穷大时,固定按一列排列,列宽度按显示区域内最大的ListItem计算<br/>- ListItemGroup在多列模å¼ä¸‹ä¹Ÿæ˜¯ç‹¬å 一行,ListItemGroupä¸çš„ListItem按照List组件的lanes属性设置值æ¥å¸ƒå±€ã€‚<br/>- lanes设置了{minLength,maxLength}时,计算列数会按照ListItemGroup的交å‰è½´å°ºå¯¸è®¡ç®—。当ListItemGroup交å‰è½´å°ºå¯¸ä¸ŽList交å‰è½´å°ºå¯¸ä¸ä¸€è‡´æ—¶ListItemGroupä¸çš„列数与Listä¸çš„列数å¯èƒ½ä¸ä¸€æ ·ã€‚<br/>该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| alignListItem<sup>9+</sup> | [ListItemAlign](#listitemalign9枚举说明) | List交å‰è½´æ–¹å‘宽度大于ListItem交å‰è½´å®½åº¦ * lanes时,ListItem在List交å‰è½´æ–¹å‘的布局方å¼ï¼Œé»˜è®¤ä¸ºé¦–部对é½ã€‚<br/>默认值:ListItemAlign.Start<br/>该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| sticky<sup>9+</sup> | [StickyStyle](#stickystyle9枚举说明) | é…åˆ[ListItemGroup](ts-container-listitemgroup.md)组件使用,设置ListItemGroupä¸headerå’Œfooter是å¦è¦å¸é¡¶æˆ–å¸åº•ã€‚<br/>默认值:StickyStyle.None<br/>该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚<br/>**说明:**<br/>sticky属性å¯ä»¥è®¾ç½®ä¸º StickyStyle.Header \| StickyStyle.Footer 以åŒæ—¶æ”¯æŒheaderå¸é¡¶å’Œfooterå¸åº•ã€‚ | ## ListItemAlign<sup>9+</sup>枚举说明 该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ -| å称 | æè¿° | -| ------ | -------------------------------------- | +| å称 | æè¿° | +| ------ | ------------------------- | | Start | ListItem在Listä¸ï¼Œäº¤å‰è½´æ–¹å‘首部对é½ã€‚ | | Center | ListItem在Listä¸ï¼Œäº¤å‰è½´æ–¹å‘å±…ä¸å¯¹é½ã€‚ | | End | ListItem在Listä¸ï¼Œäº¤å‰è½´æ–¹å‘尾部对é½ã€‚ | @@ -78,11 +78,11 @@ List(value?:{space?: number | string, initialIndex?: number, scroller? 该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ -| å称 | æè¿° | -| ------ | -------------------------------------- | -| None | ListItemGroupçš„headerä¸å¸é¡¶ï¼Œfooterä¸å¸åº•ã€‚ | -| Header | ListItemGroupçš„headerå¸é¡¶ï¼Œfooterä¸å¸åº•ã€‚ | -| Footer | ListItemGroupçš„footerå¸åº•ï¼Œheaderä¸å¸åº•ã€‚ | +| å称 | æè¿° | +| ------ | ---------------------------------- | +| None | ListItemGroupçš„headerä¸å¸é¡¶ï¼Œfooterä¸å¸åº•ã€‚ | +| Header | ListItemGroupçš„headerå¸é¡¶ï¼Œfooterä¸å¸åº•ã€‚ | +| Footer | ListItemGroupçš„footerå¸åº•ï¼Œheaderä¸å¸åº•ã€‚ | ## ChainEdgeEffect<sup>10+</sup>枚举说明 @@ -90,10 +90,10 @@ List(value?:{space?: number | string, initialIndex?: number, scroller? **系统API:** æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ -| å称 | æè¿° | -| ------ | -------------------------------------- | -| DEFAULT | 默认效果,列表滚动到边缘以åŽç»§ç»æ‹–动,拖拽方å‘上的列表项间è·ç¼©å°ï¼Œæ‹–拽åæ–¹å‘上的列表项间è·æ‰©å¤§ã€‚ | -| STRETCH | 列表滚动到边缘以åŽç»§ç»æ‹–动,所有列表项间è·æ‰©å¤§ã€‚ | +| å称 | æè¿° | +| ------- | ---------------------------------------- | +| DEFAULT | 默认效果,列表滚动到边缘以åŽç»§ç»æ‹–动,拖拽方å‘上的列表项间è·ç¼©å°ï¼Œæ‹–拽åæ–¹å‘上的列表项间è·æ‰©å¤§ã€‚ | +| STRETCH | 列表滚动到边缘以åŽç»§ç»æ‹–动,所有列表项间è·æ‰©å¤§ã€‚ | ## chainAnimationOptions<sup>10+</sup>对象说明 @@ -101,13 +101,13 @@ List(value?:{space?: number | string, initialIndex?: number, scroller? **系统API:** æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ -| å称 | 类型 | å¿…å¡« | 说明 | -| ------ | ------ | ---- | --------------- | -| minSpace | [Length](ts-types.md#length) | 是 | 设置链å¼è”动动效最å°é—´è·ã€‚ | -| maxSpace | [Length](ts-types.md#length) | 是 | 设置链å¼è”动动效最大间è·ã€‚ | -| conductivity | number | å¦ | 设置链å¼è”åŠ¨åŠ¨æ•ˆä¼ å¯¼ç³»æ•°ã€‚å–值范围[0,1]ï¼Œæ•°å€¼è¶Šå¤§ï¼ŒåŠ¨æ•ˆä¼ å¯¼èŒƒå›´è¶Šè¿œã€‚<br/>默认为0.7。 | -| intensity | number | å¦ | 设置链å¼è”动动效效果强度。å–值范围[0,1],数值越大,动效效果越明显。<br/>默认为0.3。 | -| edgeEffect | [ChainEdgeEffect](#chainedgeeffect10枚举说明) | å¦ | 设置链å¼è”动动效边缘效果。<br/>默认为ChainEdgeEffect.DEFAULT。| +| å称 | 类型 | å¿…å¡« | 说明 | +| ------------ | ---------------------------------------- | ---- | ---------------------------------------- | +| minSpace | [Length](ts-types.md#length) | 是 | 设置链å¼è”动动效最å°é—´è·ã€‚ | +| maxSpace | [Length](ts-types.md#length) | 是 | 设置链å¼è”动动效最大间è·ã€‚ | +| conductivity | number | å¦ | 设置链å¼è”åŠ¨åŠ¨æ•ˆä¼ å¯¼ç³»æ•°ã€‚å–值范围[0,1]ï¼Œæ•°å€¼è¶Šå¤§ï¼ŒåŠ¨æ•ˆä¼ å¯¼èŒƒå›´è¶Šè¿œã€‚<br/>默认为0.7。 | +| intensity | number | å¦ | 设置链å¼è”动动效效果强度。å–值范围[0,1],数值越大,动效效果越明显。<br/>默认为0.3。 | +| edgeEffect | [ChainEdgeEffect](#chainedgeeffect10枚举说明) | å¦ | 设置链å¼è”动动效边缘效果。<br/>默认为ChainEdgeEffect.DEFAULT。 | > **说明:** > @@ -115,16 +115,16 @@ List(value?:{space?: number | string, initialIndex?: number, scroller? ## 事件 -| å称 | 功能æè¿° | -| -------- | -------- | +| å称 | 功能æè¿° | +| ---------------------------------------- | ---------------------------------------- | | onItemDelete<sup>(deprecated)</sup>(event: (index: number) => boolean) | 当List组件在编辑模å¼æ—¶ï¼Œç‚¹å‡»ListItemå³è¾¹å‡ºçŽ°çš„åˆ é™¤æŒ‰é’®æ—¶è§¦å‘。<br/>从API version9开始废弃。<br/>- index: è¢«åˆ é™¤çš„åˆ—è¡¨é¡¹çš„ç´¢å¼•å€¼ã€‚ | | onScroll(event: (scrollOffset: number, scrollState: ScrollState) => void) | 列表滑动时触å‘。<br/>- scrollOffset: æ¯å¸§æ»šåŠ¨çš„å移é‡ï¼ŒList的内容å‘上滚动时å移é‡ä¸ºæ£ï¼Œå‘下滚动时å移é‡ä¸ºè´Ÿã€‚<br/>- [scrollState](#scrollstate枚举说明): 当å‰æ»‘动状æ€ã€‚<br/>使用控制器调用ScrollEdgeå’ŒScrollToIndexæ—¶ä¸ä¼šè§¦å‘,其余情况有滚动就会触å‘该事件。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | | onScrollIndex(event: (start: number, end: number) => void) | 有å组件划入或划出List显示区域时触å‘。<br/>计算索引值时,ListItemGroup作为一个整体å 一个索引值,ä¸è®¡ç®—ListItemGroup内部ListItem的索引值。<br/>- start: 滑动起始ä½ç½®ç´¢å¼•å€¼ã€‚<br/>- end: 滑动结æŸä½ç½®ç´¢å¼•å€¼ã€‚<br/>触å‘该事件的æ¡ä»¶ï¼šåˆ—表åˆå§‹åŒ–时会触å‘一次,List显示区域内第一个å组件的索引值或åŽä¸€ä¸ªå组件的索引值有å˜åŒ–时会触å‘。<br/>List的边缘效果为弹簧效果时,在List划动到边缘继ç»åˆ’动和æ¾æ‰‹å›žå¼¹è¿‡ç¨‹ä¸ä¼šè§¦å‘onScrollIndex事件。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| onReachStart(event: () => void) | 列表到达起始ä½ç½®æ—¶è§¦å‘。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚<br/>**说明:** <br>Liståˆå§‹åŒ–时如果initialIndex为0会触å‘一次,List滚动到起始ä½ç½®æ—¶è§¦å‘一次。List边缘效果为弹簧效果时,划动ç»è¿‡èµ·å§‹ä½ç½®æ—¶è§¦å‘一次,回弹回起始ä½ç½®æ—¶å†è§¦å‘一次。 | -| onReachEnd(event: () => void) | 列表到底末尾ä½ç½®æ—¶è§¦å‘。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚<br/>**说明:** <br/>List边缘效果为弹簧效果时,划动ç»è¿‡æœ«å°¾ä½ç½®æ—¶è§¦å‘一次,回弹回末尾ä½ç½®æ—¶å†è§¦å‘一次。 | +| onReachStart(event: () => void) | 列表到达起始ä½ç½®æ—¶è§¦å‘。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚<br/>**说明:** <br>Liståˆå§‹åŒ–时如果initialIndex为0会触å‘一次,List滚动到起始ä½ç½®æ—¶è§¦å‘一次。List边缘效果为弹簧效果时,划动ç»è¿‡èµ·å§‹ä½ç½®æ—¶è§¦å‘一次,回弹回起始ä½ç½®æ—¶å†è§¦å‘一次。 | +| onReachEnd(event: () => void) | 列表到底末尾ä½ç½®æ—¶è§¦å‘。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚<br/>**说明:** <br/>List边缘效果为弹簧效果时,划动ç»è¿‡æœ«å°¾ä½ç½®æ—¶è§¦å‘一次,回弹回末尾ä½ç½®æ—¶å†è§¦å‘一次。 | | onScrollFrameBegin<sup>9+</sup>(event: (offset: number, state: ScrollState) => { offsetRemain }) | 列表开始滑动时触å‘,事件å‚æ•°ä¼ å…¥å³å°†å‘生的滑动é‡ï¼Œäº‹ä»¶å¤„ç†å‡½æ•°ä¸å¯æ ¹æ®åº”用场景计算实际需è¦çš„滑动é‡å¹¶ä½œä¸ºäº‹ä»¶å¤„ç†å‡½æ•°çš„返回值返回,列表将按照返回值的实际滑动é‡è¿›è¡Œæ»‘动。<br/>\- offset:å³å°†å‘生的滑动é‡ï¼Œå•ä½vp。<br/>\- state:当å‰æ»‘动状æ€ã€‚<br/>- offsetRemain:实际滑动é‡ï¼Œå•ä½vp。<br/>触å‘该事件的æ¡ä»¶ï¼šæ‰‹æŒ‡æ‹–动Listã€List惯性划动时æ¯å¸§å¼€å§‹æ—¶è§¦å‘ï¼›List超出边缘回弹ã€ä½¿ç”¨æ»šåŠ¨æŽ§åˆ¶å™¨çš„滚动ä¸ä¼šè§¦å‘。<br/>该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚<br/>**说明:** <br/>当listDirection的值为Axis.Vertical时,返回垂直方å‘滑动é‡ï¼Œå½“listDirection的值为Axis.Horizontal时,返回水平方å‘滑动é‡ã€‚ | | onScrollStart<sup>9+</sup>(event: () => void) | 列表滑动开始时触å‘。手指拖动列表或列表的滚动æ¡è§¦å‘的滑动开始时,会触å‘该事件。使用[Scroller](ts-container-scroll.md#scroller)滑动控制器触å‘的带动画的滑动,动画开始时会触å‘该事件。<br/>该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| onScrollStop(event: () => void) | 列表滑动åœæ¢æ—¶è§¦å‘。手拖动列表或列表的滚动æ¡è§¦å‘的滑动,手离开å±å¹•å¹¶ä¸”滑动åœæ¢æ—¶ä¼šè§¦å‘该事件;使用[Scroller](ts-container-scroll.md#scroller)滑动控制器触å‘的带动画的滑动,动画åœæ¢ä¼šè§¦å‘该事件。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| onScrollStop(event: () => void) | 列表滑动åœæ¢æ—¶è§¦å‘。手拖动列表或列表的滚动æ¡è§¦å‘的滑动,手离开å±å¹•å¹¶ä¸”滑动åœæ¢æ—¶ä¼šè§¦å‘该事件;使用[Scroller](ts-container-scroll.md#scroller)滑动控制器触å‘的带动画的滑动,动画åœæ¢ä¼šè§¦å‘该事件。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | | onItemMove(event: (from: number, to: number) => boolean) | åˆ—è¡¨å…ƒç´ å‘生移动时触å‘。<br/>- from: 移动å‰ç´¢å¼•å€¼ã€‚<br/>- to: 移动åŽç´¢å¼•å€¼ã€‚ | | onItemDragStart(event: (event: ItemDragInfo, itemIndex: number) => ((() => any) \| void) | å¼€å§‹æ‹–æ‹½åˆ—è¡¨å…ƒç´ æ—¶è§¦å‘。<br/>- event: è§[ItemDragInfo对象说明](ts-container-grid.md#itemdraginfo对象说明)。<br/>- itemIndex: è¢«æ‹–æ‹½åˆ—è¡¨å…ƒç´ ç´¢å¼•å€¼ã€‚ | | onItemDragEnter(event: (event: ItemDragInfo) => void) | æ‹–æ‹½è¿›å…¥åˆ—è¡¨å…ƒç´ èŒƒå›´å†…æ—¶è§¦å‘。<br/>- event: è§[ItemDragInfo对象说明](ts-container-grid.md#itemdraginfo对象说明)。 | @@ -136,11 +136,11 @@ List(value?:{space?: number | string, initialIndex?: number, scroller? 从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ -| å称 | æè¿° | -| ------ | ------------------------- | -| Idle | 空闲状æ€ã€‚使用控制器æ供的方法滚动ã€æ‹–动滚动æ¡æ»šåŠ¨æ—¶è§¦å‘。 | -| Scroll | 手指拖动状æ€ã€‚使用手指拖动List滚动时触å‘。 | -| Fling | 惯性滚动状æ€ã€‚快速划动æ¾æ‰‹åŽæƒ¯æ€§æ»šåŠ¨å’Œåˆ’动到边缘回弹时触å‘。 | +| å称 | æè¿° | +| ------ | ------------------------------ | +| Idle | 空闲状æ€ã€‚使用控制器æ供的方法滚动ã€æ‹–动滚动æ¡æ»šåŠ¨æ—¶è§¦å‘。 | +| Scroll | 手指拖动状æ€ã€‚使用手指拖动List滚动时触å‘。 | +| Fling | 惯性滚动状æ€ã€‚快速划动æ¾æ‰‹åŽæƒ¯æ€§æ»šåŠ¨å’Œåˆ’动到边缘回弹时触å‘。 | > **说明:** > @@ -158,8 +158,9 @@ List(value?:{space?: number | string, initialIndex?: number, scroller? > > - 绑定onDragStart事件,且事件回调ä¸è¿”回浮动UI布局。 +## 示例 -## 示例1 +### 示例1 ```ts // xxx.ets @@ -199,7 +200,7 @@ struct ListExample {  -## 示例2 +### 示例2 ```ts // xxx.ets @@ -248,7 +249,7 @@ struct ListLanesExample {  -## 示例3 +### 示例3 ```ts // xxx.ets diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-offscreencanvasrenderingcontext2d.md b/zh-cn/application-dev/reference/arkui-ts/ts-offscreencanvasrenderingcontext2d.md index 8823443bf9dac73a25e134252837f7a13d9f10e5..72b306e7662c9d11971ed43f25568a146d23e79d 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-offscreencanvasrenderingcontext2d.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-offscreencanvasrenderingcontext2d.md @@ -3,7 +3,7 @@ 使用OffscreenCanvasRenderingContext2D在Canvas上进行离å±ç»˜åˆ¶ï¼Œç»˜åˆ¶å¯¹è±¡å¯ä»¥æ˜¯çŸ©å½¢ã€æ–‡æœ¬ã€å›¾ç‰‡ç‰ã€‚离å±ç»˜åˆ¶æ˜¯æŒ‡å°†éœ€è¦ç»˜åˆ¶çš„内容先绘制在缓å˜åŒºï¼Œç„¶åŽå°†å…¶è½¬æ¢æˆå›¾ç‰‡ï¼Œä¸€æ¬¡æ€§ç»˜åˆ¶åˆ°canvasä¸Šï¼ŒåŠ å¿«äº†ç»˜åˆ¶é€Ÿåº¦ã€‚ > **说明:** -> +> > 从 API Version 8 开始支æŒã€‚åŽç»ç‰ˆæœ¬å¦‚æœ‰æ–°å¢žå†…å®¹ï¼Œåˆ™é‡‡ç”¨ä¸Šè§’æ ‡å•ç‹¬æ ‡è®°è¯¥å†…容的起始版本。 @@ -16,37 +16,37 @@ OffscreenCanvasRenderingContext2D(width: number, height: number, settings?: Rend **å‚数:** -| å‚æ•°å | å‚数类型 | å¿…å¡« | å‚æ•°æè¿° | -| ------- | ------------------------------------------------------------ | ---- | ------------------------------------ | -| width | number | 是 | 离å±ç”»å¸ƒçš„宽度 | -| height | number | 是 | 离å±ç”»å¸ƒçš„高度 | -| setting | [RenderingContextSettings](ts-canvasrenderingcontext2d.md#renderingcontextsettings) | å¦ | è§RenderingContextSettings接å£æ述。 | +| å‚æ•°å | å‚数类型 | å¿…å¡« | å‚æ•°æè¿° | +| -------- | ---------------------------------------- | ---- | ------------------------------ | +| width | number | 是 | 离å±ç”»å¸ƒçš„宽度 | +| height | number | 是 | 离å±ç”»å¸ƒçš„高度 | +| settings | [RenderingContextSettings](ts-canvasrenderingcontext2d.md#renderingcontextsettings) | å¦ | è§RenderingContextSettings接å£æ述。 | ## 属性 -| å称 | 类型 | æè¿° | -| ----------------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | -| [fillStyle](#fillstyle) | string \|number<sup>10+</sup> \|[CanvasGradient](ts-components-canvas-canvasgradient.md) \| [CanvasPattern](ts-components-canvas-canvaspattern.md#canvaspattern) | 指定绘制的填充色。<br/>- 类型为string时,表示设置填充区域的颜色。<br/>- 类型为number时,表示设置填充区域的颜色。<br/>- 类型为CanvasGradient时,表示æ¸å˜å¯¹è±¡ï¼Œä½¿ç”¨[createLinearGradient](#createlineargradient)方法创建。<br/>- 类型为CanvasPattern时,使用[createPattern](#createpattern)方法创建。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [lineWidth](#linewidth) | number | 设置绘制线æ¡çš„宽度。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [strokeStyle](#strokestyle) | string \|number<sup>10+</sup> \|[CanvasGradient](ts-components-canvas-canvasgradient.md) \| [CanvasPattern](ts-components-canvas-canvaspattern.md#canvaspattern) | 设置æ边的颜色。<br/>- 类型为string时,表示设置æ边使用的颜色。<br/>- 类型为number时,表示设置æ边使用的颜色。<br/>- 类型为CanvasGradient时,表示æ¸å˜å¯¹è±¡ï¼Œä½¿ç”¨[createLinearGradient](#createlineargradient)方法创建。<br/>- 类型为CanvasPattern时,使用[createPattern](#createpattern)方法创建。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [lineCap](#linecap) | CanvasLineCap | æŒ‡å®šçº¿ç«¯ç‚¹çš„æ ·å¼ï¼Œå¯é€‰å€¼ä¸ºï¼š<br/>- 'butt':线端点以方形结æŸã€‚<br/>- 'round':线端点以圆形结æŸã€‚<br/>- 'square':线端点以方形结æŸï¼Œè¯¥æ ·å¼ä¸‹ä¼šå¢žåŠ 一个长度和线段厚度相åŒï¼Œå®½åº¦æ˜¯çº¿æ®µåŽšåº¦ä¸€åŠçš„矩形。<br/>- 默认值:'butt'。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [lineJoin](#linejoin) | CanvasLineJoin | æŒ‡å®šçº¿æ®µé—´ç›¸äº¤çš„äº¤ç‚¹æ ·å¼ï¼Œå¯é€‰å€¼ä¸ºï¼š<br/>- 'round':在线段相连处绘制一个扇形,扇形的圆角åŠå¾„是线段的宽度。<br/>- 'bevel':在线段相连处使用三角形为底填充, æ¯ä¸ªéƒ¨åˆ†çŸ©å½¢æ‹è§’独立。<br/>- 'miter':在相连部分的外边缘处进行延伸,使其相交于一点,形æˆä¸€ä¸ªè±å½¢åŒºåŸŸï¼Œè¯¥å±žæ€§å¯ä»¥é€šè¿‡è®¾ç½®miterLimit属性展现效果。<br/>- 默认值:'miter'。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [miterLimit](#miterlimit) | number | 设置斜接é¢é™åˆ¶å€¼ï¼Œè¯¥å€¼æŒ‡å®šäº†çº¿æ¡ç›¸äº¤å¤„内角和外角的è·ç¦»ã€‚ <br/>- 默认值:10。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [font](#font) | string | 设置文本绘制ä¸çš„å—ä½“æ ·å¼ã€‚<br/>è¯æ³•ï¼šctx.font='font-size font-family'<br/>- font-size(å¯é€‰),指定å—å·å’Œè¡Œé«˜ï¼Œå•ä½åªæ”¯æŒpx。<br/>- font-family(å¯é€‰),指定å—体系列。<br/>è¯æ³•ï¼šctx.font='font-style font-weight font-size font-family'<br/>- font-style(å¯é€‰),用于指定å—ä½“æ ·å¼ï¼Œæ”¯æŒå¦‚ä¸‹å‡ ç§æ ·å¼ï¼š'normal','italic'。<br/>- font-weight(å¯é€‰),用于指定å—体的粗细,支æŒå¦‚ä¸‹å‡ ç§ç±»åž‹ï¼š'normal', 'bold', 'bolder', 'lighter', 100, 200, 300, 400, 500, 600, 700, 800, 900。<br/>- font-size(å¯é€‰),指定å—å·å’Œè¡Œé«˜ï¼Œå•ä½æ”¯æŒpxã€vp。使用时需è¦æ·»åŠ å•ä½ã€‚<br/>- font-family(å¯é€‰),指定å—体系列,支æŒå¦‚ä¸‹å‡ ç§ç±»åž‹ï¼š'sans-serif', 'serif', 'monospace'。<br/>- 默认值:'normal normal 14px sans-serif'。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [textAlign](#textalign) | CanvasTextAlign | 设置文本绘制ä¸çš„文本对é½æ–¹å¼ï¼Œå¯é€‰å€¼ä¸ºï¼š<br/>- 'left':文本左对é½ã€‚<br/>- 'right':文本å³å¯¹é½ã€‚<br/>- 'center':文本居ä¸å¯¹é½ã€‚<br/>- 'start':文本对é½ç•Œçº¿å¼€å§‹çš„地方。<br/>- 'end':文本对é½ç•Œçº¿ç»“æŸçš„地方。<br/>> **说明:**<br/>> ltr布局模å¼ä¸‹'start'å’Œ'left'一致,rtl布局模å¼ä¸‹'start'å’Œ'right'一致·。<br/>- 默认值:'left'。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [textBaseline](#textbaseline) | CanvasTextBaseline | 设置文本绘制ä¸çš„水平对é½æ–¹å¼ï¼Œå¯é€‰å€¼ä¸ºï¼š<br/>- 'alphabetic'ï¼šæ–‡æœ¬åŸºçº¿æ˜¯æ ‡å‡†çš„å—æ¯åŸºçº¿ã€‚<br/>- 'top':文本基线在文本å—的顶部。<br/>- 'hanging':文本基线是悬挂基线。<br/>- 'middle':文本基线在文本å—çš„ä¸é—´ã€‚<br/>- 'ideographic':文å—基线是表æ„å—基线;如果å—符本身超出了alphabetic基线,那么ideograhpic基线ä½ç½®åœ¨å—符本身的底部。<br/>- 'bottom':文本基线在文本å—的底部。 与ideographic基线的区别在于ideographic基线ä¸éœ€è¦è€ƒè™‘下行å—æ¯ã€‚<br/>- 默认值:'alphabetic'。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [globalAlpha](#globalalpha) | number | 设置é€æ˜Žåº¦ï¼Œ0.0为完全é€æ˜Žï¼Œ1.0为完全ä¸é€æ˜Žã€‚ | -| [lineDashOffset](#linedashoffset) | number | 设置画布的虚线å移é‡ï¼Œç²¾åº¦ä¸ºfloat。 <br/>- 默认值:0.0。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [globalCompositeOperation](#globalcompositeoperation) | string | 设置åˆæˆæ“作的方å¼ã€‚类型å—段å¯é€‰å€¼æœ‰'source-over','source-atop','source-in','source-out','destination-over','destination-atop','destination-in','destination-out','lighter','copy','xor'。<br/>- 默认值:'source-over'。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [shadowBlur](#shadowblur) | number | 设置绘制阴影时的模糊级别,值越大越模糊,精度为float。 <br/>- 默认值:0.0。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [shadowColor](#shadowcolor) | string | 设置绘制阴影时的阴影颜色。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [shadowOffsetX](#shadowoffsetx) | number | 设置绘制阴影时和原有对象的水平å移值。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [shadowOffsetY](#shadowoffsety) | number | 设置绘制阴影时和原有对象的垂直å移值。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [imageSmoothingEnabled](#imagesmoothingenabled) | boolean | 用于设置绘制图片时是å¦è¿›è¡Œå›¾åƒå¹³æ»‘度调整,true为å¯ç”¨ï¼Œfalse为ä¸å¯ç”¨ã€‚ <br/>- 默认值:true。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [imageSmoothingQuality](#imagesmoothingquality) |ImageSmoothingQuality | imageSmoothingEnabled为true时,用于设置图åƒå¹³æ»‘度。å¯é€‰å€¼ä¸ºï¼š<br/>- 'low':低画质<br/>- 'medium':ä¸ç”»è´¨<br/>- 'high':高画质。<br/>默认值:low<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [direction](#direction) |CanvasDirection | 用于设置绘制文å—时使用的文å—æ–¹å‘。å¯é€‰å€¼ä¸ºï¼š<br/>- 'inherit':继承canvas组件已设定的文本方å‘<br/>- 'ltr':从左往å³<br/>- 'rtl':从å³å¾€å·¦ã€‚<br/>默认值:inherit<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | -| [filter](#filter) |string | 用于设置图åƒçš„滤镜。支æŒçš„滤镜效果如下:<br/>- 'none': æ— æ»¤é•œæ•ˆæžœ<br/>- 'blur':给图åƒè®¾ç½®é«˜æ–¯æ¨¡ç³Š<br/>- 'brightness':给图片应用一ç§çº¿æ€§ä¹˜æ³•ï¼Œä½¿å…¶çœ‹èµ·æ¥æ›´äº®æˆ–æ›´æš—<br/>- 'contrast':调整图åƒçš„对比度<br/>- 'grayscale':将图åƒè½¬æ¢ä¸ºç°åº¦å›¾åƒ<br/>- 'hue-rotate':给图åƒåº”用色相旋转<br/>- 'invert':å转输入图åƒ<br/>- 'opacity':转化图åƒçš„é€æ˜Žç¨‹åº¦<br/>- 'saturate':转æ¢å›¾åƒé¥±å’Œåº¦<br/>- 'sepia':将图åƒè½¬æ¢ä¸ºæ·±è¤è‰²<br/>默认值:'none'<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| å称 | 类型 | æè¿° | +| ---------------------------------------- | ---------------------------------------- | ---------------------------------------- | +| [fillStyle](#fillstyle) | string \|number<sup>10+</sup> \|[CanvasGradient](ts-components-canvas-canvasgradient.md) \| [CanvasPattern](ts-components-canvas-canvaspattern.md#canvaspattern) | 指定绘制的填充色。<br/>- 类型为string时,表示设置填充区域的颜色。<br/>- 类型为number时,表示设置填充区域的颜色。<br/>- 类型为CanvasGradient时,表示æ¸å˜å¯¹è±¡ï¼Œä½¿ç”¨[createLinearGradient](#createlineargradient)方法创建。<br/>- 类型为CanvasPattern时,使用[createPattern](#createpattern)方法创建。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [lineWidth](#linewidth) | number | 设置绘制线æ¡çš„宽度。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [strokeStyle](#strokestyle) | string \|number<sup>10+</sup> \|[CanvasGradient](ts-components-canvas-canvasgradient.md) \| [CanvasPattern](ts-components-canvas-canvaspattern.md#canvaspattern) | 设置æ边的颜色。<br/>- 类型为string时,表示设置æ边使用的颜色。<br/>- 类型为number时,表示设置æ边使用的颜色。<br/>- 类型为CanvasGradient时,表示æ¸å˜å¯¹è±¡ï¼Œä½¿ç”¨[createLinearGradient](#createlineargradient)方法创建。<br/>- 类型为CanvasPattern时,使用[createPattern](#createpattern)方法创建。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [lineCap](#linecap) | CanvasLineCap | æŒ‡å®šçº¿ç«¯ç‚¹çš„æ ·å¼ï¼Œå¯é€‰å€¼ä¸ºï¼š<br/>- 'butt':线端点以方形结æŸã€‚<br/>- 'round':线端点以圆形结æŸã€‚<br/>- 'square':线端点以方形结æŸï¼Œè¯¥æ ·å¼ä¸‹ä¼šå¢žåŠ 一个长度和线段厚度相åŒï¼Œå®½åº¦æ˜¯çº¿æ®µåŽšåº¦ä¸€åŠçš„矩形。<br/>- 默认值:'butt'。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [lineJoin](#linejoin) | CanvasLineJoin | æŒ‡å®šçº¿æ®µé—´ç›¸äº¤çš„äº¤ç‚¹æ ·å¼ï¼Œå¯é€‰å€¼ä¸ºï¼š<br/>- 'round':在线段相连处绘制一个扇形,扇形的圆角åŠå¾„是线段的宽度。<br/>- 'bevel':在线段相连处使用三角形为底填充, æ¯ä¸ªéƒ¨åˆ†çŸ©å½¢æ‹è§’独立。<br/>- 'miter':在相连部分的外边缘处进行延伸,使其相交于一点,形æˆä¸€ä¸ªè±å½¢åŒºåŸŸï¼Œè¯¥å±žæ€§å¯ä»¥é€šè¿‡è®¾ç½®miterLimit属性展现效果。<br/>- 默认值:'miter'。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [miterLimit](#miterlimit) | number | 设置斜接é¢é™åˆ¶å€¼ï¼Œè¯¥å€¼æŒ‡å®šäº†çº¿æ¡ç›¸äº¤å¤„内角和外角的è·ç¦»ã€‚ <br/>- 默认值:10。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [font](#font) | string | 设置文本绘制ä¸çš„å—ä½“æ ·å¼ã€‚<br/>è¯æ³•ï¼šctx.font='font-size font-family'<br/>- font-size(å¯é€‰),指定å—å·å’Œè¡Œé«˜ï¼Œå•ä½åªæ”¯æŒpx。<br/>- font-family(å¯é€‰),指定å—体系列。<br/>è¯æ³•ï¼šctx.font='font-style font-weight font-size font-family'<br/>- font-style(å¯é€‰),用于指定å—ä½“æ ·å¼ï¼Œæ”¯æŒå¦‚ä¸‹å‡ ç§æ ·å¼ï¼š'normal','italic'。<br/>- font-weight(å¯é€‰),用于指定å—体的粗细,支æŒå¦‚ä¸‹å‡ ç§ç±»åž‹ï¼š'normal', 'bold', 'bolder', 'lighter', 100, 200, 300, 400, 500, 600, 700, 800, 900。<br/>- font-size(å¯é€‰),指定å—å·å’Œè¡Œé«˜ï¼Œå•ä½æ”¯æŒpxã€vp。使用时需è¦æ·»åŠ å•ä½ã€‚<br/>- font-family(å¯é€‰),指定å—体系列,支æŒå¦‚ä¸‹å‡ ç§ç±»åž‹ï¼š'sans-serif', 'serif', 'monospace'。<br/>- 默认值:'normal normal 14px sans-serif'。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [textAlign](#textalign) | CanvasTextAlign | 设置文本绘制ä¸çš„文本对é½æ–¹å¼ï¼Œå¯é€‰å€¼ä¸ºï¼š<br/>- 'left':文本左对é½ã€‚<br/>- 'right':文本å³å¯¹é½ã€‚<br/>- 'center':文本居ä¸å¯¹é½ã€‚<br/>- 'start':文本对é½ç•Œçº¿å¼€å§‹çš„地方。<br/>- 'end':文本对é½ç•Œçº¿ç»“æŸçš„地方。<br/>> **说明:**<br/>> ltr布局模å¼ä¸‹'start'å’Œ'left'一致,rtl布局模å¼ä¸‹'start'å’Œ'right'一致·。<br/>- 默认值:'left'。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [textBaseline](#textbaseline) | CanvasTextBaseline | 设置文本绘制ä¸çš„水平对é½æ–¹å¼ï¼Œå¯é€‰å€¼ä¸ºï¼š<br/>- 'alphabetic'ï¼šæ–‡æœ¬åŸºçº¿æ˜¯æ ‡å‡†çš„å—æ¯åŸºçº¿ã€‚<br/>- 'top':文本基线在文本å—的顶部。<br/>- 'hanging':文本基线是悬挂基线。<br/>- 'middle':文本基线在文本å—çš„ä¸é—´ã€‚<br/>- 'ideographic':文å—基线是表æ„å—基线;如果å—符本身超出了alphabetic基线,那么ideograhpic基线ä½ç½®åœ¨å—符本身的底部。<br/>- 'bottom':文本基线在文本å—的底部。 与ideographic基线的区别在于ideographic基线ä¸éœ€è¦è€ƒè™‘下行å—æ¯ã€‚<br/>- 默认值:'alphabetic'。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [globalAlpha](#globalalpha) | number | 设置é€æ˜Žåº¦ï¼Œ0.0为完全é€æ˜Žï¼Œ1.0为完全ä¸é€æ˜Žã€‚ | +| [lineDashOffset](#linedashoffset) | number | 设置画布的虚线å移é‡ï¼Œç²¾åº¦ä¸ºfloat。 <br/>- 默认值:0.0。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [globalCompositeOperation](#globalcompositeoperation) | string | 设置åˆæˆæ“作的方å¼ã€‚类型å—段å¯é€‰å€¼æœ‰'source-over','source-atop','source-in','source-out','destination-over','destination-atop','destination-in','destination-out','lighter','copy','xor'。<br/>- 默认值:'source-over'。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [shadowBlur](#shadowblur) | number | 设置绘制阴影时的模糊级别,值越大越模糊,精度为float。 <br/>- 默认值:0.0。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [shadowColor](#shadowcolor) | string | 设置绘制阴影时的阴影颜色。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [shadowOffsetX](#shadowoffsetx) | number | 设置绘制阴影时和原有对象的水平å移值。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [shadowOffsetY](#shadowoffsety) | number | 设置绘制阴影时和原有对象的垂直å移值。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [imageSmoothingEnabled](#imagesmoothingenabled) | boolean | 用于设置绘制图片时是å¦è¿›è¡Œå›¾åƒå¹³æ»‘度调整,true为å¯ç”¨ï¼Œfalse为ä¸å¯ç”¨ã€‚ <br/>- 默认值:true。<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [imageSmoothingQuality](#imagesmoothingquality) | ImageSmoothingQuality | imageSmoothingEnabled为true时,用于设置图åƒå¹³æ»‘度。å¯é€‰å€¼ä¸ºï¼š<br/>- 'low':低画质<br/>- 'medium':ä¸ç”»è´¨<br/>- 'high':高画质。<br/>默认值:low<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [direction](#direction) | CanvasDirection | 用于设置绘制文å—时使用的文å—æ–¹å‘。å¯é€‰å€¼ä¸ºï¼š<br/>- 'inherit':继承canvas组件已设定的文本方å‘<br/>- 'ltr':从左往å³<br/>- 'rtl':从å³å¾€å·¦ã€‚<br/>默认值:inherit<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | +| [filter](#filter) | string | 用于设置图åƒçš„滤镜。支æŒçš„滤镜效果如下:<br/>- 'none': æ— æ»¤é•œæ•ˆæžœ<br/>- 'blur':给图åƒè®¾ç½®é«˜æ–¯æ¨¡ç³Š<br/>- 'brightness':给图片应用一ç§çº¿æ€§ä¹˜æ³•ï¼Œä½¿å…¶çœ‹èµ·æ¥æ›´äº®æˆ–æ›´æš—<br/>- 'contrast':调整图åƒçš„对比度<br/>- 'grayscale':将图åƒè½¬æ¢ä¸ºç°åº¦å›¾åƒ<br/>- 'hue-rotate':给图åƒåº”用色相旋转<br/>- 'invert':å转输入图åƒ<br/>- 'opacity':转化图åƒçš„é€æ˜Žç¨‹åº¦<br/>- 'saturate':转æ¢å›¾åƒé¥±å’Œåº¦<br/>- 'sepia':将图åƒè½¬æ¢ä¸ºæ·±è¤è‰²<br/>默认值:'none'<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | > **说明:** > fillStyleã€shadowColor与 strokeStyle ä¸stringç±»åž‹æ ¼å¼ä¸º 'rgb(255, 255, 255)','rgba(255, 255, 255, 1.0)','\#FFFFFF'。 @@ -964,8 +964,8 @@ measureText(text: string): TextMetrics **返回值:** -| 类型 | 说明 | -| ----------- | ------------------------------------------------------------ | +| 类型 | 说明 | +| ----------- | ---------------------------------------- | | TextMetrics | 文本的尺寸信æ¯<br/>从API version 9开始,该接å£æ”¯æŒåœ¨ArkTSå¡ç‰‡ä¸ä½¿ç”¨ã€‚ | **TextMetrics类型æè¿°:** @@ -1278,8 +1278,8 @@ createPattern(image: ImageBitmap, repetition: string | null): CanvasPattern | nu **返回值:** -| 类型 | 说明 | -| ------------------------------- | ----------------------- | +| 类型 | 说明 | +| ---------------------------------------- | ----------------------- | | [CanvasPattern](ts-components-canvas-canvaspattern.md#canvaspattern) | 通过指定图åƒå’Œé‡å¤æ–¹å¼åˆ›å»ºå›¾ç‰‡å¡«å……的模æ¿å¯¹è±¡ã€‚ | **示例:** @@ -1538,16 +1538,16 @@ ellipse(x: number, y: number, radiusX: number, radiusY: number, rotation: number **å‚数:** -| å‚æ•° | 类型 | å¿…å¡« | 默认值 | 说明 | -| ---------------- | ------- | ---- | ----- | ----------------- | -| x | number | 是 | 0 | æ¤åœ†åœ†å¿ƒçš„xè½´åæ ‡ã€‚ | -| y | number | 是 | 0 | æ¤åœ†åœ†å¿ƒçš„yè½´åæ ‡ã€‚ | -| radiusX | number | 是 | 0 | æ¤åœ†xè½´çš„åŠå¾„长度。 | -| radiusY | number | 是 | 0 | æ¤åœ†yè½´çš„åŠå¾„长度。 | -| rotation | number | 是 | 0 | æ¤åœ†çš„旋转角度,å•ä½ä¸ºå¼§åº¦ã€‚ | -| startAngle | number | 是 | 0 | æ¤åœ†ç»˜åˆ¶çš„起始点角度,以弧度表示。 | -| endAngle | number | 是 | 0 | æ¤åœ†ç»˜åˆ¶çš„结æŸç‚¹è§’度,以弧度表示。 | -| counterclockwise | boolean | å¦ | false | 是å¦ä»¥é€†æ—¶é’ˆæ–¹å‘绘制æ¤åœ†ã€‚<br>true:逆时针方å‘绘制æ¤åœ†ã€‚<br>false:顺时针方å‘绘制æ¤åœ†ã€‚ | +| å‚æ•° | 类型 | å¿…å¡« | 默认值 | 说明 | +| ---------------- | ------- | ---- | ----- | ---------------------------------------- | +| x | number | 是 | 0 | æ¤åœ†åœ†å¿ƒçš„xè½´åæ ‡ã€‚ | +| y | number | 是 | 0 | æ¤åœ†åœ†å¿ƒçš„yè½´åæ ‡ã€‚ | +| radiusX | number | 是 | 0 | æ¤åœ†xè½´çš„åŠå¾„长度。 | +| radiusY | number | 是 | 0 | æ¤åœ†yè½´çš„åŠå¾„长度。 | +| rotation | number | 是 | 0 | æ¤åœ†çš„旋转角度,å•ä½ä¸ºå¼§åº¦ã€‚ | +| startAngle | number | 是 | 0 | æ¤åœ†ç»˜åˆ¶çš„起始点角度,以弧度表示。 | +| endAngle | number | 是 | 0 | æ¤åœ†ç»˜åˆ¶çš„结æŸç‚¹è§’度,以弧度表示。 | +| counterclockwise | boolean | å¦ | false | 是å¦ä»¥é€†æ—¶é’ˆæ–¹å‘绘制æ¤åœ†ã€‚<br>true:逆时针方å‘绘制æ¤åœ†ã€‚<br>false:顺时针方å‘绘制æ¤åœ†ã€‚ | **示例:** @@ -1794,7 +1794,7 @@ clip(path:Path2D, fillRule?: CanvasFillRule): void | å‚æ•° | 类型 | å¿…å¡« | 默认值 | æè¿° | | -------- | -------------- | ---- | --------- | ---------------------------------------- | -| path | Path2D | 是 | | Path2D剪切路径。 | +| path | Path2D | 是 | | Path2D剪切路径。 | | fillRule | CanvasFillRule | å¦ | "nonzero" | 指定è¦å‰ªåˆ‡å¯¹è±¡çš„规则。<br/>å¯é€‰å‚数为:"nonzero", "evenodd"。 | **示例:** @@ -1850,8 +1850,8 @@ filter(filter: string): void **å‚æ•°:** -| å‚æ•° | 类型 | å¿…å¡« | 默认值 | 说明 | -| ------ | ------ | ---- | ---- | ------------ | +| å‚æ•° | 类型 | å¿…å¡« | 默认值 | 说明 | +| ------ | ------ | ---- | ---- | ---------------------------------------- | | filter | string | 是 | - | 接å—å„类滤镜效果的函数。支æŒçš„滤镜效果如下:<br/>- 'none': æ— æ»¤é•œæ•ˆæžœ<br/>- 'blur':给图åƒè®¾ç½®é«˜æ–¯æ¨¡ç³Š<br/>- 'brightness':给图片应用一ç§çº¿æ€§ä¹˜æ³•ï¼Œä½¿å…¶çœ‹èµ·æ¥æ›´äº®æˆ–æ›´æš—<br/>- 'contrast':调整图åƒçš„对比度<br/>- 'grayscale':将图åƒè½¬æ¢ä¸ºç°åº¦å›¾åƒ<br/>- 'hue-rotate':给图åƒåº”用色相旋转<br/>- 'invert':å转输入图åƒ<br/>- 'opacity':转化图åƒçš„é€æ˜Žç¨‹åº¦<br/>- 'saturate':转æ¢å›¾åƒé¥±å’Œåº¦<br/>- 'sepia':将图åƒè½¬æ¢ä¸ºæ·±è¤è‰²<br/>默认值:'none' | **示例:** @@ -1927,8 +1927,8 @@ getTransform(): Matrix2D **返回值:** -| 类型 | 说明 | -| ----------------------------------------------------- | ---------- | +| 类型 | 说明 | +| ---------------------------------------- | ----- | | [Matrix2D](ts-components-canvas-matrix2d.md#Matrix2D) | 矩阵对象。 | ### resetTransform @@ -2460,15 +2460,15 @@ putImageData(imageData: Object, dx: number | string, dy: number | string, dirtyX **å‚数:** -| å‚æ•° | 类型 | å¿…å¡« | 默认值 | æè¿° | -| ----------- | ---------------------------------------- | ---- | --------------- | --------------------------------------------------------- | -| imagedata | Object | 是 | null | 包å«åƒç´ 值的ImageData对象。 | -| dx | number \| string<sup>10+</sup> | 是 | 0 | 填充区域在xè½´æ–¹å‘çš„å移é‡ã€‚ | -| dy | number \| string<sup>10+</sup> | 是 | 0 | 填充区域在yè½´æ–¹å‘çš„å移é‡ã€‚ | -| dirtyX | number \| string<sup>10+</sup> | å¦ | 0 | æºå›¾åƒæ•°æ®çŸ©å½¢è£åˆ‡èŒƒå›´å·¦ä¸Šè§’è·ç¦»æºå›¾åƒå·¦ä¸Šè§’çš„xè½´å移é‡ã€‚ | -| dirtyY | number \| string<sup>10+</sup> | å¦ | 0 | æºå›¾åƒæ•°æ®çŸ©å½¢è£åˆ‡èŒƒå›´å·¦ä¸Šè§’è·ç¦»æºå›¾åƒå·¦ä¸Šè§’çš„yè½´å移é‡ã€‚ | -| dirtyWidth | number \| string<sup>10+</sup> | å¦ | imagedata的宽度 | æºå›¾åƒæ•°æ®çŸ©å½¢è£åˆ‡èŒƒå›´çš„宽度。 | -| dirtyHeight | number \| string<sup>10+</sup> | å¦ | imagedata的高度 | æºå›¾åƒæ•°æ®çŸ©å½¢è£åˆ‡èŒƒå›´çš„高度。 | +| å‚æ•° | 类型 | å¿…å¡« | 默认值 | æè¿° | +| ----------- | ---------------------------------------- | ---- | ------------ | ----------------------------- | +| imagedata | Object | 是 | null | 包å«åƒç´ 值的ImageData对象。 | +| dx | number \| string<sup>10+</sup> | 是 | 0 | 填充区域在xè½´æ–¹å‘çš„å移é‡ã€‚ | +| dy | number \| string<sup>10+</sup> | 是 | 0 | 填充区域在yè½´æ–¹å‘çš„å移é‡ã€‚ | +| dirtyX | number \| string<sup>10+</sup> | å¦ | 0 | æºå›¾åƒæ•°æ®çŸ©å½¢è£åˆ‡èŒƒå›´å·¦ä¸Šè§’è·ç¦»æºå›¾åƒå·¦ä¸Šè§’çš„xè½´å移é‡ã€‚ | +| dirtyY | number \| string<sup>10+</sup> | å¦ | 0 | æºå›¾åƒæ•°æ®çŸ©å½¢è£åˆ‡èŒƒå›´å·¦ä¸Šè§’è·ç¦»æºå›¾åƒå·¦ä¸Šè§’çš„yè½´å移é‡ã€‚ | +| dirtyWidth | number \| string<sup>10+</sup> | å¦ | imagedata的宽度 | æºå›¾åƒæ•°æ®çŸ©å½¢è£åˆ‡èŒƒå›´çš„宽度。 | +| dirtyHeight | number \| string<sup>10+</sup> | å¦ | imagedata的高度 | æºå›¾åƒæ•°æ®çŸ©å½¢è£åˆ‡èŒƒå›´çš„高度。 | **示例:** @@ -2963,11 +2963,11 @@ createConicGradient(startAngle: number, x: number, y: number): CanvasGradient **å‚数:** -| å‚æ•° | 类型 | å¿…å¡« | 默认值 | æè¿° | -| ---------- | ------ | ---- | ------ | ------------------------------------------------------------ | -| startAngle | number | 是 | 0 | 开始æ¸å˜çš„角度,以弧度为å•ä½ã€‚角度测é‡ä»Žä¸å¿ƒå³ä¾§æ°´å¹³å¼€å§‹ï¼Œé¡ºæ—¶é’ˆç§»åŠ¨ã€‚ | -| x | number | 是 | 0 | 圆锥æ¸å˜çš„ä¸å¿ƒxè½´åæ ‡ã€‚å•ä½ï¼švp | -| y | number | 是 | 0 | 圆锥æ¸å˜çš„ä¸å¿ƒyè½´åæ ‡ã€‚å•ä½ï¼švp | +| å‚æ•° | 类型 | å¿…å¡« | 默认值 | æè¿° | +| ---------- | ------ | ---- | ---- | ----------------------------------- | +| startAngle | number | 是 | 0 | 开始æ¸å˜çš„角度,以弧度为å•ä½ã€‚角度测é‡ä»Žä¸å¿ƒå³ä¾§æ°´å¹³å¼€å§‹ï¼Œé¡ºæ—¶é’ˆç§»åŠ¨ã€‚ | +| x | number | 是 | 0 | 圆锥æ¸å˜çš„ä¸å¿ƒxè½´åæ ‡ã€‚å•ä½ï¼švp | +| y | number | 是 | 0 | 圆锥æ¸å˜çš„ä¸å¿ƒyè½´åæ ‡ã€‚å•ä½ï¼švp | **示例:** diff --git a/zh-cn/application-dev/ui/arkts-graphics-display.md b/zh-cn/application-dev/ui/arkts-graphics-display.md index 44816912f12dbadf3a0fc32add3a512d373fc587..353a6446dd0a04acb19a8bf72c45a98020426448 100644 --- a/zh-cn/application-dev/ui/arkts-graphics-display.md +++ b/zh-cn/application-dev/ui/arkts-graphics-display.md @@ -26,6 +26,7 @@ Image支æŒåŠ è½½å˜æ¡£å›¾ã€å¤šåª’体åƒç´ 图两ç§ç±»åž‹ã€‚ å˜æ¡£å›¾ç±»åž‹çš„æ•°æ®æºå¯ä»¥åˆ†ä¸ºæœ¬åœ°èµ„æºã€ç½‘络资æºã€Resource资æºã€åª’体库datashare资æºå’Œbase64。 - æœ¬åœ°èµ„æº + 创建文件夹,将本地图片放入ets文件夹下的任æ„ä½ç½®ã€‚ Image组件引入本地图片路径,å³å¯æ˜¾ç¤ºå›¾ç‰‡ï¼ˆæ ¹ç›®å½•ä¸ºets文件夹)。 @@ -36,6 +37,7 @@ Image支æŒåŠ è½½å˜æ¡£å›¾ã€å¤šåª’体åƒç´ 图两ç§ç±»åž‹ã€‚ ``` - ç½‘ç»œèµ„æº + 引入网络图片需申请æƒé™ohos.permission.INTERNET,具体申请方å¼è¯·å‚考[æƒé™ç”³è¯·å£°æ˜Ž](../security/accesstoken-guidelines.md)。æ¤æ—¶ï¼ŒImage组件的srcå‚数为网络图片的链接。 ```ts @@ -43,6 +45,7 @@ Image支æŒåŠ è½½å˜æ¡£å›¾ã€å¤šåª’体åƒç´ 图两ç§ç±»åž‹ã€‚ ``` - Resourceèµ„æº + 使用资æºæ ¼å¼å¯ä»¥è·¨åŒ…/跨模å—引入图片,resources文件夹下的图片都å¯ä»¥é€šè¿‡$r资æºæŽ¥å£è¯» å–到并转æ¢åˆ°Resourceæ ¼å¼ã€‚ **图1** resouces  @@ -59,7 +62,7 @@ Image支æŒåŠ è½½å˜æ¡£å›¾ã€å¤šåª’体åƒç´ 图两ç§ç±»åž‹ã€‚ **图2** rawfile  -  +  调用方å¼ï¼š @@ -68,6 +71,7 @@ Image支æŒåŠ è½½å˜æ¡£å›¾ã€å¤šåª’体åƒç´ 图两ç§ç±»åž‹ã€‚ ``` - 媒体库datashare + 支æŒdatashare://路径å‰ç¼€çš„å—符串,用于访问通过媒体库æ供的图片路径。 1. 调用接å£èŽ·å–图库的照片url。 diff --git a/zh-cn/application-dev/web/web-in-page-app-function-invoking.md b/zh-cn/application-dev/web/web-in-page-app-function-invoking.md index caffe3d2cc2a18efae36fd67650113202e5e4d2d..9b7fdaeab713bf68fede9bc49800508f30cf9e5e 100644 --- a/zh-cn/application-dev/web/web-in-page-app-function-invoking.md +++ b/zh-cn/application-dev/web/web-in-page-app-function-invoking.md @@ -92,7 +92,7 @@ > 使用[registerJavaScriptProxy()](../reference/apis/js-apis-webview.md#registerjavascriptproxy)接å£æ³¨å†Œæ–¹æ³•æ—¶ï¼Œæ³¨å†ŒåŽéœ€è°ƒç”¨[refresh()](../reference/apis/js-apis-webview.md#refresh)接å£ç”Ÿæ•ˆã€‚ -- index.htmå‰ç«¯é¡µé¢è§¦å‘应用侧代ç 。 +- index.htmlå‰ç«¯é¡µé¢è§¦å‘应用侧代ç 。 ```html <!-- index.html --> diff --git a/zh-cn/application-dev/website.md b/zh-cn/application-dev/website.md index 5ac5f15882a73bc8e97baa054cf5c5c0f254de14..fe50393cfc6e8066e16301d05e85efaf5929b9f7 100644 --- a/zh-cn/application-dev/website.md +++ b/zh-cn/application-dev/website.md @@ -713,15 +713,16 @@ - [颜色æ¸å˜](reference/arkui-ts/ts-universal-attributes-gradient-color.md) - [Popup控制](reference/arkui-ts/ts-universal-attributes-popup.md) - [Menu控制](reference/arkui-ts/ts-universal-attributes-menu.md) - - [点击控制](reference/arkui-ts/ts-universal-attributes-click.md) - [焦点控制](reference/arkui-ts/ts-universal-attributes-focus.md) - [悬浮æ€æ•ˆæžœ](reference/arkui-ts/ts-universal-attributes-hover-effect.md) - [ç»„ä»¶æ ‡è¯†](reference/arkui-ts/ts-universal-attributes-component-id.md) - - [触摸çƒåŒºè®¾ç½®](reference/arkui-ts/ts-universal-attributes-touch-target.md) - [多æ€æ ·å¼](reference/arkui-ts/ts-universal-attributes-polymorphic-style.md) - - [触摸测试控制](reference/arkui-ts/ts-universal-attributes-hit-test-behavior.md) - [分布å¼è¿ç§»æ ‡è¯†](reference/arkui-ts/ts-universal-attributes-restoreId.md) - [å‰æ™¯è‰²è®¾ç½®](reference/arkui-ts/ts-universal-attributes-foreground-color.md) + - 触摸交互控制 + - [点击控制](reference/arkui-ts/ts-universal-attributes-click.md) + - [触摸çƒåŒºè®¾ç½®](reference/arkui-ts/ts-universal-attributes-touch-target.md) + - [触摸测试控制](reference/arkui-ts/ts-universal-attributes-hit-test-behavior.md) - 模æ€è½¬åœºè®¾ç½® - [å…¨å±æ¨¡æ€è½¬åœº](reference/arkui-ts/ts-universal-attributes-modal-transition.md) - [åŠæ¨¡æ€è½¬åœº](reference/arkui-ts/ts-universal-attributes-sheet-transition.md)