<apex: axis> Visualforce 页面中的组件

17 Mar 2025 | 4 分钟阅读

<apex: axis> 是一个用作 <apex: chart> 子组件的组件，用于指定图表应设计的轴。我们可以为每个图表边缘定义一个 <apex: axis>。因此，我们可以为一个 <apex: chart> 组件指定最多 4 个 <apex: axis>。

使用 <apex: axis> 组件，我们可以设置轴的单位、比例、标签和其他视觉选项。

<apex: axis> 组件在 Visualforce 页面上具有以下属性

1. dashSize

dashSize 是一个 Integer 类型的属性，用于指定短划线标记的大小。此属性接受像素值，如果我们不指定其值，则默认值设置为 3。

语法

2. fields

"fields" 是一个字符串类型的属性，用于指定图表数据中每个记录中的字段，从中检索轴标签值。我们可以指定多个字段以增加轴刻度范围，以包括所有值。

语法

3. grid

grid 是一个 Boolean 类型的属性，用于指定是否在图表的背景中绘制网格线。此属性的默认值为 Boolean 值 false。

语法

4. gridFill

gridFill 是一个 Boolean 类型的属性，用于指定是否用背景颜色填充替代网格间隔。此属性的默认值为 Boolean 值 false。

语法

5. id

Id 是一个字符串类型的属性，即一个唯一的标识符，允许页面上的其他组件引用此组件。

语法

6. margin

margin 是一个整数类型的属性，用于指定图表外边缘与轴标签文本基线之间的距离。默认情况下，此属性的值设置为 10。

语法

7. maximum

maximum 是一个整数类型的属性，用于指定轴的最大值。默认情况下，其值根据字段中的值计算得出。

语法

8. minimum

minimum 是一个整数类型的属性，用于指定轴的最小值。默认情况下，其值根据字段中的值计算得出。

语法

9. position

position 是一个字符串类型的属性，用于指定将轴绑定到的图表的边缘。这些是此属性的可能值

左
右
top
bottom (底部)
gauge
radial

语法

10. rendered

rendered 是一个 Boolean 类型的属性，用于指定是否使用图表呈现轴元素。此属性的默认值为 Boolean 值 true。

语法

11. tips

"tips" 是一个整数类型的属性，用于指定放置在轴上的刻度线数量。仅当轴类型为数字时，tips 属性才有效。

语法

12. title

title 是一个字符串类型的属性，用于指定轴的标签。

语法

13. type

type 是一个字符串类型的属性，用于指定用于计算轴间隔和间距的轴类型。这些是此属性的可能值

类别
数字
Gauge
Radial

语法

让我们看一个例子来了解如何在 Visualforce 页面上使用 <apex: axis> 组件。

ApexAxisExample.vfp

<!-- apex page to represent the use of apex: axis component -->
<apex:page controller="ApexAxisController" title="Bar Chart">
    <!-- create a chart using <apex: chart> component-->
    <apex:chart data="{!OrgInformation}" height="500" width="600">
        <apex:legend position="top"/>
        <!-- use <apex: axis> component to specify axis for left and bottom position-->
        <apex:axis type="Numeric" position="left" fields="apiRequestLimit" title="Limit" />
        <apex:axis type="Category" position="bottom" fields="attribute" title="LimitAttribute"/>
        <apex:barSeries orientation="vertical" axis="left" xField="attribute" yField="apiRequestLimit"/>
    </apex: chart>
</apex: page>

ApexAxisController.apxc

//create class ApexAxisController to construct data for the chart
public class ApexAxisController {
    //create
    public List<ChartInfo> getOrgInformation() {
        
        // create a list of ChartInfo
        List<ChartInfo> records = new List<ChartInfo>();
        
        // create a map that stores org information
        Map<String,System.OrgLimit> limitsMap = OrgLimits.getMap();
        
        if(limitsMap.containsKey('DailyApiRequests')){
            System.OrgLimit apiRequestsLimit = limitsMap.get('DailyApiRequests');
            
            Integer value1 = apiRequestsLimit.getValue();
            Integer value2 = apiRequestsLimit.getLimit();
            
            records.add(new ChartInfo('Max/Remaining', value2));
            records.add(new ChartInfo('Remaining', value2-value1));
            records.add(new ChartInfo('Used', value1));
            return records;
        }
        return null;
    }
    // create wrapper class for chart
    public class ChartInfo {
        public String attribute {get;set;}
        public Integer apiRequestLimit {get;set;}        
        
        // constructor
        public ChartInfo(String attribute, Integer requestLimit) {
            this.attribute = attribute ;
            this.apiRequestLimit = requestLimit ;
        }
    }    
}

输出