Skip to content

Conversation

Whf0403
Copy link
Contributor

@Whf0403 Whf0403 commented Mar 13, 2025

improve documentation/element/edge configuration

Copy link

Walkthrough

This pull request focuses on improving the documentation related to the configuration of elements and edges in the G6 library. It includes updates to various markdown files to enhance clarity and provide examples for better understanding.

Changes

File Summary
packages/site/common/shape.md Removed sections on BaseStyleProps, TextStyleProps, and RectStyleProps.
packages/site/docs/manual/element/edge/build-in/BaseEdge.zh.md Updated edge configuration descriptions and added examples for edge types and styles.
packages/site/docs/manual/element/edge/build-in/Cubic.zh.md Added an overview and usage scenarios for cubic Bezier curves, along with style configuration details and examples.
packages/site/docs/manual/element/edge/build-in/CubicHorizontal.zh.md Added an overview and usage scenarios for horizontal cubic Bezier curves, along with style configuration details and examples.
packages/site/docs/manual/element/edge/build-in/CubicRadial.zh.md Removed sections on style.controlPoints, style.curveOffset, and style.curvePosition.
packages/site/docs/manual/element/edge/build-in/CubicVertical.zh.md Added an overview and usage scenarios for vertical cubic Bezier curves, along with style configuration details and examples.
packages/site/docs/manual/element/edge/overview.zh.md Enhanced edge configuration instructions with examples and explanations for different edge types and styles.
packages/site/docs/manual/element/node/build-in/Ellipse.zh.md Added an overview and usage scenarios for ellipse nodes.
packages/site/docs/manual/element/node/build-in/Hexagon.zh.md Added an overview and usage scenarios for hexagon nodes, including style configuration details.
packages/site/docs/manual/element/node/build-in/Html.zh.md Added an overview and usage scenarios for HTML nodes, including style configuration details.
packages/site/docs/manual/element/node/build-in/Image.zh.md Added an overview and usage scenarios for image nodes.
packages/site/docs/manual/element/node/build-in/Rect.zh.md Added an overview and usage scenarios for rectangle nodes.
packages/site/docs/manual/element/node/build-in/Star.zh.md Added an overview and usage scenarios for star nodes.
packages/site/docs/manual/element/node/build-in/Triangle.zh.md Added an overview and usage scenarios for triangle nodes.
packages/site/examples/element/edge/demo/cubic.js Replaced fetch API with static data for cubic edge demo.
packages/site/examples/element/edge/demo/horizontal-cubic.js Replaced fetch API with static data for horizontal cubic edge demo.
packages/site/examples/element/edge/demo/line.js Replaced fetch API with static data for line edge demo.
packages/site/examples/element/edge/demo/polyline.js Adjusted controlPoints handling in polyline edge demo.
packages/site/examples/element/edge/demo/quadratic.js Replaced fetch API with static data for quadratic edge demo.
packages/site/examples/element/node/demo/donut.js Added index property to node data in donut node demo.
packages/site/examples/element/node/demo/hexagon.js Added outerR property to hexagon node demo.

Copy link

Walkthrough

This pull request focuses on improving the documentation related to the configuration of elements and edges in the G6 library. It includes updates to various markdown files to enhance clarity and provide examples for better understanding.

Changes

File Summary
packages/site/common/shape.md Removed sections on BaseStyleProps, TextStyleProps, and RectStyleProps.
packages/site/docs/manual/element/edge/build-in/BaseEdge.zh.md Updated edge configuration descriptions and added examples for edge types and styles.
packages/site/docs/manual/element/edge/build-in/Cubic.zh.md Added an overview and usage scenarios for cubic Bezier curves, along with style configuration details and examples.
packages/site/docs/manual/element/edge/build-in/CubicHorizontal.zh.md Added an overview and usage scenarios for horizontal cubic Bezier curves, along with style configuration details and examples.
packages/site/docs/manual/element/edge/build-in/CubicRadial.zh.md Removed sections on style.controlPoints, style.curveOffset, and style.curvePosition.
packages/site/docs/manual/element/edge/build-in/CubicVertical.zh.md Added an overview and usage scenarios for vertical cubic Bezier curves, along with style configuration details and examples.
packages/site/docs/manual/element/edge/overview.zh.md Enhanced edge configuration instructions with examples and explanations for different edge types and styles.
packages/site/docs/manual/element/node/build-in/Ellipse.zh.md Added an overview and usage scenarios for ellipse nodes.
packages/site/docs/manual/element/node/build-in/Hexagon.zh.md Added an overview and usage scenarios for hexagon nodes, including style configuration details.
packages/site/docs/manual/element/node/build-in/Html.zh.md Added an overview and usage scenarios for HTML nodes, including style configuration details.
packages/site/docs/manual/element/node/build-in/Image.zh.md Added an overview and usage scenarios for image nodes.
packages/site/docs/manual/element/node/build-in/Rect.zh.md Added an overview and usage scenarios for rectangle nodes.
packages/site/docs/manual/element/node/build-in/Star.zh.md Added an overview and usage scenarios for star nodes.
packages/site/docs/manual/element/node/build-in/Triangle.zh.md Added an overview and usage scenarios for triangle nodes.
packages/site/examples/element/edge/demo/cubic.js Replaced fetch API with static data for cubic edge demo.
packages/site/examples/element/edge/demo/horizontal-cubic.js Replaced fetch API with static data for horizontal cubic edge demo.
packages/site/examples/element/edge/demo/line.js Replaced fetch API with static data for line edge demo.
packages/site/examples/element/edge/demo/polyline.js Adjusted controlPoints handling in polyline edge demo.
packages/site/examples/element/edge/demo/quadratic.js Replaced fetch API with static data for quadratic edge demo.
packages/site/examples/element/node/demo/donut.js Added index property to node data in donut node demo.
packages/site/examples/element/node/demo/hexagon.js Added outerR property to hexagon node demo.
🪧 Tips For further assistance, please describe your question in the comments and @petercat-assistant to start a conversation with me.

Copy link

Walkthrough

This pull request focuses on improving the documentation related to the configuration of elements and edges in the G6 library. It includes updates to various markdown files to enhance clarity and provide examples for better understanding.

Changes

File Summary
packages/site/common/shape.md Removed sections on BaseStyleProps, TextStyleProps, and RectStyleProps.
packages/site/docs/manual/element/edge/build-in/BaseEdge.zh.md Updated edge configuration descriptions and added examples for edge types and styles.
packages/site/docs/manual/element/edge/build-in/Cubic.zh.md Added an overview and usage scenarios for cubic Bezier curves and updated style configurations.
packages/site/docs/manual/element/edge/build-in/CubicHorizontal.zh.md Added an overview and usage scenarios for horizontal cubic Bezier curves, along with style configuration details.
packages/site/docs/manual/element/edge/build-in/CubicRadial.zh.md Removed sections on style.controlPoints, style.curveOffset, and style.curvePosition.
packages/site/docs/manual/element/edge/build-in/CubicVertical.en.md Added an overview and usage scenarios for vertical cubic Bezier curves.
packages/site/docs/manual/element/edge/build-in/Line.zh.md Added an overview and usage scenarios for line edges, along with style configuration and examples.
packages/site/docs/manual/element/edge/build-in/Quadratic.zh.md Added an overview and usage scenarios for quadratic Bezier curves, along with style configuration details.
packages/site/docs/manual/element/edge/overview.zh.md Enhanced edge configuration instructions with examples and explanations for different edge types and styles.
packages/site/docs/manual/element/edge/build-in/Polyline.zh.md Added overview, usage scenarios, and style configuration for polyline edges.
packages/site/docs/manual/element/node/build-in/Circle.zh.md Added an overview and usage scenarios for circle nodes.
packages/site/docs/manual/element/edge/build-in/CubicRadial.zh.md Removed sections on style.controlPoints, style.curveOffset, and style.curvePosition.
packages/site/docs/manual/element/node/build-in/Hexagon.zh.md Added overview and usage scenarios for hexagon nodes.
packages/site/examples/element/edge/demo/cubic.js Replaced fetch API with static data for cubic edge demo.
packages/site/examples/element/edge/demo/horizontal-cubic.js Replaced fetch API with static data for horizontal cubic edge demo.
packages/site/examples/element/edge/demo/line.js Replaced fetch API with static data for line edge demo.
packages/site/examples/element/edge/demo/polyline.js Adjusted the way control points are defined in polyline edge demo.
packages/site/examples/element/edge/demo/quadratic.js Replaced fetch API with static data for quadratic edge demo.
packages/site/examples/element/edge/demo/line.js Replaced fetch API with static data for line edge demo.
packages/site/examples/element/node/build-in/BaseNode.zh.md Updated node style properties table with additional attributes and descriptions.
packages/site/examples/element/node/demo/donut.js Added index property to node data in donut node demo.
packages/site/docs/manual/element/edge/build-in/Quadratic.zh.md Added overview, usage scenarios, and style configuration for quadratic Bezier curves.
packages/site/docs/manual/element/edge/build-in/Line.zh.md Added overview and usage scenarios for line edges.
packages/site/docs/manual/element/edge/build-in/Polyline.zh.md Added overview and usage scenarios for polyline edges, along with style configuration details.
packages/site/docs/manual/element/edge/build-in/CubicRadial.zh.md Removed sections on style.controlPoints, style.curveOffset, and style.curvePosition.
packages/site/examples/element/custom-node/demo/meta.json Updated JSON structure for node data.
packages/site/examples/element/edge/demo/cubic.js Replaced fetch API with static data and updated edge style configuration.
packages/site/examples/element/edge/demo/horizontal-cubic.js Replaced fetch API with static data and updated edge style configuration.
packages/site/examples/element/edge/demo/line.js Replaced fetch API with static data in line edge demo.
packages/site/examples/element/edge/demo/quadratic.js Replaced fetch API with static data in quadratic edge demo.
packages/site/docs/manual/element/edge/build-in/Line.zh.md Added overview and usage scenarios for line edges.
packages/site/examples/element/node/demo/hexagon.js Added outerR property to node style in hexagon node demo.

@Whf0403 Whf0403 closed this Mar 13, 2025
Copy link

Walkthrough

This pull request focuses on improving the documentation for element and edge configurations in the G6 library. It includes updates to various markdown files, enhancing the descriptions, examples, and style configurations for different edge types such as cubic, cubic-horizontal, cubic-vertical, line, polyline, and quadratic edges. The changes aim to provide clearer guidance and examples for users to better understand and implement these configurations in their projects.

Changes

File Summary
packages/site/common/shape.md Removed sections on BaseStyleProps, TextStyleProps, and RectStyleProps.
packages/site/docs/manual/element/edge/build-in/BaseEdge.zh.md Updated edge configuration with more detailed comments and examples.
packages/site/docs/manual/element/edge/build-in/Cubic.zh.md Added overview and usage scenarios for cubic Bezier curves.
packages/site/docs/manual/element/edge/build-in/CubicHorizontal.zh.md Added overview and usage scenarios for horizontal cubic Bezier curves.
packages/site/docs/manual/element/edge/build-in/CubicRadial.zh.md Removed sections on style attributes.
packages/site/docs/manual/element/edge/build-in/CubicVertical.en.md Added overview and usage scenarios for vertical cubic Bezier curves.
packages/site/docs/manual/element/edge/build-in/CubicVertical.zh.md Added overview and usage scenarios for vertical cubic Bezier curves.
packages/site/docs/manual/element/edge/build-in/Line.zh.md Added overview and usage scenarios for line edges.
packages/site/docs/manual/element/edge/build-in/Polyline.zh.md Added overview and usage scenarios for polyline edges.
packages/site/docs/manual/element/edge/build-in/Quadratic.zh.md Added overview and usage scenarios for quadratic Bezier curves.
packages/site/docs/manual/element/edge/overview.zh.md Enhanced edge configuration instructions with examples and explanations for different edge types and styles.
packages/site/examples/element/edge/demo/cubic.js Replaced fetch API with static data for cubic edge demo.
packages/site/examples/element/edge/demo/horizontal-cubic.js Replaced fetch API with static data for horizontal cubic edge demo.
packages/site/examples/element/edge/demo/line.js Replaced fetch API with static data for line edge demo.
packages/site/examples/element/edge/demo/polyline.js Adjusted the way control points are defined in polyline edge demo.
packages/site/examples/element/edge/demo/quadratic.js Replaced fetch API with static data for quadratic edge demo.
packages/site/examples/element/node/demo/donut.js Added index property to node data in donut node demo.
packages/site/docs/manual/element/node/build-in/Circle.zh.md Added overview and usage scenarios for circle nodes.
packages/site/docs/manual/element/node/build-in/Diamond.zh.md Added overview and usage scenarios for diamond nodes.
packages/site/docs/manual/element/edge/build-in/Line.zh.md Added overview and usage scenarios for line edges.
packages/site/docs/manual/element/edge/build-in/Quadratic.zh.md Added overview, usage scenarios, and style configuration for quadratic Bezier curves.
packages/site/docs/manual/element/edge/build-in/BaseEdge.zh.md Updated edge configuration descriptions and added examples for edge types and styles.
packages/site/docs/manual/element/edge/build-in/Line.zh.md Added overview and usage scenarios for line edges.
packages/site/docs/manual/element/edge/build-in/Polyline.zh.md Added overview, usage scenarios, and style configuration for polyline edges.
packages/site/docs/manual/element/edge/build-in/Cubic.zh.md Added overview and usage scenarios for cubic Bezier curves, along with style configuration details.
packages/site/docs/manual/element/edge/build-in/CubicHorizontal.zh.md Added overview and usage scenarios for horizontal cubic Bezier curves.
packages/site/docs/manual/element/edge/build-in/CubicRadial.zh.md Removed sections on style.controlPoints, style.curveOffset, and style.curvePosition.
packages/site/docs/manual/element/node/build-in/BaseNode.zh.md Updated node style properties table with additional attributes and descriptions.
packages/site/docs/manual/element/edge/build-in/BaseEdge.zh.md Updated edge configuration descriptions and added examples for edge types and styles.
packages/site/docs/manual/element/edge/build-in/BaseEdge.zh.md Updated edge configuration descriptions and added examples for edge types and styles.
packages/site/docs/manual/element/edge/build-in/Quadratic.zh.md Added overview, usage scenarios, and style configuration for quadratic Bezier curves.
packages/site/docs/manual/element/edge/build-in/Quadratic.zh.md Added overview, usage scenarios, and style configuration for quadratic Bezier curves.
packages/site/docs/manual/element/edge/build-in/Line.zh.md Added overview and usage scenarios for line edges.
packages/site/docs/manual/element/edge/build-in/Polyline.zh.md Added overview, usage scenarios, and style configuration for polyline edges.
packages/site/docs/manual/element/edge/build-in/Quadratic.zh.md Added overview, usage scenarios, and style configuration for quadratic Bezier curves.
packages/site/docs/manual/element/edge/build-in/Cubic.zh.md Added overview, usage scenarios, and style configuration for cubic Bezier curves.
packages/site/docs/manual/element/edge/build-in/CubicHorizontal.zh.md Added overview and usage scenarios for horizontal cubic Bezier curves.
packages/site/docs/manual/element/edge/build-in/CubicRadial.zh.md Removed sections on style.controlPoints, style.curveOffset, and style.curvePosition.
packages/site/docs/manual/element/edge/build-in/CubicVertical.zh.md Added overview and usage scenarios for vertical cubic Bezier curves.
packages/site/docs/manual/element/node/build-in/BaseNode.zh.md Updated node configuration descriptions and added examples for node styles.
packages/site/docs/manual/element/edge/build-in/BaseEdge.zh.md Updated edge configuration descriptions and added examples for edge types and styles.
packages/site/docs/manual/element/edge/build-in/BaseEdge.zh.md Updated edge configuration descriptions and added examples for edge types and styles.
`packages/site/examples/element/edge/demo/cubic

@hustcc hustcc changed the title Whf antv docs docs: improve documentation for element/edge configuration Mar 13, 2025
Copy link

Walkthrough

This pull request focuses on improving the documentation for element and edge configurations in the G6 library. It includes updates to various markdown files to enhance clarity and provide examples for better understanding.

Changes

File Summary
packages/site/common/shape.md Removed sections on BaseStyleProps, TextStyleProps, and RectStyleProps.
packages/site/docs/manual/element/edge/build-in/BaseEdge.zh.md Updated edge configuration with more detailed descriptions and added comments for clarity.
packages/site/docs/manual/element/edge/build-in/Cubic.zh.md Added an overview and usage scenarios for cubic Bezier curves, along with style configuration details and examples.
packages/site/docs/manual/element/edge/build-in/CubicHorizontal.zh.md Added an overview and usage scenarios for horizontal cubic Bezier curves, along with style configuration details and examples.
packages/site/docs/manual/element/edge/build-in/CubicRadial.zh.md Removed sections on style attributes.
packages/site/docs/manual/element/edge/build-in/CubicVertical.zh.md Added overview and usage scenarios for vertical cubic Bezier curves.
packages/site/docs/manual/element/edge/build-in/Line.zh.md Added overview and usage scenarios for line edges.
packages/site/docs/manual/element/edge/build-in/Polyline.zh.md Added overview and usage scenarios for polyline edges.
packages/site/docs/manual/element/edge/build-in/Quadratic.zh.md Added overview, usage scenarios, and style configuration for quadratic Bezier curves.
packages/site/docs/manual/element/edge/overview.zh.md Enhanced edge configuration instructions with examples and explanations for different edge types and styles.
packages/site/docs/manual/element/node/build-in/BaseNode.zh.md Updated node style properties table with additional attributes and descriptions.
packages/site/docs/manual/element/node/build-in/Circle.zh.md Added overview and usage scenarios for circle nodes.
packages/site/docs/manual/element/node/build-in/Diamond.zh.md Added overview and usage scenarios for diamond nodes.
packages/site/docs/manual/element/node/build-in/Donut.zh.md Added overview and usage scenarios for donut nodes.
packages/site/docs/manual/element/node/build-in/Ellipse.zh.md Added overview and usage scenarios for ellipse nodes.
packages/site/docs/manual/element/node/build-in/Hexagon.zh.md Added overview and usage scenarios for hexagon nodes.
packages/site/docs/manual/element/node/build-in/Html.zh.md Added overview and usage scenarios for HTML nodes.
packages/site/examples/element/edge/demo/cubic.js Replaced fetch API with static data for cubic edge demo.
packages/site/examples/element/edge/demo/horizontal-cubic.js Replaced fetch API with static data for horizontal cubic edge demo.
packages/site/examples/element/edge/demo/line.js Replaced fetch API with static data for line edge demo.
packages/site/examples/element/edge/demo/polyline.js Adjusted the way control points are defined in polyline edge demo.
packages/site/examples/element/edge/demo/quadratic.js Replaced fetch API with static data for quadratic edge demo.
packages/site/examples/element/node/demo/donut.js Added index property to node data in donut node demo.
packages/site/examples/element/node/demo/hexagon.js Added outerR property to node style in hexagon node demo.

| ----------------- | ---------------------------------------------------- | ---------------------------------------------------- | -------------------- |
| halo | 边光晕是否显示 | boolean | false |
| haloClass | 边光晕className | string | - |
| haloCursor | 边光晕鼠标移入样式,[配置项](#cursor) | strig | `default` |

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is a typo in the type definition for haloCursor. It should be string instead of strig. Please correct this to avoid potential issues.

@Whf0403 Whf0403 reopened this Mar 13, 2025
| filter | 边的阴影的滤镜效果 | string | - |
| increasedLineWidthForHitTesting | 边的宽度过小时,可以用来增大交互区域 | string | number | - |
| isBillboard | 3D 场景中生效,始终朝向屏幕,因此线宽不受透视投影影像 | true | boolean |
| lineDash | 虚线边的偏移量 | 0 | number |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lineDash 的描述形容的是 lineDashOffset?

| badgeBackgroundStroke | 边徽标背景描边颜色 | string | - |
| badgeBackgroundStrokeOpacity | 边徽标背景描边透明度 | number | string | 1 |
| badgeBackgroundVisibility | 边徽标背景是否可见 | `visible` | `hidden` | - |
| badgeBackgroundZIndex | 边徽标背景渲染层级 | number | - |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

边属性的默认值可以看下源码实现补一下

@Whf0403 Whf0403 merged commit 08522f8 into v5 Mar 13, 2025
3 checks passed
@Whf0403 Whf0403 deleted the whf-antv-docs branch March 13, 2025 09:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants