หน้านี้ได้รับการแปลโดย Cloud Translation API

Class TableChartBuilder

เครื่องมือสร้างแผนภูมิตาราง โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบ Google แผนภูมิ

ตัวอย่างที่แสดงวิธีสร้างแผนภูมิตาราง ข้อมูลจะนําเข้าจากสเปรดชีตของ Google

// Get sample data from a spreadsheet.
var dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AF' +
    '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1';

var chartBuilder = Charts.newTableChart()
    .setDimensions(600, 500)
    .enablePaging(20)
    .setDataSourceUrl(dataSourceUrl);

var chart = chartBuilder.build();

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`build()`	`Chart`	สร้างแผนภูมิ
`enablePaging(enablePaging)`	`TableChartBuilder`	ตั้งค่าว่าจะเปิดใช้การสลับหน้าของข้อมูลหรือไม่
`enablePaging(pageSize)`	`TableChartBuilder`	เปิดใช้การแบ่งหน้าและกำหนดจำนวนแถวในแต่ละหน้า
`enablePaging(pageSize, startPage)`	`TableChartBuilder`	เปิดใช้งานการแบ่งหน้า ตั้งค่าจำนวนแถวในแต่ละหน้าและหน้าแรกของตารางที่จะแสดง (หน้า ตัวเลขจะเป็นศูนย์)
`enableRtlTable(rtlEnabled)`	`TableChartBuilder`	เพิ่มการสนับสนุนพื้นฐานสำหรับภาษาที่เขียนจากขวาไปซ้าย (เช่น อาหรับหรือฮีบรู) โดยกลับภาษา ลำดับคอลัมน์ของตาราง เพื่อให้คอลัมน์ 0 เป็นคอลัมน์ด้านขวาสุด และคอลัมน์สุดท้ายคือ คอลัมน์ซ้ายสุด
`enableSorting(enableSorting)`	`TableChartBuilder`	กำหนดว่าจะจัดเรียงคอลัมน์เมื่อผู้ใช้คลิกส่วนหัวของคอลัมน์หรือไม่
`setDataSourceUrl(url)`	`TableChartBuilder`	ตั้งค่า URL ของแหล่งข้อมูลที่ใช้เพื่อดึงข้อมูลจากแหล่งที่มาภายนอก เช่น Google ชีต
`setDataTable(tableBuilder)`	`TableChartBuilder`	ตั้งค่าตารางข้อมูลที่จะใช้กับแผนภูมิโดยใช้ DataTableBuilder
`setDataTable(table)`	`TableChartBuilder`	ตั้งค่าตารางข้อมูลที่มีเส้นสำหรับแผนภูมิ และป้ายกำกับแกน X
`setDataViewDefinition(dataViewDefinition)`	`TableChartBuilder`	ตั้งค่าคำจำกัดความของมุมมองข้อมูลที่จะใช้กับแผนภูมิ
`setDimensions(width, height)`	`TableChartBuilder`	ตั้งค่ามิติข้อมูลสำหรับแผนภูมิ
`setFirstRowNumber(number)`	`TableChartBuilder`	กำหนดหมายเลขแถวให้แถวแรกในตารางข้อมูล
`setInitialSortingAscending(column)`	`TableChartBuilder`	ตั้งค่าดัชนีของคอลัมน์ตามที่ควรจัดเรียงตารางในตอนแรก (จากน้อยไปมาก)
`setInitialSortingDescending(column)`	`TableChartBuilder`	ตั้งค่าดัชนีของคอลัมน์ตามที่ควรจัดเรียงตารางในตอนแรก (มากไปน้อย)
`setOption(option, value)`	`TableChartBuilder`	ตั้งค่าตัวเลือกขั้นสูงสำหรับแผนภูมินี้
`showRowNumberColumn(showRowNumber)`	`TableChartBuilder`	กำหนดว่าจะแสดงหมายเลขแถวเป็นคอลัมน์แรกของตารางหรือไม่
`useAlternatingRowStyle(alternate)`	`TableChartBuilder`	กำหนดว่ามีการกำหนดรูปแบบสีสลับให้กับแถวเลขคี่และแถวคู่ของแผนภูมิตารางหรือไม่

เอกสารโดยละเอียด

`build()`

สร้างแผนภูมิ

รีเทิร์น

Chart — ออบเจ็กต์แผนภูมิที่สามารถฝังลงในเอกสาร องค์ประกอบ UI หรือใช้เป็นแบบคงที่ รูปภาพ

`enablePaging(enablePaging)`

ตั้งค่าว่าจะเปิดใช้การสลับหน้าของข้อมูลหรือไม่

ลักษณะการทำงานเริ่มต้นคือปิดใช้การแบ่งหน้า หากเปิดใช้การแบ่งหน้า ขนาดหน้าตามค่าเริ่มต้นคือ 10

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`enablePaging`	`Boolean`	`true` หากควรเปิดใช้การแบ่งหน้า มิฉะนั้นให้`false`

รีเทิร์น

TableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่

`enablePaging(pageSize)`

เปิดใช้การแบ่งหน้าและกำหนดจำนวนแถวในแต่ละหน้า

ขนาดหน้าเริ่มต้นคือ 10

// Creates a table chart builder and enables paging with page size of 5.
var builder = Charts.newTableChart();
builder.enablePaging(5);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`pageSize`	`Integer`	จำนวนแถวในแต่ละหน้าของตาราง

รีเทิร์น

TableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่

`enablePaging(pageSize, startPage)`

เปิดใช้งานการแบ่งหน้า ตั้งค่าจำนวนแถวในแต่ละหน้าและหน้าแรกของตารางที่จะแสดง (หน้า ตัวเลขจะเป็นศูนย์)

ขนาดหน้าเริ่มต้นคือ 10 และหน้าเริ่มต้นเริ่มต้นคือ 0

// Creates a table chart builder and enables paging with page size of 5 and displays page 2
// first.
var builder = Charts.newTableChart();
builder.enablePaging(5, 2);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`pageSize`	`Integer`	จำนวนแถวในแต่ละหน้าของตาราง
`startPage`	`Integer`	หน้าแรกของตารางที่แสดง (หมายเลขหน้าจะมีฐาน 0)

รีเทิร์น

TableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่

`enableRtlTable(rtlEnabled)`

เพิ่มการสนับสนุนพื้นฐานสำหรับภาษาที่เขียนจากขวาไปซ้าย (เช่น อาหรับหรือฮีบรู) โดยกลับภาษา ลำดับคอลัมน์ของตาราง เพื่อให้คอลัมน์ 0 เป็นคอลัมน์ด้านขวาสุด และคอลัมน์สุดท้ายคือ คอลัมน์ซ้ายสุด

โดยจะไม่ส่งผลต่อดัชนีคอลัมน์ในข้อมูลที่สำคัญ แต่ส่งผลเฉพาะกับลำดับของการแสดงผลเท่านั้น การแสดงภาพตารางไม่รองรับการแสดงภาษาแบบ 2 ทิศทาง (BiDi) แบบเต็มรูปแบบ ด้วยตัวเลือกนี้ ระบบจะไม่สนใจตัวเลือกนี้หากคุณเปิดใช้การแบ่งหน้า (โดยใช้ตัวเลือกหน้าเว็บ) หรือหาก ตารางมีแถบเลื่อน เนื่องจากคุณได้ระบุตัวเลือกความสูงและความกว้างน้อยกว่า ขนาดตารางที่กำหนด ลักษณะการทำงานเริ่มต้นคือปิดใช้การรองรับ RTL

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`rtlEnabled`	`Boolean`	`true` หากควรเปิดใช้การสนับสนุนข้อความจากขวาไปซ้าย `false` หรือไม่เช่นนั้น

รีเทิร์น

TableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่

`enableSorting(enableSorting)`

กำหนดว่าจะจัดเรียงคอลัมน์เมื่อผู้ใช้คลิกส่วนหัวของคอลัมน์หรือไม่

หากเปิดใช้การจัดเรียง เมื่อผู้ใช้คลิกส่วนหัวของคอลัมน์ ระบบจะเรียงแถวให้โดยอัตโนมัติ จัดเรียงแล้ว ลักษณะการทำงานเริ่มต้นคือเปิดใช้การจัดเรียง

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`enableSorting`	`Boolean`	`true` เพื่อเปิดใช้การจัดเรียงโดยคลิกส่วนหัวของคอลัมน์ หากไม่ใช่ `false`

รีเทิร์น

TableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่

`setDataSourceUrl(url)`

ตั้งค่า URL ของแหล่งข้อมูลที่ใช้เพื่อดึงข้อมูลจากแหล่งที่มาภายนอก เช่น Google ชีต หากมีการระบุ URL แหล่งข้อมูลและ DataTable ระบบจะไม่สนใจ URL ของแหล่งข้อมูล

โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการค้นหาแหล่งข้อมูลในเอกสารประกอบ Google แผนภูมิ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`url`	`String`	URL แหล่งข้อมูล รวมถึงพารามิเตอร์การค้นหา

รีเทิร์น

TableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่

`setDataTable(tableBuilder)`

ตั้งค่าตารางข้อมูลที่จะใช้กับแผนภูมิโดยใช้ DataTableBuilder นี่คือวิธีอำนวยความสะดวก สำหรับการตั้งค่าตารางข้อมูลโดยไม่ต้องเรียกใช้ build()

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`tableBuilder`	`DataTableBuilder`	เครื่องมือสร้างตารางข้อมูล ตารางข้อมูลใหม่จะสร้างขึ้นทันทีซึ่งเป็นส่วนหนึ่งของการทำงานนี้ ดังนั้น การอัปเดตเครื่องมือสร้างเพิ่มเติมจะไม่แสดงในแผนภูมิ

รีเทิร์น

TableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่

`setDataTable(table)`

ตั้งค่าตารางข้อมูลที่มีเส้นสำหรับแผนภูมิ และป้ายกำกับแกน X คอลัมน์แรกควรเป็นสตริงและมีป้ายกำกับของแกนแนวนอน กี่คอลัมน์ก็ได้ สามารถติดตามได้ ทั้งหมดต้องเป็นตัวเลข แต่ละคอลัมน์จะแสดงเป็นเส้นแยกจากกัน

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`table`	`DataTableSource`	ตารางข้อมูลที่ใช้สำหรับแผนภูมิ

รีเทิร์น

TableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่

`setDataViewDefinition(dataViewDefinition)`

ตั้งค่าคำจำกัดความของมุมมองข้อมูลที่จะใช้กับแผนภูมิ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`dataViewDefinition`	`DataViewDefinition`	ออบเจ็กต์คำจำกัดความของมุมมองข้อมูลที่กำหนดข้อมูลพร็อพเพอร์ตี้ที่ควรอยู่ ได้มาจากแหล่งข้อมูลที่กำหนดสำหรับการวาดแผนภูมิ

รีเทิร์น

TableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่

`setDimensions(width, height)`

ตั้งค่ามิติข้อมูลสำหรับแผนภูมิ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`width`	`Integer`	ความกว้างของแผนภูมิเป็นพิกเซล
`height`	`Integer`	ความสูงของแผนภูมิในหน่วยพิกเซล

รีเทิร์น

TableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่

`setFirstRowNumber(number)`

กำหนดหมายเลขแถวให้แถวแรกในตารางข้อมูล

หมายเลขแถวเริ่มต้นของแถวแรกคือ 1

// Creates a table chart builder and sets the first row to be 2.
var builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`number`	`Integer`	หมายเลขแถวสำหรับแถวแรกในตารางข้อมูล

รีเทิร์น

TableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่

`setInitialSortingAscending(column)`

ตั้งค่าดัชนีของคอลัมน์ตามที่ควรจัดเรียงตารางในตอนแรก (จากน้อยไปมาก)

ระบบปฏิบัติการของคอลัมน์จะจัดเรียงจากน้อยไปมากและมีลูกศรขนาดเล็กกำกับอยู่

// Creates a table chart builder and sorts it by the second column (ascending).
var builder = Charts.newTableChart();
builder.setInitialSortingAscending(2);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`column`	`Integer`	จำนวนคอลัมน์ตามตารางที่ควรจัดเรียงในตอนแรก

รีเทิร์น

TableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่

`setInitialSortingDescending(column)`

ตั้งค่าดัชนีของคอลัมน์ตามที่ควรจัดเรียงตารางในตอนแรก (มากไปน้อย)

ระบบปฏิบัติการของคอลัมน์จะจัดเรียงตามลำดับจากมากไปหาน้อย และมีลูกศรเล็กๆ กำกับไว้

// Creates a table chart builder and sorts it by the second column (descending).
var builder = Charts.newTableChart();
builder.setInitialSortingDescending(2);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`column`	`Integer`	จำนวนคอลัมน์ตามตารางที่ควรจัดเรียงในตอนแรก

รีเทิร์น

TableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่

`setOption(option, value)`

ตั้งค่าตัวเลือกขั้นสูงสำหรับแผนภูมินี้ ดูตัวเลือกที่ใช้ได้กับ แผนภูมินี้ วิธีการนี้จะไม่มีผลหากตัวเลือกที่ระบุไม่ถูกต้อง

// Build a table chart which renders HTML.
var builder = Charts.newTableChart();
builder.setOption('allowHtml', {@code true});
var chart = builder.build();

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`option`	`String`	ตัวเลือกที่จะตั้งค่า
`value`	`Object`	ค่าที่ต้องกำหนด

รีเทิร์น

TableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่

`showRowNumberColumn(showRowNumber)`

กำหนดว่าจะแสดงหมายเลขแถวเป็นคอลัมน์แรกของตารางหรือไม่

ลักษณะการทำงานเริ่มต้นจะไม่แสดงหมายเลขแถว

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`showRowNumber`	`Boolean`	`true` หากคอลัมน์แรกของตารางควรแสดงหมายเลขแถว `false` หรือไม่เช่นนั้น

รีเทิร์น

TableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่

`useAlternatingRowStyle(alternate)`

กำหนดว่ามีการกำหนดรูปแบบสีสลับให้กับแถวเลขคี่และแถวคู่ของแผนภูมิตารางหรือไม่

การทำงานเริ่มต้นคือแถวที่มีรูปแบบสลับสี

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`alternate`	`Boolean`	`true` หากรูปแบบสีควรสลับกัน หรือ`false`

รีเทิร์น

TableChartBuilder — เครื่องมือสร้างนี้เหมาะสำหรับการทำห่วงโซ่