文字區

可讓使用者輸入多行文字。 它可以配置成顯示純文字或 Rich Text。

資料連結

一般 內容中設定或修改視圖的資料連結。 「文字區」視圖可以連結至 String 變數。

配置內容

配置下,設定或修改視圖的外觀和行為內容。

螢幕大小
在內容名稱旁具有「畫面大小」圖示 螢幕大小圖示 的配置內容,每一個畫面大小可以有不同的值。 如果您未設定值,則畫面大小會繼承下一個較大畫面大小的值作為其預設值。
佈景主題定義
佈景主題定義指定視圖的顏色和樣式,並決定其外觀。 您可以在佈景主題編輯器中預覽視圖的外觀與操作方式。 請參閱 佈景主題
下表顯示「文字」區域的外觀配置內容:
表 1. 文字區的外觀配置內容
外觀配置內容 說明 資料類型
寬度 螢幕大小圖示 指定文字欄位的寬度 (以像素、百分比或 em 為單位)。 例如: 50px20%0.4em

如果未指定其他值,則預設單位是像素。

String
高度 螢幕大小圖示 px (像素) 或 em 單位來指定文字欄位的高度。 如果未指定任何單元類型,則會假設為 px String
大小 螢幕大小圖示 指定文字大小。 同時套用至標籤和文字。
  • 預設值
  • 大型
  • 小型
String
標籤放置 螢幕大小圖示 指定標籤相對於文字的位置。
附註: 左側的標籤會變更視圖的指定寬度。
String
標籤寬度 大畫面圖示 標籤的寬度。 您可以指定以 px (像素)、% (百分比) 或 em 為單位的寬度。 例如, 50px、20% 或 0.4em。 如果未指定單元類型,則會採用 px。 String
下表列出「文字」區域的行為配置內容:
表 2. 文字區的行為配置內容
行為配置內容 說明 資料類型
定位點索引 指定視圖的定位順序索引。 標籤索引從 1 開始,可以稀疏地設定。 例如,您可以使用 1、5、10。 當您按 Tab 鍵在使用者介面區域之間移動時, Tab 索引內容會控制定位點順序。 Integer
位置保留元文字 提供未輸入任何值時所顯示的位置保留元文字。 String
驗證輸入 用於驗證輸入的正規表示式。 String
列印時自動擴充 啟用列印文字區的整個內容,超出畫面上可見的區域。 Boolean

事件

事件 內容中設定或修改視圖的事件處理程式。 您可以將事件設為以程式化方式觸發,或在使用者與視圖互動時觸發。 如需如何定義及編碼事件的相關資訊,請參閱 使用者定義事件
文字區具有下列類型的事件處理程式:
  • On load: 在頁面載入時啟動。 例如:
    me.setText("Some default text on load.")
  • On change: 在變更文字時啟動。 例如:
    if(newText != oldText){return confirm ("Are you sure you want to change the text area field?");}
  • On focus: 當焦點移至文字欄位時啟動。 例如:
    me.setLabelPlacement("T")

    其中 "T" (代表 Top) 必須定義在 "me.setLabelPlacement("L")"中。

  • On blur: 在文字欄位失去焦點時啟動。 例如:
    me.setLabelPlacement("L")

    其中 "L" (代表 Left) 必須定義在 "me.setLabelPlacement("L")"中。

  • On input: 當使用者在文字欄位中輸入文字時啟動。 例如:
    return potential.length<=10;

方法

如需「文字」區域可用方法的詳細資訊,請參閱 文字區域 JavaScript API。

其他資源

如需如何建立 Coach 或頁面的相關資訊,請參閱 建置 Coach
如需標準內容 (一般配置定位可見性HTML 屬性) 的相關資訊,請參閱 檢視內容