DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> XML學習教程 >> XML詳解
打造一個以 XML 驅動的模組化視窗框架:菜單定義與 XSD 設計(上篇)
編輯:XML詳解     

想把一個日益膨脹的桌面程式拆成可以獨立增刪的功能模組,最常見的做法是寫死菜單、每加一個功能就改一次主程式。這篇提供另一條路:讓菜單結構完全由 XML 描述,並用 XSD 把這份描述約束起來,主程式只負責「照著讀」。

上篇先把兩個基礎檔案準備好——菜單定義檔與驗證用的 schema。

第一步:寫一份菜單定義檔

結構非常樸素:根元素 Menu 底下放若干 MenuItem,而 MenuItem 可以再嵌套 MenuItem,層次因此是無限的。

<Menu>
    <MenuItem Name="系統管理" AssemblyName="" FormTag="FALSE" AddToolbar="FALSE">
        <MenuItem Name="權限管理" ShortCut="" Image=""
                  AssemblyName="" FormTag="FALSE" AddToolButton="FALSE">
            <MenuItem Name="系統權限管理" ShortCut="" Image="passWord.png"
                      AssemblyName="HustCAD.IntePLM.WinUI.FrmSysRight,IntePLM.TyRightWinUI"
                      FormTag="TRUE" AddToolButton="FALSE"/>
            <MenuItem Name="權限規則定義" ShortCut="" Image="right.png"
                      AssemblyName="HustCAD.IntePLM.WinUI.FrmRightRule,IntePLM.TyRightWinUI"
                      FormTag="TRUE" AddToolButton="FALSE"/>
            <MenuItem Name="權限日誌" ShortCut="" Image="doc_yellow_edit.png"
                      AssemblyName="HustCAD.IntePLM.WinUI.FrmRightLog,IntePLM.TyRightWinUI"
                      FormTag="TRUE" AddToolButton="FALSE"/>
        </MenuItem>
    </MenuItem>
</Menu>

每個屬性各有分工,理解它們的意思比記住語法更重要:

  • Name:顯示在使用者眼前的文字,必填。
  • AssemblyName:真正要開的表單在哪裡,格式是「命名空間.類別名稱, 組件名稱」,必填。上層的分類節點因為本身不對應任何表單,可以留空。
  • FormTag:這是不是一個可開啟的表單節點。TRUE 才會觸發反射載入,FALSE 代表純分類。必填。
  • Image:圖示檔名,程式會自動去當前主題目錄底下找。留空則不顯示圖示,也不會出現在 OutlookBar 與工具列上。
  • ShortCut:全域快捷鍵,例如 F5、CtrlS。可選,且必須是 schema 認得的值。
  • AddToolButton / AddToolbar:控制是否也在工具列上放一顆按鈕。

把「顯示文字」與「要去哪裡」拆成兩個不同屬性,是這份設計裡最關鍵的決定。因為兩者分離,同一支表單可以在菜單裡以不同名稱出現多次,介面調整時也不必動到任何程式碼。

第二步:用 XSD 把規則寫死

XML 的長處是自由,短處也是自由。既然設定檔會決定整個程式的行為,就必須有東西告訴我們「怎樣才算寫對」。XSD 在這裡扮演的就是守門員。

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="https://www.w3.org/2001/XMLSchema"
           elementFormDefault="qualified">

    <!-- 根元素:至少一個 MenuItem -->
    <xs:element name="Menu">
        <xs:complexType>
            <xs:sequence>
                <xs:element ref="MenuItem" maxOccurs="unbounded"/>
            </xs:sequence>
        </xs:complexType>
    </xs:element>

    <!-- MenuItem 可自我嵌套,形成任意層次 -->
    <xs:element name="MenuItem">
        <xs:complexType>
            <xs:sequence>
                <xs:element ref="MenuItem" minOccurs="0" maxOccurs="unbounded"/>
            </xs:sequence>

            <!-- 是否也在工具列上顯示 -->
            <xs:attribute name="AddToolButton">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="TRUE"/>
                        <xs:enumeration value="FALSE"/>
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>

            <xs:attribute name="AddToolbar">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="TRUE"/>
                        <xs:enumeration value="FALSE"/>
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>

            <!-- 必填:表單所在位置 -->
            <xs:attribute name="AssemblyName" type="xs:string" use="required"/>

            <!-- 必填:是否為可開啟的表單節點 -->
            <xs:attribute name="FormTag" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="TRUE"/>
                        <xs:enumeration value="FALSE"/>
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>

            <!-- 圖示檔名 -->
            <xs:attribute name="Image" type="xs:string"/>

            <!-- 必填:顯示文字 -->
            <xs:attribute name="Name" type="xs:string" use="required"/>

            <!-- 可選:全域快捷鍵,僅接受列舉中的值 -->
            <xs:attribute name="ShortCut">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value=""/>
                        <xs:enumeration value="F1"/>
                        <xs:enumeration value="F2"/>
                        <!-- F3 ~ F12 依此類推 -->
                        <xs:enumeration value="CtrlA"/>
                        <xs:enumeration value="CtrlB"/>
                        <!-- CtrlC ~ CtrlZ 依此類推 -->
                        <xs:enumeration value="CtrlShiftA"/>
                        <!-- CtrlShiftB ~ CtrlShiftZ 依此類推 -->
                        <xs:enumeration value="AltF1"/>
                        <!-- AltF2 ~ AltF12 依此類推 -->
                        <xs:enumeration value="AltUpArrow"/>
                        <xs:enumeration value="AltDownArrow"/>
                        <xs:enumeration value="AltLeftArrow"/>
                        <xs:enumeration value="AltRightArrow"/>
                        <xs:enumeration value="ShiftF1"/>
                        <!-- ShiftF2 ~ ShiftF12 依此類推 -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
        </xs:complexType>
    </xs:element>
</xs:schema>

(實務上 ShortCut 的列舉會把 F1~F12、Ctrl+字母、Ctrl+Shift+字母、Alt+功能鍵、方向鍵等組合全部列舉出來,這裡只列出代表性項目以免佔篇幅。)

這份 schema 換來了什麼

有了 use="required",Name、AssemblyName、FormTag 三個屬性一旦漏寫,驗證階段就會直接報錯,而不是等到使用者點下去才發現開不了視窗。

有了 xs:enumeration,ShortCut 就不能隨便亂填。這一點比看起來重要:快捷鍵字串是要交給 MenuShortCut.GetShortCut() 解析的,拼錯一個字母只會在執行期靜默失效,很難查。用列舉把它擋在門外,等於把錯誤往前挪到了設定階段。

而 MenuItem 裡允許 ref="MenuItem" 自我遞迴,正是「任意層次模組」的語法基礎——schema 不限制你只能有兩層或三層,菜單有多深,結構就能有多深。

下一步

檔案準備好了,接下來就是寫 MenuLoad 類別:先用 XSD 驗證這份 XML,再把 MenuItem 節點遞迴轉成真正的菜單控制項、OutlookBar 圖示與工具列按鈕,最後透過 AssemblyName 以反射把對應表單開起來。這些都在下篇。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved