Chart.js Page & Widgets API Reference

`Chart`

4 methods

Chart 类：渲染到画布的构造函数、配置对象和实例更新方法。

$.mobile.changePage(to, options?)

使用提供的配置在给定画布（或 2d 上下文）上创建并渲染图表。

Parameters

Name	Type	Description
to	string \| jQuery	Target page selector, element, or URL.
options	object	Optional { transition, reverse, changeHash, role, ... }.

Returns

Promise

Example

jquery-mobile

$.mobile.changePage('#settings', {
  transition: 'slide',
  reverse: false,
});

data-role="page"

此图表实例的实时配置对象；修改后调用 update() 重新渲染。

Returns

markup

Example

jquery-mobile

<div data-role="page" id="home">
  <div data-role="header"><h1>Home</h1></div>
  <div data-role="content">...</div>
</div>

data-transition="slide|fade|pop|flip"

在数据或选项变更后重新渲染图表。mode 控制动画（'none' 跳过）。

Parameters

Name	Type	Description
transition	string	One of slide, fade, pop, flip, slidedown, etc.

Returns

markup

Example

jquery-mobile

<a href="#settings" data-transition="slide">Settings</a>

$.mobile.navigate(url, data?)

销毁图表实例，移除所有事件监听器并清空画布。复用画布前调用。

Parameters

Name	Type	Description
url	string	Target URL or hash.

Returns

void

Example

jquery-mobile

$.mobile.navigate('#profile', { info: 'from menu' });

`Controllers`

4 methods

内置图表类型的控制器特定配置：柱状图、折线图和饼图/环形图。

$(el).listview(options?)

柱状图配置。数据集选项包括 backgroundColor、borderColor、borderWidth 和 barPercentage。

Parameters

Name	Type	Description
options	object	Optional { inset, autodividers, filter, splitIcon, ... }.

Returns

jQuery

Example

jquery-mobile

$('#mylist').listview({
  inset: true,
  filter: true,
  filterPlaceholder: 'Search...',
});

$(el).navbar()

折线图配置。数据集选项包括 borderColor、fill、tension（0-1，用于样条）和 pointRadius。

Returns

jQuery

Example

jquery-mobile

<div data-role="navbar">
  <ul><li><a href="#">One</a></li><li><a href="#">Two</a></li></ul>
</div>
// programmatic
$('[data-role="navbar"]').navbar();

$(el).popup(options?)

饼图/环形图配置。每个数据值对应一个切片；backgroundColor 是匹配数据长度的数组。

Parameters

Name	Type	Description
options	object	Optional { dismissible, overlayTheme, transition, positionTo, ... }.

Returns

jQuery

Example

jquery-mobile

$('#info').popup({
  dismissible: true,
  transition: 'pop',
  positionTo: 'window',
});
$('#info').popup('open');

instance('open' | 'close', ...args)

配置 x 轴和 y 轴（linear、category、time、log）。笛卡尔图表需显式设置 scales。

Parameters

Name	Type	Description
method	string	'open' or 'close'.

Returns

jQuery

Example

jquery-mobile

$('#info').popup('open');
setTimeout(() => $('#info').popup('close'), 1500);

All references