g6/shapeProperties.en.md at e657fef1a96c92e2843869ddd018bbe293f154ce

test/g6

mirror of https://gitee.com/antv/g6.git synced 2024-12-16 02:21:25 +08:00

Yanyan-Wang 3095544cdf chore: commit history cleaning

2023-02-02 10:31:36 +08:00

14 KiB

Raw Blame History

title	order
Shape Style Properties	8

Shape is the basic element on an item (node/edge). The style of a node or an edge corresponds to the shape properties of its keyShape (key shape). The style in labelCfg of a label on a node or an edge corresponds to the properties of text shape.

group.addShape('rect', {
  attrs: {
    fill: 'red',
    shadowOffsetX: 10,
    shadowOffsetY: 10,
    shadowColor: 'blue',
    shadowBlur: 10,
    opacity: 0.8,
  },
  // must be assigned in G6 3.3 and later versions. it can be any string you want, but should be unique in a custom item type
  name: 'rect-shape',
});

G6 has these shapes:

circle;
rect;
ellipse;
polygon;
image;
marker;
path;
text;
dom(svg): DOM (available only when the renderer of Graph instance is 'svg').

Common Property

name

String required

Must be assigned in G6 3.3 and later versions. It can be any string you want but must be unique in a custom node/edge/combo type. Otherwise, the style updating might be wrong.

fill

String optional

The color(RGB or Hex) or gradient color for filling. The corresponding property in canvas is fillStyle. Examples: rgb(18, 150, 231),#c193af,l(0) 0:#ffffff 0.5:#7ec2f3 1:#1890ff, r(0.5, 0.5, 0.1) 0:#ffffff 1:#1890ff.

stroke

String optional

The color(RGB or Hex) or gradient color for stroke. The corresponding property in canvas is strokeStyle. Examples: rgb(18, 150, 231),#c193af,l(0) 0:#ffffff 0.5:#7ec2f3 1:#1890ff, r(0.5, 0.5, 0.1) 0:#ffffff 1:#1890ff.

lineWidth

Number optional

The width of the stroke.

lineDash

Number | Number[] optional

The lineDash of the stroke. If its type is Number[], the elements in the array are the lengths of the lineDash.

shadowColor

String optional

The color of the shadow.

shadowBlur

Number optional

The blur level for shadow. Larger the value, more blur.

shadowOffsetX

Number optional

The horizontal offset of the shadow.

shadowOffsetY

Number optional

The vertical offset of the shadow.

opacity

Number optional

The opacity (alpha value) of the shape. The corresponding property in canvas is globalAlpha.

fillOpacity

Number optional

The filling opacity (alpha value) of the shape. The priority is higher than opacity. Range [0, 1].

strokeOpacity

Number optional

The stroke opacity (alpha value) of the shape. The priority is higher than opacity. Range [0, 1].

cursor

String optional

The type of the mouse when hovering the node. The options are the same as cursor in CSS.

Circle

group.addShape('circle', {
  attrs: {
    x: 100,
    y: 100,
    r: 50,
    fill: 'blue',
  },
  // must be assigned in G6 3.3 and later versions. it can be any string you want, but should be unique in a custom item type
  name: 'circle-shape',
});

x

Number optional

The x of the center of the circle.

y

Number optional

The y of the center of the circle.

r

Number optional

The radius of the circle.

Ellipse

group.addShape('ellipse', {
  attrs: {
    x: 100,
    y: 100,
    rx: 50,
    ry: 50,
    fill: 'blue',
  },
  // must be assigned in G6 3.3 and later versions. it can be any string you want, but should be unique in a custom item type
  name: 'ellipse-shape',
});

x

Number optional

The x of the center of the ellipse.

y

Number optional

The y of the center of the ellipse.

rx

Number optional

The horizontal raidus of the ellipse.

ry

Number optional

The vertical raidus of the ellipse.

Image

group.addShape('image', {
  attrs: {
    x: 0,
    y: 0,
    img: 'https://g.alicdn.com/cm-design/arms-trace/1.0.155/styles/armsTrace/images/TAIR.png',
  },
  // must be assigned in G6 3.3 and later versions. it can be any string you want, but should be unique in a custom item type
  name: 'image-shape',
});

x

Number optional

The x of the left top of the image.

y

Number optional

The y of the left top of the image.

width

Number optional

The width of the image.

height

Number optional

The height of the image.

img

String optional

The source of the image.G6 supports multiple image formats:
- url
- ImageData
- Image
- canvas
.

Marker

// use the built-in symbol
group.addShape('marker', {
  attrs: {
    x: 10,
    y: 10,
    r: 10,
    symbol: 'triangle-down',
  },
  // must be assigned in G6 3.3 and later versions. it can be any string you want, but should be unique in a custom item type
  name: 'marker-shape',
});

// custom the symbol with path
group.addShape('marker', {
  attrs: {
    x: 10,
    y: 10,
    r: 10,
    symbol: function (x, y, r) {
      return [['M', x, y], ['L', x + r, y + r], ['L', x + r * 2, y], ['Z']];
    },
  },
  // must be assigned in G6 3.3 and later versions. it can be any string you want, but should be unique in a custom item type
  name: 'marker-shape',
});

x

Number optional

The x of the center of the marker.

y

Number optional

The y of the center of the marker.

r

Number optional

The radius of the marker.

symbol

String | Function optional

The shape name.There are several built-in shapes: 'circle', 'square', 'diamond', 'triangle', 'triangle-down', you can use them with the String names. And user could customize a shape as marker.

Polygon

group.addShape('polygon', {
  attrs: {
    points: [
      [30, 30],
      [40, 20],
      [30, 50],
      [60, 100],
    ],
    fill: 'red',
  },
  // must be assigned in G6 3.3 and later versions. it can be any string you want, but should be unique in a custom item type
  name: 'polygon-shape',
});

points

Array optional

The coordinates of the points on the polygon.

Rect

group.addShape('rect', {
  attrs: {
    x: 150,
    y: 150,
    width: 150,
    height: 150,
    stroke: 'black',
    radius: [2, 4],
  },
  // must be assigned in G6 3.3 and later versions. it can be any string you want, but should be unique in a custom item type
  name: 'rect-shape',
});

x

Number optional

The x of left top of the rect.

y

Number optional

The y of left top of the rect.

width

Number optional

The width of the rect.

height

Number optional

The height of the rect.

radius

Number | Number[] optional

The border radius. It can be an integer or an array, representing the border radii of lefttop, righttop, rightbottom, leftbotton respectively.
- radius = 1 or radius = [ 1 ] is equal to radius = [ 1, 1, 1, 1 ]
- radius = [ 1, 2 ] is equal to radius = [ 1, 2, 1, 2 ]
- radius: [ 1, 2, 3 ] is equal to radius: [ 1, 2, 3, 2 ]

Path

⚠️Attention: When the edge is too thin to be hitted by mouse, set lineAppendWidth to enlarge the hitting area.

group.addShape('path', {
  attrs: {
    startArrow: {
      // The custom arrow is a path points at (0, 0), and its tail points to the positive direction of x-axis
      path: 'M 0,0 L 20,10 L 20,-10 Z',
      // the offset of the arrow, nagtive value means the arrow is moved alone the positive direction of x-axis
      // d: -10
    },
    endArrow: {
      // The custom arrow is a path points at (0, 0), and its tail points to the positive direction of x-axis
      path: 'M 0,0 L 20,10 L 20,-10 Z',
      // the offset of the arrow, nagtive value means the arrow is moved alone the positive direction of x-axis
      // d: -10
    },
    path: [
      ['M', 100, 100],
      ['L', 200, 200],
    ],
    stroke: '#000',
    lineWidth: 8,
    lineAppendWidth: 5,
  },
  // must be assigned in G6 3.3 and later versions. it can be any string you want, but should be unique in a custom item type
  name: 'path-shape',
});

path

String | Array optional

The path. Refer to SVG path.

startArrow

Boolean | Object optional

The arrow on the start of the path. When startArrow is true, show a default arrow on the start of the path. User can custom an arrow by path.

endArrow

Boolean | Object optional

The arrow on the end of the path. When endArrow is true, show a default arrow on the end of the path. User can custom an arrow by path.

lineAppendWidth

Number optional

The hitting area of the path. Enlarge the hitting area by enlarging its value.

lineCap

String optional default: 'miter'

The style of two ends of the path. Options:
- 'bevel'
- 'round'
- 'miter'(default)

lineJoin

String optional default: 'miter'

The style of the intersection of two path. Options:
- 'bevel'
- 'round'
- 'miter'(default)

lineWidth

Number optional

The line width of the current path.

miterLimit

Number optional

The maximum miter length.

lineDash

Number | Number[] optional

The style of the dash line. It is an array that describes the length of gaps and line segments. If the number of the elements in the array is odd, the elements will be dulplicated. Such as [5, 15, 25] will be regarded as [5, 15, 25, 5, 15, 25].

Text

group.addShape('text', {
  attrs: {
    text: 'test text',
    fill: 'red',
    fontWeight: 400,
    shadowOffsetX: 10,
    shadowOffsetY: 10,
    shadowColor: 'blue',
    shadowBlur: 10,
  },
  // must be assigned in G6 3.3 and later versions. it can be any string you want, but should be unique in a custom item type
  name: 'text-shape',
});

text

String optional

The text content of the text shape.

textAlign

String optional

The align way of the text. Options: 'center' / 'end' / 'left' / 'right' / 'start'. 'start' by default.

textBaseline

String optional

The base line of the text. Options:
'top' / 'middle' / 'bottom' / 'alphabetic' / 'hanging'. 'bottom' by default.

fontStyle

String optional

The font style of the text. The corresponding property in CSS is font-style.

fontVariant

String optional

The font variant of the text. The corresponding property in CSS is font-variant.

fontWeight

Number optional

The font weight of the text. The corresponding property in CSS is font-weight.

fontFamily

String optional

The font family of the text. The corresponding property in CSS is font-family.

lineHeight

Number optional

Line height of the text. The corresponding property in CSS is line-height.

DOM (svg)

This shape is available only when the renderer is assgined to 'svg' for graph instance.

⚠️ Attention:

Only support native HTML DOM, but not react or other components;
If you custom a Node type or an Edge type with dom shape, please use the original DOM events instead of events of G6.
In Safari, if you assign position:relative for the a dom node, the rendered position might be unexpected. It is related to the foreignObject bug of Safari. Issus.

group.addShape('dom', {
  attrs: {
    width: cfg.size[0],
    height: cfg.size[1],
    // DOM's html
    html: `
    <div style="background-color: #fff; border: 2px solid #5B8FF9; border-radius: 5px; width: ${
      cfg.size[0] - 5
    }px; height: ${cfg.size[1] - 5}px; display: flex;">
      <div style="height: 100%; width: 33%; background-color: #CDDDFD">
        <img alt="img" style="line-height: 100%; padding-top: 6px; padding-left: 8px;" src="https://gw.alipayobjects.com/mdn/rms_f8c6a0/afts/img/A*Q_FQT6nwEC8AAAAAAAAAAABkARQnAQ" width="20" height="20" />  
      </div>
      <span style="margin:auto; padding:auto; color: #5B8FF9">${cfg.label}</span>
    </div>
      `,
  },
  // must be assigned in G6 3.3 and later versions. it can be any string you want, but should be unique in a custom item type
  name: 'dom-shape',
  draggable: true,
});

html

String optional

The HTML value for DOM shape.

14 KiB Raw Blame History

Common Property

name

fill

stroke

lineWidth

lineDash

shadowColor

shadowBlur

shadowOffsetX

shadowOffsetY

opacity

fillOpacity

strokeOpacity

cursor

Circle

x

y

r

Ellipse

x

y

rx

ry

Image

x

y

width

height

img

Marker

x

y

r

symbol

Polygon

points

Rect

x

y

width

height

radius

Path

path

startArrow

endArrow

lineAppendWidth

lineCap

lineJoin

lineWidth

miterLimit

lineDash

Text

text

textAlign

textBaseline

fontStyle

fontVariant

fontWeight

fontSize

fontFamily

lineHeight

DOM (svg)

html

14 KiB

Raw Blame History