URLItem

URLItem クラスは URL 型項目に対して操作を行うためのメンバーを持っています。

継承

SheetItem

インスタンスプロパティ

url

入力されている URL です。

例

esmJSPlugin.sheetEntry("customer").onEntered((screen) => {
  const urlItem = screen.getSheetItemByLabel("URL");

  urlItem.onMounted(function () {
    // 初期値を確認
    console.log("初期値:", urlItem.url); // 初期値: ""

    // 値を変更
    urlItem.url = "https://www.softbrain.co.jp/";

    // 変更後の値を確認
    console.log("変更後:", urlItem.url); // 変更後: "https://www.softbrain.co.jp/"
  });
});

urlLength読み取り専用

url の文字数を表します。

例

esmJSPlugin.sheetEntry("customer").onEntered((screen) => {
  const urlItem = screen.getSheetItemByLabel("URL");

  urlItem.onMounted(function () {
    // 値を設定
    urlItem.url = "https://www.softbrain.co.jp/";

    console.log("文字数:", urlItem.urlLength); // 文字数: 28
  });
});

text

URL の表示文字列です。
シート登録・変更画面では利用できません。

例

esmJSPlugin.sheetDetail("customer").onEntered((scrn) => {
  const urlItem = screen.getSheetItemByLabel("URL");

  urlItem.onMounted(function () {
    // 値を変更
    urlItem.text = "ホームページ";

    // 変更後の値を確認
    console.log("変更後:", urlItem.text); // 変更後: "ホームページ"
  });
});

textLength読み取り専用

text の文字数を表します。

例

esmJSPlugin.sheetEntry("customer").onEntered((screen) => {
  const urlItem = screen.getSheetItemByLabel("URL");

  urlItem.onMounted(function () {
    // 値を設定
    urlItem.url = "ホームページ";

    console.log("文字数:", urlItem.textLength); // 文字数: 6
  });
});

インスタンスメソッド

setUrl

文字列を受け取り、url を変更します。

構文

setUrl(url);

引数

url
入力内容を示す文字列です。

返値

なし

例

esmJSPlugin.sheetEntry("customer").onEntered((screen) => {
  const urlItem = screen.getSheetItemByLabel("URL");

  urlItem.onMounted(function () {
    // 値を確認
    console.log("初期値:", urlItem.url); // 値: ""

    // 値を変更
    urlItem.setUrl("https://www.softbrain.co.jp/");

    // 変更後の値を確認
    console.log("変更後:", urlItem.url); // 変更後: "https://www.softbrain.co.jp/"
  });
});

urlEqualsTo

url が指定した文字列と一致するかどうかを判定します。

構文

urlEqualsTo(string);

引数

string
比較対象の文字列です。

返値

真偽値

例

esmJSPlugin.sheetEntry("customer").onEntered((screen) => {
  const urlItem = screen.getSheetItemByLabel("URL");

  urlItem.onUpdated(function () {
    // 値を確認
    console.log("初期値:", urlItem.url); // 初期値: "https://www.softbrain.co.jp/"

    const isEqual = stringItem.urlEqualsTo("https://www.softbrain.co.jp/");
    console.log(isEqual); // true
  });
});

urlContains

指定した文字列が url に含まれているかどうかを判定します。

構文

urlContains(substring);

引数

substring
検索対象の文字列です。

返値

真偽値

例

esmJSPlugin.sheetEntry("customer").onEntered((screen) => {
  const urlItem = screen.getSheetItemByLabel("URL");

  urlItem.onUpdated(function () {
    // 値を確認
    console.log("値:", urlItem.url); // 値: "ソフトブレーン"

    const result = urlItem.urlContains("softbrain");
    console.log(result); // false
  });
});

urlLengthEqualsTo

数値を受け取り、url の文字数が指定した数値と同じかどうかを判定します。

構文

urlLengthEqualsTo(number);

引数

number
比較対象の数値です。

返値

真偽値

例

esmJSPlugin.sheetEntry("customer").onEntered((screen) => {
  const urlItem = screen.getSheetItemByLabel("URL");

  urlItem.onUpdated(function () {
    // 値を確認
    console.log("値:", urlItem.url); // 値: "https://www.softbrain.co.jp/"

    const result = urlItem.urlLengthEqualsTo(28);
    console.log(result); // true
  });
});

urlLengthIsGreaterThan

url の文字数が指定した数値より大きいかどうかを判定します。

構文

urlLengthIsGreaterThan(number);

引数

number
比較対象の数値です。

返値

真偽値

例

esmJSPlugin.sheetEntry("customer").onEntered((screen) => {
  const urlItem = screen.getSheetItemByLabel("URL");

  urlItem.onUpdated(function () {
    // 値を確認
    console.log("値:", urlItem.url); // 値: "https://www.softbrain.co.jp/"

    const result = urlItem.urlLengthIsGreaterThan(27);
    console.log(result); // true
  });
});

urlLengthIsGreaterThanOrEqual

url の文字数が指定した数値以上かどうかを判定します。

構文

urlLengthIsGreaterThanOrEqual(number);

引数

number
比較対象の数値です。

返値

真偽値

例

esmJSPlugin.sheetEntry("customer").onEntered((screen) => {
  const urlItem = screen.getSheetItemByLabel("URL");

  urlItem.onUpdated(function () {
    // 値を確認
    console.log("値:", urlItem.url); // 値: "ソフトブレーン"

    const result = urlItem.urlLengthIsGreaterThanOrEqual(28);
    console.log(result); // true
  });
});

urlLengthIsLessThan

url の文字数が指定した数値より小さいかどうかを判定します。

構文

urlLengthIsLessThan(number);

引数

number
比較対象の数値です。

返値

真偽値

例

esmJSPlugin.sheetEntry("customer").onEntered((screen) => {
  const urlItem = screen.getSheetItemByLabel("URL");

  urlItem.onUpdated(function () {
    // 値を確認
    console.log("値:", urlItem.url); // 値: "https://www.softbrain.co.jp/"

    const result = urlItem.urlLengthIsLessThan(29);
    console.log(result); // true
  });
});

urlLengthIsLessThanOrEqual

url の文字数が指定した数値以下かどうかを判定します。

構文

urlLengthIsLessThanOrEqual(number);

引数

number
比較対象の数値です。

返値

真偽値

例

esmJSPlugin.sheetEntry("customer").onEntered((screen) => {
  const urlItem = screen.getSheetItemByLabel("URL");

  urlItem.onUpdated(function () {
    // 値を確認
    console.log("値:", urlItem.url); // 値: "https://www.softbrain.co.jp/"

    const result = urlItem.urlLengthIsLessThanOrEqual(28);
    console.log(result); // true
  });
});

setText

文字列を受け取り、text を変更します。

構文

setText(text);

引数

text
入力内容を示す文字列です。

返値

なし

例

esmJSPlugin.sheetEntry("customer").onEntered((screen) => {
  const urlItem = screen.getSheetItemByLabel("URL");

  urlItem.onMounted(function () {
    // 値を確認
    console.log("初期値:", urlItem.text); // 値: ""

    // 値を変更
    urlItem.setText("ホームページ");

    // 変更後の値を確認
    console.log("変更後:", urlItem.text); // 変更後: "ホームページ"
  });
});

textEqualsTo

text が指定した文字列と一致するかどうかを判定します。

構文

textEqualsTo(string);

引数

string
比較対象の文字列です。

返値

真偽値

例

esmJSPlugin.sheetEntry("customer").onEntered((screen) => {
  const urlItem = screen.getSheetItemByLabel("URL");

  urlItem.onUpdated(function () {
    // 値を確認
    console.log("初期値:", urlItem.text); // 初期値: "ホームページ"

    const isEqual = stringItem.textEqualsTo("ホームページ");
    console.log(isEqual); // true
  });
});

textContains

指定した文字列が text に含まれているかどうかを判定します。

構文

textContains(substring);

引数

substring
検索対象の文字列です。

返値

真偽値

例

esmJSPlugin.sheetEntry("customer").onEntered((screen) => {
  const urlItem = screen.getSheetItemByLabel("URL");

  urlItem.onUpdated(function () {
    // 値を確認
    console.log("値:", urlItem.text); // 値: "ホームページ"

    const result = urlItem.textContains("ホームページ");
    console.log(result); // true
  });
});

textLengthEqualsTo

数値を受け取り、text の文字数が指定した数値と同じかどうかの真偽値を返します。

構文

textLengthEqualsTo(number);

引数

number
比較対象の数値です。

返値

真偽値

例

esmJSPlugin.sheetEntry("customer").onEntered((screen) => {
  const urlItem = screen.getSheetItemByLabel("URL");

  urlItem.onUpdated(function () {
    // 値を確認
    console.log("値:", urlItem.text); // 値: "ホームページ"

    const result = urlItem.textLengthEqualsTo(6);
    console.log(result); // true
  });
});

textLengthIsGreaterThan

text の文字数が指定した数値より大きいかどうかを判定します。

構文

textLengthIsGreaterThan(number);

引数

number
比較対象の数値です。

返値

真偽値

例

esmJSPlugin.sheetEntry("customer").onEntered((screen) => {
  const urlItem = screen.getSheetItemByLabel("URL");

  urlItem.onUpdated(function () {
    // 値を確認
    console.log("値:", urlItem.text); // 値: "ホームページ"

    const result = urlItem.textLengthIsGreaterThan(5);
    console.log(result); // true
  });
});

textLengthIsGreaterThanOrEqual

text の文字数が指定した数値以上かどうかを判定します。

構文

textLengthIsGreaterThanOrEqual(number);

引数

number
比較対象の数値です。

返値

真偽値

例

esmJSPlugin.sheetEntry("customer").onEntered((screen) => {
  const urlItem = screen.getSheetItemByLabel("URL");

  urlItem.onUpdated(function () {
    // 値を確認
    console.log("値:", urlItem.text); // 値: "ホームページ"

    const result = urlItem.textLengthIsGreaterThanOrEqual(6);
    console.log(result); // true
  });
});

textLengthIsLessThan

text の文字数が指定した数値より小さいかどうかを判定します。

構文

textLengthIsLessThan(number);

引数

number
比較対象の数値です。

返値

真偽値

例

esmJSPlugin.sheetEntry("customer").onEntered((screen) => {
  const urlItem = screen.getSheetItemByLabel("URL");

  urlItem.onUpdated(function () {
    // 値を確認
    console.log("値:", urlItem.text); // 値: "ホームページ"

    const result = urlItem.textLengthIsLessThan(7);
    console.log(result); // true
  });
});

textLengthIsLessThanOrEqual

text の文字数が指定した数値以下かどうかを判定します。

構文

textLengthIsLessThanOrEqual(number);

引数

number
比較対象の数値です。

返値

真偽値

例

esmJSPlugin.sheetEntry("customer").onEntered((screen) => {
  const urlItem = screen.getSheetItemByLabel("URL");

  urlItem.onUpdated(function () {
    // 値を確認
    console.log("値:", urlItem.text); // 値: "ホームページ"

    const result = urlItem.textLengthIsLessThanOrEqual(6);
    console.log(result); // true
  });
});

関連情報

• SheetItem
• screen