VisActor VBI
  • Tiếng Việt

      • Line

      Khuyến nghị

      - Cấu hình trường được khuyến nghị: 1 chỉ số, 2 chiều

      - Hỗ trợ reshape dữ liệu: ít nhất 1 chỉ số, 0 chiều

      Ánh xạ mã hóa

      Biểu đồ đường hỗ trợ các kênh trực quan sau:

      x : kênh trục x, hỗ trợ nhiều chiều, ánh xạ giá trị chiều lên trục x

      y : kênh trục y, hỗ trợ nhiều chỉ số, ánh xạ giá trị chỉ số lên trục y

      color : kênh màu, hỗ trợ nhiều chiều hoặc một chỉ số; màu theo chiều dùng để phân biệt các chuỗi dữ liệu, màu theo chỉ số dùng để ánh xạ tuyến tính giá trị chỉ số sang màu đồ họa

      tooltip: kênh tooltip, hỗ trợ nhiều chiều và nhiều chỉ số, hiển thị khi di chuột lên điểm dữ liệu

      label : kênh nhãn, hỗ trợ nhiều chiều và nhiều chỉ số, hiển thị nhãn dữ liệu trên điểm dữ liệu

      Mô tả

      Biểu đồ đường phù hợp để hiển thị xu hướng dữ liệu theo thời gian hoặc theo danh mục có thứ tự, bằng cách nối các điểm dữ liệu thành đường xu hướng.

      Kịch bản áp dụng:

      - Hiển thị xu hướng biến đổi của dữ liệu chuỗi thời gian

      - So sánh xu hướng của nhiều chuỗi dữ liệu

      - Phân tích quy luật tăng hoặc giảm của dữ liệu

      Warning

      Yêu cầu dữ liệu:

      - Ít nhất 1 trường số (chỉ số)

      - Chiều đầu tiên được đặt trên trục X; các chiều còn lại sẽ được kết hợp với tên chỉ số khi có nhiều chỉ số và hiển thị như các mục chú giải

      - Tất cả chỉ số sẽ tự động được hợp nhất thành một chỉ số

      Các tính năng bật mặc định:

      - Chú giải, trục, marker điểm dữ liệu, tooltip và đường xu hướng được bật mặc định

      chartType

      Type: "line"

      Mô tả

      Biểu đồ đường, phù hợp để hiển thị xu hướng dữ liệu theo thời gian hoặc theo danh mục có thứ tự

      Ví dụ 'line'

      dataset

      Type: Record[]

      Mô tả

      Tập dữ liệu

      Tập dữ liệu đã tổng hợp phù hợp với quy chuẩn TidyData. Nó định nghĩa nguồn và cấu trúc dữ liệu của biểu đồ. Dữ liệu người dùng nhập không cần tiền xử lý vì VSeed tự động reshape dữ liệu. Dữ liệu biểu đồ vùng cuối cùng được chuyển thành hai chiều và một measure.

      Ví dụ [{month:'Jan', value:100}, {month:'Feb', value:150}, {month:'Mar', value:120}]

      dimensions

      Type: ColumnDimension[] | undefined

      Mô tả

      Chiều

      Chiều đầu tiên được ánh xạ lên trục X; các chiều còn lại được gộp với tên measure khi có nhiều measure và hiển thị thành mục chú giải.

      Ví dụ [{ id: 'month', alias: 'Month' }, { id: 'year', alias: 'Year' }]

      id

      Type: string

      Mô tả

      ID trường tương ứng với chiều

      alias

      Type: string | undefined

      Mô tả

      Bí danh chiều

      timeFormat

      Type: TimeFormat | undefined

      Mô tả

      Cấu hình định dạng ngày của chiều

      type

      Type: "year" | "quarter" | "month" | "week" | "day" | "hour" | "minute" | "second"

      Mô tả

      Độ chi tiết thời gian, quyết định độ chính xác hiển thị ngày

      encoding

      Type: "xAxis" | "color" | "detail" | "tooltip" | "label" | "row" | "column" | undefined

      Mô tả

      Kênh mà chiều được ánh xạ tới

      - xAxis: hỗ trợ ánh xạ nhiều chiều tới trục x

      - color: hỗ trợ ánh xạ nhiều chiều tới kênh màu

      - detail: hỗ trợ ánh xạ nhiều chiều tới kênh chi tiết

      - tooltip: hỗ trợ ánh xạ nhiều chiều tới kênh tooltip

      - label: hỗ trợ ánh xạ nhiều chiều tới kênh nhãn

      - row: hỗ trợ ánh xạ nhiều chiều tới kênh hàng

      - column: hỗ trợ ánh xạ nhiều chiều tới kênh cột

      measures

      Type: ColumnMeasure[] | undefined

      Mô tả

      Measure

      Measure của biểu đồ vùng tự động được gộp thành một measure và ánh xạ lên trục Y. Tên measure được gộp với các chiều khác và hiển thị thành mục chú giải.

      Ví dụ [{id: 'value', alias: 'Value'}]

      id

      Type: string

      Mô tả

      ID measure, phải duy nhất

      alias

      Type: string | undefined

      Mô tả

      Bí danh measure, cho phép trùng; nếu không đặt thì bí danh mặc định là id

      autoFormat

      Type: boolean | undefined

      Mô tả

      Định dạng số tự động, bật mặc định, có ưu tiên cao nhất

      Khi autoFormat=true, nó ghi đè toàn bộ cấu hình numFormat

      Khi bật, nhãn dữ liệu và tooltip của biểu đồ sẽ tự động chọn định dạng phù hợp theo giá trị measure và locale

      Quy tắc định dạng: số thập phân bật ký hiệu rút gọn, tối thiểu 0 chữ số thập phân, tối đa 2 chữ số thập phân, tự động làm tròn, dùng triển khai Intl.NumberFormat của trình duyệt

      Ví dụ:

      - locale='zh-CN': 749740.264 → 74.45万

      - locale='en-US': 749740.264 → 744.5K

      numFormat

      Type: NumFormat | undefined

      Mô tả

      Định dạng số tùy chỉnh cho measure; tự động áp dụng cho nhãn và tooltip

      Lưu ý: để sử dụng định dạng tùy chỉnh, bạn phải đặt rõ autoFormat=false; nếu không autoFormat sẽ ghi đè cấu hình này

      type

      Type: "number" | "percent" | "permille" | "scientific" | undefined

      Mô tả

      Loại định dạng số, hỗ trợ: number (thập phân), percent (%), permille (‰), ký hiệu khoa học

      ratio

      Type: number | undefined

      Mô tả

      Tỷ lệ định dạng số, không thể là 0

      Ví dụ - 100000 được chuyển thành 10万, ratio:10000, symbol:"万" - 100000 được chuyển thành 10K, ratio:1000, symbol:"K"

      symbol

      Type: string | undefined

      Mô tả

      Ký hiệu định dạng số, ví dụ %, ‰

      Ví dụ - 100000 được chuyển thành 10万, ratio:10000, symbol:"万" - 100000 được chuyển thành 10K, ratio:1000, symbol:"K"

      thousandSeparator

      Type: boolean | undefined

      Mô tả

      Dấu phân tách hàng nghìn cho định dạng số

      suffix

      Type: string | undefined

      Mô tả

      Hậu tố định dạng số

      prefix

      Type: string | undefined

      Mô tả

      Tiền tố định dạng số

      fractionDigits

      Type: number | undefined

      Mô tả

      Số chữ số thập phân cho định dạng số, dùng Intl.NumberFormat minimumFractionDigits và maximumFractionDigits của trình duyệt; ưu tiên thấp hơn significantDigits

      Ví dụ - 1234.5678 được chuyển thành 1235, fractionDigits:0 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.6, fractionDigits:1 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.57, fractionDigits:2 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1230.568, fractionDigits:3 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.5678, fractionDigits:4 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.56780, fractionDigits:5 (roundingMode:halfCeil)

      significantDigits

      Type: number | undefined

      Mô tả

      Chữ số có nghĩa cho định dạng số, dùng Intl.NumberFormat minimumSignificantDigits và maximumSignificantDigits của trình duyệt; ưu tiên cao hơn fractionDigits

      Ví dụ - 1234.5678 được chuyển thành 1000, significantDigits:1 - 1234.5678 được chuyển thành 1200, significantDigits:2 - 1234.5678 được chuyển thành 1230, significantDigits:3 - 1234.5678 được chuyển thành 1234, significantDigits:4 - 1234.5678 được chuyển thành 1234.6, significantDigits:5 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.57, significantDigits:6 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.568, significantDigits:7 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.5678, significantDigits:8 (roundingMode:halfCeil)

      roundingPriority

      Type: "morePrecision" | "lessPrecision" | undefined

      Mô tả

      Ưu tiên làm tròn cho định dạng số khi cả significantDigits và fractionDigits đều được đặt; dùng Intl.NumberFormat của trình duyệt và tuân theo cùng quy tắc với roundingPriority của Intl.NumberFormat

      Ví dụ - 1234.5678 được chuyển thành 1230, significantDigits:3 (roundingPriority:lessPrecision) - 1234.5678 được chuyển thành 1234.5678, significantDigits:3 (roundingPriority:morePrecision)

      roundingMode

      Type: "floor" | "ceil" | "expand" | "trunc" | "halfCeil" | "halfFloor" | "halfExpand" | "halfTrunc" | "halfEven" | undefined

      Mô tả

      Chế độ làm tròn cho định dạng số, dùng Intl.NumberFormat của trình duyệt và tuân theo cùng quy tắc với roundingMode của Intl.NumberFormat

      format

      Type: NumFormat | undefined

      type

      Type: "number" | "percent" | "permille" | "scientific" | undefined

      Mô tả

      Loại định dạng số, hỗ trợ: number (thập phân), percent (%), permille (‰), ký hiệu khoa học

      ratio

      Type: number | undefined

      Mô tả

      Tỷ lệ định dạng số, không thể là 0

      Ví dụ - 100000 được chuyển thành 10万, ratio:10000, symbol:"万" - 100000 được chuyển thành 10K, ratio:1000, symbol:"K"

      symbol

      Type: string | undefined

      Mô tả

      Ký hiệu định dạng số, ví dụ %, ‰

      Ví dụ - 100000 được chuyển thành 10万, ratio:10000, symbol:"万" - 100000 được chuyển thành 10K, ratio:1000, symbol:"K"

      thousandSeparator

      Type: boolean | undefined

      Mô tả

      Dấu phân tách hàng nghìn cho định dạng số

      suffix

      Type: string | undefined

      Mô tả

      Hậu tố định dạng số

      prefix

      Type: string | undefined

      Mô tả

      Tiền tố định dạng số

      fractionDigits

      Type: number | undefined

      Mô tả

      Số chữ số thập phân cho định dạng số, dùng Intl.NumberFormat minimumFractionDigits và maximumFractionDigits của trình duyệt; ưu tiên thấp hơn significantDigits

      Ví dụ - 1234.5678 được chuyển thành 1235, fractionDigits:0 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.6, fractionDigits:1 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.57, fractionDigits:2 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1230.568, fractionDigits:3 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.5678, fractionDigits:4 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.56780, fractionDigits:5 (roundingMode:halfCeil)

      significantDigits

      Type: number | undefined

      Mô tả

      Chữ số có nghĩa cho định dạng số, dùng Intl.NumberFormat minimumSignificantDigits và maximumSignificantDigits của trình duyệt; ưu tiên cao hơn fractionDigits

      Ví dụ - 1234.5678 được chuyển thành 1000, significantDigits:1 - 1234.5678 được chuyển thành 1200, significantDigits:2 - 1234.5678 được chuyển thành 1230, significantDigits:3 - 1234.5678 được chuyển thành 1234, significantDigits:4 - 1234.5678 được chuyển thành 1234.6, significantDigits:5 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.57, significantDigits:6 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.568, significantDigits:7 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.5678, significantDigits:8 (roundingMode:halfCeil)

      roundingPriority

      Type: "morePrecision" | "lessPrecision" | undefined

      Mô tả

      Ưu tiên làm tròn cho định dạng số khi cả significantDigits và fractionDigits đều được đặt; dùng Intl.NumberFormat của trình duyệt và tuân theo cùng quy tắc với roundingPriority của Intl.NumberFormat

      Ví dụ - 1234.5678 được chuyển thành 1230, significantDigits:3 (roundingPriority:lessPrecision) - 1234.5678 được chuyển thành 1234.5678, significantDigits:3 (roundingPriority:morePrecision)

      roundingMode

      Type: "floor" | "ceil" | "expand" | "trunc" | "halfCeil" | "halfFloor" | "halfExpand" | "halfTrunc" | "halfEven" | undefined

      Mô tả

      Chế độ làm tròn cho định dạng số, dùng Intl.NumberFormat của trình duyệt và tuân theo cùng quy tắc với roundingMode của Intl.NumberFormat

      encoding

      Type: "color" | "detail" | "tooltip" | "label" | "yAxis" | undefined

      Mô tả

      Kênh mà measure được ánh xạ tới

      - yAxis: chỉ số được ánh xạ tới trục y

      - detail: measure được ánh xạ tới kênh chi tiết

      - color: measure được ánh xạ tới kênh màu

      - label: measure được ánh xạ tới kênh label

      - tooltip: measure được ánh xạ tới kênh tooltip

      parentId

      Type: string | undefined

      Mô tả

      Trong cấu hình measure phẳng, xây dựng nhóm measure dạng cây. parentId trỏ đến id của nhóm measure cha và được dùng để xây dựng cây measure

      Tip

      Có hai cách cấu hình cây measure: cách 1 là cấu hình trực tiếp cây measure với children; cách 2 là cấu hình danh sách measure phẳng với parentId. Hai cách này không thể dùng đồng thời

      page

      Type: Page | undefined

      Mô tả

      Phân trang

      Cấu hình phân trang cho biểu đồ

      field

      Type: string

      Mô tả

      Trường phân trang; chỉ định tên field dùng để phân trang và phải là một chiều

      currentValue

      Type: string

      Mô tả

      Giá trị phân trang hiện tại; chỉ định giá trị dùng để xác định trang hiện tại

      Ví dụ '2023-01-01'

      backgroundColor

      Type: BackgroundColor

      Mô tả

      Màu nền biểu đồ

      Màu nền có thể là chuỗi màu (ví dụ: 'red', 'blue'), hoặc giá trị hex, rgb, rgba (ví dụ: '#ff0000', 'rgba(255,0,0,0.5)')

      color

      Type: Color | undefined

      Mô tả

      Màu

      Cấu hình màu dùng để xác định bảng màu của biểu đồ, bao gồm danh sách màu, ánh xạ màu và chuyển sắc màu.

      colorScheme

      Type: string[] | undefined

      Mô tả

      Bảng màu rời rạc dùng để xác định màu của các phần tử khác nhau trong biểu đồ

      Ví dụ ['#FFCDD2,#F8BBD0,#E1BEE7,#D1C4E9,#C5CAE9,#BBDEFB,#B3E5FC,#B2EBF2,#B2DFDB,#C8E6C9,#DCEDC8,#F0F4C3,#FFF9C4,#FFECB3,#FFE0B2']

      linearColorScheme

      Type: string[] | undefined

      Mô tả

      Bảng màu chuyển sắc tuyến tính dùng để xác định màu của các phần tử khác nhau trong biểu đồ

      Ví dụ ['#FFCDD2, #F8BBD0]

      colorMapping

      Type: Record<string, string> | undefined

      Mô tả

      Ánh xạ màu dùng để ánh xạ giá trị dữ liệu tới màu cụ thể

      Ví dụ { 'profit': 'red', 'sales': 'blue', }

      positiveColor

      Type: string | undefined

      Mô tả

      Cấu hình màu dương/âm; xác định màu cho giá trị dương trong biểu đồ

      negativeColor

      Type: string | undefined

      Mô tả

      Cấu hình màu dương/âm; xác định màu cho giá trị âm trong biểu đồ

      label

      Type: Label | undefined

      Mô tả

      Nhãn

      Cấu hình label dùng để xác định label dữ liệu của biểu đồ, bao gồm vị trí, định dạng và kiểu.

      enable

      Type: false | true

      Mô tả

      Có bật chức năng label hay không

      wrap

      Type: boolean | undefined

      Mô tả

      Label có xuống dòng tiếp theo hay không

      showValue

      Type: boolean | undefined

      Mô tả

      Label có hiển thị giá trị measure hay không

      Trong kịch bản nhiều measure, không cần lo xung đột giá trị, vì tất cả measure liên quan đến phần vẽ đều đi qua xử lý foldMeasures và được gộp thành một measure đại diện cho một điểm dữ liệu

      Lưu ý: label của encoding có mức ưu tiên cao hơn; cấu hình này không ảnh hưởng đến label của encoding

      showValuePercent

      Type: boolean | undefined

      Mô tả

      Label có hiển thị tỷ lệ phần trăm của giá trị measure hay không

      Trong kịch bản nhiều measure, không cần lo xung đột giá trị, vì tất cả measure liên quan đến phần vẽ đều đi qua xử lý foldMeasures và được gộp thành một measure đại diện cho một điểm dữ liệu

      Lưu ý: label của encoding có mức ưu tiên cao hơn; cấu hình này không ảnh hưởng đến label của encoding

      showDimension

      Type: boolean | undefined

      Mô tả

      Label có hiển thị label chiều hay không

      Hiển thị tất cả nhãn chiều

      Lưu ý: label của encoding có mức ưu tiên cao hơn; cấu hình này không ảnh hưởng đến label của encoding

      autoFormat

      Type: boolean | undefined

      Mô tả

      Có tự động định dạng giá trị label hay không; khi autoFormat là true, cấu hình numFormat sẽ bị bỏ qua

      numFormat

      Type: NumFormat | undefined

      Mô tả

      Cấu hình định dạng giá trị label; được hợp nhất với format trong measure, trong đó format của measure có ưu tiên cao hơn. numFormat có ưu tiên thấp hơn autoFormat

      type

      Type: "number" | "percent" | "permille" | "scientific" | undefined

      Mô tả

      Loại định dạng số, hỗ trợ: number (thập phân), percent (%), permille (‰), ký hiệu khoa học

      ratio

      Type: number | undefined

      Mô tả

      Tỷ lệ định dạng số, không thể là 0

      Ví dụ - 100000 được chuyển thành 10万, ratio:10000, symbol:"万" - 100000 được chuyển thành 10K, ratio:1000, symbol:"K"

      symbol

      Type: string | undefined

      Mô tả

      Ký hiệu định dạng số, ví dụ %, ‰

      Ví dụ - 100000 được chuyển thành 10万, ratio:10000, symbol:"万" - 100000 được chuyển thành 10K, ratio:1000, symbol:"K"

      thousandSeparator

      Type: boolean | undefined

      Mô tả

      Dấu phân tách hàng nghìn cho định dạng số

      suffix

      Type: string | undefined

      Mô tả

      Hậu tố định dạng số

      prefix

      Type: string | undefined

      Mô tả

      Tiền tố định dạng số

      fractionDigits

      Type: number | undefined

      Mô tả

      Số chữ số thập phân cho định dạng số, dùng Intl.NumberFormat minimumFractionDigits và maximumFractionDigits của trình duyệt; ưu tiên thấp hơn significantDigits

      Ví dụ - 1234.5678 được chuyển thành 1235, fractionDigits:0 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.6, fractionDigits:1 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.57, fractionDigits:2 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1230.568, fractionDigits:3 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.5678, fractionDigits:4 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.56780, fractionDigits:5 (roundingMode:halfCeil)

      significantDigits

      Type: number | undefined

      Mô tả

      Chữ số có nghĩa cho định dạng số, dùng Intl.NumberFormat minimumSignificantDigits và maximumSignificantDigits của trình duyệt; ưu tiên cao hơn fractionDigits

      Ví dụ - 1234.5678 được chuyển thành 1000, significantDigits:1 - 1234.5678 được chuyển thành 1200, significantDigits:2 - 1234.5678 được chuyển thành 1230, significantDigits:3 - 1234.5678 được chuyển thành 1234, significantDigits:4 - 1234.5678 được chuyển thành 1234.6, significantDigits:5 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.57, significantDigits:6 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.568, significantDigits:7 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.5678, significantDigits:8 (roundingMode:halfCeil)

      roundingPriority

      Type: "morePrecision" | "lessPrecision" | undefined

      Mô tả

      Ưu tiên làm tròn cho định dạng số khi cả significantDigits và fractionDigits đều được đặt; dùng Intl.NumberFormat của trình duyệt và tuân theo cùng quy tắc với roundingPriority của Intl.NumberFormat

      Ví dụ - 1234.5678 được chuyển thành 1230, significantDigits:3 (roundingPriority:lessPrecision) - 1234.5678 được chuyển thành 1234.5678, significantDigits:3 (roundingPriority:morePrecision)

      roundingMode

      Type: "floor" | "ceil" | "expand" | "trunc" | "halfCeil" | "halfFloor" | "halfExpand" | "halfTrunc" | "halfEven" | undefined

      Mô tả

      Chế độ làm tròn cho định dạng số, dùng Intl.NumberFormat của trình duyệt và tuân theo cùng quy tắc với roundingMode của Intl.NumberFormat

      labelFontSize

      Type: number | undefined

      Mô tả

      Cỡ chữ label

      labelFontWeight

      Type: string | number | undefined

      Mô tả

      Độ đậm chữ label

      labelBackgroundColor

      Type: string | undefined

      Mô tả

      Màu nền label

      labelStroke

      Type: string | undefined

      Mô tả

      Màu viền label

      labelColor

      Type: string | undefined

      Mô tả

      Màu chữ label

      labelColorSmartInvert

      Type: boolean | undefined

      Mô tả

      Có tự động đảo màu chữ label theo màu của phần tử đồ họa hay không

      labelPosition

      Type: "inside" | "outside" | undefined

      Mô tả

      Vị trí nhãn

      labelOverlap

      Type: boolean | undefined

      Mô tả

      Có bật tránh chồng lấp label hay không

      selector

      Type: Selector | Selectors | undefined

      Mô tả

      Lọc label; quan hệ mặc định giữa các selector là OR

      field

      Type: string

      Mô tả

      Trường chiều, ID của một mục chiều

      operator

      Type: "in" | "not in" | undefined

      Mô tả

      giống operator

      - in: Chọn các mục dữ liệu có giá trị field chiều nằm trong giá trị đã chỉ định

      op

      Type: "in" | "not in" | undefined

      Mô tả

      giống operator

      - in: Chọn các mục dữ liệu có giá trị field chiều nằm trong giá trị đã chỉ định

      giống operator

      value

      Type: string | number | (string | number)[]

      Mô tả

      Giá trị của trường chiều, hỗ trợ mảng

      dynamicFilter

      Type: ChartDynamicFilter | undefined

      Mô tả

      Bộ lọc động (thực thi mã do AI tạo)

      Triển khai logic lọc dữ liệu phức tạp bằng mã JavaScript do AI tạo.

      Khả năng chính:

      • Hỗ trợ mọi điều kiện lọc dữ liệu phức tạp

      • Sử dụng các hàm tiện ích tích hợp cho thao tác dữ liệu

      • Thực thi an toàn trong môi trường trình duyệt (sandbox Web Worker)

      Yêu cầu môi trường: chỉ hỗ trợ môi trường trình duyệt; môi trường Node.js sẽ dùng fallback

      Lưu ý: selector và dynamicFilter không thể dùng đồng thời; dynamicFilter có ưu tiên cao hơn

      Cấu hình bộ lọc động của biểu đồ

      Lọc các mark của biểu đồ (vùng, điểm, v.v.) bằng mã JavaScript do AI tạo

      type

      Type: "row-with-field"

      description

      Type: string | undefined

      Mô tả

      Mô tả yêu cầu lọc của người dùng (ngôn ngữ tự nhiên)

      Ví dụ "Highlight data items with sales greater than 1000"

      code

      Type: string

      Mô tả

      Mã lọc JavaScript do AI tạo

      • Chỉ được dùng các hàm tiện ích tích hợp (truy cập qua _ hoặc R)

      • Tham số đầu vào: data (mảng), mỗi item chứa trường __row_index biểu thị số dòng

      • Phải trả về mảng kết hợp chỉ số dòng và field: Array<{ __row_index: number, field: string }>

      • __row_index biểu thị số dòng của mục dữ liệu gốc, field biểu thị trường cần làm nổi bật

      • Không được dùng: eval, Function, thao tác bất đồng bộ, DOM API, yêu cầu mạng

      Ví dụ Làm nổi bật trường sales của các mục dữ liệu có sales lớn hơn 1000

      const filtered = _.filter(data, item => item.sales > 1000);
return _.map(filtered, item => ({
__row_index: item.__row_index,
field: 'sales'
}));

      Làm nổi bật mục dữ liệu có biên lợi nhuận cao nhất trong mỗi khu vực

      const grouped = _.groupBy(data, 'area');
const maxItems = _.map(grouped, group =>
_.maxBy(group, item => item.profit / item.sales)
);
return _.flatten(
_.map(maxItems, item => [
{ __row_index: item.__row_index, field: 'product' },
{ __row_index: item.__row_index, field: 'profit' }
])
);

      Làm nổi bật các mục dữ liệu được lọc theo nhiều điều kiện

      const filtered = _.filter(data, item => {
const profitRate = item.profit / item.sales;
return profitRate > 0.2 && item.sales > 5000;
});
return _.flatten(
_.map(filtered, item => [
{ __row_index: item.__row_index, field: 'product' },
{ __row_index: item.__row_index, field: 'sales' }
])
);

      fallback

      Type: Selector | Selectors | undefined

      Mô tả

      Phương án fallback khi thực thi mã thất bại hoặc môi trường không được hỗ trợ

      field

      Type: string

      Mô tả

      Trường chiều, ID của một mục chiều

      operator

      Type: "in" | "not in" | undefined

      Mô tả

      giống operator

      - in: Chọn các mục dữ liệu có giá trị field chiều nằm trong giá trị đã chỉ định

      op

      Type: "in" | "not in" | undefined

      Mô tả

      giống operator

      - in: Chọn các mục dữ liệu có giá trị field chiều nằm trong giá trị đã chỉ định

      giống operator

      value

      Type: string | number | (string | number)[]

      Mô tả

      Giá trị của trường chiều, hỗ trợ mảng

      result

      Type: DynamicFilterExecutionResult<RowWithFieldRes> | undefined

      Mô tả

      Kết quả thực thi bộ lọc động (trường runtime)

      Được ghi trong giai đoạn prepare(), chỉ đọc khi runtime

      success

      Type: false | true

      data

      Type: T[] | undefined

      error

      Type: string | undefined

      legend

      Type: Legend | undefined

      Mô tả

      Chú giải

      Cấu hình chú giải dùng để định nghĩa chú giải của biểu đồ, bao gồm vị trí, định dạng và kiểu hiển thị.

      enable

      Type: boolean | undefined

      Mô tả

      Có bật chức năng chú giải hay không

      Ví dụ enable: true

      border

      Type: boolean | undefined

      Mô tả

      Có bật viền chú giải hay không.

      Warning

      Chỉ có hiệu lực với chú giải rời rạc

      Ví dụ border: true

      labelColor

      Type: string | undefined

      Mô tả

      Màu chữ chú giải

      pagerIconColor

      Type: string | undefined

      Mô tả

      Màu biểu tượng pager

      pagerIconDisableColor

      Type: string | undefined

      Mô tả

      Màu biểu tượng pager bị vô hiệu hóa

      labelFontSize

      Type: number | undefined

      Mô tả

      Cỡ chữ chú giải

      Ví dụ labelFontSize: 10

      labelFontColor

      Type: string | undefined

      Mô tả

      Màu chữ chú giải

      labelFontWeight

      Type: string | number | undefined

      Mô tả

      Độ đậm chữ chú giải

      Ví dụ labelFontWeight: 400

      shapeType

      Type: "circle" | "cross" | "diamond" | "square" | "arrow" | "arrow2Left" | "arrow2Right" | "wedge" | "thinTriangle" | "triangle" | "triangleUp" | "triangleDown" | "triangleRight" | "triangleLeft" | "stroke" | "star" | "wye" | "rect" | "arrowLeft" | "arrowRight" | "rectRound" | "roundLine" | undefined

      Mô tả

      Hình dạng chú giải

      Warning

      Chỉ có hiệu lực với chú giải rời rạc

      Ví dụ shapeType: 'circle'

      position

      Type: "left" | "leftTop" | "leftBottom" | "lt" | "lb" | "top" | "topLeft" | "topRight" | "tl" | "tr" | "right" | "rightTop" | "rightBottom" | "rt" | "rb" | "bottom" | "bottomLeft" | "bottomRight" | "bl" | "br" | undefined

      Mô tả

      Vị trí chú giải

      Ví dụ position: 'rightTop'

      maxSize

      Type: number | undefined

      Mô tả

      Số cột hoặc hàng tối đa khi có nhiều mục chú giải

      Warning

      Chỉ có hiệu lực với chú giải rời rạc

      Ví dụ maxSize: 2

      regionPadding

      Type: RegionPadding | undefined

      Mô tả

      Khoảng đệm của vùng vẽ

      Ánh xạ tới VChart region[0].padding, dành không gian cho các phần tử vượt ra ngoài vùng vẽ như annotation và label.

      top

      Type: number | undefined

      Type: number | undefined

      bottom

      Type: number | undefined

      left

      Type: number | undefined

      tooltip

      Type: Tooltip | undefined

      Mô tả

      Tooltip

      Cấu hình tooltip của biểu đồ, bao gồm vị trí, định dạng, kiểu, v.v.

      enable

      Type: false | true

      Mô tả

      Có bật chức năng tooltip hay không

      brush

      Type: Brush | undefined

      Mô tả

      Cấu hình brush của biểu đồ

      enable

      Type: boolean | undefined

      Mô tả

      Có bật chọn brush hay không

      brushType

      Type: "rect" | "x" | "y" | "polygon" | undefined

      Mô tả

      Loại brush

      Xác định hình dạng và hướng chọn của brush

      - rect: chọn brush hình chữ nhật, có thể chọn đồng thời theo cả hướng trục X và trục Y

      - polygon: chọn brush đa giác, nhấp nhiều điểm để vẽ đa giác bất kỳ rồi chọn

      - x: chọn brush theo hướng trục X, chỉ chọn theo hướng trục X, hướng trục Y không bị giới hạn

      - y: chọn brush theo hướng trục Y, chỉ chọn theo hướng trục Y, hướng trục X không bị giới hạn

      brushMode

      Type: "single" | "multiple" | undefined

      Mô tả

      - multiple: chế độ multiple, nhiều lựa chọn brush có thể cùng tồn tại đồng thời

      Xác định chế độ chọn brush

      - multiple: chế độ chọn multiple; nhiều vùng brush có thể tồn tại cùng lúc

      removeOnClick

      Type: boolean | undefined

      Mô tả

      Có xóa vùng brush sau khi kết thúc chọn hay không

      inBrushStyle

      Type: { opacity?: number; stroke?: string; lineWidth?: number; } | undefined

      Mô tả

      Độ mờ của điểm dữ liệu chưa được chọn, phạm vi 0-1

      Định nghĩa kiểu dáng điểm dữ liệu được brush

      opacity

      Type: number | undefined

      Mô tả

      Độ mờ

      Độ mờ của điểm dữ liệu được chọn, phạm vi 0-1

      stroke

      Type: string | undefined

      Mô tả

      Màu nét

      lineWidth

      Type: number | undefined

      Mô tả

      Độ rộng viền

      outOfBrushStyle

      Type: { opacity?: number; stroke?: string; lineWidth?: number; } | undefined

      Mô tả

      Trục X, trục danh mục, cấu hình trục X; xác định trục X của biểu đồ, bao gồm vị trí, định dạng, kiểu, v.v.

      Định nghĩa kiểu dáng điểm dữ liệu ngoài vùng chọn brush

      opacity

      Type: number | undefined

      Mô tả

      Độ mờ

      Độ mờ của các điểm dữ liệu không được chọn, phạm vi 0-1

      stroke

      Type: string | undefined

      Mô tả

      Màu nét

      lineWidth

      Type: number | undefined

      Mô tả

      Độ rộng viền

      animation

      Type: LineAreaAnimation | undefined

      Mô tả

      Cấu hình hoạt ảnh

      Cấu hình hoạt ảnh biểu đồ; hiệu ứng khả dụng phụ thuộc vào loại biểu đồ

      enable

      Type: boolean | undefined

      Mô tả

      Có bật hoạt ảnh biểu đồ đường/vùng hay không

      params

      Type: LineAreaAnimationParams | undefined

      Mô tả

      Tham số hoạt ảnh cho biểu đồ đường/vùng

      appear

      Type: LineAreaAppearAnimation | undefined

      Mô tả

      Hoạt ảnh xuất hiện cho biểu đồ đường/vùng

      effects

      Type: ("load" | "growth")[] | undefined

      Mô tả

      Hiệu ứng xuất hiện cho biểu đồ đường/vùng; hỗ trợ hoạt ảnh tải và tăng trưởng

      enable

      Type: boolean | undefined

      Mô tả

      Có bật giai đoạn hoạt ảnh hiện tại hay không

      ease

      Type: string | undefined

      Mô tả

      Hàm easing của hoạt ảnh

      duration

      Type: number | undefined

      Mô tả

      Thời lượng hoạt ảnh tính bằng mili giây

      color

      Type: string | undefined

      Mô tả

      Màu nhấn hoặc màu bầu không khí của hoạt ảnh

      update

      Type: LineAreaUpdateAnimation | undefined

      Mô tả

      Hoạt ảnh cập nhật cho biểu đồ đường/vùng

      effects

      Type: "growth"[] | undefined

      Mô tả

      Hiệu ứng cập nhật cho biểu đồ đường/vùng; hỗ trợ hoạt ảnh tăng trưởng

      enable

      Type: boolean | undefined

      Mô tả

      Có bật giai đoạn hoạt ảnh hiện tại hay không

      ease

      Type: string | undefined

      Mô tả

      Hàm easing của hoạt ảnh

      duration

      Type: number | undefined

      Mô tả

      Thời lượng hoạt ảnh tính bằng mili giây

      color

      Type: string | undefined

      Mô tả

      Màu nhấn hoặc màu bầu không khí của hoạt ảnh

      loop

      Type: LineAreaAnimationLoop | undefined

      Mô tả

      Hoạt ảnh lặp cho biểu đồ đường/vùng

      enable

      Type: boolean | undefined

      Mô tả

      Có bật hoạt ảnh lặp hay không

      interval

      Type: number | undefined

      Mô tả

      Khoảng thời gian hoạt ảnh lặp tính bằng mili giây

      loop

      Type: LineAreaLoopAnimation | undefined

      Mô tả

      Hoạt ảnh lặp cho biểu đồ đường/vùng

      effects

      Type: LineAreaLoopEffect[] | undefined

      Mô tả

      Hiệu ứng lặp cho biểu đồ đường/vùng

      enable

      Type: boolean | undefined

      Mô tả

      Có bật giai đoạn hoạt ảnh hiện tại hay không

      ease

      Type: string | undefined

      Mô tả

      Hàm easing của hoạt ảnh

      duration

      Type: number | undefined

      Mô tả

      Thời lượng hoạt ảnh tính bằng mili giây

      color

      Type: string | undefined

      Mô tả

      Màu nhấn hoặc màu bầu không khí của hoạt ảnh

      atmosphere

      Type: PointAtmosphereConfig | undefined

      Mô tả

      Hoạt ảnh bầu không khí cho biểu đồ đường/vùng

      ease

      Type: string | undefined

      Mô tả

      Hàm easing của hoạt ảnh bầu không khí

      color

      Type: string | undefined

      Mô tả

      Màu của hoạt ảnh bầu không khí

      effect

      Type: PointAtmosphereEffect | undefined

      Mô tả

      Hiệu ứng hoạt ảnh bầu không khí; hỗ trợ hiệu ứng ripple, visibility và breathing

      xAxis

      Type: XBandAxis | undefined

      Mô tả

      Trục X

      Trục danh mục. Cấu hình trục X dùng để xác định vị trí, định dạng, kiểu và các thiết lập liên quan.

      visible

      Type: boolean | undefined

      Mô tả

      Có hiển thị trục hay không

      inverse

      Type: boolean | undefined

      Mô tả

      Có hiển thị trục theo chiều đảo ngược hay không; chỉ có hiệu lực với trục số

      zero

      Type: boolean | undefined

      Mô tả

      Có buộc hiển thị giá trị 0 trên trục hay không; khi min và max đã được cấu hình, tùy chọn này không có hiệu lực. Chỉ áp dụng cho trục số.

      labelAutoHide

      Type: boolean | undefined

      Mô tả

      Tự động ẩn nhãn trục: nếu hai nhãn chồng lên nhau, nhãn gây chồng lấn sẽ tự động bị ẩn. Chỉ áp dụng cho trục danh mục.

      labelAutoHideGap

      Type: number | undefined

      Mô tả

      Khoảng cách tự động ẩn nhãn trục: nếu khoảng cách giữa hai nhãn văn bản nhỏ hơn autoHideGap, nhãn chồng lấn sẽ tự động bị ẩn. Chỉ áp dụng cho trục danh mục.

      Khi bật autoHide, dùng autoHide và cấu hình trong autoHideSeparation.

      Khi tắt autoHide, dùng sampling và cấu hình trong minGap.

      labelAutoRotate

      Type: boolean | undefined

      Mô tả

      Tự động xoay nhãn trục: khi độ rộng nhãn vượt quá độ dài trục, nhãn sẽ tự động xoay. Chỉ áp dụng cho trục danh mục.

      labelAutoRotateAngleRange

      Type: number[] | undefined

      Mô tả

      Phạm vi góc tự động xoay nhãn trục. Chỉ áp dụng cho trục danh mục.

      labelAutoLimit

      Type: boolean | undefined

      Mô tả

      Tự động giới hạn độ dài nhãn trục: khi độ rộng nhãn vượt quá độ dài trục, phần vượt quá hiển thị bằng dấu ba chấm và nhãn đầy đủ hiển thị khi hover. Chỉ áp dụng cho trục danh mục.

      labelAutoLimitLength

      Type: number | undefined

      Mô tả

      Độ dài tối đa khi tự động giới hạn nhãn trục: khi văn bản nhãn vượt quá độ dài này, phần vượt quá hiển thị bằng dấu ba chấm và nhãn đầy đủ hiển thị khi hover. Chỉ áp dụng cho trục danh mục.

      label

      Type: { visible?: boolean; labelColor?: string; labelFontSize?: number; labelFontWeight?: number; labelAngle?: number; } | undefined

      Mô tả

      Nhãn tick trục X

      visible

      Type: boolean | undefined

      Mô tả

      Có hiển thị nhãn hay không

      labelColor

      Type: string | undefined

      Mô tả

      Màu nhãn

      labelFontSize

      Type: number | undefined

      Mô tả

      Cỡ chữ nhãn

      labelFontWeight

      Type: number | undefined

      Mô tả

      Độ đậm chữ nhãn

      labelAngle

      Type: number | undefined

      Mô tả

      Góc xoay nhãn

      line

      Type: { visible?: boolean; lineColor?: string; lineWidth?: number; } | undefined

      Mô tả

      Đường trục X

      visible

      Type: boolean | undefined

      Mô tả

      Có hiển thị đường trục hay không

      lineColor

      Type: string | undefined

      Mô tả

      Màu đường trục

      lineWidth

      Type: number | undefined

      Mô tả

      Độ rộng đường trục

      tick

      Type: { visible?: boolean; tickInside?: boolean; tickColor?: string; tickSize?: number; } | undefined

      Mô tả

      Tick trục X

      visible

      Type: boolean | undefined

      Mô tả

      Có hiển thị tick hay không

      tickInside

      Type: boolean | undefined

      Mô tả

      Tick có hướng vào trong hay không

      tickColor

      Type: string | undefined

      Mô tả

      Màu tick

      tickSize

      Type: number | undefined

      Mô tả

      Kích thước tick

      title

      Type: { visible?: boolean; titleText?: string; titleColor?: string; titleFontSize?: number; titleFontWeight?: number; } | undefined

      Mô tả

      Tiêu đề trục X

      visible

      Type: boolean | undefined

      Mô tả

      Có hiển thị tiêu đề hay không

      titleText

      Type: string | undefined

      Mô tả

      Văn bản tiêu đề, mặc định theo cấu hình trường

      titleColor

      Type: string | undefined

      Mô tả

      Màu tiêu đề

      titleFontSize

      Type: number | undefined

      Mô tả

      Cỡ chữ tiêu đề

      titleFontWeight

      Type: number | undefined

      Mô tả

      Độ đậm chữ tiêu đề

      grid

      Type: { visible?: boolean; gridColor?: string; gridWidth?: number; gridLineDash?: number[]; } | undefined

      Mô tả

      Bao gồm các theme tích hợp light và dark. Có thể thêm theme tùy chỉnh qua registerTheme.

      visible

      Type: boolean | undefined

      gridColor

      Type: string | undefined

      Mô tả

      selector = [{ profit: 100 }, { profit: 200 }]

      gridWidth

      Type: number | undefined

      Mô tả
      • not in: Chọn các mục dữ liệu có giá trị trường chiều không nằm trong mảng value.

      gridLineDash

      Type: number[] | undefined

      Mô tả

      Hỗ trợ kiểu toàn cục hoặc cấu hình kiểu có điều kiện.

      animation

      Type: { duration?: number; easing?: string; } | undefined

      Mô tả

      Cấu hình hoạt ảnh trục X

      duration

      Type: number | undefined

      Mô tả

      value: [100, 300]

      easing

      Type: string | undefined

      Mô tả

      }

      yAxis

      Type: YLinearAxis | undefined

      Mô tả

      Trục Y

      Trục số. Cấu hình trục Y dùng để xác định vị trí, định dạng, kiểu và các thiết lập liên quan.

      visible

      Type: boolean | undefined

      Mô tả

      Có hiển thị trục hay không

      min

      Type: number | undefined

      Mô tả

      Đường trục width

      max

      Type: number | boolean | undefined

      Mô tả

      Tick trục X

      log

      Type: boolean | undefined

      Mô tả

      Có sử dụng trục logarit hay không, chỉ có hiệu lực với trục số

      logBase

      Type: number | undefined

      Mô tả

      Hàm easing của hoạt ảnh.

      nice

      Type: boolean | undefined

      Mô tả

      Cấu hình trục Y (trục danh mục) dùng để định nghĩa trục Y, bao gồm vị trí, định dạng, kiểu dáng, v.v.

      inverse

      Type: boolean | undefined

      Mô tả

      Có hiển thị trục theo chiều đảo ngược hay không; chỉ có hiệu lực với trục số

      zero

      Type: boolean | undefined

      Mô tả

      Có buộc hiển thị giá trị 0 trên trục hay không; khi min và max đã được cấu hình, tùy chọn này không có hiệu lực. Chỉ áp dụng cho trục số.

      autoFormat

      Type: boolean | undefined

      Mô tả

      Có tự động định dạng label tick của trục số hay không. Chỉ áp dụng cho trục số. Khi autoFormat là true, numFormat bị bỏ qua.

      numFormat

      Type: NumFormat | undefined

      Mô tả

      Định dạng số cho trục số. Chỉ áp dụng cho trục số và có độ ưu tiên thấp hơn autoFormat.

      type

      Type: "number" | "percent" | "permille" | "scientific" | undefined

      Mô tả

      Loại định dạng số, hỗ trợ: number (thập phân), percent (%), permille (‰), ký hiệu khoa học

      ratio

      Type: number | undefined

      Mô tả

      Tỷ lệ định dạng số, không thể là 0

      Ví dụ - 100000 được chuyển thành 10万, ratio:10000, symbol:"万" - 100000 được chuyển thành 10K, ratio:1000, symbol:"K"

      symbol

      Type: string | undefined

      Mô tả

      Ký hiệu định dạng số, ví dụ %, ‰

      Ví dụ - 100000 được chuyển thành 10万, ratio:10000, symbol:"万" - 100000 được chuyển thành 10K, ratio:1000, symbol:"K"

      thousandSeparator

      Type: boolean | undefined

      Mô tả

      Dấu phân tách hàng nghìn cho định dạng số

      suffix

      Type: string | undefined

      Mô tả

      Hậu tố định dạng số

      prefix

      Type: string | undefined

      Mô tả

      Tiền tố định dạng số

      fractionDigits

      Type: number | undefined

      Mô tả

      Số chữ số thập phân cho định dạng số, dùng Intl.NumberFormat minimumFractionDigits và maximumFractionDigits của trình duyệt; ưu tiên thấp hơn significantDigits

      Ví dụ - 1234.5678 được chuyển thành 1235, fractionDigits:0 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.6, fractionDigits:1 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.57, fractionDigits:2 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1230.568, fractionDigits:3 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.5678, fractionDigits:4 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.56780, fractionDigits:5 (roundingMode:halfCeil)

      significantDigits

      Type: number | undefined

      Mô tả

      Chữ số có nghĩa cho định dạng số, dùng Intl.NumberFormat minimumSignificantDigits và maximumSignificantDigits của trình duyệt; ưu tiên cao hơn fractionDigits

      Ví dụ - 1234.5678 được chuyển thành 1000, significantDigits:1 - 1234.5678 được chuyển thành 1200, significantDigits:2 - 1234.5678 được chuyển thành 1230, significantDigits:3 - 1234.5678 được chuyển thành 1234, significantDigits:4 - 1234.5678 được chuyển thành 1234.6, significantDigits:5 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.57, significantDigits:6 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.568, significantDigits:7 (roundingMode:halfCeil) - 1234.5678 được chuyển thành 1234.5678, significantDigits:8 (roundingMode:halfCeil)

      roundingPriority

      Type: "morePrecision" | "lessPrecision" | undefined

      Mô tả

      Ưu tiên làm tròn cho định dạng số khi cả significantDigits và fractionDigits đều được đặt; dùng Intl.NumberFormat của trình duyệt và tuân theo cùng quy tắc với roundingPriority của Intl.NumberFormat

      Ví dụ - 1234.5678 được chuyển thành 1230, significantDigits:3 (roundingPriority:lessPrecision) - 1234.5678 được chuyển thành 1234.5678, significantDigits:3 (roundingPriority:morePrecision)

      roundingMode

      Type: "floor" | "ceil" | "expand" | "trunc" | "halfCeil" | "halfFloor" | "halfExpand" | "halfTrunc" | "halfEven" | undefined

      Mô tả

      Chế độ làm tròn cho định dạng số, dùng Intl.NumberFormat của trình duyệt và tuân theo cùng quy tắc với roundingMode của Intl.NumberFormat

      label

      Type: { visible?: boolean; labelColor?: string; labelFontSize?: number; labelFontWeight?: number; labelAngle?: number; } | undefined

      Mô tả

      Nhãn tick trục X

      visible

      Type: boolean | undefined

      Mô tả

      Có hiển thị nhãn hay không

      labelColor

      Type: string | undefined

      Mô tả

      Màu nhãn

      labelFontSize

      Type: number | undefined

      Mô tả

      Cỡ chữ label

      labelFontWeight

      Type: number | undefined

      Mô tả

      Độ đậm chữ label

      labelAngle

      Type: number | undefined

      Mô tả

      Góc xoay nhãn

      line

      Type: { visible?: boolean; lineColor?: string; lineWidth?: number; } | undefined

      Mô tả

      Đường trục X

      visible

      Type: boolean | undefined

      Mô tả

      - orderBy:'date'

      lineColor

      Type: string | undefined

      Mô tả

      }

      lineWidth

      Type: number | undefined

      Mô tả

      - 100000 được chuyển thành 10万, ratio:10000, symbol:"万"

      tick

      Type: { visible?: boolean; tickInside?: boolean; tickColor?: string; tickSize?: number; } | undefined

      Mô tả

      order: 'asc',

      visible

      Type: boolean | undefined

      Mô tả

      Hậu tố định dạng số

      tickInside

      Type: boolean | undefined

      Mô tả

      Tick có hướng vào trong hay không

      tickColor

      Type: string | undefined

      Mô tả

      Cấu hình sắp xếp chú giải; hỗ trợ sắp xếp theo dimension hoặc measure, cũng như thứ tự tùy chỉnh; mảng sort tuân theo thứ tự từ trái sang phải hoặc từ trên xuống dưới.

      tickSize

      Type: number | undefined

      Mô tả

      Kích thước tick

      title

      Type: { visible?: boolean; titleText?: string; titleColor?: string; titleFontSize?: number; titleFontWeight?: number; } | undefined

      Mô tả

      Tiêu đề trục X

      visible

      Type: boolean | undefined

      Mô tả

      - 1234.5678 được chuyển thành 1234.6, significantDigits:5 (roundingMode:halfCeil)

      titleText

      Type: string | undefined

      Mô tả

      Văn bản tiêu đề, mặc định theo cấu hình trường

      titleColor

      Type: string | undefined

      Mô tả

      - orderBy:'profit'

      titleFontSize

      Type: number | undefined

      Mô tả

      Thứ tự sắp xếp tùy chỉnh; thứ tự này được áp dụng trực tiếp cho chú giải. Tăng dần theo trái-sang-phải hoặc trên-xuống-dưới; giảm dần theo phải-sang-trái hoặc dưới-lên-trên.

      titleFontWeight

      Type: number | undefined

      Mô tả

      ])

      grid

      Type: { visible?: boolean; gridColor?: string; gridWidth?: number; gridLineDash?: number[]; } | undefined

      Mô tả

      Bao gồm các theme tích hợp light và dark. Có thể thêm theme tùy chỉnh qua registerTheme.

      visible

      Type: boolean | undefined

      gridColor

      Type: string | undefined

      Mô tả

      selector = [{ profit: 100 }, { profit: 200 }]

      gridWidth

      Type: number | undefined

      Mô tả
      • not in: Chọn các mục dữ liệu có giá trị trường chiều không nằm trong mảng value.

      gridLineDash

      Type: number[] | undefined

      Mô tả

      Hỗ trợ kiểu toàn cục hoặc cấu hình kiểu có điều kiện.

      animation

      Type: { duration?: number; easing?: string; } | undefined

      Mô tả

      selector = [{ profit: 100 }, { profit: 200 }]

      duration

      Type: number | undefined

      Mô tả

      value: [100, 300]

      easing

      Type: string | undefined

      Mô tả

      }

      crosshairLine

      Type: CrosshairLine | undefined

      Mô tả

      Đường gợi ý dọc

      Đường gợi ý dọc hiển thị khi chuột di chuyển trên biểu đồ.

      Cấu hình crosshair, dùng để hiển thị đường crosshair (đường gợi ý) trong biểu đồ.

      visible

      Type: boolean | undefined

      Mô tả

      Có hiển thị đường crosshair hay không

      lineColor

      Type: string | undefined

      Mô tả

      Màu đường crosshair

      labelColor

      Type: string | undefined

      Mô tả

      Màu nhãn đường crosshair

      labelVisible

      Type: boolean | undefined

      Mô tả

      Có hiển thị nhãn của đường crosshair hay không

      labelBackgroundColor

      Type: string | undefined

      Mô tả

      Màu nen nhãn đường crosshair

      sort

      Type: Sort | undefined

      Mô tả

      Cấu hình sắp xếp trục X, hỗ trợ sắp xếp theo chiều hoặc chỉ số cũng như thứ tự tùy chỉnh

      Cấu hình sắp xếp trục danh mục, hỗ trợ sắp xếp theo chiều hoặc chỉ số cũng như thứ tự tùy chỉnh

      Ví dụ sort: { orderBy: 'profit', order: 'asc', } sort: { customOrder:['2019', '2020', '2021'] }

      - order:'asc' - orderBy:'date'

      - customOrder:['2019', '2020', '2021']

      order

      Type: "asc" | "desc" | undefined

      Mô tả

      Thứ tự sắp xếp, giá trị có thể là 'asc' hoặc 'desc'

      Ví dụ order:'asc'

      orderBy

      Type: string | undefined

      Mô tả

      Tô sáng mục dữ liệu có tỷ lệ lợi nhuận cao nhất trong từng khu vực

      Ví dụ - orderBy:'date' - orderBy:'profit'

      customOrder

      Type: string[] | undefined

      Mô tả

      Thứ tự tùy chỉnh được áp dụng trực tiếp cho trục danh mục

      sortLegend

      Type: SortLegend | undefined

      Mô tả

      Cấu hình sắp xếp chú giải, hỗ trợ sắp xếp theo chiều hoặc chỉ số cũng như thứ tự tùy chỉnh

      Cấu hình sắp xếp chú giải; mảng sắp xếp tuân theo thứ tự từ trái sang phải hoặc từ trên xuống dưới

      Ví dụ sortLegend: { orderBy: 'profit', order: 'asc', } sortLegend: { customOrder:['2019', '2020', '2021'] }

      - order:'asc' - orderBy:'date'

      - customOrder:['2019', '2020', '2021']

      order

      Type: "asc" | "desc" | undefined

      Mô tả

      Thứ tự sắp xếp, giá trị có thể là 'asc' hoặc 'desc'

      Ví dụ order:'asc'

      orderBy

      Type: string | undefined

      Mô tả

      Tô sáng mục dữ liệu có tỷ lệ lợi nhuận cao nhất trong từng khu vực

      Ví dụ - orderBy:'date' - orderBy:'profit'

      customOrder

      Type: string[] | undefined

      Mô tả

      Thứ tự tùy chỉnh được áp dụng trực tiếp cho chú giải; tăng dần từ trái sang phải hoặc từ trên xuống dưới, giảm dần từ phải sang trái hoặc từ dưới lên trên

      theme

      Type: Theme | undefined

      Mô tả

      Theme của biểu đồ. Theme là cấu hình chức năng có mức ưu tiên thấp hơn, gồm các thiết lập chung cho tất cả loại biểu đồ và các thiết lập biểu đồ dùng chung trong một nhóm loại biểu đồ.

      Có hai theme tích hợp là light và dark. Người dùng có thể tùy chỉnh theme thông qua Builder.

      Theme

      Có sẵn hai theme tích hợp light và dark; theme mới có thể được tùy chỉnh thông qua registerTheme.

      Ví dụ 'dark'

      'light'

      'customThemeName'

      length

      Type: number

      brand

      Type: brand

      pointStyle

      Type: PointStyle | PointStyle[] | undefined

      Mô tả

      Cấu hình kiểu mark điểm, dùng để xác định màu, viền và các thiết lập liên quan của mark điểm.

      Hỗ trợ cấu hình kiểu toàn cục hoặc kiểu có điều kiện

      Bộ lọc dữ liệu

      selector

      Type: Selector | Selectors | undefined

      Mô tả
      • not in: Chọn các mục dữ liệu có giá trị trường chiều không nằm trong mảng value.

      Ví dụ Màu nét primitive cột (hình chữ nhật) selector = "tool" selector = ["tool", "book"] selector = 100 selector = [100, 200]

      selector = { profit: 100 } selector = [{ profit: 100 }, { profit: 200 }]

      selector = { field: 'category', operator: 'in', value: 'tool' } selector = { field: 'category', operator: 'not in', value: 'book' }

      selector = { field: 'profit', operator: '>=', value: 100 } selector = { field: 'profit', operator: 'between' value: [100, 300] }

      field

      Type: string

      Mô tả

      Trường chiều, ID của một mục chiều

      operator

      Type: "in" | "not in" | undefined

      Mô tả

      giống operator

      - in: Chọn các mục dữ liệu có giá trị field chiều nằm trong giá trị đã chỉ định

      op

      Type: "in" | "not in" | undefined

      Mô tả

      giống operator

      - in: Chọn các mục dữ liệu có giá trị field chiều nằm trong giá trị đã chỉ định

      giống operator

      value

      Type: string | number | (string | number)[]

      Mô tả

      Giá trị của trường chiều, hỗ trợ mảng

      dynamicFilter

      Type: ChartDynamicFilter | undefined

      Mô tả

      Bộ lọc động (thực thi mã do AI tạo)

      Triển khai logic lọc dữ liệu phức tạp bằng mã JavaScript do AI tạo.

      Phù hợp với Top N, phân tích thống kê, điều kiện phức tạp và các tình huống khác khó biểu đạt bằng selector tĩnh.

      Khả năng chính:

      • Hỗ trợ mọi điều kiện lọc dữ liệu phức tạp

      • Sử dụng các hàm tiện ích tích hợp cho thao tác dữ liệu

      • Thực thi an toàn trong môi trường trình duyệt (sandbox Web Worker)

      Yêu cầu môi trường: chỉ hỗ trợ môi trường trình duyệt; môi trường Node.js sẽ dùng fallback

      Lưu ý: selector và dynamicFilter không thể dùng đồng thời; dynamicFilter có ưu tiên cao hơn

      Cấu hình bộ lọc động của biểu đồ

      Lọc các mark của biểu đồ (vùng, điểm, v.v.) bằng mã JavaScript do AI tạo

      type

      Type: "row-with-field"

      description

      Type: string | undefined

      Mô tả

      Mô tả yêu cầu lọc của người dùng (ngôn ngữ tự nhiên)

      Ví dụ "Highlight data items with sales greater than 1000"

      code

      Type: string

      Mô tả

      Mã lọc JavaScript do AI tạo

      • Chỉ được dùng các hàm tiện ích tích hợp (truy cập qua _ hoặc R)

      • Tham số đầu vào: data (mảng), mỗi item chứa trường __row_index biểu thị số dòng

      • Phải trả về mảng kết hợp chỉ số dòng và field: Array<{ __row_index: number, field: string }>

      • __row_index biểu thị số dòng của mục dữ liệu gốc, field biểu thị trường cần làm nổi bật

      • Không được dùng: eval, Function, thao tác bất đồng bộ, DOM API, yêu cầu mạng

      Ví dụ Làm nổi bật trường sales của các mục dữ liệu có sales lớn hơn 1000

      const filtered = _.filter(data, item => item.sales > 1000);
return _.map(filtered, item => ({
__row_index: item.__row_index,
field: 'sales'
}));

      Làm nổi bật mục dữ liệu có biên lợi nhuận cao nhất trong mỗi khu vực

      const grouped = _.groupBy(data, 'area');
const maxItems = _.map(grouped, group =>
_.maxBy(group, item => item.profit / item.sales)
);
return _.flatten(
_.map(maxItems, item => [
{ __row_index: item.__row_index, field: 'product' },
{ __row_index: item.__row_index, field: 'profit' }
])
);

      Làm nổi bật các mục dữ liệu được lọc theo nhiều điều kiện

      const filtered = _.filter(data, item => {
const profitRate = item.profit / item.sales;
return profitRate > 0.2 && item.sales > 5000;
});
return _.flatten(
_.map(filtered, item => [
{ __row_index: item.__row_index, field: 'product' },
{ __row_index: item.__row_index, field: 'sales' }
])
);

      fallback

      Type: Selector | Selectors | undefined

      Mô tả

      Phương án fallback khi thực thi mã thất bại hoặc môi trường không được hỗ trợ

      field

      Type: string

      Mô tả

      Trường chiều, ID của một mục chiều

      operator

      Type: "in" | "not in" | undefined

      Mô tả

      giống operator

      - in: Chọn các mục dữ liệu có giá trị field chiều nằm trong giá trị đã chỉ định

      op

      Type: "in" | "not in" | undefined

      Mô tả

      giống operator

      - in: Chọn các mục dữ liệu có giá trị field chiều nằm trong giá trị đã chỉ định

      giống operator

      value

      Type: string | number | (string | number)[]

      Mô tả

      Giá trị của trường chiều, hỗ trợ mảng

      result

      Type: DynamicFilterExecutionResult<RowWithFieldRes> | undefined

      Mô tả

      Kết quả thực thi bộ lọc động (trường runtime)

      Được ghi trong giai đoạn prepare(), chỉ đọc khi runtime

      success

      Type: false | true

      data

      Type: T[] | undefined

      error

      Type: string | undefined

      pointVisible

      Type: boolean | undefined

      Mô tả

      Điểm có hiển thị hay không

      pointSize

      Type: number | undefined

      Mô tả

      Kich thuoc diem

      Kich thuoc diem

      pointColor

      Type: string | undefined

      Mô tả

      Màu dấu điểm

      Màu dấu điểm

      pointColorOpacity

      Type: number | undefined

      Mô tả

      Độ trong suốt màu dấu điểm

      Độ trong suốt màu dấu điểm

      pointBorderColor

      Type: string | undefined

      Mô tả

      Màu viền dấu điểm

      Màu viền dấu điểm

      pointBorderWidth

      Type: number | undefined

      Mô tả

      Độ rộng viền dấu điểm

      Độ rộng viền dấu điểm

      pointBorderStyle

      Type: "solid" | "dashed" | "dotted" | undefined

      Mô tả

      Kiểu viền dấu điểm

      Kiểu viền dấu điểm

      Ví dụ solid

      dashed

      dotted

      lineStyle

      Type: LineStyle | LineStyle[] | undefined

      Mô tả

      Cấu hình kiểu mark đường, dùng để xác định màu, độ trong suốt, đường cong và các thiết lập liên quan của mark đường.

      Hỗ trợ cấu hình kiểu toàn cục hoặc kiểu có điều kiện

      Bộ lọc dữ liệu

      selector

      Type: Selector | Selectors | undefined

      Mô tả
      • not in: Chọn các mục dữ liệu có giá trị trường chiều không nằm trong mảng value.

      Ví dụ Màu nét primitive cột (hình chữ nhật) selector = "tool" selector = ["tool", "book"] selector = 100 selector = [100, 200]

      selector = { profit: 100 } selector = [{ profit: 100 }, { profit: 200 }]

      selector = { field: 'category', operator: 'in', value: 'tool' } selector = { field: 'category', operator: 'not in', value: 'book' }

      selector = { field: 'profit', operator: '>=', value: 100 } selector = { field: 'profit', operator: 'between' value: [100, 300] }

      field

      Type: string

      Mô tả

      Trường chiều, ID của một mục chiều

      operator

      Type: "in" | "not in" | undefined

      Mô tả

      giống operator

      - in: Chọn các mục dữ liệu có giá trị field chiều nằm trong giá trị đã chỉ định

      op

      Type: "in" | "not in" | undefined

      Mô tả

      giống operator

      - in: Chọn các mục dữ liệu có giá trị field chiều nằm trong giá trị đã chỉ định

      giống operator

      value

      Type: string | number | (string | number)[]

      Mô tả

      Giá trị của trường chiều, hỗ trợ mảng

      dynamicFilter

      Type: ChartDynamicFilter | undefined

      Mô tả

      Bộ lọc động (thực thi mã do AI tạo)

      Triển khai logic lọc dữ liệu phức tạp bằng mã JavaScript do AI tạo.

      Phù hợp với Top N, phân tích thống kê, điều kiện phức tạp và các tình huống khác khó biểu đạt bằng selector tĩnh.

      Khả năng chính:

      • Hỗ trợ mọi điều kiện lọc dữ liệu phức tạp

      • Sử dụng các hàm tiện ích tích hợp cho thao tác dữ liệu

      • Thực thi an toàn trong môi trường trình duyệt (sandbox Web Worker)

      Yêu cầu môi trường: chỉ hỗ trợ môi trường trình duyệt; môi trường Node.js sẽ dùng fallback

      Lưu ý: selector và dynamicFilter không thể dùng đồng thời; dynamicFilter có ưu tiên cao hơn

      Cấu hình bộ lọc động của biểu đồ

      Lọc các mark của biểu đồ (vùng, điểm, v.v.) bằng mã JavaScript do AI tạo

      type

      Type: "row-with-field"

      description

      Type: string | undefined

      Mô tả

      Mô tả yêu cầu lọc của người dùng (ngôn ngữ tự nhiên)

      Ví dụ "Highlight data items with sales greater than 1000"

      code

      Type: string

      Mô tả

      Mã lọc JavaScript do AI tạo

      • Chỉ được dùng các hàm tiện ích tích hợp (truy cập qua _ hoặc R)

      • Tham số đầu vào: data (mảng), mỗi item chứa trường __row_index biểu thị số dòng

      • Phải trả về mảng kết hợp chỉ số dòng và field: Array<{ __row_index: number, field: string }>

      • __row_index biểu thị số dòng của mục dữ liệu gốc, field biểu thị trường cần làm nổi bật

      • Không được dùng: eval, Function, thao tác bất đồng bộ, DOM API, yêu cầu mạng

      Ví dụ Làm nổi bật trường sales của các mục dữ liệu có sales lớn hơn 1000

      const filtered = _.filter(data, item => item.sales > 1000);
return _.map(filtered, item => ({
__row_index: item.__row_index,
field: 'sales'
}));

      Làm nổi bật mục dữ liệu có biên lợi nhuận cao nhất trong mỗi khu vực

      const grouped = _.groupBy(data, 'area');
const maxItems = _.map(grouped, group =>
_.maxBy(group, item => item.profit / item.sales)
);
return _.flatten(
_.map(maxItems, item => [
{ __row_index: item.__row_index, field: 'product' },
{ __row_index: item.__row_index, field: 'profit' }
])
);

      Làm nổi bật các mục dữ liệu được lọc theo nhiều điều kiện

      const filtered = _.filter(data, item => {
const profitRate = item.profit / item.sales;
return profitRate > 0.2 && item.sales > 5000;
});
return _.flatten(
_.map(filtered, item => [
{ __row_index: item.__row_index, field: 'product' },
{ __row_index: item.__row_index, field: 'sales' }
])
);

      fallback

      Type: Selector | Selectors | undefined

      Mô tả

      Phương án fallback khi thực thi mã thất bại hoặc môi trường không được hỗ trợ

      field

      Type: string

      Mô tả

      Trường chiều, ID của một mục chiều

      operator

      Type: "in" | "not in" | undefined

      Mô tả

      giống operator

      - in: Chọn các mục dữ liệu có giá trị field chiều nằm trong giá trị đã chỉ định

      op

      Type: "in" | "not in" | undefined

      Mô tả

      giống operator

      - in: Chọn các mục dữ liệu có giá trị field chiều nằm trong giá trị đã chỉ định

      giống operator

      value

      Type: string | number | (string | number)[]

      Mô tả

      Giá trị của trường chiều, hỗ trợ mảng

      result

      Type: DynamicFilterExecutionResult<RowWithFieldRes> | undefined

      Mô tả

      Kết quả thực thi bộ lọc động (trường runtime)

      Được ghi trong giai đoạn prepare(), chỉ đọc khi runtime

      success

      Type: false | true

      data

      Type: T[] | undefined

      error

      Type: string | undefined

      lineVisible

      Type: boolean | undefined

      Mô tả

      Đoạn đường co hiển thị hay không

      lineSmooth

      Type: boolean | undefined

      Mô tả

      Đoạn đường có được làm mượt hay không

      lineColor

      Type: string | undefined

      Mô tả

      Màu doan đường

      lineColorOpacity

      Type: number | undefined

      Mô tả

      Độ trong suốt màu đoạn đường

      lineWidth

      Type: number | undefined

      Mô tả

      Độ rộng doan đường

      lineStyle

      Type: "solid" | "dashed" | "dotted" | undefined

      Mô tả

      Kiểu doan đường

      Ví dụ lineStyle: 'solid'

      annotationPoint

      Type: AnnotationPoint | AnnotationPoint[] | undefined

      Mô tả

      Cấu hình điểm chú thích. Xác định các điểm chú thích của biểu đồ dựa trên dữ liệu đã chọn, bao gồm vị trí, định dạng, kiểu và các thiết lập liên quan.

      selector

      Type: Selector | Selectors | undefined

      Mô tả

      Selector điểm chú thích, dùng để chọn điểm dữ liệu.

      field

      Type: string

      Mô tả

      Trường chiều, ID của một mục chiều

      operator

      Type: "in" | "not in" | undefined

      Mô tả

      giống operator

      - in: Chọn các mục dữ liệu có giá trị field chiều nằm trong giá trị đã chỉ định

      op

      Type: "in" | "not in" | undefined

      Mô tả

      giống operator

      - in: Chọn các mục dữ liệu có giá trị field chiều nằm trong giá trị đã chỉ định

      giống operator

      value

      Type: string | number | (string | number)[]

      Mô tả

      Giá trị của trường chiều, hỗ trợ mảng

      measureId

      Type: string | undefined

      Mô tả

      Chỉ định measure id mà điểm chú thích thuộc về. Trong kịch bản nhiều measure, có thể kết hợp với selector để định vị duy nhất điểm chú thích của measure mục tiêu.

      dynamicFilter

      Type: ChartDynamicFilter | undefined

      Mô tả

      Bộ lọc động (thực thi mã do AI tạo)

      Triển khai logic lọc dữ liệu phức tạp bằng mã JavaScript do AI tạo.

      Phù hợp với Top N, phân tích thống kê, điều kiện phức tạp và các tình huống khác khó biểu đạt bằng selector tĩnh.

      Khả năng chính:

      • Hỗ trợ mọi điều kiện lọc dữ liệu phức tạp

      • Sử dụng các hàm tiện ích tích hợp cho thao tác dữ liệu

      • Thực thi an toàn trong môi trường trình duyệt (sandbox Web Worker)

      Yêu cầu môi trường: chỉ hỗ trợ môi trường trình duyệt; môi trường Node.js sẽ dùng fallback

      Lưu ý: selector và dynamicFilter không thể dùng đồng thời; dynamicFilter có ưu tiên cao hơn

      Cấu hình bộ lọc động của biểu đồ

      Lọc các mark của biểu đồ (vùng, điểm, v.v.) bằng mã JavaScript do AI tạo

      type

      Type: "row-with-field"

      description

      Type: string | undefined

      Mô tả

      Mô tả yêu cầu lọc của người dùng (ngôn ngữ tự nhiên)

      Ví dụ "Highlight data items with sales greater than 1000"

      code

      Type: string

      Mô tả

      Mã lọc JavaScript do AI tạo

      • Chỉ được dùng các hàm tiện ích tích hợp (truy cập qua _ hoặc R)

      • Tham số đầu vào: data (mảng), mỗi item chứa trường __row_index biểu thị số dòng

      • Phải trả về mảng kết hợp chỉ số dòng và field: Array<{ __row_index: number, field: string }>

      • __row_index biểu thị số dòng của mục dữ liệu gốc, field biểu thị trường cần làm nổi bật

      • Không được dùng: eval, Function, thao tác bất đồng bộ, DOM API, yêu cầu mạng

      Ví dụ Làm nổi bật trường sales của các mục dữ liệu có sales lớn hơn 1000

      const filtered = _.filter(data, item => item.sales > 1000);
return _.map(filtered, item => ({
__row_index: item.__row_index,
field: 'sales'
}));

      Làm nổi bật mục dữ liệu có biên lợi nhuận cao nhất trong mỗi khu vực

      const grouped = _.groupBy(data, 'area');
const maxItems = _.map(grouped, group =>
_.maxBy(group, item => item.profit / item.sales)
);
return _.flatten(
_.map(maxItems, item => [
{ __row_index: item.__row_index, field: 'product' },
{ __row_index: item.__row_index, field: 'profit' }
])
);

      Làm nổi bật các mục dữ liệu được lọc theo nhiều điều kiện

      const filtered = _.filter(data, item => {
const profitRate = item.profit / item.sales;
return profitRate > 0.2 && item.sales > 5000;
});
return _.flatten(
_.map(filtered, item => [
{ __row_index: item.__row_index, field: 'product' },
{ __row_index: item.__row_index, field: 'sales' }
])
);

      fallback

      Type: Selector | Selectors | undefined

      Mô tả

      Phương án fallback khi thực thi mã thất bại hoặc môi trường không được hỗ trợ

      field

      Type: string

      Mô tả

      Trường chiều, ID của một mục chiều

      operator

      Type: "in" | "not in" | undefined

      Mô tả

      giống operator

      - in: Chọn các mục dữ liệu có giá trị field chiều nằm trong giá trị đã chỉ định

      op

      Type: "in" | "not in" | undefined

      Mô tả

      giống operator

      - in: Chọn các mục dữ liệu có giá trị field chiều nằm trong giá trị đã chỉ định

      giống operator

      value

      Type: string | number | (string | number)[]

      Mô tả

      Giá trị của trường chiều, hỗ trợ mảng

      result

      Type: DynamicFilterExecutionResult<RowWithFieldRes> | undefined

      Mô tả

      Kết quả thực thi bộ lọc động (trường runtime)

      Được ghi trong giai đoạn prepare(), chỉ đọc khi runtime

      success

      Type: false | true

      data

      Type: T[] | undefined

      error

      Type: string | undefined

      text

      Type: string | string[] | undefined

      Mô tả

      'red'

      Ví dụ 'Văn bản đánh dấu'

      textColor

      Type: string | undefined

      Mô tả

      4

      Ví dụ 'red'

      textFontSize

      Type: number | undefined

      Mô tả

      [2, 2]

      Ví dụ 12

      textFontWeight

      Type: number | undefined

      Mô tả

      0

      Ví dụ 400

      textAlign

      Type: "left" | "right" | "center" | undefined

      Mô tả

      Cách căn chỉnh văn bản. Thông thường đặt là right để văn bản hiển thị bên trái điểm chú thích và nằm trong vùng hiển thị của biểu đồ

      Khuyến nghị đặt là 'right' để văn bản nằm bên trái điểm chú thích

      right: văn bản nằm bên trái điểm chú thích, mép phải của văn bản căn với điểm chú thích

      left: văn bản nằm bên phải điểm chú thích, mép trái của văn bản căn với điểm chú thích

      center: văn bản nằm ở giữa điểm chú thích

      Ví dụ 'right' văn bản nằm bên trái điểm chú thích

      textBaseline

      Type: "top" | "bottom" | "middle" | undefined

      Mô tả

      Cách căn dọc văn bản. Thông thường đặt là top để văn bản hiển thị phía dưới điểm chú thích và nằm trong vùng hiển thị của biểu đồ

      Khuyến nghị đặt là 'top' để toàn bộ văn bản hiển thị trong vùng nhìn thấy của biểu đồ

      top: văn bản nằm phía dưới điểm chú thích, mép trên của văn bản căn với điểm chú thích

      middle: văn bản nằm ở giữa điểm chú thích

      bottom: văn bản nằm phía trên điểm chú thích, mép dưới của văn bản căn với điểm chú thích

      Ví dụ 'top' văn bản nằm phía dưới điểm chú thích

      textBackgroundVisible

      Type: boolean | undefined

      Mô tả

      Hiển thị nền

      Ví dụ true

      textBackgroundColor

      Type: string | undefined

      Mô tả

      Màu nền

      Ví dụ 'red'

      textBackgroundBorderColor

      Type: string | undefined

      Mô tả

      Màu văn bản

      Ví dụ 'red'

      textBackgroundBorderWidth

      Type: number | undefined

      Mô tả

      Độ rộng viền nền

      Ví dụ 2

      textBackgroundBorderRadius

      Type: number | undefined

      Mô tả

      Bo góc viền nền

      Ví dụ 4

      textBackgroundPadding

      Type: number | undefined

      Mô tả

      Padding nền

      Ví dụ 4

      offsetY

      Type: number | undefined

      Mô tả

      Nền có hiển thị hay không.

      Ví dụ true

      offsetX

      Type: number | undefined

      Mô tả

      Khoảng lệch pixel của toàn bộ điểm chú thích theo hướng X. Khi điểm chú thích ở bên trái biểu đồ (điểm bắt đầu trục danh mục), nên dùng giá trị dương; khi ở bên phải biểu đồ (điểm cuối trục danh mục), nên dùng giá trị âm.

      Giá trị âm dịch toàn bộ sang trái; ví dụ -10 sẽ dịch toàn bộ thành phần điểm chú thích, gồm văn bản và nền, sang trái 10 pixel

      Giá trị dương dịch toàn bộ sang phải; ví dụ 10 sẽ dịch toàn bộ thành phần điểm chú thích, gồm văn bản và nền, sang phải 10 pixel

      Ví dụ offsetX: 5, toàn bộ điểm chú thích dịch sang phải 5 pixel

      annotationVerticalLine

      Type: AnnotationVerticalLine | AnnotationVerticalLine[] | undefined

      Mô tả

      Đường chú thích giá trị chiều, hiển thị theo chiều dọc, có thể cấu hình vị trí và kiểu dáng

      xValue

      Type: string | number | (string | number)[] | undefined

      Mô tả

      );

      dynamicFilter

      Type: ValueDynamicFilter | undefined

      Mô tả

      Bộ lọc động (thực thi mã do AI tạo)

      Tính động giá trị đường chú thích bằng mã JavaScript do AI tạo.

      Phù hợp khi cần xác định động vị trí đường chú thích dựa trên dữ liệu, như giá trị trung bình, giá trị lớn nhất, phân vị hoặc đường nghiệp vụ.

      Chỉ hỗ trợ môi trường trình duyệt (cần Web Worker).

      type

      Type: "value"

      description

      Type: string | undefined

      Mô tả

      Mô tả yêu cầu lọc của người dùng (ngôn ngữ tự nhiên)

      Ví dụ "Lấy giá trị doanh số cao nhất làm tham chiếu cho đường đánh dấu"

      "Tính doanh số trung bình cho đường đánh dấu"

      code

      Type: string

      Mô tả

      - Tham số đầu vào: data (mảng), trong đó mỗi mục có field __row_index biểu thị số dòng

      - __row_index biểu thị số dòng của mục dữ liệu gốc; field biểu thị field cần tô nổi bật

      - Cấm: eval, Function, thao tác bất đồng bộ, DOM API, yêu cầu mạng

      Ví dụ

      const maxSales = _.maxBy(data, 'sales')?.sales;
return maxSales || 0;
      const avgSales = _.meanBy(data, 'sales');
return _.round(avgSales, 2);
      const sorted = _.sortBy(data, 'sales');
const index = Math.floor(sorted.length * 0.75);
return sorted[index]?.sales || 0;
      const currentYearTotal = _.sumBy(
_.filter(data, item => item.year === 2024),
'sales'
);
return currentYearTotal;

      fallback

      Type: string | number | undefined

      Mô tả

      Phương án fallback khi thực thi mã thất bại hoặc môi trường không được hỗ trợ

      result

      Type: { success: boolean; data?: number | string; } | undefined

      Mô tả

      Kết quả thực thi bộ lọc động (trường runtime)

      Được ghi trong giai đoạn prepare(), chỉ đọc khi runtime

      success

      Type: false | true

      data

      Type: string | number | undefined

      text

      Type: string | string[] | undefined

      Mô tả

      'red'

      Ví dụ 'Văn bản đánh dấu'

      textPosition

      Type: "outsideStart" | "outsideEnd" | "outsideMiddle" | "insideStart" | "insideMiddle" | "insideEnd" | undefined

      Mô tả

      Các giá trị trường dimension đã chọn; hỗ trợ mảng.

      Ví dụ 'outsideEnd'

      textColor

      Type: string | undefined

      Mô tả

      4

      Ví dụ 'red'

      textFontSize

      Type: number | undefined

      Mô tả

      [2, 2]

      Ví dụ 12

      textFontWeight

      Type: number | undefined

      Mô tả

      0

      Ví dụ 400

      textAlign

      Type: "left" | "right" | "center" | undefined

      Mô tả

      Cách căn chỉnh văn bản. Thông thường không cần đặt

      Khuyến nghị đặt là 'right' để văn bản nằm bên trái đường chú thích

      right: văn bản nằm bên trái đường tham chiếu, mép phải của văn bản căn với đường chú thích dọc

      left: văn bản nằm bên phải đường tham chiếu, mép trái của văn bản căn với đường chú thích dọc

      center: văn bản nằm ở giữa đường tham chiếu

      Ví dụ 'right'

      textBaseline

      Type: "top" | "bottom" | "middle" | undefined

      Mô tả

      middle: Văn bản được căn giữa theo chiều dọc trong vùng chú thích.

      Ví dụ 'top'

      lineVisible

      Type: boolean | undefined

      Mô tả

      Độ mờ màu vùng chú thích

      Ví dụ true

      lineColor

      Type: string | undefined

      Mô tả

      Màu viền vùng chú thích.

      Ví dụ 'red'

      lineWidth

      Type: number | undefined

      Mô tả

      Độ rộng viền vùng chú thích.

      Ví dụ 2

      lineStyle

      Type: "solid" | "dashed" | "dotted" | undefined

      Mô tả

      Bán kính bo góc viền vùng chú thích.

      Ví dụ 'solid'

      textBackgroundVisible

      Type: boolean | undefined

      Mô tả

      Hiển thị nền

      Ví dụ true

      textBackgroundColor

      Type: string | undefined

      Mô tả

      Màu nền

      Ví dụ 'red'

      textBackgroundBorderColor

      Type: string | undefined

      Mô tả

      Màu văn bản

      Ví dụ 'red'

      textBackgroundBorderWidth

      Type: number | undefined

      Mô tả

      Độ rộng viền nền

      Ví dụ 2

      textBackgroundBorderRadius

      Type: number | undefined

      Mô tả

      Bo góc viền nền

      Ví dụ 4

      textBackgroundPadding

      Type: number | undefined

      Mô tả

      Padding nền

      Ví dụ 4

      annotationHorizontalLine

      Type: AnnotationHorizontalLine | AnnotationHorizontalLine[] | undefined

      Mô tả

      Đường chú thích dạng số, bao gồm đường trung bình, đường lớn nhất và đường nhỏ nhất. Hiển thị theo chiều ngang và có thể cấu hình theo vị trí, style. Dùng cấu hình này để vẽ các đường chú thích cho giá trị số như đường trung bình.

      yValue

      Type: string | number | (string | number)[] | undefined

      Mô tả

      Giá trị Y cố định dùng để chú thích đường ngang. Nếu trục danh mục nằm theo hướng Y, có thể nhập giá trị chiều; nếu trục số nằm theo hướng Y, có thể nhập giá trị số cụ thể.

      dynamicFilter

      Type: ValueDynamicFilter | undefined

      Mô tả

      Bộ lọc động (thực thi mã do AI tạo)

      Tính động giá trị đường chú thích bằng mã JavaScript do AI tạo.

      Phù hợp khi cần xác định động vị trí đường chú thích dựa trên dữ liệu, như giá trị trung bình, giá trị lớn nhất, phân vị hoặc đường nghiệp vụ.

      Chỉ hỗ trợ môi trường trình duyệt (cần Web Worker).

      type

      Type: "value"

      description

      Type: string | undefined

      Mô tả

      Mô tả yêu cầu lọc của người dùng (ngôn ngữ tự nhiên)

      Ví dụ "Lấy giá trị doanh số cao nhất làm tham chiếu cho đường đánh dấu"

      "Tính doanh số trung bình cho đường đánh dấu"

      code

      Type: string

      Mô tả

      - Tham số đầu vào: data (mảng), trong đó mỗi mục có field __row_index biểu thị số dòng

      - __row_index biểu thị số dòng của mục dữ liệu gốc; field biểu thị field cần tô nổi bật

      - Cấm: eval, Function, thao tác bất đồng bộ, DOM API, yêu cầu mạng

      Ví dụ

      const maxSales = _.maxBy(data, 'sales')?.sales;
return maxSales || 0;
      const avgSales = _.meanBy(data, 'sales');
return _.round(avgSales, 2);
      const sorted = _.sortBy(data, 'sales');
const index = Math.floor(sorted.length * 0.75);
return sorted[index]?.sales || 0;
      const currentYearTotal = _.sumBy(
_.filter(data, item => item.year === 2024),
'sales'
);
return currentYearTotal;

      fallback

      Type: string | number | undefined

      Mô tả

      Phương án fallback khi thực thi mã thất bại hoặc môi trường không được hỗ trợ

      result

      Type: { success: boolean; data?: number | string; } | undefined

      Mô tả

      Kết quả thực thi bộ lọc động (trường runtime)

      Được ghi trong giai đoạn prepare(), chỉ đọc khi runtime

      success

      Type: false | true

      data

      Type: string | number | undefined

      text

      Type: string | string[] | undefined

      Mô tả

      'red'

      Ví dụ 'Văn bản đánh dấu'

      textPosition

      Type: "outsideStart" | "outsideEnd" | "outsideMiddle" | "insideStart" | "insideMiddle" | "insideEnd" | undefined

      Mô tả

      2

      Ví dụ 'outsideEnd'

      textColor

      Type: string | undefined

      Mô tả

      4

      Ví dụ 'red'

      textFontSize

      Type: number | undefined

      Mô tả

      [2, 2]

      Ví dụ 12

      textFontWeight

      Type: number | undefined

      Mô tả

      0

      Ví dụ 400

      textAlign

      Type: "left" | "right" | "center" | undefined

      Mô tả

      Cách căn chỉnh văn bản. Thông thường không cần đặt

      Khuyến nghị đặt là 'right' để văn bản nằm bên trái đường chú thích

      right: văn bản nằm bên trái đường tham chiếu, mép phải của văn bản căn với điểm cuối của đường chú thích ngang

      left: văn bản nằm bên phải đường tham chiếu, mép trái của văn bản căn với điểm cuối của đường chú thích ngang

      center: văn bản nằm ở giữa đường tham chiếu

      Ví dụ 'right'

      textBaseline

      Type: "top" | "bottom" | "middle" | undefined

      Mô tả

      Cách căn dọc văn bản. Thông thường không cần đặt

      Khuyến nghị đặt là 'top' để toàn bộ văn bản hiển thị trong vùng nhìn thấy của biểu đồ

      top: văn bản nằm phía dưới đường tham chiếu, mép trên của văn bản căn với đường chú thích ngang

      middle: văn bản nằm ở giữa đường tham chiếu

      bottom: văn bản nằm phía trên đường tham chiếu, mép dưới của văn bản căn với đường chú thích ngang

      Ví dụ 'top'

      textBackgroundVisible

      Type: boolean | undefined

      Mô tả

      Hiển thị nền

      Ví dụ true

      textBackgroundColor

      Type: string | undefined

      Mô tả

      Màu nền

      Ví dụ 'red'

      textBackgroundBorderColor

      Type: string | undefined

      Mô tả

      Màu văn bản

      Ví dụ 'red'

      textBackgroundBorderWidth

      Type: number | undefined

      Mô tả

      Độ rộng viền nền

      Độ rộng viền nền

      Ví dụ 2

      textBackgroundBorderRadius

      Type: number | undefined

      Mô tả

      Bo góc viền nền

      Ví dụ 4

      textBackgroundPadding

      Type: number | undefined

      Mô tả

      Padding nền

      Ví dụ 4

      lineVisible

      Type: boolean | undefined

      Mô tả

      Độ mờ màu vùng chú thích

      Độ mờ màu vùng chú thích

      Ví dụ true

      lineColor

      Type: string | undefined

      Mô tả

      Màu viền vùng chú thích.

      Ví dụ 'red'

      lineWidth

      Type: number | undefined

      Mô tả

      Độ rộng viền vùng chú thích.

      Ví dụ 2

      lineStyle

      Type: "solid" | "dashed" | "dotted" | undefined

      Mô tả

      Bán kính bo góc viền vùng chú thích.

      Ví dụ 'solid'

      splitLine

      Type: boolean | { positiveColor?: string; negativeColor?: string; } | undefined

      Mô tả

      Kiểu gạch của viền vùng chú thích.

      positiveColor

      Type: string | undefined

      Mô tả

      Màu chính cho phần lớn hơn giá trị chú thích

      negativeColor

      Type: string | undefined

      Mô tả

      0

      annotationArea

      Type: AnnotationArea | AnnotationArea[] | undefined

      Mô tả

      Vùng chú thích

      Cấu hình vùng chú thích; dựa trên dữ liệu đã chọn để xác định vị trí và kiểu của vùng chú thích.

      selector

      Type: AreaSelector | AreaSelectors | undefined

      Mô tả

      Có bật chức năng liên kết dimension khi biểu đồ bật perspective hoặc khi các measure được gộp hay không.

      field

      Type: string

      Mô tả

      Trường chiều, ID của một mục chiều

      operator

      Type: "in" | "not in" | undefined

      Mô tả

      giống operator

      - in: Chọn các mục dữ liệu có giá trị field chiều nằm trong giá trị đã chỉ định

      op

      Type: "in" | "not in" | undefined

      Mô tả

      giống operator

      - in: Chọn các mục dữ liệu có giá trị field chiều nằm trong giá trị đã chỉ định

      giống operator

      value

      Type: string | number | (string | number)[]

      Mô tả

      Giá trị của trường chiều, hỗ trợ mảng

      text

      Type: string | string[] | undefined

      Mô tả

      'red'

      Ví dụ 'Văn bản đánh dấu'

      textPosition

      Type: "left" | "top" | "topLeft" | "topRight" | "right" | "bottom" | "bottomLeft" | "bottomRight" | undefined

      Mô tả

      2

      Ví dụ 'top'

      textColor

      Type: string | undefined

      Mô tả

      4

      Ví dụ 'red'

      textFontSize

      Type: number | undefined

      Mô tả

      [2, 2]

      Ví dụ 12

      textFontWeight

      Type: number | undefined

      Mô tả

      0

      Ví dụ 400

      textAlign

      Type: "left" | "right" | "center" | undefined

      Mô tả

      Cấu hình đường hồi quy đa thức, bao gồm bậc đa thức, kiểu đường hồi quy, v.v.

      Nên đặt thành 'center' để đảm bảo văn bản nằm ở giữa vùng đánh dấu

      Ví dụ 'center' Văn bản nằm ở giữa vùng đánh dấu

      textBaseline

      Type: "top" | "bottom" | "middle" | undefined

      Mô tả

      Bậc của hồi quy đa thức

      Ví dụ 'top' Văn bản nằm phía dưới vùng đánh dấu

      textBackgroundVisible

      Type: boolean | undefined

      Mô tả

      Hiển thị nền

      Ví dụ true

      textBackgroundColor

      Type: string | undefined

      Mô tả

      Màu nền

      Ví dụ 'red'

      textBackgroundBorderColor

      Type: string | undefined

      Mô tả

      Màu văn bản

      Màu văn bản

      Ví dụ 'red'

      textBackgroundBorderWidth

      Type: number | undefined

      Mô tả

      Độ rộng viền nền

      Ví dụ 2

      textBackgroundBorderRadius

      Type: number | undefined

      Mô tả

      Bo góc viền nền

      Bo góc viền nền

      Ví dụ 4

      textBackgroundPadding

      Type: number | undefined

      Mô tả

      Padding nền

      Ví dụ 4

      areaColor

      Type: string | undefined

      Mô tả

      Màu vùng đánh dấu

      Ví dụ 'red'

      areaColorOpacity

      Type: number | undefined

      Mô tả

      Độ mờ màu tô vùng chú thích

      Ví dụ 0.5

      areaBorderColor

      Type: string | undefined

      Mô tả

      Màu viền vùng chú thích

      Ví dụ 'red'

      areaBorderWidth

      Type: number | undefined

      Mô tả

      Độ rộng viền vùng chú thích

      Ví dụ 2

      areaBorderRadius

      Type: number | undefined

      Mô tả

      Bán kính bo góc viền vùng chú thích

      Ví dụ 4

      areaLineDash

      Type: number[] | undefined

      Mô tả

      Kiểu đường viền vùng chú thích

      Ví dụ [2, 2]

      outerPadding

      Type: number | undefined

      Mô tả

      Lề của vùng đánh dấu

      Ví dụ 0

      annotationDifferenceLine

      Type: AnnotationDifferenceLine | AnnotationDifferenceLine[] | undefined

      Mô tả

      Đường chú thích chênh lệch

      Vẽ đường chú thích chênh lệch dựa trên hai điểm dữ liệu đã chọn và tự động tính văn bản chênh lệch.

      start

      Type: DifferenceAnchor

      Mô tả

      Điểm neo bắt đầu của đường chú thích chênh lệch.

      Cấu hình điểm neo chênh lệch, dùng để chọn dữ liệu liên kết với điểm bắt đầu hoặc điểm kết thúc.

      selector

      Type: DifferenceSelector | DifferenceSelector[]

      Mô tả

      Selector điểm neo, cuối cùng phải định vị tới một điểm neo logic.

      Ví dụ { year: '1930', type: 'Autocracies' }

      [{ field: 'year', operator: 'in', value: ['1930'] }, { field: 'type', operator: 'in', value: ['Autocracies'] }]

      field

      Type: string

      Mô tả

      Trường chiều, ID của một mục chiều

      operator

      Type: "in" | "not in" | undefined

      Mô tả

      giống operator

      - in: Chọn các mục dữ liệu có giá trị field chiều nằm trong giá trị đã chỉ định

      op

      Type: "in" | "not in" | undefined

      Mô tả

      giống operator

      - in: Chọn các mục dữ liệu có giá trị field chiều nằm trong giá trị đã chỉ định

      giống operator

      value

      Type: string | number | (string | number)[]

      Mô tả

      Giá trị của trường chiều, hỗ trợ mảng

      end

      Type: DifferenceAnchor

      Mô tả

      Điểm neo kết thúc của đường chú thích chênh lệch.

      Cấu hình điểm neo chênh lệch, dùng để chọn dữ liệu liên kết với điểm bắt đầu hoặc điểm kết thúc.

      selector

      Type: DifferenceSelector | DifferenceSelector[]

      Mô tả

      Selector điểm neo, cuối cùng phải định vị tới một điểm neo logic.

      Ví dụ { year: '1930', type: 'Autocracies' }

      [{ field: 'year', operator: 'in', value: ['1930'] }, { field: 'type', operator: 'in', value: ['Autocracies'] }]

      field

      Type: string

      Mô tả

      Trường chiều, ID của một mục chiều

      operator

      Type: "in" | "not in" | undefined

      Mô tả

      giống operator

      - in: Chọn các mục dữ liệu có giá trị field chiều nằm trong giá trị đã chỉ định

      op

      Type: "in" | "not in" | undefined

      Mô tả

      giống operator

      - in: Chọn các mục dữ liệu có giá trị field chiều nằm trong giá trị đã chỉ định

      giống operator

      value

      Type: string | number | (string | number)[]

      Mô tả

      Giá trị của trường chiều, hỗ trợ mảng

      differenceType

      Type: "percent" | "absolute" | undefined

      Mô tả

      Loại giá trị chênh lệch.

      • absolute: hiển thị chênh lệch tuyệt đối, tính bằng end - start

      • percent: hiển thị chênh lệch phần trăm, tính bằng (end - start) / start :::

      textFontSize

      Type: number | undefined

      :::note{title=Mô tả} Cỡ chữ văn bản.

      textColor

      Type: string | undefined

      Mô tả

      Text color.

      textBackgroundColor

      Type: string | undefined

      Mô tả

      Màu nền văn bản.

      lineColor

      Type: string | undefined

      Mô tả

      Màu đường.

      lineStyle

      Type: "solid" | "dashed" | "dotted" | undefined

      Mô tả

      Kiểu đường.

      dimensionLinkage

      Type: DimensionLinkage | undefined

      Mô tả

      Có bật liên kết chiều khi pivot hoặc nhóm chỉ số được bật trên biểu đồ hay không

      Khi hover vào một giá trị chiều, làm nổi bật dữ liệu có cùng giá trị chiều trong các biểu đồ khác

      Cấu hình liên kết chiều của biểu đồ pivot

      enable

      Type: false | true

      Mô tả

      Có bật liên kết chiều của biểu đồ pivot hay không

      showTooltip

      Type: boolean | undefined

      Mô tả

      Có hiển thị thông tin Tooltip của các biểu đồ con tương ứng với tất cả các chiều hay không

      showLabel

      Type: boolean | undefined

      Mô tả

      Có hiển thị nhãn tương ứng với crosshair hay không

      locale

      Type: "zh-CN" | "en-US" | "ja-JP" | "de-DE" | "id-ID" | "fr-FR" | "ko-KR" | "vi-VN" | undefined

      Mô tả

      Language

      Cấu hình ngôn ngữ của biểu đồ. Hỗ trợ hai ngôn ngữ 'zh-CN' và 'en-US'; ngoài ra có thể gọi intl.setLocale('zh-CN') để đặt ngôn ngữ