confusing API for heatmap legend

When trying to customize the legend for a heatmap I would expect that to be done through the layout similar to other trace types.

plot_ly(
  z = volcano, 
  type = "heatmap",
) %>%
  layout(
    legend = list(
      title = list(
        text = "custom title"
      )
    )
  )

After digging around for a while and examining the output of plotly_build() %>% plotly_json() I found that this is done through the top level colorbar instead.

plot_ly(
  z = volcano, 
  type = "heatmap",
  colorbar = list(
    title = "custom title"
  )
) 

I would say that if the interface for this needs to be different than for other traces, that should be documented on the heatmap page. Even better may be to standardize the approach so that users always know to go to layout for this type of thing.

I'm also curious why colorbar title is shown as a deprecated attribute from schema().

Bắt đầu với trang heatmap R được liên kết trong issue và kiểm tra các ví dụ được ghi lại cùng với đầu ra của plotly_build() và plotly_json() được mô tả ở đó. Ghi lại rằng việc tùy chỉnh chú giải của heatmap sử dụng colorbar ở cấp cao nhất, bao gồm cả chi tiết về việc schema() không còn được khuyến nghị; công việc hoàn tất khi một người mới có thể tìm và làm theo interface được ghi lại.