data#

data 的值必须是称为“轨迹”（“traces”）的字典列表。

• 每个轨迹可能是超过 40 种类型中的一种(见下面按子图类型组织的列表，包括例如 Scatter Plots、Bar Charts、Pie Charts、3D Surface Plots、Choropleth Maps，并表示一组相关的图形标记。每个轨迹必须有一个 type 属性，该属性定义其他被允许的属性。

• 每个轨迹都绘制在一个 Subplots 上，该子图的类型必须与轨迹的类型兼容，或者是它自己的子图(参见下面)。

• 轨迹可能只有一个 Legends 项，但饼图和漏斗区域轨迹（funnelarea traces）除外(见下文)。

• 某些轨迹类型支持 带有关联颜色条的连续颜色，当使用 coloraxis 属性时，可以通过轨迹内的属性或布局内的属性来控制颜色条。

layout#

图的三个顶级属性中的第二个是 layout，它的值在文本中称为”布局”，必须是一个字典，包含控制图中非数据相关部分的定位和配置的属性，例如：

• 尺寸和边距，定义了“纸张坐标”的边界

• 图的默认值：模板、字体、标题、颜色、悬停标签 和 mobar

• 可在容器和/或纸坐标中定位 标题 和 Legends

• 可在纸坐标中定位 标题 和 颜色轴和相关的颜色条

• 各种类型的子图，可在其上绘制多个轨迹，并在纸坐标中定位：

  • xaxis, yaxis, xaxis2, yaxis3 等：X 和 Y 笛卡儿轴，它们的交点是笛卡儿子图

  • scene, scene2, scene3等：3D 场景子图

  • ternary, ternary2, ternary3, polar, polar2, polar3, geo, geo2, geo3, mapbox, mapbox2, mabox3等：三元，极坐标，地理或 mapbox 子图

• 非数据标记，可以在纸坐标中定位，也可以在链接到二维笛卡尔子图的数据坐标中定位

  • annotations：带有或不带有箭头的文本注释

  • shapes：直线，矩形，椭圆或开放或封闭的路径

  • images：背景或装饰图像

• 可以在纸坐标中定位的控件，当用户与之交互时，可以触发 Plotly.js 函数

  • updatemenus：自定义按钮 和 Dropdown Menus

  • sliders：Sliders

frames#

图的三个顶级属性中的第三个是 frames，它的值必须是一个字典列表，在 animation plot 中定义顺序帧。每个帧包含自己的数据属性和其他参数。动画通常是通过 layout.sliders 和/或 layout.updatemenus 定义的控件来触发和控制的。

属性设置#

plotly.graph_objects 模块包含自动生成的 Python 类层次结构，这些类代表图模式中的非叶子属性，并为它们提供了一个 Python API。当 操作 plotly.graph_objects.Figure 对象 时，属性可以直接使用 Python 对象属性设置，例如fig.layout.title.font.family="Open Sans"或使用 update 方法和 魔法下划线表示法，例如 fig.update_layout(title_font_family="Open Sans")。