如何使用 Python openpyxl 套件操作 Excel 連結？openpyxl Hyperlink 物件介紹

Python openpyxl 套件中的 Excel 連結物件 Hyperlink

Pythonopenpyxl套件中的Hyperlink類別，屬於模組openpyxl.worksheet.hyperlink，用於表示 Excel 儲存格中的連結。

使用 Python openpyxl 套件的 Hyperlink 物件建立 Excel 連結

使用 Pythonopenpyxl套件的Hyperlink物件的建構子，你可以建立新的 Excel 連結，這些連結可被設定到工作表的某個 Excel 儲存格中。

Hyperlink(ref=None, location=None, tooltip=None, display=None, id=None, target=None)

ref 參數

ref參數是一個字串，表示含有 Excel 連結的儲存格的位址，比如'A1'。通過該參數指派的ref變數，可能會被openpyxl修改，因此，這裏的ref參數是無關緊要的，如果開發人員自行建立Hyperlink物件的話。

location 參數

location參數是一個字串，表示 Excel 連結指向的 Excel 儲存格或範圍的位址，其格式為worksheet!address（比如，SheetB!A1），其中worksheet為工作表名稱，address為位址，如果指向的是本工作表中的儲存格或範圍，則worksheet和!可以省去（比如，A1:B2）。

tooltip 參數

tooltip參數是一個字串，他表示 Excel 連結對應的工具提示。需要說明的是，即便設定了tooltip，一些 Office 軟體也不會按照tooltip給出的值來顯示工具提示。

display 參數

display參數是一個字串，他表示 Excel 連結在其對應的儲存格中應該顯示的文字，需要指出，Excel 儲存格中最終顯示的內容是由Cell物件的value屬性來決定的。

id 參數

id參數是一個字串，用於識別 Excel 連結。如果連結對應的target變數不為None，那麽通過參數id指派的id變數，可能會被openpyxl套件在儲存 Excel 檔案時修改，當id變數為None，或者id變數的值不符合要求時。

target 參數

target參數是一個字串，他可能是某個網路位址（比如，以http，https，mailto開頭的位址），或者是某個 Excel 檔案的路徑（可以是相對路徑或絕對路徑）。

在讀取 Excel 檔案時，openpyxl套件會建立 Excel 連結物件Hyperlink。如果 Excel 連結並未指向儲存格或範圍，那麽Hyperlink物件的location變數可能為 Python 空值None。如果 Excel 連結指向 Excel 儲存格或範圍，那麽Hyperlink物件的id變數可能為 Python 空值None。如果 Excel 連結指向本工作表中的儲存格或範圍，那麽Hyperlink物件的target變數可能為 Python 空值None。

使用 Python openpyxl 套件的 Cell 物件取得和設定 Excel 連結

Pythonopenpyxl套件的Cell物件的hyperlink屬性，可用於取得或設定 Excel 儲存格中的連結。hyperlink屬性的傳回值是一個Hyperlink物件，如果 Excel 儲存格未包含連結，則Cell物件的hyperlink屬性傳回空值None。

cell.hyperlink
cell.hyperlink = link

link 值

link是一個表示 Excel 連結的Hyperlink物件，或者是一個表示連結目標的字串（他將對應Hyperlink物件的target變數），比如'https://www.bing.com/'。要移除 Excel 儲存格中的連結，link應該為空值None。

# 開啟 Link.xlsx 中的工作表 Hyperlinks
import openpyxl
wb = openpyxl.load_workbook('Link.xlsx')
ws = wb['Hyperlinks']


# 顯示範圍 A1:A2 中的儲存格的連結
for row in ws['A1:A2']:
	for cell in row:
		print(f'{cell.hyperlink}, {cell.hyperlink.target}')


from openpyxl.worksheet.hyperlink import Hyperlink
# B1 儲存格不會顯示為 Google，而是 https://www.google.com/，參數 ref 並不正確，但沒有關系
ws['B1'].hyperlink = Hyperlink('XXXX', display='Google', target='https://www.google.com/')
# 直接通過網址來設定 Excel 連結
ws['C1'].hyperlink = 'https://www.python.org'
# 指向工作表 Other 的 A1 儲存格的連結
ws['D1'].hyperlink = Hyperlink('D1', location='Other!A1')
# 指向本工作表的 A1 儲存格的連結
ws['E1'].hyperlink = Hyperlink('E1', location='A1')


wb.save('Google.xlsx')

…
ref='A1', location=None, tooltip=None, display='Bing', id='rId1', https://www.bing.com/
…
ref='A2', location='Other!B1:B4', tooltip=None, display='Other 的 B1:B4 範圍', id=None, None

使用 Python openpyxl 套件的 Cell 物件修改 Excel 連結

對於 Pythonopenpyxl套件的Cell物件的hyperlink屬性所傳回的Hyperlinks物件，你可以通過其變數來達到修改 Excel 連結的目的。

# 開啟 Link.xlsx 中的工作表 Hyperlinks
import openpyxl
workbook = openpyxl.load_workbook('Link.xlsx')
worksheet = workbook['Hyperlinks']


link = worksheet['A2'].hyperlink
# 修改工具提示和指向的儲存格位址
link.tooltip = '一個大概不會顯示的工具提示'
link.location = 'Other!A1'
# 修改 display 不影響儲存格的內容，因此修改 value 屬性
worksheet['A2'].value = '指向 Other 的 A1'
link.display = '不影響儲存格內容'


workbook.save('Modify.xlsx')

# 開啟 Link.xlsx 中的工作表 Hyperlinks
import openpyxl
workbook = openpyxl.load_workbook('Link.xlsx')
worksheet = workbook['Hyperlinks']


# 移動儲存格 A1，A2 至 D1，D2
worksheet.move_range('A1:A2', cols=3)
# 修改 D1 儲存格的連結的 ref
worksheet['D1'].hyperlink.ref = 'D1'


workbook.save('Move.xlsx')

使用 Python openpyxl 套件的 Cell 物件移除 Excel 連結

你可以通過將 Pythonopenpyxl套件的Cell物件的hyperlink屬性設定為None，來移除對應 Excel 儲存格中的連結，但連結的相關資訊（比如，某個網址或顯示文字）可能會被保留在儲存格中，因為將hyperlink設定為None並不影響Cell的value屬性。

# 開啟 Link.xlsx 中的工作表 Hyperlinks
import openpyxl
workbook = openpyxl.load_workbook('Link.xlsx')
worksheet = workbook['Hyperlinks']


# 刪除 A1 儲存格中的連結
worksheet['A1'].hyperlink = None


workbook.save('Remove.xlsx')

程式碼

src/zh-hant/openpyxl/cells/hyperlinks·codebeatme/office-programming·GitHub